Webhooks CALLBACK

Webhooks permitem que o Wemov WMS envie notificações automáticas para o seu sistema sempre que determinados eventos ocorrerem no armazém. Em vez de consultar a API repetidamente, o WMS faz uma requisição HTTP POST ao endpoint configurado pelo cliente.

Como funciona

O Wemov WMS realiza um POST no endpoint cadastrado pelo cliente sempre que um evento relevante ocorrer. O payload é enviado em formato JSON.

Configuração

Para receber webhooks, é necessário:

1. Disponibilizar um endpoint HTTPS acessível publicamente
2. Informar a URL ao time Wemov para cadastro
3. Responder com status 200 para confirmar o recebimento

Importante

Caso o endpoint retorne um status diferente de 2xx, o WMS tentará reenviar a notificação até 3 vezes com intervalos crescentes.

URL do Callback

POST https://seu-dominio.com.br/webhook

Request Header

O WMS envia as seguintes headers na requisição:

Content-Type: application/json

Webhooks Disponíveis

Webhook	Descrição
Recebimento	Notificação quando uma nota fiscal é recebida no armazém
Situação de Recebimento	Mudança de situação/status da nota de entrada
Saída (Expedição)	Notificação de separação e expedição de pedidos de saída
Situação de Pedidos	Mudança de situação/status dos pedidos de saída
Embalagem	Notificação de embalagem finalizada com detalhes dos volumes
Estoque	Notificação de posição de estoque atual

Response Esperado

O endpoint do cliente deve retornar:

{
  "received": true
}

Status HTTP	Significado
200	Webhook recebido com sucesso
4xx	Erro no lado do cliente — será reenviado
5xx	Erro no servidor — será reenviado

Boas Práticas

• Processe o webhook de forma assíncrona para responder rapidamente com 200
• Implemente idempotência para lidar com possíveis reenvios
• Registre logs de todos os webhooks recebidos para auditoria