Qué es
Además de los webhooks, Tero POS expone un feed de eventos por pull. Sirve para reconciliar, reprocesar o cargar eventos perdidos. El mismo envelope y el mismo catálogo de eventos.Dónde está
Parámetros
Respuesta
next_seq es el seq del último evento de la página. Guardalo y volvé a llamar con after=<next_seq>. Si la página viene vacía, next_seq es igual al after que enviaste.
Cómo paginar
- Guardá tu cursor (
next_seq) por empresa. - Llamá con
after=<cursor>ylimit=500. - Procesá los eventos en orden de
seqy avanzá el cursor. - Repetí hasta que la página venga vacía.
Los eventos se conservan 90 días. Después de eso se eliminan del feed (y con ellos las entregas pendientes). Si tu ERP estuvo caído más de ese plazo, resincronizá desde los endpoints de reporte del back office.
Reglas de procesamiento
- Idempotencia por
event_id: un evento puede repetirse (reintento de webhook o replay manual). Deduplicá porevent_id. - Orden por
seq: dentro de una empresa losseqson crecientes y sin repetir. El feed tolera huecos, no los rellena. - Duplicados y huecos: al reprocesar, no asumas que el
seqanterior es exactamenteseq - 1. - Sin eventos de nota de crédito aparte: las NC llegan como
fiscal_document.issuedcondata.kind = "credit_note".