Cadastro de produto por link (API)

1. A empresa gera um link para um seller. Todo produto enviado por esse link entra nesse seller, na unidade dele.
2. O outro sistema envia um produto por chamada, com os dados em JSON.
3. O ExlogWMS confere os dados e responde na mesma hora: cadastrou, ou recusou dizendo o motivo.
4. O produto entra com estoque zero. A entrada de estoque continua sendo feita pelo recebimento.

• Faz: cadastra produto novo, simples ou com variações.
• Não faz: não altera, não consulta e não apaga produto. Se o SKU ou o código já existir no seller, a chamada é recusada e nada muda.

No menu lateral, abra Configurações e clique em Empresa. Na lista de seções à esquerda, clique em Links de cadastro (fica depois de Integrações).

A seção lista os links já gerados, com o nome, o começo do código, o seller, a validade, o limite por dia, as chamadas de hoje, o último uso e a situação.

Print pendenteassets/img/api-cadastro-produto/secao-links.png

1. Clique em Gerar link.
2. Em Nome do link, escreva algo que ajude a reconhecer depois (ex.: Loja virtual).
3. Em Seller que recebe os produtos, escolha o seller. Seller que aparece como (sem unidade) não pode receber link: edite o seller e informe a unidade primeiro.
4. Validade em dias é opcional. Em branco, o link não vence.
5. Limite de chamadas por dia já vem com 500. Contam as chamadas aceitas e as recusadas.
6. Clique em Gerar link.

Print pendenteassets/img/api-cadastro-produto/janela-gerar-link.png

Abre a janela Link gerado. Clique em Copiar link e guarde em local seguro antes de fechar.

Print pendenteassets/img/api-cadastro-produto/janela-link-gerado.png

O link tem este formato (o código abaixo é só um exemplo):

https://n8n.srv1206270.hstgr.cloud/webhook/exlog-produto?link=0000000000000000000000000000000000000000000000000000000000000000

Campo que não está nesta tabela é ignorado.

Use variacoes quando o mesmo produto tem versões (tamanho, cor, voltagem). O produto e as variações entram juntos: se uma variação for recusada, nada é gravado. São aceitas até 100 variações por produto.

O estoque e o preço principal ficam no produto. Cada variação guarda a própria descrição, o SKU, o código de barras e, se informado, o preço.

A terceira variação mostra os campos opcionais; as duas primeiras, só o necessário.

Guarde o id_produto: é o número do produto no ExlogWMS.

Toda recusa traz sucesso: false e uma mensagem. Quando o problema está nos dados, a lista erros diz o campo e o motivo. Em variação, o campo vem como variacoes[2].sku — o número é a posição na lista, começando em 1.

1. Baixe o arquivo de descrição da API pelo botão abaixo.
2. No Postman, clique em Import e escolha o arquivo baixado. O Postman cria a coleção com a requisição Cadastra um produto novo.
3. Abra a requisição e, na aba Params, troque o valor de link pelo código do seu link (os 64 caracteres depois de ?link=).
4. Na aba Body, ajuste os dados do produto e clique em Send.

1. Crie uma requisição e escolha o método POST.
2. Cole o link completo no campo do endereço.
3. Na aba Authorization, deixe em No Auth.
4. Na aba Body, escolha raw e, na lista ao lado, JSON.
5. Cole um dos modelos do passo 4 e clique em Send.

Na seção Links de cadastro, clique em Chamadas na linha do link. A janela mostra as 50 chamadas mais recentes, com a data, o resultado (Cadastrado ou Recusado com o código), o SKU e a mensagem devolvida.

Print pendenteassets/img/api-cadastro-produto/janela-chamadas.png

Clique em Desligar na linha do link e confirme. A partir daí, quem usa esse link recebe a recusa 403 e não cadastra mais nada. Para voltar atrás, clique em Ligar.

Desligue sempre que o link tiver sido exposto, quando a integração for encerrada ou quando a pessoa que recebeu o link sair do projeto.