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.)

Este guia o orienta pelas seguintes tarefas:

1. Reunir informações
2. Gerar um ID EDI e adicionar um parceiro
3. Criar um ou mais fluxos de trabalho
4. Configurar definições de EDI
5. Preparar um arquivo EDI
6. Configurar comunicações
7. Verificar
8. 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.

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 usá-las, 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 EDI e adicionar um parceiro

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

Para adicionar seu primeiro parceiro e gerar seu ID EDI, siga estas etapas:

1. Selecione EDI > Parceiros comerciais no menu do portal Harmony. A página Parceiros comerciais é aberta:

   

2. Clique em Novo > Parceiro. A gaveta Adicionar parceiro comercial é aberta:

   

3. 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.)

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

   

5. Como esta é a primeira vez que você está configurando o Jitterbit EDI no ambiente selecionado, a caixa de diálogo Gerando seu ID EDI é aberta. Digite o código qualificador e o 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.

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

7. Para fechar a gaveta Adicionar parceiro comercial, clique no ícone Fechar.

8. Selecione o novo parceiro para abrir a gaveta com a aba Gerenciar workflows selecionada:

   

3. Criar um ou mais workflows

Após adicionar um parceiro, você pode definir (pelo menos um, mas geralmente muitos) workflows para o parceiro.

Para criar um workflow, siga estas etapas:

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

   

2. Defina os seguintes campos:

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

     Dica

     Quando a direção é Outbound, há também uma chave Validação. Se você ativar isso, o formato do documento é 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 a ID EDI.)

   • Versão: 4010

   • Ativo: Ativado

   

3. Clique no botão Salvar.

4. Configurar definições de EDI

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

Para configurar as definições de envelope EDI, siga estas etapas (consulte o guia de implementação do seu parceiro para 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, selecione a aba Definições de EDI e clique no ícone Expandir para expandir a gaveta.

2. Abra cada seção na gaveta expandida e 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. Preparar um arquivo EDI

Para esta etapa, você precisará obter um arquivo de teste do seu parceiro comercial. Se não conseguir obter um, use o exemplo 850 4010, mas certifique-se de alterar as 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. A ID do Parceiro e a ID EDI estão na seção ID Preferido (IDs ISA) da aba Definiçõ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 oferece suporte a 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 ícone Expandir para expandir a gaveta.

3. Clique no botão Criar e selecione Conexão FTP. O painel Criar uma nova conexão FTP aparece:

   

4. Insira valores para os seguintes campos:

   

   • Nome: Um nome para a conexão.
   • Login: O nome de usuário do servidor FTP.
   • Senha: A senha do 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. (O firewall deve permitir tráfego na porta.)
   • Protocolo: Selecione FTP.
   • Segurança: Selecione o tipo de segurança: Explícito, Implícito ou Nenhum.
   • Modo: Selecione o modo FTP: Ativo ou Passivo.

5. Ative a chave Ativo.

6. Expanda a aba Opções adicionais e ative a chave Download ativo.

7. Expanda a aba Automação.

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

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

10. Na pasta raiz do servidor FTP, crie duas subpastas: Download e Upload. Se 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 o documento foi enviado e a transação de teste foi processada com sucesso, procure por ela na página Transações:

Se não a encontrar, abra a página Mensagens, onde deverá ver a transação e o motivo da falha:

8. Integrar

Depois que o Jitterbit EDI estiver se comunicando com sucesso com parceiros e processando documentos, é possível usar o Studio para automatizar outros processos que possam ser necessários 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 as configurações do Jitterbit EDI.

2. Selecione 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 as configurações do Jitterbit EDI e 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 em 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 Get Document:

   1. Na etapa 1, selecione o parceiro comercial e clique no botão Próximo.

   2. Na etapa 2, selecione o documento e clique no botão Próximo.

   3. 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 relacionada, consulte o seguinte no guia de solução de problemas de EDI:

• Token de acesso EDI desativado causa erro INVALID_TOKEN

• A atividade EDI for Cloud v2 falha em um agente privado atrás de um firewall ou proxy