Ir para o conteúdo

Configurações de comunicação no Jitterbit EDI

Introdução

O Jitterbit EDI utiliza os protocolos de comunicação FTP e AS2 para trocar documentos com parceiros.

Não há configurações padrão para nenhum dos protocolos, portanto, você deve configurá-los por conta própria. Isso é feito na página de Administração do EDI, na aba Configurações de comunicação:

Configurações de comunicação

Você pode atribuir qualquer conexão a qualquer parceiro. Quando você exclui parceiros, suas conexões são preservadas.

Serviço VAN do Jitterbit

O serviço VAN do Jitterbit é uma conexão gerenciada. Para configurá-lo, entre em contato com o suporte do Jitterbit ou com seu Gerente de Sucesso do Cliente (CSM). Quando configurado, você pode atribuir a um parceiro.

Filtrar conexões

Por padrão, você só pode ver conexões que estão ativas e atribuídas. Para ver outras conexões, use a barra de ferramentas de filtro:

Barra de ferramentas de filtros

Ela é composta por:

  • Barra de pesquisa: Digite texto para buscar uma conexão.
  • Menu de conexão: Abra o menu e selecione Selecionar todas as conexões para selecionar todas as opções, ou selecione uma ou mais das seguintes opções:
    • AS2: Conexões AS2.
    • FTP: Conexões FTP.
    • Serviço VAN: Conexões do serviço VAN.
  • Menu de status: Abra o menu e selecione Selecionar todos os status para selecionar todas as opções, ou selecione uma ou mais das seguintes opções:
    • Ativo: Conexões ativas.
    • Inativo: Conexões inativas.
    • Atribuído: Conexões atribuídas (selecionado por padrão).
    • Não atribuído: Conexões não atribuídas.

Criar uma conexão FTP

Para criar uma conexão FTP, siga estas etapas:

  1. Clique no botão Novo , em seguida, selecione Conexão FTP. O painel Criar uma nova conexão FTP aparece (destacado):

    Nova conexão FTP

  2. Defina os seguintes interruptores:

    • Verificação de Transação Duplicada: Ative para verificar transações duplicadas transmitidas por meio desta conexão.
    • Ativo: Ative para tornar a conexão disponível para uso. (Isso também revela a aba Automação.)
  3. No grupo de configurações básicas, defina valores para os seguintes campos:

    Opções básicas

    • Nome: Um nome para a conexão.
    • Login: O nome de usuário para o servidor FTP.
    • Senha: (Opcional.) 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 como um inteiro positivo. (Seu firewall deve permitir tráfego na porta.)
    • Protocolo: FTP ou SFTP.
    • Segurança: O tipo de segurança, um dos Explícito, Implícito ou Nenhum.
    • Modo: O modo FTP, Ativo ou Passivo.
  4. (Opcional) Expanda o painel Opções Adicionais, e então defina valores para os seguintes campos:

    Opções adicionais

    • Configurações SSL: Configurações SSL adicionais.
    • Máscara de recuperação: Uma máscara de nome de arquivo.
    • Enviar chave privada: Ative para autenticar um cliente quando ele se conecta a um servidor SFTP.
    • Download ativo: Ative para usar o modo FTP ativo. Desative para usar o modo FTP passivo.
    • Excluir arquivo após download: Ative para excluir o arquivo do servidor FTP após ter sido baixado.
  5. Expanda a aba Detalhes Remotos, e então defina valores para os seguintes campos:

    Detalhes remotos

    • Pasta de download remota: A pasta no servidor remoto de onde os arquivos são baixados.
    • Pasta de upload remota: A pasta no servidor remoto para onde os arquivos são enviados.
    • Nome do arquivo de upload remoto: O nome do arquivo para arquivos enviados. Você também pode incluir qualquer um dos parâmetros de nome de arquivo suportados para gerar o nome de arquivo que deseja.
    • Extensão do arquivo de upload remoto: A extensão do nome do arquivo para arquivos enviados, seja .edi ou .xml.
    • Índice inicial do nome do arquivo de download remoto: O índice inicial do nome do arquivo de download remoto. 001 é recomendado.
    • Índice final do nome do arquivo de download remoto: O índice final do nome do arquivo de download remoto. 999 é recomendado.
  6. (Opcional) Para testar a conexão, clique no botão Testar conexão. Este botão fica ativo quando todos os campos obrigatórios estão preenchidos. (Isso não se aplica a conexões SFTP.)

  7. Quando a conexão estiver ativa, a aba Automação se torna visível:

    Automação

    Para definir com que frequência e quando executar uma conexão FTP, defina valores para os seguintes campos:

    • Frequência: Com que frequência executar o serviço FTP. Selecione uma das opções 15 minutos, 1 Hora, 12 Horas, Diariamente ou Semanalmente.
    • Próxima execução: Quando executar o serviço novamente. Selecione qualquer um dos campos de data-hora e insira um valor numérico, ou clique no ícone de calendário para escolher uma data e hora.
  8. Clique no botão Salvar. A nova conexão agora está pronta para você atribuir a um parceiro.

Criar uma conexão AS2

Importante

Para habilitar a comunicação AS2, seu parceiro deve configurar seu firewall (adicionar ao seu whitelist) o endereço IP 40.71.22.62.

Para criar uma conexão AS2, siga estas etapas:

  1. Clique no botão Novo , em seguida, selecione Conexão AS2. O painel Criar uma nova conexão AS2 aparece (destacado):

    Nova conexão AS2

  2. Defina os seguintes interruptores:

    • Verificação de Transação Duplicada: Ative para verificar transações duplicadas transmitidas por meio desta conexão.
    • Ativo: Ative para tornar a conexão disponível para uso.
  3. No grupo de configurações básicas, defina valores para os seguintes campos:

    Configurações básicas

    • Nome: O nome da conexão.
    • URL de Envio: A URL fornecida pelo parceiro comercial para enviar documentos através da conexão AS2. Deve ser incluída como parte da configuração AS2.

      URLs de Recepção

      Você também deve fornecer ao seu parceiro comercial uma dessas URLs de recepção, de acordo com a região da sua conta Harmony:

      • América do Norte: na.as2.jitterbitedi.com/receiver.aspx
      • EMEA: emea.as2.jitterbitedi.com/receiver.aspx
    • Tempo limite de conexão: O tempo limite de conexão inicial.

    • ID da empresa AS2: O identificador da empresa AS2.
    • ID do parceiro AS2: O identificador do parceiro AS2.
  4. (Opcional) Expanda a aba Configurações de Proxy, e então defina valores para os seguintes campos:

    Configurações básicas

    • Proxy: Ativar o servidor proxy.
    • Endereço: O endereço do servidor proxy.
    • Domínio: O domínio do servidor proxy.
    • Nome de usuário: O nome de usuário do servidor proxy.
    • Senha: A senha do servidor proxy.
  5. (Opcional) Expanda a aba Configurações HTTP, e então defina valores para os seguintes campos:

    Configurações HTTP

    • Autenticação: Ativar a autenticação HTTP.
    • Tipo de Autenticação: O tipo de autenticação HTTP. Selecione um dos seguintes:
      • Básica: Usar credenciais codificadas em base64 não criptografadas (RFC 2617).
      • Digest: Usar credenciais codificadas em base64 criptografadas (RFC 2617).
    • Usuário de autenticação: O nome de usuário para autenticação HTTP.
    • Senha de autenticação: A senha para autenticação HTTP.
    • Assunto: O assunto descrevendo o propósito do endpoint.
  6. (Opcional) Expanda a aba Configurações de Criptografia, e então defina valores para os seguintes campos:

    Configurações de Criptografia

    • Algoritmo de assinatura: O algoritmo de assinatura.
    • Algoritmo de criptografia: O algoritmo de criptografia.
    • Assinar: Ativar para rejeitar mensagens de entrada não assinadas.
    • Criptografar: Ativar para rejeitar mensagens de entrada não criptografadas.
    • Solicitar MDN: Solicitar um MDN (notificação de disposição de mensagem).
    • Solicitar MDN assinado: Solicitar um MDN assinado.
    • Compactar: Ativar para usar compressão ZLIB.
  7. (Opcional) Expanda a aba Certificado:

    Certificado

    A aba possui duas regiões:

    • Meus certificados: Certificados para sua organização. Estes são certificados privados, que devem estar no formato pfx, e contêm apenas chaves privadas.
    • Certificados do parceiro: Certificados para o parceiro comercial. Estes são certificados públicos, que devem estar no formato .cer, e contêm apenas chaves públicas.

    Certificados carregados ou criados aparecem como uma linha, mostrando o nome, a data de expiração e os seguintes ícones:

    • Atribuir: Atribuir o certificado à conexão.
    • Baixar: Baixar o certificado como um arquivo .cer.
    • Excluir: Excluir o certificado. Para confirmar a ação, digite a palavra DELETE no campo de texto do diálogo e, em seguida, clique no botão Excluir.

    Para carregar um certificado, siga estas etapas:

    1. Clique no ícone Carregar para qualquer uma das partes.
    2. No painel que se abre, insira os valores para Nome do certificado e Senha:

      Carregar certificado

    3. Clique no botão Carregar arquivo, em seguida, selecione o arquivo do certificado. (Os tipos de arquivo aceitos são .cer e .pfx.)

    4. No painel Carregar certificado, clique no botão Salvar.

    Para criar um certificado para sua organização, siga estas etapas:

    1. Clique no ícone Criar.
    2. No painel que se abre, insira os valores para Nome do certificado e Anos de validade

      Criar certificado

    3. No painel Criar um novo certificado, clique no botão Salvar.

  8. No painel Criar uma nova conexão AS2, clique no botão Salvar. A nova conexão agora está pronta para você atribuir a um parceiro.

Gerenciar conexões

Atribuir

Para atribuir uma conexão, selecione um parceiro no painel de parceiros comerciais, em seguida clique em Atribuir.

A palavra Atribuído e uma marca de verificação aparecem em verde na conexão para mostrar que agora está atribuída ao parceiro atualmente selecionado.

Nota

Muitos parceiros podem usar a mesma conexão, mas um parceiro pode ter apenas uma conexão atribuída por vez.

Editar

Para editar uma conexão, clique no ícone Editar de uma conexão.

Edite os detalhes da conexão e, em seguida, clique em Salvar.

Excluir

Para excluir uma conexão, clique no ícone Excluir. Para confirmar a ação, digite a palavra DELETE no campo de texto do diálogo e, em seguida, clique no botão Excluir.

Nota

Conexões atribuídas não podem ser excluídas. Para excluir uma conexão atribuída, atribua uma diferente ao parceiro selecionado.