Docs

Referencia de eventos

Cuándo se envía cada evento y qué datos contiene.

Recibir webhooks

Sobre del evento

CampoDescripción
idId opaco del evento, también enviado en webhook-id. No cambia entre reintentos y reenvíos.
typeTipo de evento del catálogo.
timestampMomento del evento en ISO 8601.
issuerRFC de la organización a la que pertenece el evento.
dataDatos 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.

CampoDescripción
invoiceIdId público de la factura. Consulta la factura para obtener el documento completo.
uuidUUID del SAT.
kindTipo de comprobante, con los valores de REST.
directionEmitido o recibido, con los valores de REST.
statusEstado 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.

CampoDescripción
invoiceIdId público de la factura. Consulta la factura para obtener el documento completo.
uuidUUID del SAT.
kindTipo de comprobante, con los valores de REST.
directionEmitido o recibido, con los valores de REST.
statusEstado 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.

CampoDescripción
periodMes de la sincronización.
dateFromPrimera fecha del intervalo.
dateToÚltima fecha del intervalo.
startedAtInicio 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"}