Referencia de eventos
Cuándo se envía cada evento y qué datos contiene.
Sobre del evento
| Campo | Descripción |
|---|---|
id | Id opaco del evento, también enviado en webhook-id. No cambia entre reintentos y reenvíos. |
type | Tipo de evento del catálogo. |
timestamp | Momento del evento en ISO 8601. |
issuer | RFC de la organización a la que pertenece el evento. |
data | Datos resumidos del evento. Consulta el recurso para obtener el resto. |
invoice.stamped
Una factura emitida por Exac pasa a vigente, incluso si se guarda por primera vez con ese estado.
| Campo | Descripción |
|---|---|
invoiceId | Id público de la factura. Consulta la factura para obtener el documento completo. |
uuid | UUID del SAT. |
kind | Tipo de comprobante, con los valores de REST. |
direction | Emitido o recibido, con los valores de REST. |
status | Estado al momento del evento. |
{ "type": "invoice.stamped", "data": { "invoiceId": "invoice:example", "uuid": "00000000-0000-4000-8000-000000000001", "kind": "income", "direction": "issued", "status": "valid" }, "id": "event_example", "timestamp": "2026-09-01T01:00:00.000Z", "issuer": "AAA010101AAA"}invoice.canceled
Una factura vigente pasa a cancelada, sea emitida o recibida. Guardar una factura que ya estaba cancelada no genera un evento.
| Campo | Descripción |
|---|---|
invoiceId | Id público de la factura. Consulta la factura para obtener el documento completo. |
uuid | UUID del SAT. |
kind | Tipo de comprobante, con los valores de REST. |
direction | Emitido o recibido, con los valores de REST. |
status | Estado al momento del evento. |
{ "type": "invoice.canceled", "data": { "invoiceId": "invoice:example", "uuid": "00000000-0000-4000-8000-000000000001", "kind": "income", "direction": "issued", "status": "canceled" }, "id": "event_example", "timestamp": "2026-09-01T01:00:00.000Z", "issuer": "AAA010101AAA"}sat_sync.completed
Termina una sincronización del SAT del cliente. Se envía un evento por RFC y sincronización, no por documento importado. Llama GET /v1/invoices?addedFrom={data.startedAt} para ese issuer y pagina hasta que pagination.hasMore sea false. Usa el encabezado de RFC indicado en la referencia de facturas. Actualiza o inserta por id, porque el intervalo puede incluir documentos de otra sincronización o agregados por Exac.
| Campo | Descripción |
|---|---|
period | Mes de la sincronización. |
dateFrom | Primera fecha del intervalo. |
dateTo | Última fecha del intervalo. |
startedAt | Inicio de la sincronización en RFC 3339, siempre presente. Úsalo como límite inclusivo de addedFrom. |
{ "type": "sat_sync.completed", "data": { "period": "2026-08", "dateFrom": "2026-08-01", "dateTo": "2026-08-31", "startedAt": "2026-09-01T00:00:00.000Z" }, "id": "event_example", "timestamp": "2026-09-01T01:00:00.000Z", "issuer": "AAA010101AAA"}