Criação de IDOC

1. Check List para Criação de um IDOC Inbound (entrada) (Tcode: WEDI)

1.1. Criar Segmento (Tcode: WE31)

1.2. Criar Tipo de Idoc (Tcode: WE30)
1.3. Associar o Segmento ao Tipo de Idoc (Tcode: WE30)
1.4. Criar Tipo de Mensagem (Tcode: WE81)
1.5. Associar o Tipo de Mensagem ao Tipo de Idoc (Tcode: WE82)
1.6. Criar Porta (Tcode: WE21)
1.7. Definir Parceiros (Emissor / Receptor) (Tcode: WE20)
1.8. Criar Módulo de Função (Tcode: SE37)
1.9. Cadastrar o Módulo de função como de entrada (Tcode: BD51)
1.10. Associar o Módulo de função ao Tipo de Mensagem(Tcode: WE57)
1.11. Criar um Process Code Inbound (Tcode: WE42)
1.12. Associar Process Code ao Módulo de Função (Tcode: BD67)

2. Check List para Criação de um IDOC Outbound (saída) (Tcode: WEDI)

2.1. Criar Segmento (Tcode: WE31)

2.2. Criar Tipo de Idoc (Tcode: WE30)
2.3. Associar o Segmento ao Tipo de Idoc (Tcode: WE30)
2.4. Criar Tipo de Mensagem (Tcode: WE81)
2.5. Associar o Tipo de Mensagem ao Tipo de Idoc (Tcode: WE82)
2.6. Criar Porta (Tcode: WE21)
2.7. Definir Parceiros (Emissor / Receptor) (Tcode: WE20)
2.8. Criar Módulo de Função (Tcode: SE37)
2.9. Criar Programa para preencher o Idoc (Tcode: SE38)

3. Visualizando os IDOCs e seus status (Tcode: WE05)

4. Enviando / Recebendo os IDOCs (Tcode: BALE)

5. Preparando arquivo de saída (Idoc Outbound) para arquivo (Tcode: WE12)

de entrada (Idoc Inbound)

Data: 29/01/21 Página: 1

 Criação de IDOC

1. Check List para Criação de um IDOC Inbound (entrada)

Tcode: WEDI

WE05 WE20 WE21

Criar Segmentos :
Desenvolvimento ->
Segmento de Idoc
Deverá ser criado todos os
segmentos necessários para
satisfazer a necessidade do
IDOC, ou seja, Header,
Item, etc; cada segmento
deverá conter os campos
desejados.

Normalmente, parceiros de negócios trocam informações via email, fax ou outros meios,
mas desta forma a estrutura técnica dos documentos é perdida e o receptor tem que inserir
os dados em seu sistema manualmente.

Com EDI a estrutura técnica dos documentos não se perdem, o que permite que o receptor
processe o documento automaticamente em seu sistema. Como os parceiros de negócios
são independentes, eles têm suas próprias infraestruturas e usam sistemas independentes.

Por esta razão, padrões de EDI são necessários para converter os dados do remetente no
padrão EDI e depois converter do padrão EDI para o sistema do receptor.

Data: 29/01/21 Página: 2

 Criação de IDOC

IDoc é a estrutura de dados da aplicação SAP na interface. Ele fornece uma interface
unificada a qualquer subsistema EDI, independente do módulo do SAP que cria ou recebe
mensagens.

No caso da ligação ser entre dois sistemas SAP diretamente, o IDoc pode ser transmitido
sem conversão para o padrão EDI. Utiliza-se o ALE (Application Link Enabling).

Data: 29/01/21 Página: 3

 Criação de IDOC

1.1. Criar Segmentos

Tcode: WE31 ou WEDI -> Desenvolvimento -> Segmento de Idoc

SAP segment types start with “E1”;

SAP segment names start with “E2”;
Customer segments start with “Z1” or “Z2”.

Segmentos são estruturas do R/3, ou seja, conjunto de campos de tamanhos definidos.

Os campos de um segmento são sempre do tipo caracter.

Data: 29/01/21 Página: 4

 Criação de IDOC

Cada segmento deverá

conter os nomes dos
campos / elementos de
dados, necessários a
construção do IDOC.

Data: 29/01/21 Página: 5

 Criação de IDOC

1.2. Criar Tipo de Idoc

Tcode: WE30 ou WEDI -> Desenvolvimento -> Tipo de Idoc

Cada Tipo de Idoc é composto de todas as estruturas dos segmentos ( Headers,

Items, etc ) associadas a ele.

