Conectar a TrueCommerce: mensagens de pedido entrantes, mensagens de embarque e fatura saintes

Solicite a URL base à sua equipe da TrueCommerce, preencha uma chave de API ou suas credenciais de cliente OAuth, teste, configure o mapeamento por parceiro comercial e ative.

O conector da TrueCommerce troca documentos EDI com seus parceiros comerciais por meio da TrueCommerce: as mensagens de pedido dos parceiros entram e viram pedidos, e as mensagens de embarque e fatura voltam para esses parceiros. Não é uma conexão de loja: tudo é organizado por parceiro comercial e por mensagem.

Pré-requisitos#

• Uma conta da TrueCommerce, com uma equipe de conta à qual solicitar a URL base da API e as credenciais.
• Pelo menos um parceiro comercial com quem você troque mensagens EDI: mensagens de pedido entrantes e mensagens de embarque e fatura saintes. Cada parceiro é mapeado separadamente mais adiante neste guia.
• Uma decisão sobre qual método de autenticação esta conexão usará: uma chave de API sozinha, ou credenciais de cliente OAuth (Client ID + Client Secret) quando você não tiver chave de API. Os dois métodos são alternativas: não misture campos dos dois.

Obter credenciais#

1. Solicite à sua equipe de conta da TrueCommerce a URL base da API da sua conta. Sem ela a conexão não pode ser preenchida: é o endereço por onde passa toda a troca de mensagens.
2. Se for usar chave de API: solicite à TrueCommerce a chave de API da sua conta e copie-a por completo. Com uma chave de API, você não precisa dos campos OAuth.
3. Se não tiver chave de API: solicite à TrueCommerce, em vez disso, as credenciais de cliente OAuth — o Client ID de OAuth e o Client Secret de OAuth. Os dois são obrigatórios juntos.
4. Guarde o Client Secret em local seguro assim que recebê-lo: ele é exibido uma única vez. Se o perder, peça à sua equipe de conta da TrueCommerce que emita um novo.

Preencher no Integration#

1. Abra Integration → Marketplace → TrueCommerce → Nova conexão.
2. URL base: cole a URL base da API da TrueCommerce que sua equipe de conta lhe deu, começando com https://. Este campo é obrigatório e precisa ser o endereço da TrueCommerce: um endereço de outro sistema não responderá.
3. Chave de API: se estiver usando o método de chave de API, cole aqui a chave de API da TrueCommerce. Se estiver usando OAuth, deixe este campo vazio: um campo de chave de API vazio é o que diz à conexão para usar suas credenciais de cliente OAuth.
4. Client ID de OAuth: obrigatório apenas quando o campo de chave de API estiver vazio. Cole o Client ID de OAuth que a TrueCommerce emitiu para sua conta. Se você preencheu uma chave de API, pode deixar este campo vazio.
5. Segredo de cliente OAuth: obrigatório apenas quando o campo de chave de API estiver vazio, e forma par com o Client ID de OAuth: os dois devem vir do mesmo conjunto emitido. É criptografado em repouso e nunca exibido.

Testar a conexión#

Clique em Testar a conexão. O teste vai até a URL base que você preencheu e apresenta as credenciais do método escolhido: a chave de API, ou o Client ID e o Client Secret de OAuth quando o campo de chave de API está vazio. Se passar, a TrueCommerce foi alcançada nesse endereço e aceitou essas credenciais. Se falhar, guarde o erro que o teste mostra: ele indica se o endereço ou as credenciais foram rejeitados, e as perguntas frequentes abaixo tratam de cada caso.

Mapping / escolher modelo#

Na TrueCommerce o mapeamento é por parceiro comercial, não uma configuração única para toda a conexão. Para cada parceiro, escolha o modelo desse parceiro e verifique como as mensagens de pedido dele mapeiam para o pedido padrão — número do pedido, linhas, quantidades e dados de entrega — e como os dados de embarque e fatura mapeiam de volta para o formato de mensagem que esse parceiro espera. Um parceiro sem mapeamento configurado não tem onde pousar suas mensagens: as mensagens de pedido dele não viram pedidos, e as mensagens de embarque e fatura não podem ser montadas para ele. Trabalhe parceiro por parceiro e confira a prévia de mapeamento de cada um antes de ativar.

Ativar#

Após ativar, as mensagens de pedido dos seus parceiros comerciais mapeados entram e viram pedidos, e as mensagens de embarque e fatura são enviadas de volta a cada parceiro pela TrueCommerce. Parceiros sem mapeamento ficam em silêncio: nada flui para eles até o mapeamento ser configurado. Acompanhe as primeiras mensagens de cada parceiro em Runs / Logs antes de deixar a troca sem supervisão.

Perguntas frequentes#

O teste falha: as credenciais são rejeitadas

As credenciais da conexão não correspondem ao que a TrueCommerce emitiu para a sua conta. As causas habituais são um valor copiado incompleto, ou um método preenchido pela metade: o campo de chave de API ficou vazio — o que muda a conexão para OAuth — mas só um entre o Client ID e o Client Secret de OAuth foi preenchido, então o par está incompleto e não pode ser aceito.

Decida um método e preencha-o por completo. Método de chave de API: cole a chave de API inteira e deixe os campos OAuth vazios. Método OAuth: deixe a chave de API vazia e cole tanto o Client ID quanto o Client Secret de OAuth do mesmo conjunto emitido; lembre que o segredo é exibido uma única vez, então, se sua cópia salva se perdeu, peça um novo à sua equipe de conta da TrueCommerce. Salve e teste de novo.

O teste falha: não é possível alcançar a TrueCommerce de jeito nenhum

A URL base da conexão está incorreta, então o teste está batendo na porta errada. As causas comuns são um endereço digitado errado ou truncado, um endereço destinado a outro sistema, ou um endereço antigo depois que sua equipe de conta lhe deu um novo: as credenciais nem chegam a ser verificadas porque nada da TrueCommerce responde ali.

Peça à sua equipe de conta da TrueCommerce que confirme a URL base da API exata da sua conta, substitua a URL base da conexão por esse endereço exatamente como foi passado — começando com https:// — e depois salve e teste de novo.

Conectado, mas as mensagens de pedido de um parceiro nunca viram pedidos

A conexão em si funciona: o teste passa e outros parceiros podem estar fluindo. O problema é que este parceiro comercial não tem mapeamento configurado, ou o modelo dele não cobre suas mensagens de pedido, então as mensagens que chegam não têm onde pousar e nunca viram pedidos.

Abra o mapeamento desse parceiro comercial, escolha o modelo dele e confira a prévia de mapeamento com uma das mensagens de pedido reais dele: número do pedido, linhas, quantidades e dados de entrega devem pousar no pedido padrão. Salve o mapeamento e depois veja Runs / Logs para a próxima mensagem desse parceiro.

Os pedidos entram, mas as mensagens de embarque e fatura não chegam ao parceiro

A entrada funciona, então o endereço e as credenciais estão certos. A lacuna está no lado de saída do mapeamento desse parceiro: o parceiro está mapeado para as mensagens de pedido entrantes, mas as mensagens de embarque e fatura saintes dele nunca foram configuradas, então os resultados do fulfillment não têm mensagem para voltar.

Abra o mapeamento desse parceiro comercial e configure também o lado de saída: mensagens de embarque e mensagens de fatura, no formato que esse parceiro espera. Confira a prévia de mapeamento com um pedido já atendido e depois acompanhe Runs / Logs para a próxima mensagem de saída para esse parceiro.