Solução de problemas de EDI

Este guia aborda erros e problemas comuns encontrados ao usar o Jitterbit EDI. Comece com as etapas de diagnóstico abaixo e depois encontre seu problema específico na seção relevante.

Para uma referência unificada que abrange problemas de integração, automação, gerenciamento de API, EDI e desenvolvimento de aplicativos em um único lugar, consulte o guia de solução de problemas do Harmony.

Para problemas com uma operação do Studio que se integra ao Jitterbit EDI (por exemplo, uma que usa o conector EDI for Cloud v2), consulte solução de problemas de operação ou solução de problemas de agente privado se a operação for executada em um agente privado.

Etapas de diagnóstico

Verificar o status da transação

Abra a página Transações e filtre por transações com falha ou rejeitadas. O status e qualquer mensagem de erro associada exibida para a transação são os indicadores principais do que deu errado.

Verificar a página Mensagens

A página Mensagens mostra mensagens de log do sistema EDI. Para encontrar mensagens relacionadas a uma transmissão ou documento com falha, filtre por status de Erro, parceiro comercial, nível de severidade (Alto, Médio, Baixo ou Informação) e categoria de mensagem. Para problemas de transmissão, filtre pela categoria Comunicação (canais AS2, FTP e VAN); para problemas de processamento de documentos, filtre pela categoria Transação (Processador e Validação).

Verificar a página Arquivo

A página Arquivo contém os documentos EDI brutos de entrada e saída para transações arquivadas. Revisar um documento arquivado pode confirmar se uma falha está no conteúdo do documento em si ou na lógica de processamento.

Verificar os logs de operação e agente

Se sua integração usa o conector EDI for Cloud v2 em uma operação do Studio, primeiro revise os logs de operação para erros da execução da operação. Se a operação é executada em um agente privado e você precisa de detalhes de nível inferior, como erros de conectividade, também revise os logs do agente.

Falhas de comunicação EDI

Falha de conexão ou certificado AS2

• Sintoma: As transmissões AS2 de saída falham ou os reconhecimentos do parceiro comercial não são recebidos.
• Possíveis causas:
  • O certificado AS2 expirou ou não é mais confiável pelo parceiro comercial.
  • O algoritmo do certificado não corresponde ao que o parceiro comercial exige (por exemplo, SHA-1 vs. SHA-256).
  • A URL do endpoint AS2, ID do parceiro ou outros parâmetros de conexão estão incorretos.
  • Um firewall ou restrição de rede está bloqueando o tráfego AS2 de saída na porta 443 ou na porta AS2 configurada.
• Resolução:
  • Revise as configurações de comunicação AS2 do parceiro comercial afetado e confirme que a URL do endpoint, IDs de parceiro e configurações de certificado estão corretos.
  • Verifique a data de expiração do certificado e renove-o se tiver expirado. Troque o certificado atualizado com o parceiro comercial.
  • Confirme que o algoritmo do certificado corresponde aos requisitos do parceiro comercial. Atualize o algoritmo nas configurações AS2 se necessário.
  • Verifique se o tráfego de saída para o endpoint AS2 do parceiro comercial é permitido pelo firewall da sua rede.

AS2: O firewall do parceiro comercial deve colocar os endereços IP da Jitterbit na lista de permissões

• Sintoma: Um parceiro comercial relata que não consegue receber suas transmissões AS2, ou os reconhecimentos AS2 deles nunca chegam, mesmo que suas configurações AS2 de saída pareçam corretas.
• Possível causa: O firewall do parceiro comercial exige uma lista de permissões explícita para tráfego de entrada e não adicionou os endereços IP do EDI Jitterbit.

• Resolução:

  • Forneça os seguintes endereços IP do EDI Jitterbit ao seu parceiro comercial e solicite que coloque-os na lista de permissões para tráfego AS2 de entrada e saída:

    • América do Norte: 40.71.22.62
    • EMEA e APAC: 20.166.31.85

  • Para sua URL de recebimento AS2 de entrada e o endereço IP correspondente para fornecer aos parceiros comerciais, consulte a página configurações de comunicação AS2 da sua região.

