Apostila Curso IDoc Modulo SD

IDOC Intermediate Document

Configuração IDOC Plaut.

Elaborado por Ana Paula Malavazi.

Page 1

IDOC Intermediate Document

1- O QUE É UM IDOC. ................... ............ ............... ............... .............. ............. ......3 2- O IDOC É COMPOSTO COMPOS TO POR....... ........... ......... ....... ....... ........ ....... ....... ....... ...5 3- TRANSAÇÃO WEDI. ...... ........... ......... ....... ....... ....... ....... ........ ....... ....... ........ ....... ...6 4- TRANSA TR ANSAÇÃO ÇÃO WE81 W E81 – TIPOS TIP OS DE MENSA M ENSAGEM. GEM. ... ...... ...... ..... ....8 5- TRANSAÇ TRA NSAÇÃO ÃO WE30 WE3 0 – TIPOS TIPO S BÁSICO BÁSIC O (IDOC). (IDO C). .. .... .... .... .... .... .. 9 6- TRANSAÇÃO WE82 – TIPOS IDOC / TIPO DE MENSAGEM. 10 7- TRANSAÇÃO TRANS AÇÃO WE31 WE 31 – TIPOS DE SEGMENTO. .. .... .... .... .... .11 8- TRANSA TR ANSAÇÃO ÇÃO WE31 W E31 – CRIANDO CRIA NDO UM U M SEGMENT SEG MENTO. O... .... ....12 9- TRANSA TR ANSAÇÃO ÇÃO WE30 W E30 – CRIANDO CRIA NDO UMA U MA AMPLIA AM PLIAÇÃO. ÇÃO. . .15 10- TRANSAÇÃO WE82 – ASSOCIAR TIPO MENSAGEM COM TIPO BÁSICO....... ............ ........... ......... ....... ....... ....... ....... ........ ....... ....... ........ ....... ....... .... 20 11- TRANSAÇÃO TRA NSAÇÃO WE20 – CONFIGURANDO OS PARCEIROS. PARCE IROS. 21 12- TRANSAÇÃO WE60 – VERIFICA A DOCUMENTAÇÃO DO IDOC.................................................. ........................................................ .............. ............. ......27 13- TRANSAÇÃO WE05 – VERIFICA OS IDOCS EXISTENTES. 29 14- TRANSAÇÃO WE19 – EXIBINDO UM IDOC PARA MODIFICAR SE FOR NECESSÁRIO. ..... ......... ....... ....... ........ ....... ....... ......35 15- TRANS T RANSAÇÃO AÇÃO BD87 – RE-PROC RE- PROCESSA ESSANDO NDO IDOC. I DOC. .. .... ....37 16- PROGRAMANDO PRO GRAMANDO UM IDOC DE NOTA FISCAL.. . . . . . .39 17- UTILIZ UT ILIZANDO ANDO O PROGRA P ROGRAMA MA RSNAST0 RSN AST00. 0.... ...... ...... ..... .... .... ..41 18- CUSTO C USTOMIZA MIZAÇÃO ÇÃO SPRO S PRO – IDOC NOTA FISC FISCAL. AL... ..... ..... .. 42

Page 2

IDOC Intermediate Document

1-

O que é um IDoc. IDoc Intermediate Document é uma tecnologia do SAP para troca de informações entre parceiros de negócios. Podem ser definidas duas áreas de aplicação de IDoc:

ALE Troca eletrônica de dados entre sistemas diferentes de uma mesma empresa.

Sistema SAP R/3

Sistema SAP R/3 Documento

IDoc

Nesse exemplo acima nos temos 2 sistemas que utilizam o mesmo sistema fazendo troca de dados utilizando IDoc via ALE.

EDI Troca eletrônica de dados entre empresas diferentes

Sistema SAP R/3

Oracle Documento

Page 3

IDOC Intermediate Document

IDoc

