API ViaShopModa documentação

Webhooks

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

Ver como Markdown 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 #

EventoQuando
PedidoPedido criado, cancelado ou alterado (a alteração gera um cancelamento e, 4 minutos depois, um pedido novo).
ClienteCliente se cadastrou na loja ou foi incluído pela loja.
LeadVisitante deixou nome e e-mail ou WhatsApp.
Sacola abandonadaCliente 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. 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.