Event reference
When each event fires and what it contains.
Event envelope
| Field | Description |
|---|---|
id | Opaque event id, also sent as webhook-id. Stable across retries and replays. |
type | Catalog event type. |
timestamp | Event occurrence time in ISO 8601. |
issuer | RFC of the organization that owns the event. |
data | Small 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.
| Field | Description |
|---|---|
invoiceId | Public invoice id. Fetch the invoice for its full contents. |
uuid | SAT UUID. |
kind | Invoice kind, using the REST vocabulary. |
direction | Issued or received, using the REST vocabulary. |
status | Status 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.
| Field | Description |
|---|---|
invoiceId | Public invoice id. Fetch the invoice for its full contents. |
uuid | SAT UUID. |
kind | Invoice kind, using the REST vocabulary. |
direction | Issued or received, using the REST vocabulary. |
status | Status 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.
| Field | Description |
|---|---|
period | Sync month. |
dateFrom | First date in the sync range. |
dateTo | Last date in the sync range. |
startedAt | Required 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"}