Solução de problemas de EDI

Este guia cobre erros e problemas comuns encontrados ao usar o Jitterbit EDI. Comece com os passos de diagnóstico abaixo e, em seguida, encontre seu problema específico na seção relevante.

Para uma referência unificada que abrange integração, automação, gerenciamento de API, EDI e problemas de desenvolvimento de aplicativos em um só 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.

Passos de diagnóstico

Verifique o status da transação

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

Verifique a página de Mensagens

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

Verifique a página de 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.

Verifique os logs de operação e do 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 em busca de erros da execução da operação. Se a operação for executada em um agente privado e você precisar de detalhes mais específicos, 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.
• Causas possíveis:
  • 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.
• Solução:
  • Revise as configurações de comunicação AS2 para o parceiro comercial afetado e confirme se a URL do endpoint, IDs dos parceiros e configurações do certificado estão corretas.
  • Verifique a data de expiração do certificado e renove-o se estiver expirado. Reenvie o certificado atualizado para o parceiro comercial.
  • Confirme se 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 seu firewall de rede.

AS2: O firewall do parceiro comercial deve permitir os endereços IP do Jitterbit

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

• Solução:

  • Forneça os seguintes endereços IP do EDI do Jitterbit ao seu parceiro comercial e solicite que eles os adicionem à lista de permissões para o tráfego AS2 de entrada e saída:
    • América do Norte: 40.71.22.62
    • EMEA e APAC: 20.166.31.85

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

Falha na conexão FTP ou SFTP

• Sintoma: Transmissões FTP ou SFTP para ou de um parceiro comercial falham, ou transferências de arquivos ficam penduradas 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 Jitterbit EDI e o servidor FTP/SFTP.
  • O diretório de destino não existe ou a conta de serviço não possui permissões de leitura/gravação nele.
  • A chave do host mudou no servidor SFTP, causando uma incompatibilidade.
• Resolução:
  • Revise as configurações de comunicação FTP para o parceiro comercial afetado e verifique todos os parâmetros de conexão.
  • Confirme que a conectividade com o endereço e a porta do servidor FTP/SFTP é permitida através dos firewalls relevantes.
  • Verifique se a conta de serviço possui as permissões necessárias no diretório de destino.
  • Se estiver usando autenticação por chave SSH, confirme se a chave está atual e aceita pelo servidor. Se a chave do host mudou, atualize a entrada de hosts conhecidos.

A verificação de transações duplicadas não se aplica ao formato EDIXml ou XCBL

• Sintoma: Documentos duplicados recebidos estão sendo processados várias vezes, mesmo com a configuração de 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 no formato EDI. Não filtra duplicatas para formatos de intercâmbio EDIXml ou XCBL.
• Resolução: Se o filtro de duplicatas for necessário para fluxos de trabalho EDIXml ou XCBL, implemente uma lógica de deduplicação na operação do Studio que processa os documentos recebidos (por exemplo, verificando um ID de transação contra um banco de dados ou registro do Cloud Datastore antes do processamento).

Problemas de conectividade com VAN

• Sintoma: Documentos EDI não estão sendo entregues ou recebidos através de uma Rede de Valor Agregado (VAN).
• Causa possível: 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. Falhas na entrega geralmente envolvem a interconexão da VAN, roteamento de caixa de correio ou configuração do parceiro do lado do provedor, em vez de uma configuração de autoatendimento no EDI da Jitterbit.
• 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 pelo EDI da Jitterbit, entre em contato com o suporte da Jitterbit ou com seu Gerente de Sucesso do Cliente para verificar a interconexão da VAN e o roteamento de documentos.
  • Coordene-se com o provedor da VAN para confirmar se os identificadores de caixa de correio do parceiro comercial e o roteamento estão corretos do lado da VAN.

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

• Sintoma: Em um agente privado, uma atividade EDI for Cloud v2, como Obter Documento, falha ao recuperar dados (por exemplo, com um erro "Não foi possível buscar dados"), mesmo que o teste de conexão seja bem-sucedido e o mesmo projeto funcione em um grupo de agentes em nuvem.
• Causa possível: O agente privado está atrás de um firewall ou proxy que bloqueia o acesso de saída ao serviço EDI da Jitterbit eiCloud em eicloudservice.com. O conector EDI for Cloud v2 chama esse serviço (por exemplo, em *.transactionapi.eicloudservice.com) para recuperar dados, portanto, bloqueá-lo causa a falha da atividade. Agentes em nuvem não são afetados.
• Resolução:
  1. Adicione eicloudservice.com e seus subdomínios à lista de permissões para acesso de saída na rede do agente privado, firewall e proxy. Para os outros domínios e endereços IP da Jitterbit que um agente privado precisa para acesso de saída, consulte as informações sobre a lista de permissões.
  2. Se um proxy estiver em uso, confirme se ele 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 usando o conector EDI for Cloud v2 falham com:

  Error opening connection. Exception is: Error code: INVALID_TOKEN
  

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

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

