Conectar a Logiwa: enviar pedidos, consultar estoque
Use o e-mail e a senha de uma conta da Logiwa com acesso à API na conexão WMS, teste o login real por token, mapeie e ative.
O conector da Logiwa conecta este sistema à Logiwa como sistema externo de armazém. Ele pode enviar pedidos de expedição para a Logiwa, de forma individual ou em lote, e consultar o estoque mantido na Logiwa. As confirmações de expedição voltam pelo Webhook V2 da Logiwa, não por uma chamada de consulta desta conexão. Esta conexão é configurada na área WMS, não no assistente de canais, e entra com usuário e senha da Logiwa para obter um token de sessão.
Pré-requisitos#
- Uma conta da Logiwa à qual você consiga entrar. O usuário desta conexão é o e-mail de um usuário da Logiwa com acesso à API.
- A senha desse mesmo usuário da Logiwa. Não há uma API Key separada para gerar nesta conexão: o e-mail e a senha da conta são as credenciais.
- Você sabe se deve usar o endereço de serviço padrão https://myapi.logiwa.com ou outra baseUrl indicada para o seu ambiente da Logiwa. Se ninguém lhe deu outro endereço, deixe o padrão.
Obter credenciais#
- Escolha o usuário da Logiwa para a integração e confirme que esse usuário tem acesso à API. Use um usuário dedicado quando possível, para que uma troca pessoal de senha não quebre a conexão.
- Anote o usuário: o endereço de e-mail desse usuário da Logiwa.
- Anote a senha desse mesmo usuário. Você a digitará uma vez na conexão WMS, onde ela é guardada como segredo e usada junto com o usuário para obter um token.
- Se o seu ambiente da Logiwa lhe deu um endereço de serviço diferente do padrão, anote também essa baseUrl. Caso contrário, não há mais nada para reunir.
Preencher no Integration#
Esta conexão não tem lista de campos no assistente de canais. Abra a conexão WMS da Logiwa no Integration e preencha os valores abaixo nesse formulário de conexão WMS. Não procure a Logiwa nas etapas de campos do assistente de canais: o assistente não tem campos para ela.
- username, obrigatório: o e-mail do usuário da Logiwa com acesso à API, exatamente como usado para entrar na Logiwa.
- password, obrigatório: a senha desse mesmo usuário da Logiwa. É um campo secreto e é enviado junto com username quando o sistema obtém um token.
- baseUrl, opcional: o endereço de serviço da Logiwa. Deixe vazio para usar o padrão https://myapi.logiwa.com, ou preencha o endereço diferente indicado para o seu ambiente da Logiwa.
Testar a conexão#
Use o teste da conexão WMS. Ele envia uma solicitação real de login para o endereço de token sob a sua baseUrl, com o username e a password preenchidos, e só aprova quando a Logiwa devolve um token. Se username ou password estiver ausente, o teste para com MISSING_CREDENTIALS. Se a solicitação não devolver token, falha com AUTH_FAILED. Há duas entradas de teste que você pode encontrar: este teste da conexão WMS é a verificação real de credenciais descrita aqui, enquanto um teste exibido no assistente de canais não contata a Logiwa com estas credenciais: não trate uma aprovação lá como prova de que a conta da Logiwa funciona. Julgue a conexão apenas pelo teste da conexão WMS.
Mapping / escolher modelo#
Escolha o mapping padrão da Logiwa. Com ele, um pedido de saída deste sistema se torna um pedido de expedição da Logiwa, e uma consulta de estoque lê a lista de estoque da Logiwa para o SKU mapeado. Depois que o teste aprovar, envie um pedido real e compare na Logiwa (referência, linhas e quantidades) e confira a quantidade de um SKU com o que a Logiwa mostra, antes de ativar. Se um SKU deste sistema nomear de outro modo o mesmo produto na Logiwa, corrija esse SKU no mapping em vez de renomear o produto em qualquer dos sistemas.
Ativar#
Após ativar, os pedidos de saída deste sistema são enviados para a Logiwa como pedidos de expedição, um a um ou em lote, e as consultas de estoque leem as quantidades atuais da Logiwa para os SKUs mapeados. As confirmações de expedição voltam pelo Webhook V2 da Logiwa, então mantenha a entrega por webhook funcionando no lado da Logiwa. Acompanhe os primeiros pedidos em Runs / Logs e na própria Logiwa antes de deixar a conexão sem supervisão.
Perguntas frequentes#
O teste WMS falha com AUTH_FAILED
A solicitação de token chegou à Logiwa, mas não devolveu token. O par de usuário e senha não foi aceito: o e-mail não é um usuário da Logiwa com acesso à API, a senha não pertence a esse usuário, ou a baseUrl aponta para um ambiente da Logiwa diferente do da conta.
Entre na Logiwa no navegador com o mesmo e-mail e senha para provar que o par funciona, confirme que o usuário tem acesso à API e digite novamente username e password na conexão WMS sem cortar nada. Se outra baseUrl foi indicada para o seu ambiente, coloque-a exatamente; caso contrário, limpe baseUrl para usar o endereço padrão e teste novamente.
O teste para com MISSING_CREDENTIALS
Falta username ou password na conexão WMS. A solicitação de token precisa dos dois valores, então o teste para antes de contatar a Logiwa.
Preencha os dois campos no formulário de conexão WMS (username com o e-mail do usuário da Logiwa e password com a senha desse usuário), salve e teste novamente.
O teste do assistente de canais aprovou, mas o teste WMS continua falhando
Os dois testes não são a mesma verificação. O assistente de canais não tem campos da Logiwa e o teste dele não entra na Logiwa com seu username e password, então uma aprovação lá não diz nada sobre a conta da Logiwa. Só o teste da conexão WMS faz o login real por token.
Ignore o resultado do assistente nesta conexão. Execute o teste da conexão WMS e trabalhe a partir do resultado dele: MISSING_CREDENTIALS significa que um campo está vazio e AUTH_FAILED significa que o par da conta foi recusado.
Os pedidos são enviados, mas a Logiwa mostra quantidades diferentes
A conexão e o token funcionam (o pedido chegou), mas uma linha não corresponde: normalmente o SKU do pedido nomeia outro produto na Logiwa, ou a unidade da linha difere entre os dois sistemas.
Compare o pedido enviado linha por linha com o pedido na Logiwa, corrija o mapping de SKU do produto que não corresponde, envie um pedido de teste novo e compare novamente antes de retomar os pedidos normais.
A consulta de estoque não devolve nada para um SKU que existe na Logiwa
A consulta de estoque lê a lista de estoque da Logiwa com o SKU mapeado. Se o SKU enviado não for o SKU sob o qual a Logiwa guarda o estoque, a lista volta vazia mesmo que o produto exista.
Encontre o SKU exato no registro do produto na Logiwa, coloque esse valor no mapping deste produto e execute a consulta de estoque novamente.
Os pedidos são expedidos na Logiwa, mas a confirmação não chega aqui
As confirmações de expedição desta conexão viajam pelo Webhook V2 da Logiwa, não pelas chamadas de pedidos nem de estoque. Se a entrega por webhook no lado da Logiwa estiver parada ou falhando, os pedidos e o estoque continuam funcionando enquanto as confirmações deixam de chegar.
Verifique o estado de entrega por webhook no lado da Logiwa e restaure-o, expida um pedido de teste na Logiwa e confirme que a confirmação chega aqui antes de retomar o volume normal.