---
title: "Referencia de eventos"
description: "Cuándo se envía cada evento y qué datos contiene."
language: es-MX
canonical_url: "https://exac.mx/docs/webhooks/events"
md_url: "https://exac.mx/docs/webhooks/events.md"
---

# Referencia de eventos

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

[Recibir webhooks](/docs/webhooks)

## Sobre del evento

- `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.

- `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.

```json
{
  "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.

- `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.

```json
{
  "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.

- `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.

```json
{
  "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"
}
```

Documentación completa: https://exac.mx/docs.md
Índice para agentes: https://exac.mx/docs/llms.txt