Erros de 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 um reconhecimento negativo.
• Causas possíveis:
  • Um segmento ou elemento de dados obrigatório está ausente do documento.
  • Um valor de campo excede o comprimento permitido, usa um tipo de dado 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: Revise a transação rejeitada na página Transações para o segmento ou elemento específico citado no erro, então:
  • 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, então atualize o mapeamento EDI e as configurações para o tipo de documento afetado para produzir uma saída conforme.
  • Para um documento de entrada enviado pelo parceiro comercial, compartilhe o erro de validação com eles para que possam 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 ao processar corretamente.
• Causas possíveis:
  • O mapa ou esquema EDI está desatualizado e não reflete o guia de implementação atual ou os requisitos do parceiro comercial.
  • Campos de dados de origem estã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. Revise as configurações EDI para o 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 em busca de 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 representativa 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 para Cloud v2

• Sintoma: Uma transformação usando uma atividade EDI para 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"
  

• Causa possível: A versão do conector EDI para 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, portanto, 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 Desativar Atualização Automática do Conector estiver habilitada, atualize o conector para o grupo de agentes na página Agentes do Console de Gerenciamento.

Mapas de segmento ou loop EDI repetidos apenas na última iteração

• Sintoma: Em uma transformação no Studio, um segmento ou loop repetido em um documento EDI tratado 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 dentro de um loop LX em um 945) quanto EDIFACT (por exemplo, um grupo CNI repetido em um IFCSUM).
• Causa possível: 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 EDI Transações contém todas as iterações, e um esquema construído manualmente a partir desse XML bruto as mapeia corretamente, o que confirma que o esquema de resposta do conector (não os dados) é 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 no Studio para um conjunto de transações EDI que utiliza 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 HL-I filho).
• Causa possível: Documentos hierárquicos podem aninhar níveis HL a diferentes profundidades, então 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 ao nó duplicado se ele deve ser criado na saída apenas sob circunstâncias específicas.

Configuração do 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.
• Causas possíveis:
  • O ID EDI do remetente ou do destinatário, o código de 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 se o EDI ID e os códigos de qualificador 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, em seguida, reprocessar ou reenviar 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 padrão do remetente ou receptor da configuração do parceiro comercial em vez dos IDs de substituição preferenciais configurados nas configurações de ID EDI.
• Causa possível: As substituições de ID EDI não são aplicadas automaticamente. Os IDs preferenciais 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: Na transformação de solicitação, mapeie valores para esses campos para aplicar os IDs preferenciais (consulte a página de configurações de ID EDI para os valores exatos a serem usados):
  • ISA05_ID_Qualifier: qualificador de ID do remetente
  • ISA06_Sender_ID: ID EDI do remetente
  • ISA07_ID_Qualifier: qualificador de ID do receptor
  • ISA08_Receiver_ID: ID EDI do receptor

Reconhecimentos não configurados ou não recebidos

• Sintoma: Reconhecimentos funcionais esperados 997 (X12) ou CONTRL (EDIFACT) não estão sendo enviados ou recebidos, ou o processamento de reconhecimentos não está funcionando como esperado.
• Causas possíveis:
  • A geração ou processamento de reconhecimentos está desativada nas configurações EDI do parceiro comercial.
  • O tipo de documento de reconhecimento não está incluído na configuração do fluxo de trabalho do parceiro comercial.
  • O parceiro comercial não está enviando reconhecimentos, ou seus reconhecimentos estão sendo roteados incorretamente.
• Resolução:
  • Nas configurações EDI do parceiro comercial, confirme que a geração e o processamento de reconhecimentos estão habilitados para os tipos de documentos relevantes.
  • Revise a configuração de gerenciar fluxos de trabalho para confirmar que o tipo de documento de reconhecimento está incluído no fluxo de trabalho.
  • Verifique o arquivo para determinar se os reconhecimentos do parceiro comercial estão sendo recebidos, mas não processados, ou não estão chegando de forma alguma.
  • Se os reconhecimentos não estão chegando, coordene com o parceiro comercial para confirmar que eles estão enviando para o endpoint correto.

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