Nesse exemplo acima nos temos 2 sistemas diferentes fazendo troca de dados utilizando IDoc via EDI, essa troca de informação informação ela é feit feitaa através através de arquivo arquivo texto que será gerado em um diretório diretório que foi configurado. O arquivo é enviado para o recebedor, este pode ser se r um diretório ou um IP (via FTP). 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 formado XML. Todos os Idoc’s são gerados gerados na estrutura estrutura abaixo, abaixo, e cada linha gerada no arquivo texto, corresponde corresponde a 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. Segmento Segment o de Controle .

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

Numero 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 Segmento de Registros.

Contém informações relevantes que serão trocadas entre os sistemas. Pode haver muitos em um único IDoc. Consiste de : 

Numero do IDoc.



Nome do Segmento.



Etc. 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. Segmento de Status:

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

Numero do IDoc. Page 4

IDOC Intermediate Document

2-



Código de Status.



Tipo do IDoc.



Data e Hora.

O IDoc é composto por. IDoc ele é composto pela seguinte estrutura.

Configuração Portas Tipo de Mensagem Tipo Basico Segmento Grupo de Função User-Exit

Page 5

IDOC Intermediate Document

3-

Transação WEDI. Essa transação você ira verificar varias configurações referente ao IDoc.

Page 6

IDOC Intermediate Document

Page 7

IDOC Intermediate Document

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

Page 8

IDOC Intermediate Document

5-

Transação WE30 – Tipos Básico (IDoc). Essa transação ela contem todos Tipo Básico existentes no SAP (Standard ou Tipos Mensagem Z).

Page 9

IDOC Intermediate Document

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.

Page 10

IDOC Intermediate Document

7-

Transação WE31 – Tipos de Segmento. Essa transação contem os segmentos referente cada IDoc Standard ou IDoc Tipo Z. Segmento E1EDK01.

Exibindo o conteúdo do segmento E1EDK01.

Page 11

IDOC Intermediate Document

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

.

Criando um segmento ZE1EDK01 com copia do segmento Standard E1EDK01.

Page 12

IDOC Intermediate Document

O Segmento ZE1EDK01 foi criado como copia do Standard.

Segmento com os campos necessários.

Selecione o ícone Ampliação.

para criar um Segmento para inserir os campos necessários da incluir na

Page 13

IDOC Intermediate Document

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.

Veja como fica depois que o segmento foi Liberado.

Page 14

IDOC Intermediate Document

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 opção

..

Page 15

IDOC Intermediate Document

Selecionar a Ampliação que você deseja incluir o segmento criado. Acessar o MENU  PROCESSAR  CRIAR SEGMENTO. Devera aparecer a seguinte tela, veja abaixo.

Page 16

IDOC Intermediate Document

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.

Page 17

IDOC Intermediate Document

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. Somente quando você fizer a Anulação de Liberação você ira conseguir fazer qualquer alteração. Veja abaixo a tela anexa.

Page 18



IDOC Intermediate Document

Page 19

IDOC Intermediate Document

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

Selecionar o ícone

para incluir o Tipo de Mensagem – Tipo Básico e Ampliação.

.

Selecionar o Tipo de Mensagem INVOIC e inserir a Ampliação desejada.

Assim que você incluir a Ampliação devera aparecer a seguinte tela.

Page 20

IDOC Intermediate Document

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 Parceiro KU – CLIENTE .

Deverá preencher os seguintes campos. Parceiro Tipo de Parceiro

BR-COM001.  KU = Cliente. 

Deverá preencher os seguintes campos. Tipo Responsável Idioma

US  ABAP00  PT 

=> Usuário. => Responsável que esta configurando. => Português.

Você ira encontrar dois tipos de Parâmetros nos quais são eles:

Esses Parâmetros será preenchido de acordo com a sua necessidade. Exemplo se você for utilizar um IDoc de Saída você deverá preencher o Parâmetro de Saída ou se você for utilizar um IDoc de Entrada você deverá preencher o Parâmetro de Entrada.

Page 21

IDOC Intermediate Document

Nesse exemplo estamos utilizando 2 tipos de mensagens nos quais são eles: PR DP

 

Emissor da ordem Recebedor da fatura

Tipo de Mensagem

 

