VISÃO GLOBAL - sobre IDoc

O IDoc é um objeto SAP que transporta dados de uma transação comercial de um sistema para outro na forma de mensagem eletrônica. IDoc é um acrônimo para I ntermediate Doc ument. O objetivo de um IDoc é transferir dados ou informações do SAP para outros sistemas e vice-versa. A transferência do SAP para o sistema não SAP é feita via subsistemas EDI (Electronic Data Interchange), enquanto para a transferência entre dois sistemas SAP, o ALE é usado.

O IDoc pode ser acionado no sistema SAP ou no subsistema EDI.Isso depende da direção na qual o IDoc é enviado e é chamado como IDoc de entrada e IDoc de saída de acordo. No caso de fluxo de saída, o IDoc é acionado no SAP por meio do controle de mensagens do documento, que é então enviado ao subsistema EDI.EDI converte os dados do IDoc em XML ou formato equivalente e, em seguida, envia os dados para o sistema parceiro através da Internet.

Para o fluxo de entrada, o EDI converte os dados do parceiro e o IDoc é criado no SAP. Após o processamento bem-sucedido deste IDoc, o documento de aplicação é lançado no SAP.

PADRÕES EDI E IDOC

“EDI is electronic exchange of business document between the computer systems of business partners, using a standard format over a communication network”. EDI stands for Electronic DataInterchange.

Para transmissão de informações eletronicamente, dois padrões amplamente utilizados são ANSI ASC X12 e EDIFACT. O ANSI ASC X12 é um comitê formado por representantes de grandes organizações, órgãos governamentais e empresas de software de EDI que define padrões e diretrizes para o intercâmbio de informações sobre o EDI. UN / EDIFACT significa EDI das Nações Unidas para Administração, Comércio e Transporte e foi formado em 1985 usando ANSI X12 e UNTDI (intercâmbio de dados de comércio das Nações Unidas) como padrões básicos. ANSI X12 descreve o documento de negócios como transações e cada transação é representada por um número de três dígitos, por exemplo, 850 - Pedido de Compra, 855 - Reconhecimento de Pedido de Compra.EDIFACT descreve documentos comerciais como mensagens, representados por nomes padrão, por exemplo, ORDERS para pedidos.

TERMINOLOGIAS DO IDOC

TIPO DE IDOC (BASIC)

Os tipos de IDoc são baseados nos padrões EDI e principalmente nos padrões EDIFACT. 

Tipos Básicos (ou Tipo de IDoc) define a estrutura de um IDoc. Cada tipo básico descreve segmentos IDoc padrão, formato de campos de dados e seu tamanho. Tipo básico também define o número de segmentos e campos em um IDoc. Todos os campos necessários para transmissão de mensagem para uma transação comercial específica são mapeados em segmentos diferentes. Ele também define a estrutura e o relacionamento de segmentos de IDoc junto com segmentos obrigatórios e opcionais.

EXTENSÃO DO IDOC

O tipo básico contém todos os campos padrão necessários para realizar uma transação comercial. No entanto, se algum valor adicional precisar ser enviado ao parceiro, poderemos usar o recurso IDoc Extension. A extensão IDoc é a extensão do tipo básico e contém segmentos e campos IDoc personalizados adicionais que não estão disponíveis no tipo básico padrão.

SEGMENTOS DO IDOC

Os segmentos de IDoc contêm os dados reais enviados ourecebidos de um parceiro. Esses segmentos contêm os valores reais enviados como parte da transmissão do IDoc.

SEGMENTOS DE PAIS E CRIANÇAS

O segmento de IDoc é denominado como segmento pai se contiver seus próprios segmentos. Os segmentos dependentes são chamados de segmentos filhos.

IDOCS INBOUND / OUTBOUND

Os IDocs enviados fora do sistema são denominados como IDocs de saída e os que são recebidos no sistema são chamados de IDocs de entrada.

DIREÇÃO DO IDOC

Isso significa que a direção é para qual informação é enviada e é semelhante à terminologia usada nos correios. Se a informação for enviada para fora do sistema, a direção é a caixa de saída quando é recebida no sistema e a direção é a caixa de entrada. Na direção da Caixa de Saída do SAP, representa “1”, ou seja, a caixa de saída e a direção da Caixa de Entrada são representadas por “2”.