Falha de conexão FTP ou SFTP

• Sintoma: As transmissões FTP ou SFTP para ou de um parceiro comercial falham, ou as transferências de arquivo travam e expiram.
• Possíveis causas:
  • O endereço do servidor, porta, credenciais ou método de autenticação (senha vs. chave SSH) estão incorretos ou desatualizados.
  • Um firewall ou restrição de rede está bloqueando a porta necessária entre o EDI Jitterbit e o servidor FTP/SFTP.
  • O diretório de destino não existe ou a conta de serviço não tem permissões de leitura/escrita nele.
  • A chave do host foi alterada no servidor SFTP, causando uma incompatibilidade.
• Resolução:
  • Revise as configurações de comunicação FTP do parceiro comercial afetado e verifique todos os parâmetros de conexão.
  • Confirme que a conectividade com o endereço e porta do servidor FTP/SFTP é permitida através dos firewalls relevantes.
  • Verifique se a conta de serviço tem as permissões necessárias no diretório de destino.
  • Se usar autenticação por chave SSH, confirme que a chave está atual e é aceita pelo servidor. Se a chave do host foi alterada, atualize a entrada de hosts conhecidos.

Verificação de transação duplicada não se aplica aos formatos EDIXml ou XCBL

• Sintoma: Documentos de entrada duplicados estão sendo processados várias vezes mesmo com a configuração Verificação de Transação Duplicada ativada na conexão AS2 do parceiro comercial.
• Possível causa: A Verificação de Transação Duplicada se aplica apenas a documentos em formato EDI. Ela não filtra duplicatas para os formatos de intercâmbio EDIXml ou XCBL.
• Resolução: Se a filtragem de duplicatas for necessária para fluxos de trabalho EDIXml ou XCBL, implemente lógica de deduplicação na operação do Studio que processa os documentos de entrada (por exemplo, verificando um ID de transação em um registro de banco de dados ou Cloud Datastore antes do processamento).

Problemas de conectividade VAN

• Sintoma: Documentos EDI não estão sendo entregues ou recebidos através de uma Rede de Valor Agregado (VAN).
• Possível causa: Uma conexão VAN é uma conexão gerenciada que a Jitterbit configura; você não pode criá-la ou configurá-la por conta própria. As falhas de entrega geralmente envolvem a interconexão VAN, roteamento de caixa de correio ou configuração do parceiro no lado do provedor, em vez de uma configuração de autoatendimento no Jitterbit EDI.
• Resolução:
  • Confirme se a conexão VAN correta está atribuída ao parceiro comercial afetado.
  • Como a conexão VAN não pode ser configurada diretamente no Jitterbit EDI, entre em contato com o suporte Jitterbit ou com seu Gerenciador de Sucesso do Cliente para verificar a interconexão VAN e o roteamento de documentos.
  • Coordene com o provedor VAN para confirmar se os identificadores de caixa de correio e o roteamento do parceiro comercial estão corretos no lado da VAN.

Atividade EDI for Cloud v2 falha em um agente privado atrás de firewall ou proxy

• Sintoma: Em um agente privado, uma atividade EDI for Cloud v2 como Get Document falha ao recuperar dados (por exemplo, com um erro "Unable to fetch data"), mesmo que o teste de conexão seja bem-sucedido e o mesmo projeto funcione em um grupo de agentes na nuvem.
• Possível causa: O agente privado está atrás de um firewall ou proxy que bloqueia o acesso de saída para o serviço Jitterbit eiCloud EDI em eicloudservice.com. O conector EDI for Cloud v2 chama este serviço (por exemplo, em *.transactionapi.eicloudservice.com) para recuperar dados, portanto bloqueá-lo causa falha na atividade. Agentes na nuvem não são afetados.
• Resolução:
  1. Coloque na lista de permissões eicloudservice.com e seus subdomínios para acesso de saída no firewall, proxy e rede do agente privado. Para os outros domínios Jitterbit e endereços IP que um agente privado precisa para acesso de saída, consulte Informações da lista de permissões.
  2. Se um proxy estiver em uso, confirme se está configurado corretamente no agente privado e não está interferindo na conexão.

