Configuração IDOC
Configuração IDOC
Plaut.
Plaut.
1- O QUE É
1- O QUE É
UM IDOC. ...
UM IDOC. ...
...
...
...
...
...
...
...
...
...
...
3
3
2- O IDOC
2- O IDOC
É COMPOS
É COMPOS
TO POR.
TO POR.
...
...
...
...
....
....
...
...
....
....
....
....
...
...
....
....
...
...
5
5
3- TRANSAÇÃO WEDI.
3- TRANSAÇÃO WEDI.
...
...
...
...
....
....
...
...
....
....
...
...
....
....
....
....
...
...
....
....
....
....
...
...
6
6
4- TR
4- TR
ANSA
ANSA
ÇÃO W
ÇÃO W
E81
E81
– TIP
– TIP
OS DE M
OS DE M
ENSA
ENSA
GEM.
GEM.
...
...
...
...
...
...
..
..
.
.
8
8
5- TRA
5- TRA
NSAÇ
NSAÇ
ÃO WE3
ÃO WE3
0 – TIPO
0 – TIPO
S BÁSIC
S BÁSIC
O (IDO
O (IDO
C).
C).
..
..
..
..
..
..
..
..
..
..
..
..
9
9
6- TRANSAÇÃO WE82 – TIPOS IDOC / TIPO DE MENSAGEM.
6- TRANSAÇÃO WE82 – TIPOS IDOC / TIPO DE MENSAGEM.
10
10
7- TRANS
7- TRANS
AÇÃO WE
AÇÃO WE
31 –
31 –
TIPOS DE
TIPOS DE
SEGMENTO.
SEGMENTO.
..
..
..
..
..
..
..
..
.
.
.
.
11
11
8- TR
8- TR
ANSA
ANSA
ÇÃO W
ÇÃO W
E31
E31
– CRIA
– CRIA
NDO U
NDO U
M SEG
M SEG
MENT
MENT
O.
O.
..
..
..
..
.
.
12
12
9- TR
9- TR
ANSA
ANSA
ÇÃO W
ÇÃO W
E30
E30
– CRIA
– CRIA
NDO U
NDO U
MA AM
MA AM
PLIA
PLIA
ÇÃO.
ÇÃO.
.
.
.
.
15
15
10- TRANSAÇÃO WE82 –
10- TRANSAÇÃO WE82 –
ASSOCIAR TIPO MENSAGEM COM
ASSOCIAR TIPO MENSAGEM COM
TIPO BÁSICO.
TIPO BÁSICO.
...
...
...
...
...
...
....
....
...
...
....
....
...
...
....
....
....
....
...
...
....
....
....
....
...
...
....
....
20
20
11- TRA
11- TRA
NSAÇÃO
NSAÇÃO
WE20 –
WE20 –
CONFIGURANDO
CONFIGURANDO
OS PARCE
OS PARCE
IROS.
IROS.
21
21
12- TRANSAÇÃO WE60 –
12- TRANSAÇÃO WE60 –
VERIFICA A DOCUMENTAÇÃO DO
VERIFICA A DOCUMENTAÇÃO DO
IDOC.
IDOC.
...
...
...
...
...
...
...
...
27
27
13- TRANSAÇÃO WE05 –
13- TRANSAÇÃO WE05 –
VERIFICA OS IDOCS EXISTENTES.
VERIFICA OS IDOCS EXISTENTES.
29
29
14- TRANSAÇÃO WE19 – EXIBINDO UM IDOC PARA
14- TRANSAÇÃO WE19 – EXIBINDO UM IDOC PARA
MODIFICAR
MODIFICAR
SE FOR
SE FOR
NECESSÁRIO.
NECESSÁRIO.
...
...
....
....
...
...
....
....
....
....
...
...
....
....
.
.
35
35
15- T
15- T
RANS
RANS
AÇÃO
AÇÃO
BD87
BD87
– RE-
– RE-
PROC
PROC
ESSA
ESSA
NDO I
NDO I
DOC.
DOC.
..
..
..
..
.
.
37
37
16- PRO
1
1
-
-
O
O
q
q
u
u
e
e
é
é
u
u
m
m
I
I
D
D
o
o
c
c
.
.
IDoc Intermediate Document é uma tecnologia do SAP para troca de informações entre parceiros de IDoc Intermediate Document é uma tecnologia do SAP para troca de informações entre parceiros de negócios.
negócios.
Podem ser definidas duas áreas de aplicação de IDoc: Podem ser definidas duas áreas de aplicação de IDoc: ALE
ALE
Troca eletrônica de dados entre sistemas diferentes de uma mesma empresa. Troca eletrônica de dados entre sistemas diferentes de uma mesma empresa.
Nesse exemplo acima nos temos 2 sistemas que utilizam o mesmo sistema fazendo troca de dados Nesse exemplo acima nos temos 2 sistemas que utilizam o mesmo sistema fazendo troca de dados utilizando IDoc via ALE.
utilizando IDoc via ALE. EDI
EDI
Troca eletrônica de dados entre empresas diferentes Troca eletrônica de dados entre empresas diferentes
Documento Documento IDoc IDoc
Sistema SAP R/3
Sistema SAP R/3
Sistema SAP R/3
Sistema SAP R/3
Sistema SAP R/3
Sistema SAP R/3
Sistema SAP R/3
Sistema SAP R/3
Oracle
Oracle
Oracle
Nesse exemplo acima nos temos 2 sistemas diferentes fazendo troca de dados utilizando IDoc via EDI, Nesse exemplo acima nos temos 2 sistemas diferentes fazendo troca de dados utilizando IDoc via EDI, essa troca de
essa troca de inforinformação ela é mação ela é feitfeita a atraatravés de vés de arquiarquivo texto que vo texto que será gerado em um será gerado em um diretdiretório que foiório que foi configurado. O arquivo é enviado para o recebedor, este pode se
configurado. O arquivo é enviado para o recebedor, este pode ser um diretório ou um IP (via FTP).r um diretório ou um IP (via FTP).
Posteriormente é possível converter o IDoc em outros formatos (ANSI, EDIFACT). Porém este processo Posteriormente é possível converter o IDoc em outros formatos (ANSI, EDIFACT). Porém este processo não é Standard. Existe a possibilidade de gerar o Idoc no
não é Standard. Existe a possibilidade de gerar o Idoc no formado XML.formado XML. Todos os Idoc’s são
Todos os Idoc’s são geradgerados na os na estruestrutura abaixotura abaixo, e , e cada linha gerada no arquivo texto, correscada linha gerada no arquivo texto, corresponde aponde a um segmento. São definidos 03 tipos de segmento, são eles: Segmento de Controle, Segmento de um segmento. São definidos 03 tipos de segmento, são eles: Segmento de Controle, Segmento de Registros ou Segmento de dados e Segmento de status.
Registros ou Segmento de dados e Segmento de status.
Segment
Segmento de o de Controle Controle ..
Contém informações sobre os parceiros de negócios e o tipo de
Contém informações sobre os parceiros de negócios e o tipo de mensagem.mensagem.
Numero do IDoc.Numero do IDoc.
Tipo do IDoc.Tipo do IDoc.
Mensagem Lógica (Tipo de Dados).Mensagem Lógica (Tipo de Dados).
ID do Emissor / Receptor.ID do Emissor / Receptor.
Direção do IDoc.Direção do IDoc.
O registro de controle identifica um
O registro de controle identifica um IDoc unicamente.IDoc unicamente.
O número do IDoc é gerado automaticamente pelo sistema e tem 16 dígitos. O número do IDoc é gerado automaticamente pelo sistema e tem 16 dígitos. É o identificador único do IDoc no R/3
É o identificador único do IDoc no R/3
Segmento de Registros Segmento de Registros..
Contém informações relevantes que serão trocadas
Contém informações relevantes que serão trocadas entre os sistemas.entre os sistemas. Pode haver muitos em um único IDoc.
Pode haver muitos em um único IDoc. Consiste de :
Consiste de :
Numero do IDoc.Numero do IDoc.
Nome do Segmento.Nome do Segmento.
IDoc IDoc
Código de Status.
Tipo do IDoc.
Data e Hora.
2-
O IDoc é composto por.
IDoc ele é composto pela seguinte estrutura.Tipo de Mensagem Tipo Basico Grupo de Função User-Exit Configuração Portas Segmento
3-
Transação WEDI.
4-
Transação WE81 – Tipos de Mensagem.
Essa transação ela contem todos os Tipos de Mensagem existentes no SAP (Standard ou Tipos Mensagem Z). Todas as mensagens Standards já estão cadastradas automaticamente, é necessário incluir as mensagens do Tipo ‘Z’.
5-
Transação WE30 – Tipos Básico (IDoc).
6-
Transação WE82 – Tipos IDoc / Tipo de Mensagem.
Essa transação ela contem a atribuição do Tipo IDoc Standard ou Tipo IDoc Z com o Tipo de Mensagem Standard ou Tipo de Mensagem Tipo Z e Ampliação do Tipo Z. Só é possível se o Tipo Básico (IDoc) já estiver sido criado.
7-
Transação WE31 – Tipos de Segmento.
Essa transação contem os segmentos referente cada IDoc Standard ou IDoc Tipo Z. Segmento E1EDK01.
8-
Transação WE31 – Criando um Segmento.
Essa transação ela é utilizada para criar um segmento do Tipo Z com copia de Standard ou um segmento do Tipo Z com os campos necessários para você utilizar na sua Ampliação.
Informar o nome do Segmento que deseja criar.
Existe 2 tipos de criar segmento nos quais são eles:
Segmento como copia.
Segmento com campos necessários. Segmento como copia.
Selecione o Ícone .
O Segmento ZE1EDK01 foi criado como copia do Standard.
Segmento com os campos necessários.
Selecione o ícone para criar um Segmento para inserir os campos necessários da incluir na Ampliação.
Inclua os campos necessários que você ira utilizar na sua Ampliação.
Após a criação do segmento será necessário Definir Liberação do segmento, veja abaixo.
9-
Transação WE30 – Criando uma Ampliação.
O que é uma Ampliação?Uma Ampliação ela devera ser criada quando um IDoc Standard não contem um determinado segmento. Exemplo Um IDoc de Nota Fiscal não existe mas é possível trabalhar com o IDoc de Faturamento e criar vários segmentos do Tipo Z para alimentar os dados de Nota Fiscal. Exemplo: Numero da N.F – Serie etc.
Informar o Nome da Ampliação que você deseja criar ou copiar. É aconselhável sempre que você for criar uma Ampliação fazer como cópia de um Tipo Básico.
Selecionar a Ampliação que você deseja incluir o segmento criado. Acessar o MENU PROCESSAR CRIAR SEGMENTO.
Devera aparecer a seguinte tela de Mensagem.
Aparece a Tela para você devera incluir o nome do Segmento do Tipo Z com os campos abaixo que devera ser igual ao Segmento Standard.
Selecionar o Botão . Ampliação criada com sucesso com cópia do Tipo Básico INVOIC02 e com a inclusão do Segmento do Tipo Z.
Observação: Se for necessário alterar alguma coisa nessa Ampliação você deverá ir ao MENU
PROCESSAR ANULAR LIBERAÇÃO.
10- Transação WE82 – Associar Tipo Mensagem com Tipo
Básico.
Se você for precisar trabalhar com Ampliação será necessário incluir a Ampliação do Tipo Z com o Tipo de Mensagem e Tipo Básico.
Selecionar o ícone para incluir o Tipo de Mensagem – Tipo Básico e Ampliação.
Selecionar o ícone .
Selecionar o Tipo de Mensagem INVOIC e inserir a Ampliação desejada.
11- Transação WE20 – Configurando os Parceiros.
Essa transação você configura os parceiros (Clientes / Fornecedores) que deverão receber ou enviar IDoc, essa configuração é necessária.
Tipo de ParceiroKU – CLIENTE.
Deverá preencher os seguintes campos. Parceiro BR-COM001. Tipo de Parceiro KU = Cliente.
Deverá preencher os seguintes campos. Tipo US => Usuário.
Responsável ABAP00 => Responsável que esta configurando. Idioma PT => Português.
Você ira encontrar dois tipos de Parâmetros nos quais são eles:
Nesse exemplo estamos utilizando 2 tipos de mensagens nos quais são eles:
PR Emissor da ordem ORDRSP Confirmação do pedido/ordem.
DP Recebedor da fatura INVOIC Fatura / doc.faturamento.
Tipo de Mensagem ORDRSP
Numero do Parceiro: BR-COM001.
Devera preencher os seguintes campos abaixo:
Tipo de Parceiro. KU (Fixo para o Parceiro Cliente)
Função Parceiro. PR (O responsável pelo cadastro devera escolher o Tipo de Função Parceiro)
Nesse exemplo estou utilizando PR = Emissor da Ordem = Ordem de Venda.
O Campo Tipo de Mensagem. ORDRSP – Confirmação do Pedido/Ordem.
Aqui o você devera saber qual é o Tipo de Mensagem que ele ira utilizar.
O campo Variante Mensagem Não preencher. O campo Função da Mensagem Não preencher.
Pasta Opções de Saída.
O Campo Porta Receptoradeverá estar preenchido com a Porta que Basis criou.
Nesse exemplo estamos utilizando a Porta IDOCPLAUT.
Modo de Saída existe varias opções para disparar IDoc.
O Campo Transferir Imediatamente IDoc.
Para cada IDoc individual, a saída é imediatamente executada.
O Campo Agrupar IDocs.
A saída de IDocs é efetuada de forma conjunta, em um momento planejado.
O Campo Iniciar Subsistemas.
Na saída de IDocs, o sistema externo é executado a partir do sistema R/3.
Para isso, tem de ser indicado um file de comando (terminologia UNIX: um script de shell), na descrição de porta correspondente.
O Campo Não Iniciar Subsistemas.
O subsistema externo não é executado a partir do sistema R/3. Ele próprio tem de estar ativo para poder chamar os dados.
No exemplo acima nos iremos utilizar a seguinte opção :
Transferir Imediatamente IDoc Iniciar Subsistema.
O Campo Tipo Básico:
Você deverá preencher o nome do Tipo Básico (IDoc) Exemplo ORDERS05 - IDoc de Compras e Vendas.
Os tipos básicos podem ser ampliados conforme a necessidade dos clientes
O Campo Ampliação..: ( Esse campo somente será preenchido se houver necessidade).
As ampliações não são fornecidas pela SAP e podem ser definidas, unicamente, pelos clientes.
Exemplo: Existe Tipos Básico que não contem informações necessárias como o IDoc de Faturamento que não tem informações referente a Nota Fiscal, nesse momento será criado uma Ampliação que será alimentada via User-Exit esses campos. Assim que essa Ampliação for criada devera estar preenchida aqui.
O Campo Visão: Não preencher.
O Campo Verificar sintaxe: Devera estar Flagado.
Pasta Controle Mensagem.
Campo Ampliação:
Identifica a aplicação.
Este campo-chave é atribuído ao campo correspondente do controle de mensagens (NAST, controle de saída). Juntamente com a categoria de mensagem, este identifica, de forma unívoca, um tipo de
mensagem do NAST, que então pode ser atribuído, de forma unívoca, a um tipo de IDoc. Definido no Customização para mensagem.
Campo Tipo de Mensagem.
Este campo-chave é atribuído ao campo correspondente no controle de mensagens (NAST, controle de saída). Juntamente com a aplicação, este identifica, de forma unívoca, um tipo de mensagem do NAST
que, então, pode ser atribuído, de forma unívoca, a um tipo de IDoc. Esta configuração é efetuada no customizing.
Exemplo BA00 – Confirmação de Ordem.
Campo Código Operação.
A interface de IDocs encontra, através do código de processo, o módulo de seleção da aplicação, o qual converte o documento SAP em um IDoc.
Veja como fica o exemplo abaixo.
Tipo de Mensagem INVOIC. Pasta Opções de Saída.
12- Transação WE60 – Verifica a Documentação do IDoc.
Nessa transação você ira verificar a documentação do IDoc ou seja a descrição dos Segmentos e seus campos.
Informar o nome do Tipo básico que você deseja pesquisar a documentação. Exemplo: estamos utilizando o INVOIC02 – Faturamento.
Menu Documentação Formato HTML F8.
13- Transação WE05 – Verifica os IDocs existentes.
Aqui você ira verificar os IDoc de Entrada ou de Saída com Sucesso ou com Erro. Nessa tela você ira escolher a Data de Criação.Digitar F8.
Ira aparecer todos os IDoc’s que foram executados no período acima informado.
IDoc de Saída.
INVOIC ORDRSP
IDoc de Entrada.
• IDoc 000000000000526747
Registro de Controle.
São as informações técnica do IDoc como Direção – Tipo de Mensagem – Status e etc.
Registro de Dados. Num Total 0060.
Registro de Dados são os segmentos que o IDoc ou seja as estruturas.
Exemplo: Segmento E1EDK01 – Exemplo: Segmento E1EDKA01 – Registro de Dados.
Registro de Dados são os status do IDoc.
Exemplo 03 – Transferência de Dados com sucesso.
Exemplo 30 – IDoc Pronto para Transmissão.
Exibindo Registro de Controle. Pasta Inf. Tipo.
Veja abaixo vários segmentos do lado Esquerdo se você der um duplo clique ira aparecer no lado Direito o conteúdo do Segmento escolhido.
Exibindo Registro de Dados.
14- Transação WE19 – Exibindo um IDoc para modificar se for
necessário.
Com está ferramenta é possível criar um Idoc, ou copiar de um já existente (mais comum).
Além de efetuar a entrada e a saída na transação BD87 uma opção interessante e muito útil para os testes de entrada (que são os mais propensos a erro) é a “Entrada módulo de função”.
IDoc de Saída.
Se o IDoc já foi processado seja ele com sucesso ou com erro você devera pegar o Numero do IDoc na Transação WE05 e preencher na seguinte opção.
IDoc existente.
Assim que você informou o Nr. Do IDoc.Digitar F8.
Se você quiser re-processar esse IDoc novamente você devera escolher o Botão.
Assim que você escolher essa opção ele ira gerar um novo IDoc , para você verificar isso você terá que acessar a Transação WE05. Veja Abaixo.
Repare que o Status desse IDoc é 30 IDoc pronto para a Transmissão.
Esse IDoc ainda não foi gerado com Status para fazer esse processo você devera acessar a Transação BD87.
15- Transação BD87 – Re-Processando IDoc.
Aqui você poderá Re-Processar um IDoc já existente.Assim que você informar a Data de Modificação ou o Tipo de Mensagem você ira verificar a seguinte tela. Veja abaixo.
Posicionar o cursor no Tipo de Mensagem.
Escolher o Botão
Deverá aparecer a seguinte tela.Veja abaixo.
16- Programando um IDoc de Nota Fiscal.
Para você inciar a programação em IDoc você devera localizar uma User-Exit para iniciar a codificação.
Projeto BPID
Exibindo a Ampliação.
17- Utilizando o Programa RSNAST00.
Para gerar o IDoc o usuário ira ter que executar o seguinte programaRSNAST00com os seguintes
dados abaixo.
Assim que esse processo for finalizar o IDoc será gravado.
18- Customização SPRO – IDoc Nota Fiscal.
Acessar a Transação SPRO para verificar algumas customizações referente ao modulo SD.
Iremos verificar a seguinte opção.
Atualizar Determinação de Mensagem p/ Doc. Faturamento. Atualizar Tipos de Mensagem.
Aqui você devera saber qual é o Tipo de Mensagem que a Fatura esta utilizando, no exemplo iremo utilizar RD00 Fatura (Standard)
Assim que você localizou a sua mensagem iremos selecionar o Botão . Para exibir os detalhes.
Assim que você selecionar o Item para exibir Detalhe, devera aparecer a seguinte tela com varias Pasta. Pasta Dados Gerais.
Pasta Momento. Customização não modifica nada.
Pasta Sistema Arquivo. Customização não modifica nada. Pasta Impressão. Customização não modifica nada. Pasta E-Mail. Customização não modifica nada. Pasta Ordenação. Customização não modifica nada.
Verificando Rotinas de Processamento.
Iremos verificar a seguinte opção.
Atualizar Determinação de Mensagem p/ Doc. Faturamento.
Atribuir Mensagens às Funções do Parceiro.
Aqui iremos verificar se o Tipo de Mensagem RD00 esta amarrado ao Meio de Comunicação 6.
Iremos verificar a seguinte opção.
Atualizar Determinação de Mensagem p/ Doc. Faturamento.
Atribuir Esquemas de Mensagens.
Segue abaixo a Customização que é necessário para o IDoc INVOIC02.
Transação VV31.
Essa Transação ela será utilizada para associar o Tipo de Mensagem RD00 com o Numero do Cliente. Toda vez que tiver um cliente que ele for utilizar um IDoc INVOIC, irá precisar dessa configuração.
Selecionar o Botão
Ira aparecer a seguinte tela abaixo.
Nesse momento você deverá informar o Tipo de Documento de Faturamento.