Skip to main content
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