idoc passo a passo inbound

IDOCSIDOCS

EDI e ALE

Documento

IDoc

Mensagem

IDocIDoc

Sistema SAP R/3Sistema SAP R/3

Subsistema EDISubsistema EDI Subsistema EDISubsistema EDI

Sistema SAP R/3Sistema SAP R/3

3

Siglas

• EDI: Eletronic Data Interchange

• EDIFACT: Eletronic Data Interchange for Administration Comerce and Transport

• ALE: Application Likn Enabling

• IDoc: Intermediate Document

4

IDoc (Intermediate Document)IDoc (Intermediate Document)

• Documento intermediário usado para Documento intermediário usado para troca de dados:troca de dados:

– SAP SAP SAP SAP

– SAP SAP Sistema Externo Sistema Externo

• Orientado a mensagemOrientado a mensagem

• AssíncronoAssíncrono

5

Arquitetura do IDocArquitetura do IDoc

• Um Tipo de IDoc descreve a estrutura Um Tipo de IDoc descreve a estrutura técnica do IDoc.técnica do IDoc.

– Reg. ControleReg. Controle– Reg. Dados ( composto de segmentos )Reg. Dados ( composto de segmentos )– Reg. StatusReg. Status

• Segmentos são estruturas de dadosSegmentos são estruturas de dados• Um IDoc é um tipo de IDoc preenchido com Um IDoc é um tipo de IDoc preenchido com

dados.dados.

6

Intermediate DocumentIntermediate Document• Um IDoc, depois de gerado, consiste Um IDoc, depois de gerado, consiste

na na base de dadosbase de dados de: de:

– 1 Registro de Controle1 Registro de Controle– Muitos Registros de Dados Muitos Registros de Dados – Alguns Registros de StatusAlguns Registros de Status

• No arquivo trocado com um sistema No arquivo trocado com um sistema externo, consiste de:externo, consiste de:– 1 Registro de controle1 Registro de controle– Muitos Registros de dadosMuitos Registros de dados

7

Direção de processamentoDireção de processamento

• OUTBOUNDOUTBOUND

- IDoc de saída- IDoc de saída

• INBOUNDINBOUND

- IDoc de entrada- IDoc de entrada

8

Registro de ControleRegistro de Controle

• Contém informações sobre os parceiros de negócios e o tipo de mensagem.

- Número do IDoc

- Tipo do IDoc

- Mensagem lógica (tipo de dados)

- ID do emissor/receptor

- Direção do IDoc

• O registro de controle identifica um IDoc unicamente.

9

Registro de DadosRegistro de Dados

• Contém as informações relevantes que Contém as informações relevantes que serão trocadas entre os sistemas.serão trocadas entre os sistemas.

• Pode haver muitos em um único idoc.Pode haver muitos em um único idoc.• Consiste de :Consiste de :

– 55 bytes de controle: nº do idoc, 55 bytes de controle: nº do idoc, nome do segmento, etc...nome do segmento, etc...

–1000 bytes de dados1000 bytes de dados

10

Registro de StatusRegistro de Status

• Cada registro de status corresponde a Cada registro de status corresponde a um estágio no ciclo de vida do IDoc.um estágio no ciclo de vida do IDoc.

– Nº do IDoc Nº do IDoc

– Código de statusCódigo de status

– Tipo do IDocTipo do IDoc

– Data e HoraData e Hora

11

Categorias de um IDocCategorias de um IDoc

Pode-se:Pode-se:

• Usar um tipo de IDoc standard (não Usar um tipo de IDoc standard (não exige desenvolvimento)exige desenvolvimento)

• Criar uma extensão de um tipo IDoc Criar uma extensão de um tipo IDoc standardstandard

• Criar um novo tipo de IDocCriar um novo tipo de IDoc

12

IDoc Standard

• Existem no SAP tipos de IDoc para vários processos de negócios.

13

IDoc Standard

• Ex: Pedido de Compra

• Tipo de IDoc: ORDERS01

• Criado pela aplicação:

- no momento da liberação do pedido (automaticamente)

- na saída de mensagens

14

Passos p/ criar um Tipo de IDocPassos p/ criar um Tipo de IDoc

• Decidir se o IDoc será de entrada/saída ou os dois

• Definir a estrutura do IDoc

( que informações serão necessárias)

• Verificar se já existe algum segmento do SAP que poderá ser usado.

15

• Transação WEDI

• Editor de IDoc – Nome

– Descrição

– Segmentos

• Editor de segmentos– Campos

Passos p/ criar um Tipo de IDocPassos p/ criar um Tipo de IDoc

16

Passos p/ criar um Tipo de IDoc

• Criar Mensagem Lógica : Define o tipo de documento a ser criado.

Ex de Msg: ORDERS - Pedido de compras

• Associar a Msg. Lóg. ao tipo de IDoc

• Associar a Msg. Lóg. a uma função (inbound)

17

Passos p/ criar um Tipo de IDoc• Definir o código do processo

(Process Code)- Define qual o módulo de função a ser executada p/ criar o IDoc (outbound) ou para receber o IDoc (inbound).

• Implementar os processos outbound e inbound (Abap).

• Definir como/quando o IDoc será enviado (outbound).

18

