ERPs brasileiros (TOTVS Protheus, Bling, Tiny, sistemas próprios) raramente têm
webhooks confiáveis. A receita abaixo combina polling com diff por contentHash
e o re-sync diário noturno.
Arquitetura
Job de polling (a cada 5 min)
Como o backend Voop é idempotente, não precisa rastrear o que já foi enviado.
Items que não mudaram retornam unchanged em milissegundos.
Re-sync diário (defesa em profundidade)
Mesmo com polling, agendamentos podem falhar. Toda noite às 3h, faça um re-sync
completo do catálogo via bulk import:
Items que não mudaram entre o polling e o nightly serão unchanged — zero overhead.
Tratamento de exclusões
ERPs raramente “deletam” produtos — eles marcam inativo=true. Estratégia:
Items archived ficam fora da listagem padrão na IA mas preservam histórico
para relatórios. Se preferir hard-delete, use DELETE /items/totvs/{externalId}.
Erros comuns