PARCEIRO

Parceiro é o parceiro de negócios com o qual a troca de informações deve ocorrer usando o IDoc. Pode ser um fornecedor ou cliente ou qualquer outro sistema. Dependendo da direção da informação na qual a informação é enviada, ela desempenha um papel de “parceiro de envio” ou “parceiro de recebimento”.

TIPO DE PARCEIRO

O tipo / função de parceiro é usado para identificar parceiros nos sistemas sap. O tipo de parceiro é KU para o cliente, LI para o fornecedor e LS para o sistema lógico.

TIPO DE MENSAGEM

O processamento de IDoc envolve a transmissão ou o recebimento do documento na forma de uma mensagem, cada qual representando um documento no SAP. Esses documentos podem ser Pedido, Confirmação de Envio, Notificação de Envio Antecipado, Entrada de Mercadorias ou Fatura. O tipo de mensagem é associado ao tipo básico de IDoc (tipo básico) e define o tipo de dado ou documento que é trocado com o parceiro.

CÓDIGO DE PROCESSO

O código do processo contém os detalhes do módulo de função que são usados ​​para o processamento do IDoc. O tipo de mensagem pode ser vinculado ao código do processo.

PORTA

Porta IDoc contém as informações sobre a maneira como os dados são enviados entre o sistema de origem ou de destino. O tipo de porta define as informações contidas na porta. Para o tipo de porta "Internet", a porta conterá o endereço IP do sistema de destino. Para o tipo de porta “arquivo”, as informações do diretório ou nome do arquivo são mantidas. A porta “tRFC” contém informações sobre o destino RFC do sistema de destino. Para transmissão IDoc usando ALE “tRFC” as portas são usadas.

MANUTENÇÃO DO PERFIL DO PARCEIRO

PERFIL DO PARCEIRO (WE20)

O perfil do parceiro deve ser mantido para todos os parceiros de negócios para os quais queremos enviar ou receber os IDocs. O TCODE para manter o perfil do parceiro é WE20.

Clicar duas vezes no parceiro mostrará a seguinte tela:

O perfil do parceiro contém parâmetros para o processamento de entrada e saída de IDocs. Para cada tipo de mensagem, podemos atualizar opções de entrada / saída, controle de mensagens, opções de pós-processamento e informações de contato nos parâmetros de entrada e saída.

OPÇÕES DE ENTRADA (PARÂMETROS DE ENTRADA)

Isso envolve porta emissor / receptor, modo de saída e relação ao tipo de IDoc, ou seja, tipo básico e extensão.

CONTROLO DA MENSAGEM (PARÂMETROS DE PARTIDA)

Contém o aplicativo para o qual o IDoc será criado, por exemplo, EF para pedido, o tipo de mensagem do aplicativo que acionará o IDoc e o código de processo que converterão o documento SAP em um IDoc. Por exemplo, se o pedido deve ser enviado ao fornecedor AXXXXZ, então, na opção de saída do parceiro AXXXXZ, precisamos atualizar o tipo de mensagem ZXX1 e vinculá-lo ao Código de processo ME10. Assim, quando o tipo de mensagem ZXX1 é acionado no pedido, um IDoc será criado para o fornecedor parceiro AXXXXZ.

O código de processo é vinculado ao módulo de função no SAP, que converte os dados do aplicativo em um IDoc. Módulos de função padrão são fornecidos pela SAP para essa conversão, mas também podem ser personalizados de acordo com as necessidades do negócio.

Change Message Indicator indica se o IDoc é enviado como uma notificação de mudança. Por exemplo, as mensagens de modificação Pedido de compra são enviadas ao fornecedor usando o tipo de mensagem padrão EDI 860. 

O tipo de mensagem separado deve ser acionado no pedido de compra para a modificação do pedido. Uma linha adicional com o tipo de mensagem de modificação deve ser adicionada na guia Controle de mensagem com o indicador de mudança de mensagem ativado.

OPÇÕES DE ENTRADA (PARÂMETROS DE ENTRADA)