ORDRSP INVOIC

Confirmação do pedido/ordem.  Fatura / doc.faturamento. 

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 O campo Função da Mensagem

Não preencher.  Não preencher. 

Você ira preencher somente duas pastas nas quais são elas: Opções de Saída Controle de Mensagem.

Page 22

IDOC Intermediate Document Pasta Opções de Saída. O Campo Porta Receptora deverá 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.

Page 23

IDOC Intermediate Document 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: O Campo Verificar sintaxe:

Não preencher.  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. Exempo : V1  Venda.

Page 24

IDOC Intermediate Document 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.

Tipo de Mensagem INVOIC.

Page 25

IDOC Intermediate Document Pasta Controle de Mensagem.

Page 26

IDOC Intermediate Document

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. Assim que você escolher essa opção devera aparecer a seguinte tela.

Page 27

IDOC Intermediate Document

Page 28

IDOC Intermediate Document

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. Devera aparecer a seguinte tela.

Page 29

IDOC Intermediate Document

Ira aparecer todos os IDoc’s que foram executados no período acima informado. IDoc de Saída.

INVOIC ORDRSP IDoc de Entrada.

Para verificar o conteúdo do IDoc você devera selecionar e dar um duplo clique.

Page 30

IDOC Intermediate Document •

IDoc 000000000000526747 

Registro de Controle. 



Registro de Dados.   



São as informações técnica do IDoc como Direção – Tipo de Mensagem – Status e etc. 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.

Pasta Parceiro.

Page 31

IDOC Intermediate Document

Pasta Inf.Técnica.

Pasta InfoEndere.

Page 32

IDOC Intermediate Document

Pasta Detalhes.

Exibindo Registro de Dados

Num 0060.

Page 33

IDOC Intermediate Document

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.

Aqui você ira visualizar o Status do IDoc, se foi gerado com sucesso ou com erro.

Page 34

IDOC Intermediate Document

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. Deverá aparecer a seguinte tela. Com os dados do IDoc que você informou.

Aqui você pode processar esse IDoc novamente ou se você tiver necessidade é possível editar, incluir e excluir segmentos Page 35

IDOC Intermediate Document

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.

Page 36

IDOC Intermediate Document

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.

Aqui você verifica se existe algum idoc para ser re-processado com Status 30.

Page 37

IDOC Intermediate Document

Posicionar o cursor no Tipo de Mensagem.

Escolher o Botão Deverá aparecer a seguinte tela.Veja abaixo.

Se você clicar no Botão

Deverá abrir a transação WE05.

Page 38

IDOC Intermediate Document

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.

Modulo de Função: EXIT_SAPLVEDF_002.

Page 39

IDOC Intermediate Document

Page 40

IDOC Intermediate Document

17- Utilizando o Programa RSNAST00. Para gerar o IDoc o usuário ira ter que executar o seguinte programa RSNAST00 com os seguintes dados abaixo.

Assim que esse processo for finalizar o IDoc será gravado. Esse programa ele poderá ser executado para a Ordem de Venda ou para a Nota Fiscal.

Page 41

IDOC Intermediate Document

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)

Page 42

IDOC Intermediate Document

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.

Page 43

IDOC Intermediate Document

Pasta  Valores Propostos.

Page 44

IDOC Intermediate Document

Pasta  Momento. Pasta  Sistema Arquivo. Pasta  Impressão. Pasta  E-Mail. Pasta  Ordenação.

Customização não modifica nada.  Customização não modifica nada.  Customização não modifica nada.  Customização não modifica nada.  Customização não modifica nada. 

Verificando Funções Parceiro.

Page 45

IDOC Intermediate Document

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. Aqui iremos verificar se o Tipo de Mensagem RD00 esta amarrado com o Tipo de Faturamento ZOCO.

Page 46

IDOC Intermediate Document

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.

Que devera aparecer a seguinte tela.

Tipo de Documento de Faturamento  Função Parceiro  Cliente  Meio  Momento  Idioma.

Page 47

IDOC Intermediate Document

Page 48