Para vincular o código de rastreio da encomenda ao pedido, e automatizar a troca de status, é necessário realizar algumas configurações que listamos abaixo.
POSTAGE
1. Acesse o app Vnda Postagem (postage.vnda.com.br, senha no Keeper) e crie uma nova integração através do botão Nova loja (localizado no canto superior direito).
2. Na janela aberta, preencha os campos da seguinte forma:
Nome: nome da loja
Host: domínio da loja (www.loja.com.br, sem https:// e com www)
Integração: Mandaê
Formas de entrega: inserir as formas de entrega conforme cadastradas no Shipping, seguindo o exemplo abaixo:
rapido,economico
(no caso preencher com as formas de entrega do cliente conforme variáveis)Caracteres especiais, como espaço, ponto e hífen, sempre serão transformados em hífen;
O nome das modalidades deverá ser separado apenas por vírgula.
O nome das modalidades sempre será equivalente à nomenclatura da forma de entrega que fica dentro dos parênteses no pedido (no admin).
Token da API: token Mandaê
Código do cliente: solicitar ao cliente
Prefixo do código de rastreio: solicitar ao cliente
3. Clique em Salvar.
4. Acesse o admin da loja e cadastre o webhook de disparo dos pedidos para o app Postagem, de acordo com as orientações abaixo:
Acesse as preferências da loja (engrenagem no canto inferior esquerdo) > No menu Integrações, selecione Webhooks > Clique no símbolo + no canto superior direito;
Preencha os campos da seguinte forma:
No primeiro, selecione order-confirmed;
URL: insira a seguinte URL: https://postage.vnda.com.br/api/v1/orders/XXX/import, substituindo XXX pelo token do app Postagem obtido no passo 7.
IMPORTANTE: atente-se para que não haja espaçamento no campo de URL;
Clique em Salvar.
TRACKER
5. Acesse o app Vnda Tracker (tracker.vnda.com.br) e procure a loja usando a busca do navegador. Após encontrá-la, clique em Editar.
Caso a loja ainda não tenha sido cadastrada no Tracker, crie uma nova seguindo o passo a passo:
Ao acessar o Tracker, clicar em Adicionar no canto superior direito;
Preencha:
Nome da loja:
nome da loja
;Token:
deixar em branco
;Host da loja:
domínio da loja (www.loja.com.br, sem https://)
.
Role até o final da página e salve.
6. Role para baixo até encontrar as configurações da Mandaê, marque o checkbox "Habilitado" e preencha os campos da seguinte forma:
Mandaê token: token API recebido para cadastro no shipping
Padrão para reconhecimento do rastreio (regex):
^XXXXXX.*
No padrão de reconhecimento, lembre-se de substituir o
XXXXXX
pelo prefixo do código de rastreio solicitado ao cliente.Exemplo de como deve parecer: ^CHOFA.*
OBS.: Manter o
.*
após o prefixo.