• Sintoma: Tentar excluir uma conexão AS2 ou FTP nas Configurações de comunicação falha ou a opção de exclusão não está disponível.
• Causa possível: Conexões atribuídas não podem ser excluídas. Uma conexão que está atualmente atribuída a um parceiro comercial deve ser desatribuída antes de poder ser removida.
• Solução:
  1. Nas Configurações de comunicação, selecione o parceiro comercial que usa a conexão e atribua uma conexão diferente a esse parceiro.
  2. Assim que nenhum parceiro estiver usando a conexão, a opção de exclusão se torna disponível.

O "Próximo Horário de Execução" do FTP não é atualizado sem um refresh da página

• Sintoma: O Próximo Horário de Execução exibido nas configurações de comunicação FTP de um parceiro comercial permanece desatualizado após a execução do trabalho FTP agendado, mesmo que o agendamento esteja funcionando corretamente.
• Causa possível: A interface do usuário atualiza o status do trabalho agendado apenas quando a página é carregada ou quando uma ação manual aciona um recarregamento de dados. Não faz polling do mecanismo em tempo real.
• Solução:
  • Atualize a página do navegador para atualizar a exibição do Próximo Horário de Execução.
  • Alternativamente, navegue para fora das configurações de FTP e volte para forçar um recarregamento.

Falha na adição do ID EDI: ID já em uso em outro ambiente

• Sintoma: Adicionar um ID EDI a um parceiro comercial falha, mesmo que o ID não esteja em uso no ambiente atual.
• Causa possível: 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.
• Solução:
  • 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.
  • Para ambientes não produtivos, use um ID distinto que seja diferente do seu ID EDI de produção.

Configuração do 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.
• Causas possíveis:
  • A validação de saída está desativada na configuração do fluxo de trabalho. O Jitterbit EDI permite que documentos sejam gerados sem validação, mas sem ela, os documentos podem carecer de elementos exigidos pelo guia de implementação do parceiro comercial.
  • As configurações de EDI cobrem os elementos essenciais do padrão, mas o guia de implementação do parceiro comercial pode exigir elementos obrigatórios adicionais que não são aplicados pelas configurações padrão.
• Resolução:
  • Na configuração de gerenciar fluxos de trabalho, ative a validação para o fluxo de trabalho de saída.
  • Revise o guia de implementação do parceiro comercial para quaisquer elementos obrigatórios além das configurações padrão de EDI e adicione-os ao mapeamento.
  • A menos que você tenha um entendimento completo da transação EDI específica e dos requisitos do parceiro comercial, sempre ative 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 término do período de retenção esperado ou permanece disponível por mais tempo do que o esperado.
• Causa possível: As transações são arquivadas com base na mais recente das duas datas: a data da transação e a data do documento. Se a data do documento for mais recente do 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 para a transação afetada.
  • Revise as configurações do 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 estão indisponíveis.
• Causas possíveis:
  • O acesso EDI requer tanto uma permissão de função específica de EDI (Admin, Usuário EDI ou Visualizador EDI) quanto uma função de acesso ao ambiente de nível Gravar. A falta de qualquer uma delas impede o acesso.
  • As funções Usuário EDI e Visualizador EDI diferem no que permitem. O Visualizador EDI 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 requer a função Usuário EDI. Ações administrativas, como arquivar transações, habilitar PII e alterar configurações de purga, requerem a função Admin.
• Resolução:
  • No Console de Gerenciamento, verifique se o usuário possui uma função que inclua a permissão Admin, Usuário EDI ou Visualizador EDI.
  • Confirme se o nível de acesso do usuário ao ambiente inclui acesso Gravar para o ambiente onde o EDI está configurado.
  • Se o usuário precisar realizar operações de gravação (como criar parceiros comerciais ou fazer upload de documentos), atribua a função Usuário EDI em vez de Visualizador EDI. Veja permissões EDI para a matriz completa de permissões.

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

• Sintoma: A opção para habilitar configurações de PII (informações pessoalmente identificáveis) para um parceiro comercial está indisponível ou desativada.
• Causa possível: Habilitar configurações de PII requer a permissão Admin permissão. Nem a função Usuário EDI nem a função Visualizador EDI podem habilitar configurações de PII.
• Resolução:
  • Confirme se a função do usuário inclui a permissão Admin, e não apenas Usuário EDI ou Visualizador EDI.
  • Se o usuário precisar gerenciar configurações de PII regularmente, atualize a atribuição de função dele de acordo.