O código do processo de opções de entrada é atualizado apenas na tela Entrada. O processamento de IDocs pode ser acionado pelo programa em segundo plano e acionado imediatamente.

PÓS-PROCESSAMENTO (PARÂMETROS DE ENTRADA / SAÍDA)

Na opção de pós-processamento, podemos manter os detalhes do fluxo de trabalho dos usuários ou das posições para os quais uma notificação de erro será enviada se um processamento do IDoc falhar.

TELEFONIA (PARÂMETROS DE ENTRADA / SAÍDA)

Também podemos manter os detalhes de contato na opção de telefonia.

EDI STANDARD (PARÂMETROS DE ENTRADA)

A tela padrão do EDI contém os detalhes da terminologia padrão do EDI usada para a transmissão do IDoc.

Por exemplo, o Tipo de mensagem 850 é um padrão EDI para o IDoc de pedido de compra e está vinculado a ordens de tipo de mensagem IDoc .

ESTRUTURA E REGISTROS DO IDOC

ESTRUTURA

A estrutura do IDoc é dividida em registros de controle, registros de dados e status.

Esses registros são armazenados nas tabelas transparentes no SAP.Estes são EDIDC, EDID4 e EDIDS.

CONTROLO DE REGISTO (EDIDC)

Ele contém informações como número do IDoc, direção, status do IDoc, tipo básico, tipo de mensagem, parceiro (remetente / destinatário), data e hora da criação / atualização, arquivo de troca ou número ISA, etc.

Registro de dados (EDID4)

Contém os detalhes dos segmentos do IDoc.

O segmento de IDoc possui campos que contêm os dados necessários para lançar os documentos.

REGISTROS DE STATUS (EDIDS)

O IDoc Status define o status de processamento do IDoc. Os status de IDoc são usados ​​para rastrear o IDoc e seus vários estados de processamento. Números de status representa o status do IDoc. O status atual do IDoc está presente no registro de controle.

Os números do status inicial são 64 para entrada e 03 para saída. O status de sucesso é 53 para entrada e 16 para IDocs de saída.

ENVIANDO E RECEBENDO IDOCS

ACIONANDO UM IDOC DE SAÍDA

Os IDocs de saída podem ser acionados a partir dos tipos de mensagem de saída de Pedidos, fornecimentos, Documentos do material, faturas, etc. A figura a seguir mostra que uma vez processada a saída ZXX1 do PO XXXXXXX1, um IDoc “000000XXXXXXXXX1” é adicionado / criado.

O relacionamento entre o IDoc e o documento do aplicativo pode ser encontrado de duas maneiras:

1. Guia Relacionamento do IDoc

2. Guia Relacionamento do Documento de Aplicação, por exemplo, PO, SO, Documento de Material, etc.

O status inicial deste IDoc será 30, que após o processamento bem-sucedido será convertido em status 16.

Um IDoc de saída bem-sucedido passará por todos os status acima na ordem inversa (01-03-18-06-12-16). Cada status representa uma etapa de validação de IDoc. Se um IDoc passar todas as validações, ele atingiria o status 16. Essas etapas de validação diferentes para IDocs de saída são explicadas abaixo:

01: Geração de IDoc bem sucedida

30: O IDoc está pronto para ser processado pelo trabalho de processamento de IDoc

03: Dados IDoc são passados ​​para a porta

18: IDoc acionou com êxito o subsistema EDI

06: Dados do IDoc traduzidos para o formato EDI

12: IDoc é despachado com sucesso para o parceiro

16: O parceiro recebeu o IDoc com sucesso

O IDoc pode falhar em qualquer uma das etapas acima durante a validação.

RECEBENDO UM IDOC DE ENTRADA

O status inicial de um IDoc de entrada é 64 e o status bem-sucedido é 53.

Diferentes etapas de validação para IDocs de entrada são explicadas abaixo:

50: IDoc recebido com sucesso no sistema

64: IDoc está pronto para ser processado pelo trabalho de processamento de IDoc

53: Documento de aplicação criado e salvo com sucesso. O número do documento pode ser encontrado expandindo o nó de status 53

Um IDoc de entrada passa por todos os status acima na ordem inversa (50-64-53).

PROCESSAMENTO DE IDOC

