Corregir y reemitir el DTE de un intent
Actualiza el NIT y nombre fiscal, o la clasificación fiscal (Bien o
Servicio) de las líneas, anula el DTE vigente y emite uno nuevo con los
mismos montos. Usa el ID unificado in_… que devuelve
POST /cash_sales y GET /intents/{id}. Funciona también para cash
sales: para reclasificar una venta certificada como Bien, envía solo
tax_category: service; el NIT y el nombre se conservan.
Si el proveedor no puede anular el DTE vigente, la operación responde
422 con code: void_failed y conserva el documento y los datos
fiscales anteriores. Si la anulación termina pero la nueva emisión falla,
responde 422 con code: issue_failed; tax_invoice_url queda en null
hasta que repitas la operación y la emisión concluya.
Si SAT no encuentra el NIT y el DTE volvería a salir como Consumidor
Final, la operación responde 422 con code: invalid_nit sin anular
nada. Confirma el NIT o envía CF. Un documento extranjero que se
emite como tal no se rechaza.
Usa un Idempotency-Key único por corrección. Repetir la misma llave y
cuerpo reproduce la respuesta anterior sin anular ni reemitir otra vez.
Esta corrección no genera un webhook adicional. Consulta
GET /intents/{id} para obtener el tax_invoice_url vigente. En una
cuenta conectada, envía también X-ACCOUNT-ID.
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Path parameters
Headers
ID de una cuenta hija conectada. Ejecuta el request dentro de esa cuenta,
como Stripe-Account en Stripe Connect. La plataforma puede acceder a
todos los recursos API que pertenecen a la hija, sin filtrar por creador.
Solo aplica a hijas directas: si la cuenta no está conectada a la tuya,
el request responde 404 con code: connected_account_not_found.
Con una llave de organización este header nombra la cuenta miembro sobre
la que quieres operar; si no pertenece a la organización, el request
responde 404 con code: organization_account_not_found. En una lectura
puedes omitirlo para abarcar todas las cuentas de la organización.
Request
Envía al menos uno de los campos; los que omitas se conservan.
Response
DTE corregido y reemitido; devuelve el intent actualizado
ID del intent unificado; es la llave canónica para GET /intents/{id} y los eventos intent.*.
Estado normalizado. paid aplica solo al evento del pagador en pagos con balance (type balance).
Estado concreto sin normalizar (ej. requires_capture)
ID del mismo pago en el formato anterior de webhooks por tipo. Permite vincular registros históricos al migrar a eventos unificados; el ID canónico sigue siendo id.
Referencia a la fila del cobro masivo, o null si el intento no tiene una fila de origen. Los reintentos de una fila conservan la misma referencia.
Suscripción a la que pertenece el cobro: su renovación o un cobro hecho sobre ella, como el prorrateo de now_and_charge. id es null en cobros sin suscripción.
Public page for the payment’s final certified tax document (invoice, receipt, or donation receipt). Exempt accounts default to receipts; NGOs default to donation receipts and can choose receipts in invoicing settings. The page links to the certifier’s copy; tax_invoice_uuid remains the authorization number. API responses return the current value. Webhooks reflect the value available when delivered and may contain null even if certification succeeds later.
Campos específicos del tipo de pago. Para type: payment, incluye failure_reason, comisiones, cuotas, canal y productos. Para type: bank_transfer, incluye bank_reference (referencia asignada por el banco o la red de pago) y sender_comment (comentario libre del pagador).