Token de acesso EDI desativado causa erro INVALID_TOKEN

• Sintoma: Operações que usam o conector EDI for Cloud v2 falham com:

  Error opening connection. Exception is: Error code: INVALID_TOKEN
  

• Possível causa: O token de acesso usado pela conexão EDI for Cloud v2 foi definido como Inativo na página Access Tokens do Console de Gerenciamento.

• Resolução: Na página Access Tokens, localize o token e defina seu Status como Ativo.

Erros no processamento de documentos

Documento rejeitado: dados inválidos ou ausentes

• Sintoma: Um documento EDI de saída é rejeitado pelo parceiro comercial ou falha na validação, ou um documento de entrada produz uma confirmação negativa.
• Possíveis causas:
  • Um segmento ou elemento de dados obrigatório está ausente do documento.
  • Um valor de campo excede o comprimento permitido, usa um tipo de dados incorreto ou contém caracteres inválidos.
  • O indicador de uso de intercâmbio (ISA15) está definido como T (teste) em vez de P (produção), então o parceiro comercial rejeita o documento.
  • O documento não está em conformidade com o guia de implementação do parceiro comercial.
• Resolução: Analise a transação rejeitada na página Transações para o segmento ou elemento específico citado no erro e, em seguida:
  • Para um documento que você enviou, compare-o com o guia de implementação do parceiro comercial para identificar campos ausentes ou não conformes e, depois, atualize o mapeamento EDI e as configurações do tipo de documento afetado para produzir uma saída em conformidade.
  • Para um documento de entrada enviado pelo parceiro comercial, compartilhe o erro de validação com ele para que possa corrigir seu formato de saída.

Erro de mapeamento ou esquema EDI

• Sintoma: Documentos EDI são gerados com conteúdo incorreto, campos ausentes ou uma estrutura inesperada, ou documentos de entrada falham no processamento.
• Possíveis causas:
  • O mapa ou esquema EDI está desatualizado e não reflete o guia de implementação atual ou os requisitos do parceiro comercial.
  • Os campos de dados de origem são mapeados incorretamente, produzindo valores errados no documento de saída.
  • Incompatibilidades de tipo de dados, caracteres especiais ou problemas de codificação nos dados de origem causam falhas na transformação.
• Resolução:
  1. Analise as configurações EDI do parceiro comercial afetado em Configurações EDI e verifique se o mapa reflete com precisão o guia de implementação atual.
  2. Valide se os campos de dados de origem estão mapeados para os segmentos e elementos EDI corretos.
  3. Verifique os dados de origem quanto a caracteres especiais, problemas de codificação ou valores inesperados que possam estar causando falhas na transformação e adicione etapas de limpeza de dados, se necessário.
  4. Teste com um documento de amostra representativo e use o arquivo para comparar a saída gerada com a estrutura esperada.

Erro de transformação: campo não reconhecido na atividade EDI for Cloud v2

• Sintoma: Uma transformação usando uma atividade EDI for Cloud v2 (como Listar Transações) falha com um erro de análise JSON referenciando um nome de campo não reconhecido, por exemplo:

  Unrecognized field "user_defined_field_1"
  

• Possível causa: A versão do conector EDI for Cloud v2 instalada no agente está desatualizada. O serviço EDI de backend retorna um campo (como user_defined_field_1) que a versão mais antiga do conector não reconhece, então o conector não consegue analisar a resposta.

• Resolução: Atualize o conector EDI for Cloud v2 no agente para a versão mais recente, seguindo Confirmar disponibilidade do conector e mantê-lo atualizado no guia de solução de problemas do conector. Clicar em Testar Conexão na conexão EDI for Cloud v2 baixa a versão mais recente do conector para o agente; se a política organizacional Desabilitar Atualização Automática do Conector estiver habilitada, atualize o conector do grupo de agentes na página Agentes do Console de Gerenciamento.

Mapas de segmento ou loop EDI repetido mapeiam apenas a última iteração