PROCESSAMENTO AUTOMÁTICO / IMEDIATO

Nesse caso, o IDoc é processado imediatamente conforme gerado ou adicionado ao sistema. O cheque “Transferir IDoc imediatamente” é selecionado em Opções de saída e “Ativar imediatamente” é selecionado em Opção de entrada. Essas verificações geralmente são usadas quando a troca de informações em tempo real é necessária entre dois sistemas.

PROCESSAMENTO MANUAL

Os IDocs também podem ser processados ​​manualmente usando o TCODE BD87 no SAP.

PROCESSAMENTO ATRAVÉS DO TRABALHO DE FUNDO

O processamento de IDoc por segundo plano é a maneira mais preferida de processar os IDocs. Os seguintes programas são usados ​​no processamento dos IDocs usando a tarefa em segundo plano:

RBDAPP01 - IDocs de entrada

RSEOUT00 - IDocs de saída

REPROCESSANDO IDOCS

Com base nos status do IDoc, diferentes programas podem ser usados ​​para o reprocessamento de IDocs com falha.Estes são dados abaixo:

TESTANDO E EDITANDO IDOCS

Se um IDoc contiver erros nos dados, esses IDocs poderão ser editados usando o TCode WE02 ou WE05. Quando um IDoc é editado, as informações do IDoc original (backup) são salvas em um Novo IDoc sob o status 70 (para entrada) / 33 (para saída). Esses IDocs permanecem no sistema apenas para referência e não podem ser processados. O status do IDoc editado se torna 69 (entrada) e 32 (saída). Esses IDocs podem então ser processados ​​usando transações BD87 ou trabalhos em lote.

A depuração de IDocs pode ser feita usando copiando os IDocs usando o TCode WE19. WE19 é uma ferramenta de teste para processamento de IDocs. O WE19 copia o IDoc existente e cria um novo IDoc que pode ser modificado de acordo com as necessidades de teste. O IDoc recém gerado também pode ser processado usando o BD87.

CONVERTENDO O STATUS DO IDOC

O relatório RC1_IDOC_SET_STATUS pode ser usado para alterar o status do IDoc. Mudanças de status são geralmente necessárias para mover um IDoc para o status 68 - sem processamento adicional

PESQUISANDO IDOCS NO SAP

TCODE WE02 / WE05: PESQUISA GERAL

Os IDocs podem ser exibidos no sistema via TCODE WE02 e WE05.Se o número do IDoc não for conhecido, a pesquisa poderá ser feita com base na Data, Direção, TIPO BÁSICO, TIPO DE MENSAGEM e NÚMERO DO PARCEIRO. O número do parceiro pode ser encontrado nas Mensagens de Saída dos documentos.

A pesquisa de IDocs também pode ser feita com base na referência do arquivo ISA ou Transfer.

TCODE WE09: PESQUISANDO DADOS EM SEGMENTOS DO IDOC

Se estivermos procurando informações específicas nos segmentos de IDocs, isso pode ser encontrado usando o TCODE WE09. Isso é útil se você estiver procurando por uma informação específica em um tipo similar de IDoc dentro de segmentos IDoc. Por exemplo, se você quiser pesquisar um determinado número de Pedido de compra, por exemplo, 100000001 em vários IDocs que se encontra no segmento E1EDK01 de um IDoc no campo BELNR. Em seguida, a pesquisa pode ser executada da seguinte maneira.

VALIDAÇÃO DE IDOC, ERROS IDOC COMUNS E SOLUÇÃO

Embora a falha do IDoc possa não estar relacionada a nenhum dos motivos mencionados acima, a melhor maneira de encontrar o erro do IDoc é comparar o IDoc existente com o bom exemplo. Um bom exemplo de IDoc pode ser facilmente pesquisado com qualquer um dos métodos de busca do IDoc, conforme descrito acima.

DOCUMENTAÇÃO PARA TIPOS IDOC

A documentação do IDoc pode ser encontrada usando o TCODE WE60 e pode ser útil para obter informações do Tipo de IDoc ou seu segmento específico. Também fornece informações como segmentos obrigatórios e opcionais, número mínimo e máximo de segmentos, etc.