Extensão de um Tipo de IDoc (Enhancement)

• Definir qual o Tipo de IDoc a ser extendido• Verificar se existe Customer Exit • Definir se será inbound/outbound.

• Criar novos segmentos, não alterar os existentes.

• Associar o novo tipo de IDoc a uma Msg. Lóg.

• Criar um projeto (CMOD)

• Inserir o seu código Abap

19

Outbound via Message Control

• Message Control cria mensagens para documentos de aplicação. As mensagens possíveis são definidas no Customizing.

• Assim como o meio de transmissão da mensagem pode ser a impressora, também pode ser ALE ou EDI.

20

Outbound via Message Control

Ex: Pedido de CompraMeio de

transmissão EDI

21

• Também chamado Direct Outbound Process

• Remove dados desnecessários à comunicação

• Muda a versão do IDoc quando o sistema só reconhece versões mais antigas

Outbound via ALE

22

• Determina o receptor via Modelo de distribuição quando a aplicação não enviar esta informação

• Duplica o IDoc quando necessário para modelos distribuídos

• Transfere o IDoc para a função MASTER_IDOC_DISTRIBUTE

Outbound via ALE

23

Status de Outbound

37

29

26

02

20

31

01 39

18

03

30

25

4140 12

10

08

06

24

22

04

11

09

07

05

16

14 15

17

24

Inbound via WorkFlow• O sistema externo envia IDocs ao R/3. O R/3

endereça via porta chamada SAP<SID>, por ex, SAPC11para um sistema R/3 chamado C11.

• Se a Interface de IDoc reconhecer o sistema externo, os IDocs são aceitos e uma análise de sintaxe é executada, checando se o remetente existe como um parceiro.

• O IDoc é enviado para a aplicação via SAP Business Workflow de acordo com os parâmetros definidos no parceiro.

25

Inbound via ALE

• O IDoc é passado diretamente para a aplicação de acordo com os parâmetros definidos no parceiro.

• Também chamado Direct Inbound Process

• Remove dados desnecessários à comunicação

• Muda a versão do IDoc quando o sistema só reconhece versões mais antigas

26

Status de Inbound

52

66

53

62

51

63

56

65

60

68

50

64

61

27

Status via File Interface

• Status enviados por sistemas que utilizam porta do tipo File

• O subsistema EDI escreve em um arquivo informações de status

• O subsistema executa um startrfc (RFC Library) passando o nome do arquivo e a função EDI_STATUS_INCOMING

28

Status via Tipo de IDoc SYSTAT01

• Status enviado por sistemas que usam porta do tipo tRFC(transactional RFC)

• As informações de status são inseridas em um IDoc do tipo SYSTAT01

• O IDoc é processado como um IDoc qualquer.

• Tipo de mensagem é STATUS e o process code é STA1

29

Perfis de Parceiro, Process Code e Portas• O Perfil de parceiro liga os dois sistemas• O Process Code indica qual o processo de

negócio. O processo de negócio controla a criação de um Idoc de saída ou entrada de um IDoc para criação de um documento.

• A Porta tem as configurações técnicas para endereçar o sistema parceiro.

30

Perfil de parceiro

• Dados gerais:– Número do parceiro, Tipo de parceiro

• Dados de saída (outbound parameters)– Porta, Tipo de IDoc, Tipo de mensagem,

modo de envio (imediato ou não)• Dados de entrada

– Tipo de mensagem, Process code, momento de processsamento (imediato ou em batch)

31

Process code (inbound)

• Determina qual módulo de função ou workflow será executado para criar o documento assim que o IDoc for recebido

32

Process code (outbound)

• Só é utilizado nos casos de o processo de outbound ser via Message Control

• Determina qual o módulo de função que será executado para converter um documento em um IDoc

33

Portas

• Portas são canais por onde os IDocs são trocados.

• Existem 5 tipos de portas:– File– RFC Transacional (tRFC)– CPI-C– Internet– Programming Interface

34

Testes de Outbound

• Transações WE14 e WE19 testam a transferência de um IDoc para a porta correspondente

• Transação WE15 testa a criação de um IDoc via Message Control, executando o programa RSNAST00

• WE15 só é utilizada em SD e MM

35

Testes de Inbound

• Transações WE12 e WE16 testam a entrada de um IDoc no R/3 via sistema de arquivos

• Transação WE12 altera o registro de controle para transformar um IDoc de saída em um IDoc de entrada.

36

Testes de Confirmação de Status

• Transação WE17 testa a transferência de status em formato de arquivo.

• Os registros de status devem corresponder a IDocs de saída, ou dará erro.

• SYSTAT01 pode ser testado utilizando qualquer transação de teste de inbound.

37

Monitoramento

Transação WEDI

- Lista dos IDocs criados

- Análise Estatística por status

- Análise dos registros de controle, dados e

status

- Número de IDocs enviados/recebidos por

hora

38

Conclusão

• IDoc é uma tecnologia do SAP para troca de informações entre parceiros de negócios.

• Um tipo de IDoc é formado por registros de controle, dados e status.

• Existem Tipos de IDoc standard para vários processos do SAP.

• É possível criar novos tipos de IDoc ou extender um já existente, quando necessário.

• Existem transações para testar e monitorar IDocs enviados/recebidos.