Podem ser definidas duas áreas de aplicação de IDoc:

 EDI: troca eletrônica de dados entre empresas diferentes
 ALE: troca eletrônica de dados entre sistemas diferentes de uma mesma
empresa.

Dois sistemas podem trocar IDocs diretamente (ex. R/3 com R/3) ou convertê-los
para outros padrões (ex:. UN/EDIFACT ou ANSI X.12) utilizando subsistemas
EDI.

A aplicação que usa IDocs (para EDI ou ALE) deve ser capaz de escrever dados em
IDocs, ler dados de IDocs, ou ambos.

Entre Sistemas R/3, só formatos IDoc são utilizados. Todas as conversões para
padrões EDI são feitas por um subsistema EDI. A vantagem é que as aplicações
SAP não precisam reconhecer todos os padrões EDI existente, e sim o formato
IDoc. A desvantagem é que a SAP não fornece um subsistema EDI, logo os clientes
têm que comprar um sistema como este quando precisarem utilizar padrões EDI.

Data: 29/01/21 Página: 6

 Criação de IDOC

Criar Inserir o nome do

Tipo do Idoc a ser
criado.

Selecionar
Tipo Básico

Data: 29/01/21 Página: 7

 Criação de IDOC

Selecionar
a opção
Recriar

Data: 29/01/21 Página: 8

 Criação de IDOC

1.3. Associar os Segmentos ao Tipo de Idoc

Tcode: WE30 ou WEDI -> Desenvolvimento -> Tipo de Idoc

ZTPVA02T é o nome
dado ao Tipo de Idoc.

Z1SEGVA02T é
o nome do
segmento criado.

Através desta tela que estaremos

inserindo / associando todos os
segmentos deste IDOC ao Tipo de Idoc,
inclusive colocando-os de forma
hierárquica, ou seja, o segmento Header
deve ser amarrado ao Tipo de Idoc, e o
segmento Item deve ser amarrado ao
Header, e assim deverá ser feito conforme
o fluxo desenhado.

Arquitetura do IDOC

Um Tipo de Idoc descreve a estrutura técnica do IDOC.

 Reg. de Controle
 Reg. de Dados ( composto de segmentos )
 Reg. de Status

Segmentos são estruturas de dados.

Um IDOC é um Tipo de Idoc preenchido com dados.

Data: 29/01/21 Página: 9

 Criação de IDOC

Um IDOC, depois de gerado, consiste numa base de dados de :

 Um Registro de Controle;
 Muitos Registros de Dados;
 Alguns Registros de Status.

Num arquivo trocado com um sistema externo, consiste de :

 Um Registro de Controle;
 Muitos Registros de Dados.

IDOCs transmitidos entre dois sistemas diferentes são sempre “menores” que os
Idocs armazenados no R/3, porque não contém os registros de status.

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.

O Número do IDoc é gerado automaticamente pelo sistema e tem 16 dígitos. É o

identificador único do IDoc no R/3.

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.

Data: 29/01/21 Página: 10

 Criação de IDOC

Registro de Status

Cada registro de status corresponde a um estágio no ciclo de vida do Idoc, e consiste

em :

 Nº do IDoc ;
 Código de status ;
 Tipo do Idoc ;
 Data e Hora.

Se um sistema externo quiser informar o R/3 sobre o progresso dos IDocs que foram
enviados, uma mensagem com um status de confirmação é enviada. O R/3 então
insere o registro de status recebido no IDoc de saída correspondente na base de
dados. O R/3 também pode enviar mensagem com status de confirmação para
IDocs. Mas isto só é possível via um tipo de IDoc especial chamado SYSTAT01, ou
seja, não são enviados nem registros de controle nem de dados neste caso. A
informação de status fica localizada no registro de dados do IDoc.

O número do IDoc é uma parte muito importante do registro de status, pois um IDoc
de status de confirmação associado a uma mensagem enviada identifica o IDoc de
origem por este número.

1.4. Criar Tipo de Mensagem

Data: 29/01/21 Página: 11

 Criação de IDOC

Tcode: WE81 ou WEDI -> Desenvolvimento -> Tipo de Mensagem

Novas Entradas

Tipo de Mensagem Descrição da Mensagem

Siglas que normalmente utilizamos :

 EDI – Eletronic Data Interchange

 EDIFACT – Eletronic Data Interchange for Administration Commerce and
Transport
 ALE – Application Link Enabling
 IDOC – Intermediate Document

