Guia de introdução ao Jitterbit EDI
Introdução
Este guia mostra como configurar o Jitterbit EDI para processar uma transação X12 850 4010. (Você pode usar outro documento ou padrão, mas as configurações são diferentes.)
Dica
Se você não está familiarizado com EDI, este guia deve ajudá-lo com algumas das nuances associadas ao EDI e à solução Jitterbit EDI. No entanto, se já trabalhou com EDI, você pode querer ir diretamente para a seção Configuração, que se concentra na configuração da solução Jitterbit EDI, ou experimentar o Assistente de IA EDI.
Este guia orienta você pelas seguintes tarefas:
- Reunir informações
- Gerar um ID EDI e adicionar um parceiro
- Criar um ou mais fluxos de trabalho
- Configurar parâmetros EDI
- Preparar um arquivo EDI
- Configurar comunicações
- Verificar
- Integrar EDI
1. Reunir informações
Você deve coordenar com cada um de seus parceiros comerciais para agendar testes e obter seus guias de implementação, preferências de comunicação e arquivos de teste.
Dica
Nem sempre é possível obter tudo o que você precisa. Esteja disposto a se adaptar e improvisar.
Estas são as coisas mais importantes de que você precisará:
-
O guia de implementação EDI do seu parceiro comercial.
-
As informações de conexão FTP do seu parceiro comercial. (Conexões AS2 e VAN não são abordadas neste guia. Se precisar usar estas, consulte Comunicações, ou entre em contato com o suporte do Jitterbit ou seu Gerente de Sucesso do Cliente (CSM).)
O que é um guia de implementação EDI?
Um guia de implementação EDI é um documento que fornece instruções detalhadas sobre como configurar e usar Electronic Data Interchange (EDI) para trocar documentos comerciais entre parceiros comerciais. Especifica o formato, a estrutura e os protocolos a serem usados, e fornece quaisquer regras comerciais, diretrizes e especificações técnicas que devem ser seguidas. Esses guias são críticos para garantir que ambas as partes possam comunicar e trocar dados eletronicamente com sucesso de maneira padronizada e eficiente.
2. Gerar um ID EDI e adicionar um parceiro
Imediatamente, não há parceiros configurados no Jitterbit EDI. Na primeira vez que você adiciona um, é solicitado que gere um ID EDI.
O que é um ID EDI?
Um ID EDI funciona para identificar o remetente ou destinatário de uma transação EDI. Cada transação inclui um ID EDI para o remetente e o destinatário, acompanhado por um código qualificador, que fornece informações adicionais.
Para adicionar seu primeiro parceiro e gerar seu ID EDI, siga estas etapas:
-
Selecione EDI > Parceiros comerciais no menu do portal Harmony. A página Parceiros comerciais é aberta:
-
Clique em Novo > Parceiro. A gaveta Adicionar parceiro comercial é aberta:
-
Esta página lista mais de 1000 parceiros prontos para serem adicionados ao seu ambiente. Para procurar o que você deseja, digite o nome ou ID do parceiro na barra de pesquisa. (Se o parceiro que você deseja não existir no sistema, você deve criá-lo você mesmo.)
-
Quando encontrar o parceiro desejado, passe o mouse sobre ele e clique em seu botão Adicionar:
-
Como esta é sua primeira vez configurando o Jitterbit EDI no ambiente selecionado, a caixa de diálogo Gerando seu ID EDI é aberta. Digite o código qualificador e ID EDI da sua organização.
Dica
Você não verá isso novamente a menos que configure o Jitterbit EDI em um novo ambiente.
Importante
Não use seu ID de produção em um ambiente de QA ou teste.
-
Quando tiver certeza de seus códigos, clique no botão Salvar.
-
Para fechar a gaveta Adicionar parceiro comercial, clique no ícone Fechar.
-
Selecione o novo parceiro para abrir a gaveta com a guia Gerenciar workflows selecionada:
3. Crie um ou mais workflows
Após adicionar um parceiro, você pode definir (pelo menos um, mas geralmente vários) workflows para o parceiro.
O que é um workflow?
Um workflow define o tipo de documento enviado ou recebido de um parceiro e como ele é processado. Você precisará de um workflow para cada tipo de documento e direção distintos (para ou do parceiro, denominados Inbound ou Outbound).
Para criar um workflow, siga estas etapas:
-
Com o novo parceiro selecionado, clique em Novo > Workflow. Uma linha vazia é adicionada à lista de workflows, com Processamento de mapa definido como EDIXml por padrão:
-
Defina os seguintes campos:
-
Direction: Inbound. (Confirme isso com o guia de implementação ou com seu parceiro comercial.)
Dica
Quando a direção é Outbound, também há um botão Validation. Se você ativar isso, o formato do documento será verificado antes do envio.
-
EDI Standard: X12
-
Document type: 850 (Observação: Para essa configuração, use X12 como seu padrão EDI e consulte o guia de implementação ou peça ao seu parceiro comercial o qualificador e o EDI ID.)
-
Version: 4010
-
Active: On
-
-
Clique no botão Save.
4. Configure as definições de EDI
Quando você adiciona um workflow, a guia EDI settings mostra campos aplicáveis a qualquer configuração que você tenha usado para EDI Standard (X12 neste caso) para o primeiro workflow listado na guia Manage workflows. (Até você criar seu primeiro workflow, a guia EDI settings fica vazia.) Esses campos são as definições de envelope de EDI, usadas para processar documentos EDI de saída.
O que são as definições de envelope de EDI?
As definições de envelope são usadas para estruturar e transmitir documentos eletrônicos entre parceiros comerciais. Essas definições determinam como os dados são empacotados, endereçados e roteados em uma transmissão EDI, garantindo que os documentos sejam identificados e processados adequadamente pelo sistema do destinatário. O envelope EDI geralmente inclui informações sobre o remetente, destinatário, tipo de mensagem e instruções de roteamento.
Para configurar as definições de envelope EDI, siga estas etapas (consulte o guia de implementação de seu parceiro para obter orientação sobre valores e a seção de referência de envelopes EDI para detalhes de cada campo):
-
Com o novo parceiro selecionado, selecione a guia EDI settings e clique no ícone Expand para expandir a gaveta.
-
Abra cada seção na gaveta expandida e depois verifique ou altere os valores de acordo com os detalhes no guia de implementação EDI do parceiro:
-
Clique no botão Save.
Bom saber
Essas definições tornam desnecessário fornecer essas informações diretamente em transformações do Studio envolvendo transações EDI de saída.
5. Prepare um arquivo EDI
Para essa etapa, você precisará obter um arquivo de teste de seu parceiro comercial. Se não conseguir obter um, use o 850 de amostra 4010, mas certifique-se de alterar os IDs do arquivo para corresponder às suas definições de EDI.
Este exemplo explica como criar o cabeçalho apropriado para seu arquivo de teste. O Partner ID e o EDI ID estão na seção Preferred ID (ISA ID's) da guia EDI settings:

6. Configure as comunicações
O guia de implementação de seu parceiro deve descrever como enviar e receber arquivos com o parceiro. O Jitterbit EDI oferece suporte a comunicações com FTP (File Transfer Protocol), AS2 (Applicability Statement 2) ou usando a própria VAN (Value-Added Network) do Jitterbit.
Dica
É possível usar apenas um método de comunicação com um parceiro, mas as conexões podem ser reutilizadas com outros parceiros.
Siga estas etapas para configurar uma conexão FTP:
-
Use o menu do portal Harmony para selecionar EDI > Communications:
-
Clique no botão New, então selecione FTP connection. O painel New connection FTP abre:
-
Insira valores para os seguintes campos:
- Name: Um nome para a conexão.
- Login: O nome de usuário do servidor FTP.
- Password: A senha do servidor FTP. Deixe em branco se nenhuma senha foi configurada.
- Address: O endereço IP ou nome do host do servidor FTP.
- Port: O número da porta. (Seu firewall deve permitir tráfego na porta.)
- Protocol: Selecione FTP.
- Security: Selecione o tipo de segurança, um de Explicit, Implicit ou None.
- Mode: Selecione o modo FTP, Active ou Passive.
-
Na seção Additional options, marque a caixa de seleção Download active.
-
Na seção Automation, abra o menu Frequency, então selecione 15 minutes.
-
Na seção Automation, clique no ícone de calendário no campo Next run, então selecione uma data e hora para a conexão ser executada.
-
Clique no botão Save.
-
Selecione a nova conexão. No painel, na aba Trading partners, ative o alternador Assign para o novo parceiro, então clique em Save.
-
Na pasta raiz do servidor FTP, crie duas subpastas,
DownloadeUpload. Se estiver usando o arquivo de teste neste guia de configuração, ou um arquivo de teste do parceiro comercial, coloque-o na pastaDownload.
Dica
O servidor FTP sendo configurado é normalmente hospedado pelo parceiro comercial. Se ele tiver dados de teste prontos, é possível configurar uma conexão FTP direta com ele, fora do Jitterbit EDI.
7. Verify
Para verificar se o documento foi enviado e a transação de teste foi processada com sucesso, procure por ela na página Transactions:
Se não vir, abra a página Messaging, onde deve ver a transação e o motivo da falha:
8. Integrate
Depois que o Jitterbit EDI se comunicar com sucesso com parceiros e processar documentos, é possível usar o Studio para automatizar outros processos que pode ser necessário fazer após enviar ou receber um documento EDI.
Para criar um projeto de integração EDI, siga estas etapas:
-
Crie um token de acesso para EDI, selecionando o mesmo ambiente usado para as configurações do Jitterbit EDI.
-
Selecione Studio > Projects no menu do portal Harmony.
-
Clique no botão New Project.
-
Insira um nome de projeto, selecione o mesmo ambiente usado para as configurações do Jitterbit EDI, então clique no botão Start designing.
-
Na barra de pesquisa da paleta de componentes de design do projeto aberto, insira EDI for Cloud v2, então selecione o conector encontrado.
-
Na configuração do endpoint EDI for Cloud v2, insira o token de acesso, então clique no botão Save Changes.
-
Na paleta de componentes de design em Available endpoints, clique no endpoint Jitterbit EDI V2, então arraste e solte a atividade Get Document em uma operação na tela de design.
-
Configure a atividade Get Document:
-
Na etapa 1, selecione o parceiro comercial e clique no botão Próximo.
-
Na etapa 2, selecione o documento e clique no botão Próximo.
-
Na etapa 3, verifique o esquema de dados e clique no botão Concluído.
Solução de problemas
Para a solução de problemas relacionados, consulte o seguinte no guia de solução de problemas de EDI:










