Conectar o OpenText Trading Grid: documentos EDI de entrada e saída

Crie a conexão no Integration, em Conexões EDI, preencha o método de transporte, o host, o usuário e a senha ou a chave privada exatamente como estão no seu pacote de integração da OpenText, confira o formato das credenciais, mapeie cada parceiro comercial e ative.

O OpenText Trading Grid é uma plataforma EDI: por ela você troca documentos EDI com seus parceiros comerciais — entram documentos de pedido dos parceiros e saem documentos de embarque e fatura. Esta conexão não é criada num assistente de canal. Ela é criada no Integration, em Conexões EDI, e cada detalhe que ela pede — host, usuário e o restante — vem do pacote de integração que a OpenText entrega quando sua conta é aberta. Não há outro lugar para consultar esses detalhes.

Pré-requisitos#

• Uma conta do OpenText Trading Grid, aberta ou em abertura junto à OpenText. Os detalhes da conexão são emitidos como parte dessa abertura de conta: não são algo que você crie ou consulte por conta própria.
• O pacote de integração da OpenText para a sua conta. Ele traz o host, o usuário e cada outro detalhe de conexão que este guia pede para preencher. Mantenha-o à mão durante toda a configuração: se um detalhe não estiver no pacote, ele está faltando, e a solução é perguntar ao seu contato de integração da OpenText, não adivinhar.
• Um método de transporte, como consta no pacote de integração: SFTP com senha, SFTP com chave privada ou entrega de arquivos (file drop). O pacote decide qual a sua conta usa: os três métodos pedem campos diferentes nas próximas etapas, então saiba qual é o seu antes de começar a preencher.
• Pelo menos um parceiro comercial — um varejista ou outro parceiro — com quem você trocará documentos EDI pelo OpenText. Cada parceiro é mapeado separadamente mais adiante neste guia, usando os identificadores de parceiro e de varejista acordados para aquele parceiro.

Obter credenciais#

1. Faça a abertura de conta com a OpenText. Suas credenciais não são criadas num portal de autoatendimento nem podem ser consultadas em outro lugar: elas são emitidas para você como parte dessa integração.
2. Receba o pacote de integração da sua conta e localize nele o host SFTP e o usuário SFTP. Copie os dois exatamente como estão escritos: esses valores vêm só da OpenText, e um host ou usuário de qualquer outra origem não pertencerá à sua conta.
3. Localize o segredo que corresponde ao seu método de transporte. Se o seu pacote diz SFTP com senha, ele entrega a senha SFTP. Se diz SFTP com chave privada, ele entrega a chave privada SFTP. Se diz entrega de arquivos (file drop), não há senha nem chave privada para coletar para esta conexão.
4. Guarde juntos o pacote e o segredo, e trate a senha ou a chave privada como segredo desde o momento em que a receber: guarde-a em local seguro, não a envie em mensagens em texto puro e deixe-a pronta para colar uma vez, na próxima seção. Se faltar algo que o pacote deveria conter, peça ao seu contato de integração da OpenText que o complete: não preencha a lacuna com um valor de outra conta ou de outro sistema.

Preencher no Integration#

1. Abra Integration → Conexões EDI → Nova conexão e escolha OpenText Trading Grid. A OpenText não tem assistente de canal, então, se você o está procurando numa lista de canais ou de marketplace, está no lugar errado: a conexão fica junto das outras conexões EDI.
2. Método de transporte (transport_method): escolha o que o seu pacote de integração indica — sftp_password para SFTP com senha, sftp_key para SFTP com chave privada ou file_drop para entrega de arquivos. Essa escolha decide quais dos campos abaixo são necessários, então ela precisa coincidir com o pacote, não com o método que parecer mais fácil.
3. Host SFTP (sftp_host): cole o host exatamente como aparece no seu pacote de integração. Não existe um host padrão para digitar de memória: o pacote é a única fonte desse valor, então copie em vez de digitar, e, se o pacote não mostrar nenhum host, pare e pergunte ao seu contato de integração da OpenText em vez de adivinhar um.
4. Usuário SFTP (sftp_username): cole o usuário do mesmo pacote de integração. Ele forma par com o host acima: um usuário de outra conta ou de outro sistema não combinará com ele.
5. Senha SFTP (sftp_password): preencha este campo apenas quando o seu método de transporte for sftp_password. Cole a senha do pacote de integração. Ela é guardada criptografada e nunca é exibida de novo após salvar: se mais tarde precisar trocá-la, você a substitui por um valor novo, em vez de ver a antiga. Para os outros dois métodos, deixe este campo vazio.
6. Chave privada SFTP (sftp_private_key): preencha este campo apenas quando o seu método de transporte for sftp_key. Cole a chave privada inteira do pacote de integração, completa e sem editar: uma chave encurtada ou reformatada é outra chave. Ela é guardada criptografada e nunca é exibida de novo após salvar. Para os outros dois métodos, deixe este campo vazio. Se o seu método for file_drop, nenhum dos dois campos de segredo se aplica: o que importa é que o próprio método de transporte coincida com o pacote.
7. Salve a conexão, mas não trate o salvamento como a linha de chegada. Teste-a em seguida e depois faça o mapeamento de parceiros comerciais: uma conexão com as credenciais completas, mas sem mapeamento de parceiros, continua sem conseguir acomodar os documentos de nenhum parceiro.

Testar a conexão#

Clique em Testar a conexão e leia o resultado pelo que ele realmente cobre. Nesta etapa, a verificação olha apenas para o formato do que você preencheu: para o método que você escolheu, está presente tudo o que esse método precisa — o próprio método de transporte, o host e o usuário, a senha para o método de senha, ou a chave privada para o método de chave? Se faltar algo que esse método precise, a verificação falha e indica a peça que falta. Se você escolheu file_drop, a verificação informará que o endpoint ainda está para ser configurado: com esse método não há nenhum endpoint de servidor para a verificação alcançar, então esse resultado é o esperado e não significa que você preencheu algo errado. E, seja qual for o resultado, tenha claro o alcance dele: um formato de credenciais completo não é prova de que os arquivos já possam se mover. O envio e o recebimento reais de arquivos são ativados junto com a conclusão da sua ligação de integração com a OpenText, então julgue esta etapa apenas como uma conferência de completude do formulário, e use as perguntas frequentes abaixo quando um resultado surpreender você.

Mapping / escolher modelo#

Na OpenText o mapeamento é por parceiro comercial, não uma configuração única para toda a conexão. Para cada parceiro, registre os identificadores pelos quais aquele parceiro é conhecido — o identificador de parceiro e o identificador de varejista acordados para aquele parceiro durante a integração e a configuração do parceiro — e escolha o modelo daquele parceiro, para que os documentos de pedido que chegam sejam reconhecidos como daquele parceiro e mapeados para o pedido padrão, e seus dados de embarque e fatura sejam mapeados de volta para os documentos que aquele parceiro espera. Os identificadores são o ponto: um documento que chega trazendo identificadores que não correspondem a nenhum mapeamento não pode ser acomodado com o parceiro certo, por mais completas que estejam as credenciais da conexão. Trabalhe parceiro por parceiro e use os identificadores exatamente como acordados para cada um: não reutilize os identificadores de um parceiro para outro.

Ativar#

Ative a conexão quando o formulário estiver completo e cada parceiro comercial com quem você pretende começar estiver mapeado. A ativação coloca a conexão, com seu método de transporte e seus mapeamentos de parceiros, em serviço do lado do Integration. Tenha em mente o alcance disso: o envio e o recebimento reais de arquivos pela OpenText são ativados junto com a conclusão da sua ligação de integração com a OpenText, então, se a integração ainda não estiver concluída daquele lado, uma conexão ativada ainda não transportará arquivos — isso é a integração terminando, não uma falha no que você preencheu. Depois que a troca de arquivos estiver ativa, acompanhe os primeiros documentos de cada parceiro em Runs / Logs, parceiro por parceiro, antes de deixar a troca sem supervisão.

Perguntas frequentes#

O teste informa que o endpoint ainda está para ser configurado (file drop)

Esse é o resultado esperado para o método de entrega de arquivos (file drop), não um sinal de que você preencheu algo errado. Com file drop não há nenhum endpoint de servidor para a verificação alcançar, e os detalhes de endpoint que viriam da integração não estão configurados como algo que a verificação possa sondar, então a verificação diz isso plainamente, em vez de aprovar você.

Não mude o método de transporte nem invente um host só para o teste parecer verde. Mantenha o método que o pacote de integração indica, termine o mapeamento de parceiros comerciais e confirme com seu contato de integração da OpenText em que ponto está a abertura da conta: o envio e o recebimento de arquivos são ativados junto com a conclusão dessa ligação de integração, e os primeiros documentos reais são o que você confere em Runs / Logs.

O teste falha: falta algo que o método escolhido precisa

Os campos do formulário ainda não formam um conjunto completo para o método de transporte que você escolheu. Os casos habituais são lacunas simples: sem host, sem usuário, o método de senha escolhido, mas o campo de senha vazio, ou o método de chave escolhido, mas o campo de chave privada vazio. Um desencontro também conta: por exemplo, uma chave privada colada enquanto o método ainda está no método de senha, então a peça que a verificação procura não está lá.

Compare o formulário com o pacote de integração, campo por campo: primeiro o método de transporte, depois o host, depois o usuário e por último o único segredo que o seu método usa — a senha para sftp_password, a chave privada para sftp_key, colada por inteiro. Preencha apenas a peça que falta ou está fora do lugar, salve e teste de novo. Se um valor faltar no próprio pacote, peça-o ao seu contato de integração da OpenText em vez de pegar um emprestado de outra conta.

O formato das credenciais parece completo, mas nenhum arquivo se move ainda

Não há necessariamente nada errado no formulário. O teste de conexão só verifica se o formato das credenciais está completo para o método que você escolheu: ele, por si só, não estabelece a transferência de arquivos. O envio e o recebimento reais de arquivos são ativados junto com a conclusão da sua ligação de integração com a OpenText, então um formulário que passa por completo pode continuar sentado antes desse interruptor: a conexão está pronta deste lado e a troca de arquivos ainda não foi ligada.

Confirme com seu contato de integração da OpenText se a ligação de integração da sua conta está concluída: é essa conclusão que liga a troca de arquivos. Enquanto isso, termine o mapeamento de parceiros comerciais, para que deste lado não falte nada quando ela ligar. Depois que a ligação estiver concluída, confira os primeiros documentos de cada parceiro em Runs / Logs; se os arquivos continuarem sem se mover após a integração ser confirmada como concluída, confira de novo os detalhes da conexão e os identificadores de parceiro contra o pacote de integração.

Os documentos de um parceiro não pousam, ou pousam no parceiro errado

A conexão pode estar completa enquanto o mapeamento de um parceiro não está. O mapeamento é por parceiro, e os documentos são acomodados pelos identificadores que eles trazem: o identificador de parceiro e o identificador de varejista acordados para aquele parceiro. Se os identificadores registrados no mapeamento daquele parceiro não corresponderem aos que os documentos dele trazem, os documentos não têm um destino correto: ou não pousam de jeito nenhum, ou são lidos como de outro parceiro cujos identificadores coincidem por acaso.

Abra o mapeamento daquele parceiro e compare os identificadores de parceiro e de varejista registrados nele, caractere por caractere, com os identificadores acordados para aquele parceiro na integração e na configuração do parceiro. Corrija aquele mapeamento — nunca os mapeamentos dos outros parceiros — salve-o e confira o próximo documento daquele parceiro em Runs / Logs. Um parceiro que você adicionar depois precisa do mesmo tratamento antes do primeiro documento dele: identificadores próprios, modelo próprio, conferidos separadamente.