Guia para começar a usar o 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 estiver familiarizado com EDI, este guia deve ajudá-lo com algumas das nuances associadas a EDI e à solução Jiterbit EDI. No entanto, se você já trabalhou com EDI antes, talvez queira pular diretamente para a seção Configuração, que foca na configuração da solução Jitterbit EDI.

Este guia leva você pelas seguintes tarefas:

1. Reunir informações
2. Gerar um ID ISA e adicionar um parceiro
3. Criar um ou mais workflows
4. Configurar configurações de EDI
5. Preparar um arquivo EDI
6. Configurar comunicações
7. Verificar
8. Integrar EDI

1. Reúna informações

Você deve coordenar com cada um dos 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 que você precisará:

• O Guia de implementação EDI do seu parceiro comercial.

• As Informações de conexão FTP do seu parceiro comercial. (As conexões AS2 e VAN não são abordadas neste guia. Se você precisar usá-las, consulte Configurações de comunicação, ou entre em contato com suporte Jitterbit ou seu Gerente de Sucesso do Cliente (CSM).)

• Um documento de teste EDI.

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 o Electronic Data Interchange (EDI) para trocar documentos comerciais entre parceiros comerciais. Ele 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 essenciais para garantir que ambas as partes possam se comunicar e trocar dados eletronicamente com sucesso de forma padronizada e eficiente.

2. Gere um ID ISA e adicione um parceiro

Pronto para uso, não há parceiros configurados no Jitterbit EDI. Na primeira vez que você adiciona um, você é solicitado a gerar um ISA ID.

O que é um Isa Id?

Um ISA ID serve para identificar o remetente ou destinatário de uma transação EDI. Cada transação inclui um ISA ID 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 ISA, siga estas etapas:

1. Selecione EDI > Admin no menu do portal Harmony. A página Admin abre (com um painel Trading Partners vazio):

   

2. Clique em Ícone Adicionar no painel Parceiros Comerciais (esquerda) ou no botão Adicionar Parceiro Comercial (meio). O painel Adicionar um Parceiro Comercial abre:

   

3. Esta página lista mais de 1000 parceiros prontos para serem adicionados ao seu ambiente. Para procurar o que você quer, insira o nome ou ID do parceiro na barra de pesquisa. (Se o parceiro que você quer não existir no sistema, você deve criá-lo você mesmo.)

4. Quando encontrar o parceiro que deseja, passe o mouse sobre ele e clique no botão Adicionar:

   

5. Como esta é a primeira vez que você configura o Jitterbit EDI no ambiente selecionado, a seguinte tela é aberta:

   

   Dica

   Você não verá isso novamente a menos que configure o Jitterbit EDI em um novo ambiente.

6. Selecione o código qualificador da sua organização e insira o ID ISA da sua empresa.

   Importante

   Não use sua ID de produção em um ambiente de controle de qualidade ou teste.

7. Quando tiver certeza dos seus códigos, clique no botão Salvar.

8. Para fechar a tela Adicionar um parceiro comercial, clique em Ícone Fechar.

9. Selecione o novo parceiro no painel Trading Partners (esquerda). Na área principal, a aba Manage workflows é selecionada:

   

3. Crie um ou mais workflows

Depois que um parceiro é adicionado, você pode definir (pelo menos um, mas geralmente muitos) workflows para o parceiro.

O que é um Fluxo de trabalho?

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, denotado como Inbound ou Outbound).

Para criar um workflow, siga estas etapas:

1. Com o novo parceiro selecionado, clique no botão Add New Workflow. Uma linha vazia é adicionada à lista de workflows:

   

2. Clique no menu Processamento de mapa e selecione EDIXml. Isso revela mais campos. Defina-os da seguinte forma:

   • Direção: Entrada. (Confirme isso com o guia de implementação ou com seu parceiro comercial.)

     Dica

     Quando a direção é Saída, há também um interruptor Validação. Se você ativar isso, o formato do documento será verificado antes do envio.

   • Padrão EDI: X12

   • Tipo de documento: 850 (Observação: para esta 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 ID ISA.)

   • Versão: 4010

   • Ativo: Habilitado

   

3. Clique no botão Salvar.

4. Configurar as definições de EDI

Quando você adiciona um workflow, a aba Configurações de EDI mostra campos aplicáveis a qualquer configuração usada para EDI Padrão (X12 neste caso) para o primeiro workflow listado na aba Gerenciar Workflows. (Até você criar seu primeiro workflow, a aba Configurações de EDI estará vazia.) Esses campos são as configurações de envelope de EDI, usadas para processar documentos EDI de saída.

O que são Edi Configurações de envelope?

As configurações de envelope são usadas para estruturar e transmitir documentos eletrônicos entre parceiros comerciais. Essas configurações definem 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 normalmente inclui informações sobre o remetente, destinatário, tipo de mensagem e instruções de roteamento.

