Skip to main content

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á

Acepta una clave de alcance lectura o escritura.

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

  1. Guardá tu cursor (next_seq) por empresa.
  2. Llamá con after=<cursor> y limit=500.
  3. Procesá los eventos en orden de seq y avanzá el cursor.
  4. 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á por event_id.
  • Orden por seq: dentro de una empresa los seq son crecientes y sin repetir. El feed tolera huecos, no los rellena.
  • Duplicados y huecos: al reprocesar, no asumas que el seq anterior es exactamente seq - 1.
  • Sin eventos de nota de crédito aparte: las NC llegan como fiscal_document.issued con data.kind = "credit_note".

Errores

Last modified on October 22, 2026