Docs

Event reference

When each event fires and what it contains.

Receive webhooks

Event envelope

FieldDescription
idOpaque event id, also sent as webhook-id. Stable across retries and replays.
typeCatalog event type.
timestampEvent occurrence time in ISO 8601.
issuerRFC of the organization that owns the event.
dataSmall event snapshot. Fetch the resource for the rest.

invoice.stamped

An invoice issued by Exac becomes valid, including one first stored as valid. Never sent for SAT imports. Payment complements and payroll receipts are invoice kinds and use this event.

FieldDescription
invoiceIdPublic invoice id. Fetch the invoice for its full contents.
uuidSAT UUID.
kindInvoice kind, using the REST vocabulary.
directionIssued or received, using the REST vocabulary.
statusStatus at the time of the event.
{  "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

A valid invoice becomes canceled, whether issued or received. An invoice first stored as canceled does not emit an event.

FieldDescription
invoiceIdPublic invoice id. Fetch the invoice for its full contents.
uuidSAT UUID.
kindInvoice kind, using the REST vocabulary.
directionIssued or received, using the REST vocabulary.
statusStatus at the time of the event.
{  "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

A customer SAT sync completes. One event per RFC per sync, not per imported document. Internal single-document lookups do not emit it. No document count is included. Call GET /v1/invoices?addedFrom={data.startedAt} for that issuer and page until pagination.hasMore is false. Use the issuer header from the invoice reference. Upsert by id because the window can include documents from another sync or added by Exac.

FieldDescription
periodSync month.
dateFromFirst date in the sync range.
dateToLast date in the sync range.
startedAtRequired RFC 3339 sync start. Use it as the inclusive addedFrom boundary.
{  "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"}