Resoluçã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 localize 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 único local, consulte o guia de resolução de problemas do Harmony.
Para problemas com uma operação do Studio que se integra com o Jitterbit EDI (por exemplo, uma que usa o conector EDI for Cloud v2), consulte a resolução de problemas de operação ou a resolução de problemas do agente privado se a operação for executada em um agente privado.
Todas as entradas de resolução de problemas nesta página
-
- Falha de conexão AS2 ou certificado
- AS2: O firewall do parceiro comercial deve colocar endereços IP da Jitterbit na lista de permissões
- Falha de conexão FTP ou SFTP
- A verificação de transação duplicada não se aplica ao formato EDIXml ou XCBL
- Problemas de conectividade da VAN
- Atividade EDI for Cloud v2 falha em um agente privado atrás de firewall ou proxy
- Token de acesso EDI desativado causa erro
INVALID_TOKEN
-
Erros de processamento de documentos
- Documento rejeitado: dados inválidos ou ausentes
- Erro de mapeamento ou esquema EDI
- Erro de transformação: campo não reconhecido na atividade EDI for Cloud v2
- Segmentos ou loops EDI repetidos mapeiam apenas a última iteração
- Adicionando níveis aninhados de loop hierárquico (HL) a uma transformação EDI
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 de Mensagens
A página Mensagens mostra mensagens de log do sistema de EDI. Para encontrar mensagens relacionadas a uma transmissão com falha ou documento, filtre por status de Erro, parceiro comercial, nível de severidade (Alto, Médio, Baixo ou Informações) e categoria de mensagem. Para problemas de transmissão, filtre pela categoria Comunicação (canais AS2 e FTP); para problemas de processamento de documentos, filtre pela categoria Transação.
Verificar a página de Arquivo
A página Arquivo contém os documentos EDI de entrada e saída brutos 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 procurar 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 na comunicação EDI
Falha de conexão AS2 ou certificado
- Sintoma: Transmissões AS2 de saída falham ou confirmações do parceiro comercial não são recebidas.
- 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 requer (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 conexão AS2 para o 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 de rede.
AS2: O firewall do parceiro comercial deve colocar 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 as confirmações AS2 deles nunca chegam, mesmo que suas configurações de AS2 de saída pareçam corretas.
- Possível causa: O firewall do parceiro comercial requer uma lista de permissões explícita para tráfego de entrada e não adicionou os endereços IP do Jitterbit EDI.
-
Resolução:
-
Forneça os seguintes endereços IP do Jitterbit EDI ao seu parceiro comercial e solicite que coloque 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
- América do Norte:
-
Para sua URL de recebimento AS2 de entrada e o endereço IP correspondente a fornecer aos parceiros comerciais, consulte a página configurações de conexão AS2 para sua região.
-
Falha de conexão FTP ou SFTP
- Sintoma: Transmissões FTP ou SFTP para ou de um parceiro comercial falham, ou transferências de arquivo ficam travadas 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 tem 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 conexão FTP para o parceiro comercial afetado e verifique todos os parâmetros de conexão.
- Confirme que a conectividade com o endereço do servidor FTP/SFTP e a porta é 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 estiver usando autenticação de chave SSH, confirme que 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ção duplicada não se aplica ao formato 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 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 a lógica de deduplicação na operação do Studio que processa os documentos de entrada (por exemplo, verificando uma ID de transação em um registro de banco de dados ou Cloud Datastore antes do processamento).
Problemas de conectividade da VAN
- Sintoma: Documentos EDI não estão sendo entregues ou recebidos por meio de uma Value Added Network (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 normalmente envolvem a interconexão da VAN, roteamento de caixa de correio ou configuração do parceiro no lado do provedor, e não uma configuração de autoatendimento na 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 na Jitterbit EDI, entre em contato com suporte da Jitterbit ou com seu Customer Success Manager para verificar a interconexão da VAN e o roteamento de documentos.
- Coordene com o provedor da VAN para confirmar que 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 com o teste de conexão bem-sucedido e o mesmo projeto funcionando em um grupo de agentes em 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 esse serviço (por exemplo, em*.transactionapi.eicloudservice.com) para recuperar dados, então bloqueá-lo causa a falha da atividade. Os agentes em nuvem não são afetados. - Resolução:
- Coloque na lista de permissões
eicloudservice.come seus subdomínios para acesso de saída no firewall e proxy da 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 de lista de permissões. - Se um proxy estiver em uso, confirme se está configurado corretamente no agente privado e não está interferindo na conexão.
- Coloque na lista de permissões
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 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 gera uma confirmação negativa.
- Possíveis causas:
- um segmento obrigatório ou elemento de dados 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 do intercâmbio (
ISA15) está configurado comoT(teste) em vez deP(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 enviado, 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 saída em conformidade.
- para um documento de entrada enviado pelo parceiro comercial, compartilhe o erro de validação com eles para que possam corrigir o formato de saída deles.
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.
- 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:
- 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.
- valide se os campos de dados de origem estão mapeados para os segmentos e elementos EDI corretos.
- verifique os dados de origem para 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.
- 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 instalado no agente está desatualizada. O serviço EDI de back-end retorna um campo (como
user_defined_field_1) que a versão anterior 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 Desabilitar Atualização Automática do Conector estiver ativada, em vez disso, atualize o conector do grupo de agentes na página Agentes do Console de Gerenciamento.
Segmentos ou loops EDI repetidos mapeiam apenas a última iteração
- Sintoma: Em uma transformação no 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 schema 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 segmentoN9aninhado em um loopLXem um 945) quanto EDIFACT (por exemplo, um grupoCNIrepetido em um IFCSUM). - Causa possível: O schema gerado automaticamente fornecido pelo conector EDI for Cloud v2 não reflete a cardinalidade correta do segmento ou loop afetado. O documento bruto na loja de Transações da EDI contém todas as iterações e um schema construído manualmente a partir desse XML bruto mapeia-as corretamente, o que confirma o schema de resposta do conector (não os dados) como a causa.
- Resolução:
- Abra a conexão EDI for Cloud v2 no Studio e atualize os metadados para verificar se uma correção de schema foi lançada.
- Se a cardinalidade ainda estiver incorreta após a atualização, exporte o schema, atualize manualmente o atributo
maxOccursno segmento afetado em um editor XML externo e reimporte-o como um XSD personalizado.
Adicionando níveis aninhados de loop hierárquico (HL) a uma transformação EDI
- Sintoma: Ao construir uma transformação no Studio para um conjunto de transações EDI que usa loops hierárquicos (por exemplo, X12 870 4010VICS, estruturado de forma semelhante ao 856), o schema da atividade Send Document 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).
- Causa possível: Documentos hierárquicos podem aninhar níveis HL em profundidades variáveis, portanto o schema 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:
- Na árvore de schema 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).
- 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 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.
- Possíveis causas:
- O ID EDI do remetente ou destinatário, 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:
- Revise a configuração do parceiro comercial e confirme que o ID EDI e os códigos de qualificador correspondem aos valores especificados na documentação de configuração do parceiro comercial.
- Compare os identificadores do envelope em um documento rejeitado (visível no arquivo) contra os valores esperados.
- Atualize as configurações do parceiro comercial se algum identificador estiver incorreto e reprocesse ou reenvie os documentos afetados.
Valores de override 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 override preferidos configurados nas definições de ID EDI.
- Possível causa: Os overrides de ID EDI não são aplicados automaticamente. Os IDs preferidos devem ser mapeados explicitamente na transformação de solicitação da operação 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 esses campos a fim de 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 remetenteISA06_Sender_ID: ID EDI do remetenteISA07_ID_Qualifier: qualificador de ID do destinatárioISA08_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 como 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 workflow 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.
- Verifique a configuração de gerenciar workflows a fim de confirmar que o tipo de documento de confirmação está incluído no workflow.
- 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 estão chegando, coordene com o parceiro comercial para confirmar que está enviando para o endpoint correto.
FTP "Próxima execução" não atualiza sem atualizar a página
- Sintoma: O valor Próxima execução exibido nas definições de uma conexão FTP permanece desatualizado depois que o trabalho FTP agendado é executado, mesmo que o agendamento esteja funcionando corretamente.
- Possível causa: Esse campo reflete o status do agendamento apenas quando a página é carregada ou quando uma ação manual dispara um recarregamento de dados. Ele não faz consultas ao 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:
Cannot add EDI ID [ID] as it is currently in use; please confirm and provide a unique ID.Cannot add Preferred ID [ID] as it is currently in use; please confirm and provide a unique ID. -
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 falhará.
- Um ID Preferido deve ser único no ambiente. Ele é rejeitado se já estiver atribuído ao mesmo parceiro comercial ou a outro parceiro comercial no mesmo ambiente.
-
Resolução:
- Para uma ID EDI duplicada, verifique todos os outros ambientes Harmony onde o EDI está ativado para confirmar se a ID já está atribuída lá. Trabalhe com seu parceiro comercial para estabelecer uma ID EDI única para cada ambiente onde você troca documentos e use uma ID distinta para ambientes de não-produção que difira da sua ID EDI de produção.
- Para uma ID Preferida duplicada, verifique a lista Preferred ID (ISA ID's) para o parceiro comercial atual e para outros parceiros comerciais no mesmo ambiente, depois escolha uma ID única.
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 faltantes 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 não ter 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 não impostos pelas configurações padrão.
- Resolução:
- Na configuração manage workflows, ative 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 padrão de EDI e adicione-os ao mapeamento.
- A menos que você tenha um conhecimento profundo 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 mais cedo ou mais tarde do que esperado
- Sintoma: Uma transação é arquivada antes do período de retenção esperado terminar, ou permanece disponível por mais tempo do que esperado.
- Causa possível: As transações são arquivadas com base na data posterior de 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 para a 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 de EDI
- Sintoma: Um usuário não consegue visualizar ou interagir com páginas de EDI, ou certas ações de EDI não estão disponíveis.
- Causas possíveis:
- O acesso ao EDI requer tanto uma permissão de função específica de EDI (Admin, EDI User ou EDI Viewer) quanto uma função de acesso ao ambiente em nível Write. A falta de 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 consegue criar ou atualizar configurações nem fazer upload de arquivos. Criar ou atualizar configurações e fazer upload de arquivos para processamento exigem a função EDI User. Ações administrativas, como arquivar transações, ativar PII e alterar configurações de limpeza, exigem 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 se 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 EDI permissions 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 pessoalmente identificáveis) para um parceiro comercial está indisponível ou acinzentada.
- Possível causa: A ativação das configurações de PII requer a permissão Admin . 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 sua função accordingly.