FISCALISTO / API / REFERENCIA
issuer.ready
El emisor ya puede timbrar en producción: tiene su CSD y firmó el contrato con el PAC (por la API, el panel o una liga de alta). data.object es el emisor. En pruebas llega al terminar una liga de alta. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).
application/json- body
Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks).
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
object*stringQué tipo de objeto es («invoice», «customer»…).
type*stringQué 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*stringVersión de la API con que se armó el objeto.
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
created_at*stringCuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
date-timedata*Lo que cambió, en data.object: el comprobante (o el lote) completo, como lo contesta su GET.
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": "issuer.ready", "api_version": "2026-10-24", "livemode": false, "created_at": "2026-10-24T10:15:42-06:00", "data": { "object": { "id": "iss_OufpKqnrvx9p", "object": "issuer", "livemode": false, "tax_id": "TOL190312KT4", "legal_name": "TOLPI", "tax_system": "601", "zip": "64000", "status": "active", "requirement": null, "certificate": { "serial_number": "30001000000500003416", "expires_at": "2027-05-18T05:43:51-06:00" }, "sat_downloads": { "available": true, "efirma_expires_at": null }, "employer_registration": null, "curp": null, "stamps_as": "EKU9003173C9", "sandbox": null, "test_clock": null, "created_at": "2026-10-24T10:15:42-06:00", "archived_at": null, "metadata": { "cliente": "42" } } }}quote.rejected Webhook
El cliente rechazó una cotización en su liga; su motivo, si lo dio, viene en customer_comment. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).
balance.low Webhook
A la cuenta le quedan pocos timbres de producción: llega al bajar a low_balance_at (se elige en Desarrolladores › Timbres) y otra vez cuando se acaban, una vez cada uno hasta que vuelva a tener más. data.object es el saldo, como lo da GET /v1/balance. Siempre en producción. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).