# Webhooks

> Quais avisos a loja envia ao ERP, como configurar e como processar sem perder nem duplicar eventos.

Fonte: https://api.viashopmoda.com.br/docs-api/?p=guias/webhooks · Atualizado em 18/11/2026


## O que é

Webhook é uma chamada que a ViaShopModa faz para uma URL do ERP quando algo acontece na loja. Ele substitui as consultas repetidas ("tem pedido novo?") que gastam o limite diário.

## Eventos

| Evento | Quando |
|---|---|
| Pedido | Pedido criado, cancelado ou alterado (a alteração gera um cancelamento e, 4 minutos depois, um pedido novo). |
| Cliente | Cliente se cadastrou na loja ou foi incluído pela loja. |
| Lead | Visitante deixou nome e e-mail ou WhatsApp. |
| Sacola abandonada | Cliente identificado deixou itens na sacola sem finalizar. |

## Formato e configuração

O formato de cada webhook (corpo, cabeçalhos, autenticação) e a configuração das URLs estão na [documentação de webhooks](https://documenter.getpostman.com/view/9868245/2sBXcHhyfT). Para cadastrar ou trocar as URLs da sua integração, fale com api@viashopmoda.com.br.

## Como processar

1. **Responda rápido** com HTTP 2xx assim que receber; faça o processamento pesado depois, numa fila do ERP.
2. **Trate repetição:** o mesmo evento pode chegar mais de uma vez. Antes de criar, verifique se o registro já existe no ERP (pedido pelo `numero_pedido`, cliente pelo CPF/CNPJ ou e-mail).
3. **Respeite a ordem em alterações de pedido:** processe o cancelamento antes de reservar o pedido novo.
4. **Busque dados completos se precisar:** `pedido/consultar?pedido=`, `cliente/consultar?email=`, `sacola_abandonada/consultar?sessao=`.
5. **Confira periodicamente:** uma consulta de pedidos alterados no período (por exemplo, de hora em hora) recupera eventos perdidos enquanto o ERP estava fora do ar.

## Erros comuns de integração

- URL do ERP que demora para responder porque processa tudo antes do 2xx.
- Criar pedido em dobro quando o webhook chega duas vezes.
- Desligar o webhook e passar a consultar a API a cada minuto: consome o limite da loja inteira.
