Skip to navigation

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

X-SECRET-KEYstring

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

intent_idstringRequiredformat: "^in_"
ID unificado del intent

Headers

X-ACCOUNT-IDstringOptional

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

This endpoint expects an object.
tax_invoiceobjectRequired

Envía al menos uno de los campos; los que omitas se conservan.

Response

DTE corregido y reemitido; devuelve el intent actualizado

typeenum
Tipo de pago subyacente
Allowed values:
idstringformat: "^in_"

ID del intent unificado; es la llave canónica para GET /intents/{id} y los eventos intent.*.

statusenum

Estado normalizado. paid aplica solo al evento del pagador en pagos con balance (type balance).

Allowed values:
raw_statusstring

Estado concreto sin normalizar (ej. requires_capture)

legacy_idstringOptional

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.

receipt_numberintegerOptional
api_versionstringOptional
created_atdatetimeOptional
amount_in_centsintegerOptional
currencystringOptional
customer_idstringOptional
user_idstringOptional
customerobjectOptional
Datos del cliente
bulk_chargeobject or nullOptional

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.

productobjectOptional
Producto principal
subscriptionobjectOptional

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.

tax_invoice_urlstring or nullOptionalformat: "uri"

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.

checkoutobject or nullOptional
paymentobject or nullOptional
detailsobjectOptional

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

Errors

400
Bad Request Error
404
Not Found Error
422
Unprocessable Entity Error