• Sintoma: Em uma transformação do Studio, um segmento ou loop repetido em um documento EDI manipulado através do conector EDI for Cloud v2 mapeia apenas sua última ocorrência (iterações anteriores são descartadas), porque a cardinalidade do nó no esquema de atividade do conector é de ocorrência única (por exemplo, (0,1)) em vez de repetida ((1,many)). Isso afeta tanto X12 (por exemplo, um segmento N9 aninhado em um loop LX em um 945) quanto EDIFACT (por exemplo, um grupo CNI repetido em um IFCSUM).
• Possível causa: O esquema gerado automaticamente fornecido pelo conector EDI for Cloud v2 não reflete a cardinalidade correta para o segmento ou loop afetado. O documento bruto no armazenamento de Transações do EDI contém todas as iterações, e um esquema construído manualmente a partir desse XML bruto as mapeia corretamente, o que confirma o esquema de resposta do conector (não os dados) como a causa.
• Resolução:
  1. Abra a conexão EDI for Cloud v2 no Studio e atualize os metadados para verificar se uma correção de esquema foi lançada.
  2. Se a cardinalidade ainda estiver incorreta após a atualização, exporte o esquema, atualize manualmente o atributo maxOccurs no segmento afetado em um editor XML externo e reimporte-o como um XSD personalizado.

Adicionando níveis de loop hierárquico (HL) aninhados a uma transformação EDI

• Sintoma: Ao construir uma transformação do Studio para um conjunto de transações EDI que usa loops hierárquicos (por exemplo, X12 870 4010VICS, que é estruturado de forma semelhante ao 856), o esquema da atividade Enviar Documento do conector EDI for Cloud v2 mostra um único nível HL, mas o documento que você precisa produzir requer níveis HL aninhados (por exemplo, um nível de pedido HL-O com um nível de item filho HL-I).
• Possível causa: Documentos hierárquicos podem aninhar níveis HL em profundidades variadas, portanto o esquema do conector expõe um único nível HL que você replica na transformação para construir os níveis adicionais que seu documento requer.
• Resolução:
  1. Na árvore de esquema de destino da transformação, clique com o botão direito no nó HL existente e selecione Duplicar nó para adicionar o nível HL aninhado (por exemplo, um nível HL-I filho sob HL-O).
  2. Mapeie o nó duplicado para seus dados de origem. Adicione uma condição no nó duplicado se ele deve ser criado na saída apenas em circunstâncias específicas.

Configuração de parceiro comercial

Identificadores de parceiro comercial incorretos

• Sintoma: Documentos são roteados incorretamente, rejeitados no nível do envelope ou não reconhecidos pelo parceiro comercial.
• Possíveis causas:
  • O ID EDI do remetente ou destinatário, código qualificador ou outros identificadores no nível do envelope não correspondem ao que o parceiro comercial espera.
  • A configuração do parceiro comercial foi atualizada recentemente, mas a alteração não foi aplicada no Jitterbit EDI.
• Resolução:
  1. Revise a configuração do parceiro comercial e confirme que o ID EDI e os códigos qualificadores correspondem aos valores especificados na documentação de configuração do parceiro comercial.
  2. Compare os identificadores do envelope em um documento rejeitado (visível no arquivo) com os valores esperados.
  3. Atualize as configurações do parceiro comercial se algum identificador estiver incorreto e reprocesse ou reenvie os documentos afetados.

Valores de substituição de ID EDI não aplicados a transações de saída

• Sintoma: Transações de saída usam os IDs EDI de remetente ou destinatário padrão da configuração do parceiro comercial, em vez dos IDs de substituição preferidos configurados nas definições de ID EDI.
• Possível causa: As substituições de ID EDI não são aplicadas automaticamente. Os IDs preferidos devem ser mapeados explicitamente na transformação de solicitação da operação do Studio que envia o documento de saída usando o conector EDI for Cloud v2.
• Resolução: Nessa transformação de solicitação, mapeie valores para estes campos para aplicar os IDs preferidos (consulte a página Definições de ID EDI para os valores exatos a usar):
  • ISA05_ID_Qualifier: qualificador de ID do remetente
  • ISA06_Sender_ID: ID EDI do remetente
  • ISA07_ID_Qualifier: qualificador de ID do destinatário
  • ISA08_Receiver_ID: ID EDI do destinatário

