Ir para o conteúdo

IDs EDI no Jitterbit EDI

Os parceiros comerciais no Jitterbit EDI se identificam mutuamente usando um ID do Parceiro (também conhecido como ID ISA na interface do usuário) cujo formato depende do padrão EDI em uso:

Padrão EDI Formato Comprimento total
X12 Dois caracteres fixos (0–9 ou A–Z) + hífen + 1–15 caracteres (0–9 ou A–Z) 4–18 caracteres
EDIFACT 1–4 caracteres (0–9 ou A–Z) + hífen + 1–35 caracteres (0–9 ou A–Z) 3–40 caracteres
TRADACOMS Exatamente 12 caracteres alfanuméricos 12 caracteres

Para X12 e EDIFACT, o prefixo antes do hífen é o código qualificador EDI. O padrão EDI de um parceiro é determinado pelo primeiro workflow EDIXml associado a esse parceiro. A validação de formato é ignorada se o parceiro não tiver workflows EDIXml.

Nota

Seu próprio ID EDI não segue a tabela acima; ele usa um formato independentemente do padrão EDI: um qualificador de até 4 caracteres alfanuméricos, mais um ID obrigatório de 1–35 caracteres alfanuméricos. O qualificador é obrigatório (1–4 caracteres) na primeira vez que você configura um ID EDI para um novo ambiente, e opcional (0–4 caracteres) ao adicionar IDs EDI adicionais posteriormente via ID Preferencial (ISA IDs).

Nota

Ao criar um novo parceiro comercial, apenas a exclusividade do ID é validada. A validação de formato se aplica apenas ao adicionar IDs a um parceiro existente que tenha pelo menos um workflow EDIXml.

Observações importantes ao escolher seu ID EDI

  • Não use seu ID EDI autêntico em ambientes de teste ou QA. Use-o apenas ao configurar seu ambiente EDI de produção.

  • Cada ID deve ser exclusivo em todos os ambientes onde o Jitterbit EDI está habilitado. Tentar adicionar um ID que já está atribuído a outro parceiro comercial falha. Trabalhe com seu parceiro comercial para garantir que seu ID seja exclusivo e que a comunicação adequada possa ser estabelecida.

  • Tentar adicionar um ID Preferencial duplicado (seja já atribuído ao mesmo parceiro comercial ou a outro no mesmo ambiente) também é rejeitado. Para as mensagens de erro exatas e como resolvê-las, consulte Falha na adição de ID EDI ou ID Preferencial: ID já em uso.

Configurar um ID EDI

Na primeira vez que você adiciona um parceiro comercial a um ambiente, a caixa de diálogo Gerando seu ID EDI abre para que você configure um ID EDI para sua empresa.

Leia atentamente o conteúdo da caixa de diálogo e insira valores para os seguintes campos:

  • Código Qualificador: Insira um qualificador, 1–4 caracteres alfanuméricos (0–9 ou A–Z). Por exemplo, AAAA. Consulte a referência de códigos qualificadores EDI para valores comumente usados.

  • ID EDI: Insira o identificador EDI (ISA) de sua empresa, 1–35 caracteres alfanuméricos (0–9 ou A–Z). Por exemplo, ABCD12T, em que um caractere final apenas para teste distingue um ID de ambiente de teste de seu ID de produção.

Clique em Continuar para salvar os valores e prosseguir para adicionar seu primeiro parceiro.

Dica

Se precisar usar um ID EDI diferente, use a guia ID Preferencial (ISA IDs) para adicionar IDs adicionais, atribuir qualquer um como o novo ID e remover os anteriores. Isso é útil se houver erros na entrada do ID inicial ou se um ID alternativo for necessário.

ID Preferencial (ISA IDs)

IDs preferenciais são seus IDs padrão usados para rotear transações EDI para e de seus parceiros comerciais.

Existem dois conjuntos de IDs preferenciais:

  • ID do Parceiro: O ID que os parceiros comerciais usam com todos os seus fornecedores.

  • ID EDI: Seu ID interno que seu parceiro comercial usa para identificá-lo em sua rede.

Localizar IDs preferenciais

Para localizar os IDs preferenciais de um parceiro, siga estas etapas:

  1. Selecione EDI > Trading Partners.

  2. No painel Trading partners, selecione um parceiro.

  3. Na gaveta de configuração, selecione a aba EDI settings.

  4. Expanda a seção Preferred ID (ISA ID's):

    EDI Settings

Atribuir IDs preferidos

Depois de adicionar um parceiro comercial e criar seu primeiro fluxo de trabalho, os IDs padrão (ID do parceiro e ID EDI) são atribuídos automaticamente. Você pode reatribuir qualquer um dos IDs clicando no ícone Assign para qualquer outro ID atribuído.

O sistema usa os IDs atribuídos em transações EDI de saída ao processá-las, a menos que você os substitua.

Excluir ou substituir um ID

Durante a configuração da conta, um ID EDI é criado. Embora seja uma prática recomendada evitar usar seu ID EDI de produção em ambientes de teste ou QA (reservando-o para produção), isso nem sempre é possível.

Se você precisar de um ID EDI diferente, existem duas opções:

  • Se você quiser um ID diferente (como um ID de teste), crie e atribua o novo ID EDI, exclua o original e reutilize o ID original em outro ambiente.

  • Use um novo ambiente dentro de sua organização atual, crie um novo ID EDI e exclua o ambiente original.

Usar IDs preferidos em transações

Transações de entrada

Todos os IDs preferidos em sua lista são válidos e podem ser usados para transações de entrada, independentemente de estarem atribuídos ou não. Isso é importante para testes e para quando parceiros comerciais ou seus sistemas internos têm diferentes subsidiárias ou empresas para as quais você deseja rotear dados.

Transações de saída

Ao enviar transações de saída para seus parceiros comerciais, os IDs preferidos atribuídos são usados na transformação como valores padrão em suas transações EDI de saída. No entanto, você tem a opção de substituir os IDs preferidos atribuídos por qualquer outro ID preferido. Isso pode ser necessário se os IDs do parceiro comercial ou seus IDs internos precisarem ser alterados para se alinhar com uma subsidiária ou outra entidade dentro de seu negócio ou do seu parceiro comercial.

Substituir um ID preferido em transações de saída

Para substituir os IDs, você deve definir os seguintes valores na transformação de solicitação usada como entrada para uma atividade EDI for Cloud v2 Send Document no Studio:

ID Qualifier ISA ID
EDI ID ISA05_ID_Qualifier ISA06_Sender_ID
Partner ID ISA07_ID_Qualifier ISA08_Receiver_ID

Dica

Para transações de saída, os IDs de remetente e destinatário são invertidos em comparação com transações de entrada.

Para a posição desses elementos no segmento ISA bruto, consulte a referência do cabeçalho/trailer de controle de intercâmbio.

Exemplo

As duas imagens abaixo mostram uma transformação e o conteúdo da transformação com os IDs substituídos:

Example ISA outbound fulfillment

Example transformation expanded

Importante

Os valores definidos em uma transformação são usados para todas as transações de saída no fluxo de trabalho.

Solução de problemas

Para solução de problemas relacionada, consulte o seguinte no guia de solução de problemas EDI: