Skip to main content
O Fire emite três tipos de eventos de loja. Seu sistema deve tratar todos os três:

store.updated

Emitido sempre que uma única loja muda. O payload contém a configuração completa da loja e dos canais.
Seu endpoint recebe:
O objeto data está pronto para ser encaminhado. Nenhuma chamada adicional à API do Fire é necessária. Veja store.updated para o esquema completo.
1

Verifique a assinatura

Valide X-Fire-Signature. Veja Autenticação.
2

Confirme imediatamente

Retorne 200 OK antes de qualquer trabalho.
3

Atualize downstream

Passe data para seu sistema downstream. O payload é autocontido — não requer transformação.

store.deleted

Emitido quando uma loja é explicitamente removida do Fire. Esta é a única forma como o Fire sinaliza uma exclusão de loja — não há ambiguidade.
Seu endpoint recebe:
Use storeId e storeChannels para identificar e remover a loja em cada sistema downstream. Veja store.deleted para o esquema completo.

stores.sync

Emitido quando o Fire precisa propagar muitas lojas de uma vez — durante o onboarding inicial ou após uma mudança massiva de configuração. O Fire divide lotes grandes automaticamente (até 50 lojas por evento) e os emite sequencialmente.
Seu endpoint recebe:
Processe cada lote de forma independente. Use batchIndex e batchTotal para acompanhar o progresso se seu sistema precisar saber quando a sincronização completa terminar. Cada lote é reenviado de forma independente em caso de falha. Veja stores.sync para o esquema completo.

Idempotência

Você pode receber o mesmo evento mais de uma vez devido a retentativas. Faça seu processamento idempotente — tratar o mesmo evento duas vezes deve produzir o mesmo resultado.