Confirmações não configuradas ou não recebidas

• Sintoma: As confirmações funcionais esperadas 997 (X12) ou CONTRL (EDIFACT) não estão sendo enviadas ou recebidas, ou o processamento de confirmação não está funcionando conforme esperado.
• Possíveis causas:
  • A geração ou o processamento de confirmação está desabilitado nas definições EDI do parceiro comercial.
  • O tipo de documento de confirmação não está incluído na configuração de fluxo de trabalho do parceiro comercial.
  • O parceiro comercial não está enviando confirmações, ou suas confirmações estão sendo roteadas incorretamente.
• Resolução:
  • Nas definições EDI do parceiro comercial, confirme que a geração e o processamento de confirmação estão habilitados para os tipos de documento relevantes.
  • Revise a configuração de gerenciar fluxos de trabalho para confirmar que o tipo de documento de confirmação está incluído no fluxo de trabalho.
  • Verifique o arquivo para determinar se as confirmações do parceiro comercial estão sendo recebidas mas não processadas, ou não estão chegando.
  • Se as confirmações não estiverem chegando, coordene com o parceiro comercial para confirmar que está enviando para o endpoint correto.

Não é possível excluir uma conexão de comunicação atribuída

• Sintoma: A tentativa de excluir uma conexão AS2 ou FTP nas Definições de comunicação falha ou a opção de exclusão não está disponível.
• Possível causa: Conexões atribuídas não podem ser excluídas. Uma conexão atualmente atribuída a um parceiro comercial deve ser desatribuída antes de poder ser removida.
• Resolução:
  1. Em Definições de comunicação, selecione o parceiro comercial que usa a conexão e atribua uma conexão diferente a esse parceiro.
  2. Quando nenhum parceiro estiver usando a conexão, a opção de exclusão fica disponível.

FTP "Próxima execução" não atualiza sem atualizar a página

• Sintoma: A Próxima execução exibida nas definições de comunicação FTP de um parceiro comercial permanece desatualizada após a execução do trabalho FTP agendado, mesmo que o agendamento esteja funcionando corretamente.
• Possível causa: A interface atualiza o status de trabalhos agendados apenas quando a página é carregada ou quando uma ação manual dispara um recarregamento de dados. Ela não consulta o mecanismo em tempo real.
• Resolução:
  • Atualize a página do navegador para atualizar a exibição de Próxima execução.
  • Como alternativa, navegue para longe das definições de FTP e volte para forçar um recarregamento.

Falha na adição de ID EDI ou ID Preferido: ID já em uso

• Sintoma: A adição de um ID EDI ou um ID Preferido a um parceiro comercial falha, mesmo quando o ID não parece estar em uso no ambiente atual. Uma das seguintes mensagens é exibida:

Não é possível adicionar ID EDI [ID] pois ele já está em uso; confirme e forneça um ID único.

Não é possível adicionar ID Preferencial [ID] pois ele já está em uso; confirme e forneça um ID único.

• Possíveis causas:

  • Cada ID EDI deve ser único em todos os ambientes Harmony onde o Jitterbit EDI está habilitado. Se o mesmo ID já estiver atribuído a um parceiro comercial em um ambiente diferente, a adição falha.
  • Um ID Preferencial deve ser único dentro do ambiente. É rejeitado se já estiver atribuído ao mesmo parceiro comercial ou a outro parceiro comercial no mesmo ambiente.

• Resolução:

  • Para um ID EDI duplicado, verifique todos os outros ambientes Harmony onde o EDI está habilitado para confirmar se o ID já está atribuído lá. Trabalhe com seu parceiro comercial para estabelecer um ID EDI único para cada ambiente onde você troca documentos e use um ID distinto para ambientes de não produção que difira do seu ID EDI de produção.
  • Para um ID Preferencial duplicado, verifique a lista de ID Preferencial (IDs ISA) do parceiro comercial atual e de outros parceiros comerciais no mesmo ambiente, depois escolha um ID único.