Para configurar as configurações do envelope EDI, siga estas etapas (consulte o guia de implementação do seu parceiro para obter orientação sobre valores e a seção de referência de envelopes EDI para detalhes de cada campo):

1. Com o novo parceiro selecionado no painel Admin > Parceiros comerciais, selecione a aba Configurações de EDI:

   

2. Expanda todas as seções e, em seguida, verifique ou altere os valores de acordo com os detalhes no guia de implementação de EDI do parceiro:

   

3. Clique no botão Salvar.

Bom saber

Essas configurações tornam desnecessário fornecer essas informações diretamente em transformações do Integration Studio envolvendo transações EDI de saída.

5. Prepare um arquivo EDI

Para esta etapa, você precisará obter um arquivo de teste do seu parceiro comercial. Se não conseguir um, use o sample 850 4010, mas certifique-se de alterar os IDs do arquivo para corresponder às suas configurações de EDI.

Este exemplo explica como criar o cabeçalho apropriado para seu arquivo de teste. O ID do parceiro e o ID da empresa estão na seção IDs preferenciais da aba Configurações de EDI:

6. Configurar comunicações

O guia de implementação do seu parceiro deve descrever como enviar e receber arquivos com o parceiro. O Jitterbit EDI suporta comunicações com FTP (File Transfer Protocol), AS2 (Declaração de aplicabilidade 2), ou usando a própria VAN (Rede de Valor Agregado) da Jitterbit.

Dica

Você só pode usar 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:

1. Com o novo parceiro selecionado, selecione a aba Configurações de comunicações:

   

2. Clique em Criar botão, então selecione Conexão FTP. O painel Criar uma nova conexão FTP aparece:

   

3. Insira valores para os seguintes campos:

   

   • Nome: Um nome para a conexão.
   • Login: O nome de usuário para o servidor FTP.
   • Senha: A senha para o servidor FTP. Deixe em branco se nenhuma senha tiver sido definida.
   • Endereço: O endereço IP ou nome do hospedar do servidor FTP.
   • Porta: O número da porta. (Seu firewall deve permitir tráfego na porta.)
   • Protocolo: Selecione FTP.
   • Segurança: Selecione o tipo de segurança, um dos seguintes: Explícito, Implícito ou Nenhum.
   • Modo: Selecione o modo FTP, Ativo ou Passivo.

4. Ligue o interruptor Ativo.

5. Expanda a aba Opções adicionais e ative a opção Download ativo.

6. Expanda a aba Automação.

7. Na aba Automação, abra o menu Frequência e selecione 15 minutos.

8. Na aba Automação, clique em ícone de calendário no campo Próxima execução e selecione uma data e hora para a conexão ser executada.

9. Na pasta raiz do seu servidor FTP, crie duas subpastas, Download e Upload. Se você estiver usando o arquivo de teste neste guia de configuração ou um arquivo de teste do seu parceiro comercial, coloque-o no Download pasta.

Dica

O servidor FTP que está sendo configurado é normalmente hospedado pelo parceiro comercial. Se eles tiverem dados de teste prontos, você pode configurar uma conexão FTP direta com eles, fora do Jitterbit EDI.

7. Verificar

Para verificar se seu documento foi enviado e se a transação de teste foi processada com sucesso, procure-a na página Transações:

Se você não vê-lo, abra a página de mensagens, onde você deve ver a transação e o motivo da falha:

8. Integrar

Depois que o Jitterbit EDI estiver se comunicando com sucesso com os parceiros e processando documentos, você pode usar o Integration Studio para automatizar os outros processos que você pode precisar fazer após enviar ou receber um documento EDI.

Para criar um projeto de integração EDI, siga estas etapas:

1. Crie um token de acesso para EDI, selecionando o mesmo ambiente usado para suas configurações de EDI do Jitterbit.

2. Selecione Integration Studio > Projetos no menu do portal Harmony.

3. Clique no botão Novo Projeto.

4. Insira um nome de projeto, selecione o mesmo ambiente usado para suas configurações do Jitterbit EDI e clique no botão Iniciar design.

5. Na paleta de componentes de design do projeto aberto barra de pesquisa, digite EDI for Cloud v2 e selecione o conector encontrado.

6. Na configuração de endpoint EDI for Cloud v2, insira o token de acesso e clique no botão Salvar alterações.

7. Na paleta de componentes de design em endpoints disponíveis, clique no endpoint Jitterbit EDI V2 e arraste e solte a atividade Obter documento em uma operação na quadro de design.

8. Configure a atividade Obter documento:

   1. Na etapa 1, selecione o parceiro comercial e clique no botão Avançar.

   2. Na etapa 2, selecione o documento e clique no botão Avançar.

   3. Na etapa 3, verifique o esquema de dados e clique no botão Concluído.