IDOCS

Raquel Pereira da Cunha

Consultora BC
 EDI e ALE

Documento

IDoc
Sistema SAP R/3 Sistema SAP R/3

IDoc IDoc

Mensagem
Subsistema EDI Subsistema EDI
Siglas

• EDI: Eletronic Data Interchange

• EDIFACT: Eletronic Data Interchange
for Administration Comerce and
Transport
• ALE: Application Likn Enabling
• IDoc: Intermediate Document

3
IDoc (Intermediate Document)

• Documento intermediário usado para

troca de dados:
– SAP  SAP
– SAP  Sistema Externo

• Orientado a mensagem
• Assíncrono

4
Arquitetura do IDoc
• Um Tipo de IDoc descreve a estrutura
técnica do IDoc.
– Reg. Controle
– Reg. Dados ( composto de segmentos )
– Reg. Status
• Segmentos são estruturas de dados
• Um IDoc é um tipo de IDoc preenchido com
dados.

5
Intermediate Document
• Um IDoc, depois de gerado, consiste
na base de dados de:
– 1 Registro de Controle
– Muitos Registros de Dados
– Alguns Registros de Status
• No arquivo trocado com um sistema
externo, consiste de:
– 1 Registro de controle
– Muitos Registros de dados
6
Direção de processamento

• OUTBOUND
- IDoc de saída

• INBOUND
- IDoc de entrada

7
Registro 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.
8
Registro de Dados
• Contém as informações relevantes que
serão trocadas entre os sistemas.
• Pode haver muitos em um único idoc.
• Consiste de :
– 55 bytes de controle: nº do idoc,
nome do segmento, etc...
– 1000 bytes de dados

9
Registro de Status

• Cada registro de status corresponde a um

estágio no ciclo de vida do IDoc.

– Nº do IDoc
– Código de status
– Tipo do IDoc
– Data e Hora

10
Categorias de um IDoc

Pode-se:
• Usar um tipo de IDoc standard (não
exige desenvolvimento)
• Criar uma extensão de um tipo IDoc
standard
• Criar um novo tipo de IDoc

11
IDoc Standard

• Existem no SAP tipos de IDoc para

vários processos de negócios.

12
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

13
Passos 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.

14
Passos p/ criar um Tipo de IDoc
• Transação WEDI
• Editor de IDoc
– Nome
– Descrição
– Segmentos

• Editor de segmentos
– Campos

15
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)

16
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).

17
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

18
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.

19
Outbound via Message Control
Ex: Pedido de Compra
Meio de
transmissão
EDI

20
Outbound via ALE

• 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

21
Outbound via ALE

• 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

22
Status de Outbound
01 37 39 24 04

29
06 05
26
08 07
25

10 09
30

40 41 12 11
03 02

22

18 20
14 15

16 17

31
23
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.

24
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
25
Status de Inbound
50 56

65

60
61

64

66

62 63

51
52

53 68
26
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

27
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

28
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.

29
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)

30
Process code (inbound)

• Determina qual módulo de função ou

workflow será executado para criar o
documento assim que o IDoc for
recebido

31
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

32
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

33
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

34
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.

35
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.

36
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

37
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.

38