Documento Intermediário (IDOC) usado para troca de dados entre :

 SAP  SAP
 SAP  Sistema Externo

IDoc é chamado de documento intermediário por 2 razões:

Data: 29/01/21 Página: 12

 Criação de IDOC

 Orientado a mensagem: O IDoc faz a comunicação entre dois documentos de

aplicações como se fosse a linguagem utilizada por elas. Não importa se a
aplicação é do R/3 ou de um sistema externo. O que indica o tipo de negócio a
ser tratado, ou seja, que aplicações estão se comunicando, é o tipo de
mensagem.

 Assíncrono: Os dados são armazenados em um IDoc antes de o documento de

aplicação ser criado (gravado). Isto é importante, pois se alguma informaçào
incorreta for transferida, o documento de aplicação não será criado.

1.5. Associar Tipo de Mensagem ao Tipo de Idoc

Data: 29/01/21 Página: 13

 Criação de IDOC

Tcode: WE82 ou WEDI -> Desenvolvimento -> Tipo de Idoc / Mensagem

Novas Entradas

Tipo de Tipo de
Mensagem Idoc

Versão

1.6. Criar Porta

Data: 29/01/21 Página: 14

 Criação de IDOC

Tcode: WE21 ou WEDI -> Idoc -> Descrição da Porta

Dar Duplo clique na

porta que deseja criar, ou
seja, RFC assíncrono ou
File.

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.
–Programming Interface

File: IDocs são escritos em arquivos a nível de sistema operacional, de onde podem
ser lidos pelo sistema subsequente.

tRFC: IDocs são trocados em forma de tabelas de parâmetros de função.

Normalmente o sistema subsequente é outro R/3 (ALE).

Data: 29/01/21 Página: 15

 Criação de IDOC

CPI-C: IDocs são enviados de acordo com o protocolo CPI-C. O sistema externo é
sempre o R/2.

Internet: IDocs são escritos em formato MIME como um anexo de um e-mail.

Programming Interface (PI): IDocs são enviados como tabelas a um módulo de

função definido pelo cliente. Neste caso, os IDocs não saem do R/3. Entretanto, o
módulo de função obviamente pode enviar dados externamente.

Novas Entradas

Modificar
/ Exibir.

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

Data: 29/01/21 Página: 16

 Criação de IDOC

Nome da Porta

Descrição da
Porta

Clicar no Botão

Data: 29/01/21 Página: 17

 Criação de IDOC

Informar caminho
do diretório para
arquivo de entrada

Informar nome
do arquivo de
entrada

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.

Exemplo de uma linha de comando de startrfc em UNIX, onde o sistema de

arquivos é compartilhado entre servidores de aplicação SAP e subsistemas EDI :
startrfc -3
-t
-d <system-ID>
-c <client>
-u <user>
-p <password>
-l <language>
-h <application server>
-s <instance#>
-g <gateway machine>

Data: 29/01/21 Página: 18

 Criação de IDOC

-x <gateway process>
-F EDI_STATUS_INCOMING
-E PATHNAME=<pathname+filename>
-E PORT=<port>

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.

Data: 29/01/21 Página: 19

 Criação de IDOC

1.7. Definir Parceiros (Emissor / Receptor)

Tcode: WE20 ou WEDI -> Idoc -> Protocolo de Transmissão

Nº Parceiro = Nome
Sistema Lógico.

Tipo Parceiro =
Logical System
(LS).

Nos dois clients, 400 e 220, precisamos criar os 2 sistemas lógicos como parceiros. Os
perfis de parceiro são client dependent.

No client de origem configuramos o parceiro receptor com dados de saída

Ex: logamos no client 400 e criamos os parâmetros de saída para o parceiro LOGSYS220.

No client destino configuramos o parceiro destinatário com dados de entrada.

Ex: logamos no client 220 e criamos os parâmetros de entrada para o parceiro LOGSYS400

Client de origem com parâmetros de entrada configurados

Data: 29/01/21 Página: 20

 Criação de IDOC

Tipo de Mensagem que

foi associado em todo
o processo do IDOC.

Process Code.

Dados do
usuário a ser
notificado.

Data: 29/01/21 Página: 21

 Criação de IDOC

Data: 29/01/21 Página: 22

 Criação de IDOC

Data: 29/01/21 Página: 23

 Criação de IDOC

Data: 29/01/21 Página: 24

 Criação de IDOC

Data: 29/01/21 Página: 25

 Criação de IDOC

Data: 29/01/21 Página: 26

 Criação de IDOC

Data: 29/01/21 Página: 27