Ir al contenido
Eventos

FISCALISTO / API / REFERENCIA

sat_download.failed

Abrir en ChatGPTAbrir en Claude

El SAT no pudo terminar una descarga (por ejemplo, la e.firma venció o el SAT la rechazó). data.object es la descarga, con el motivo en error. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).

Cuerpo de la solicitud

application/json
  1. body

Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks).

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

object*string

Qué tipo de objeto es («invoice», «customer»…).

type*string

Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, issuer.ready, balance.low o test_clock.ready.

api_version*string

Versión de la API con que se armó el objeto.

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

created_at*string

Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).

Formatodate-time
data*

Lo que cambió, en data.object: el comprobante (o el lote) completo, como lo contesta su GET.

Cuerpo de la respuesta

Conteste 2xx en menos de 15 segundos; si no, se reintenta durante un día.

Así llega a su webhook

{  "id": "evt_0PKhIdhYuAGwzmMQYfkc",  "object": "event",  "type": "sat_download.failed",  "api_version": "2026-10-24",  "livemode": false,  "created_at": "2026-10-24T10:15:42-06:00",  "data": {    "object": {      "id": "sdl_OufpKqnrvx9p3n8vQd2LkW7mZr1XyT5uBc",      "object": "sat_download",      "livemode": false,      "issuer": "iss_OufpKqnrvx9p",      "direction": "received",      "from": "2026-09-01",      "to": "2026-09-30",      "type": null,      "counterparty_tax_id": null,      "uuid": null,      "status": "failed",      "new_invoices": 0,      "error": "La e.firma del emisor venció: suba una vigente para descargar del SAT.",      "created_at": "2026-10-24T10:20:00-06:00",      "completed_at": "2026-10-24T10:27:41-06:00"    }  }}

sat_download.completed Webhook

Terminó una descarga del SAT: sus facturas ya están en GET /v1/sat_invoices. data.object es la descarga, con cuántas nuevas trajo. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).

sat_declaration.created Webhook

Una consulta encontró una declaración nueva del emisor en el SAT. data.object es la declaración; sus archivos y cifras pueden llegar después (sat_declaration.updated). Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).