Guia para começar com 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.)

Este guia o levará pelas seguintes tarefas:

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

1. Coletar 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.

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. (Conexões AS2 e VAN não são abordadas neste guia. Se você precisar usar essas, consulte Configurações de comunicação, ou entre em contato com o suporte Jitterbit ou seu Gerente de Sucesso do Cliente (CSM).)

• Um documento de teste EDI.

2. Gerar um ID ISA e adicionar um parceiro

Por padrão, não há parceiros configurados no Jitterbit EDI. Na primeira vez que você adicionar um, será solicitado que você gere um ID ISA.

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 é aberta (com um painel Trading Partners vazio):

   

2. Clique no ícone Adicionar no painel Trading Partners (à esquerda) ou no botão Adicionar Parceiro Comercial (no meio). O painel Adicionar um Parceiro Comercial é aberto:

   

3. Esta página lista mais de 1000 parceiros prontos para serem adicionados ao seu ambiente. Para procurar o que você deseja, insira 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.)

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

   

5. Como esta é a sua primeira vez configurando o Jitterbit EDI no ambiente selecionado, a seguinte tela será aberta:

   

   Dica

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

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

   Importante

   Não use seu ID de produção em um ambiente de QA ou teste.

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

8. Para fechar a tela Adicionar um Parceiro Comercial, clique no ícone Fechar.

9. Selecione o novo parceiro no painel Trading Partners (à esquerda). Na área principal, a aba Gerenciar fluxos de trabalho está selecionada:

   

3. Criar um ou mais fluxos de trabalho

Uma vez que um parceiro é adicionado, você pode definir (pelo menos um, mas geralmente muitos) fluxos de trabalho para o parceiro.

Para criar um fluxo de trabalho, siga estas etapas:

1. Com o novo parceiro selecionado, clique no botão Adicionar Novo Fluxo de Trabalho. Uma linha vazia é adicionada à lista de fluxos de trabalho:

   

2. Clique no menu Mapear processamento, em seguida, 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, também há um interruptor de Validação. Se você ativar isso, o formato do documento é verificado antes do envio.

   • Padrão EDI: X12

   • Tipo de documento: 850 (Nota: Para esta configuração, use X12 como seu padrão EDI e consulte seu guia de implementação ou pergunte ao seu parceiro comercial sobre o qualificador e o ID ISA.)

   • Versão: 4010

   • Ativo: Habilitado

   

3. Clique no botão Salvar.

4. Configurar as configurações EDI

Quando você adiciona um fluxo de trabalho, a aba Configurações EDI mostra campos aplicáveis a qualquer configuração que você usou para Padrão EDI (X12 neste caso) para o primeiro fluxo de trabalho listado na aba Gerenciar Fluxos de Trabalho. (Até que você crie seu primeiro fluxo de trabalho, a aba de configurações EDI está vazia.) Esses campos são as configurações de envelope EDI, usadas para processar documentos EDI de saída.

Para configurar as configurações do envelope EDI, siga estas etapas (consulte o guia de implementação do seu parceiro para orientações sobre os 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 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 EDI do parceiro:

   

3. Clique no botão Salvar.

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 exemplo 850 4010, mas certifique-se de alterar os IDs do arquivo para corresponder às suas configurações EDI.

Este exemplo explica como criar o cabeçalho adequado para o seu arquivo de teste. O ID do Parceiro e o ID da Empresa estão na seção IDs Preferenciais da aba Configurações EDI:

6. Configure as 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 (Protocolo de Transferência de Arquivos), AS2 (Declaração de Aplicabilidade 2) ou usando a própria VAN (Rede de Valor Agregado) do Jitterbit.

Siga estas etapas para configurar uma conexão FTP:

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

   

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

   

3. Insira valores nos 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 foi definida.
   • Endereço: O endereço IP ou nome do host 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 Explícito, Implícito ou Nenhum.
   • Modo: Selecione o modo FTP, Ativo ou Passivo.

4. Ative o interruptor Ativo.

5. Expanda a aba Opções adicionais, em seguida, ative o interruptor Download ativo.

6. Expanda a aba Automação.

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

8. Na aba Automação, clique no ícone de calendário no campo Próxima execução, em seguida, 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 na pasta Download.

7. Verificar

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

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

8. Integrar

Uma vez que o Jitterbit EDI esteja se comunicando com sucesso com os parceiros e processando documentos, você pode usar o Integration Studio para automatizar os outros processos que pode precisar realizar 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 do Jitterbit EDI.

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

3. Clique no botão Novo Projeto.

4. Insira um nome para o projeto, selecione o mesmo ambiente usado para suas configurações do Jitterbit EDI e, em seguida, clique no botão Começar a projetar.

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

6. Na configuração do 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 sob Endpoints disponíveis, clique no endpoint Jitterbit EDI V2, e arraste e solte a atividade Obter Documento em uma operação na tela de design.

8. Configure a atividade Obter Documento:

   1. No passo 1, selecione o parceiro comercial e clique no botão Próximo.

   2. No passo 2, selecione o documento e clique no botão Próximo.

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