Configuração de fluxo de trabalho

Documentos de saída passam na validação local mas falham no teste do parceiro comercial

• Sintoma: Documentos EDI de saída passam na verificação de validação local no Jitterbit EDI mas são rejeitados durante o teste ou certificação do parceiro comercial, frequentemente com erros sobre elementos ausentes ou não conformes.
• Possíveis causas:
  • A validação de saída está desabilitada na configuração do fluxo de trabalho. O Jitterbit EDI permite que documentos sejam gerados sem validação, mas sem ela, os documentos podem não ter elementos exigidos pelo guia de implementação do parceiro comercial.
  • As configurações EDI cobrem os elementos essenciais do padrão, mas o guia de implementação do parceiro comercial pode exigir elementos obrigatórios adicionais não aplicados pelas configurações padrão.
• Resolução:
  • Na configuração de gerenciar fluxos de trabalho, habilite a validação para o fluxo de trabalho de saída.
  • Revise o guia de implementação do parceiro comercial para qualquer elemento obrigatório além das configurações EDI padrão e adicione-os ao mapeamento.
  • A menos que você tenha uma compreensão profunda da transação EDI específica e dos requisitos do parceiro comercial, sempre habilite a validação antes de testar com um parceiro comercial.

Arquivo e transações

Transação arquivada antes ou depois do esperado

• Sintoma: Uma transação é arquivada antes do período de retenção esperado terminar, ou permanece disponível por mais tempo do que o esperado.
• Possível causa: As transações são arquivadas com base na data posterior entre duas datas: a data da transação e a data do documento. Se a data do documento for mais recente que a data da transação, o arquivamento é calculado a partir da data do documento, o que pode estender o período de retenção.
• Resolução:
  • Ao investigar o tempo de arquivamento inesperado, verifique tanto a data da transação quanto a data do documento da transação afetada.
  • Revise as configurações de período de retenção para confirmar o número de dias configurado (30, 60 ou 90).

Permissões e acesso

Não é possível acessar recursos EDI

• Sintoma: Um usuário não consegue visualizar ou interagir com páginas EDI, ou certas ações EDI não estão disponíveis.
• Possíveis causas:
  • O acesso EDI requer tanto uma permissão de função específica do EDI (Admin, EDI User ou EDI Viewer) quanto uma função de acesso ao ambiente em nível Write. A falta de qualquer uma delas impede o acesso.
  • As funções EDI User e EDI Viewer diferem no que permitem. EDI Viewer pode reprocessar transações, reenviar confirmações e ler páginas, mas não pode criar ou atualizar configurações ou fazer upload de arquivos. Criar ou atualizar configurações e fazer upload de arquivos para processamento requerem a função EDI User. Ações administrativas, como arquivar transações, habilitar PII e alterar configurações de limpeza, requerem a função Admin.
• Resolução:
  • No Management Console, verifique se o usuário tem uma função que inclui a permissão Admin, EDI User ou EDI Viewer.
  • Confirme que o nível de acesso do ambiente do usuário inclui acesso Write para o ambiente onde o EDI está configurado.
  • Se o usuário precisar executar operações de escrita (como criar parceiros comerciais ou fazer upload de documentos), atribua a função EDI User em vez de EDI Viewer. Consulte Permissões EDI para a matriz de permissões completa.

Não é possível ativar as configurações de PII

• Sintoma: A opção para ativar as configurações de PII (informações de identificação pessoal) para um parceiro comercial está indisponível ou desativada.
• Possível causa: Ativar as configurações de PII requer a permissão Admin permission. Nem a função EDI User nem a EDI Viewer podem ativar as configurações de PII.
• Resolução:
  • Confirme se a função do usuário inclui a permissão Admin, não apenas EDI User ou EDI Viewer.
  • Se o usuário precisar gerenciar as configurações de PII regularmente, atualize a atribuição de função de acordo.