intents

Corregir y reemitir el DTE de un intent

Changed on

Actualiza el NIT y nombre fiscal, anula el DTE vigente y emite uno nuevo. Usa el ID unificado in_… que devuelve POST /cash_sales y GET /intents/{id}. Funciona también para cash sales.

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.

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.

put/intents/{intent_id}/tax_invoice

Request

Path parameters

intent_idstring required

ID unificado del intent

Request body

Response

DTE corregido y reemitido; devuelve el intent actualizado

type'payment' | 'bank_transfer' | 'crypto' | 'balance' | 'cash' required

Tipo de pago subyacente

idstring required

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

receipt_numberinteger
api_versionstring
status'pending' | 'succeeded' | 'failed' | 'canceled' | 'paid' required

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

raw_statusstring required

Estado concreto sin normalizar (ej. requires_capture)

created_atstring date-time
amount_in_centsinteger
currencystring
customer_idstring
user_idstring
customerIntentCustomer

Datos del cliente

productIntentProduct

Producto principal

tax_invoice_urlstring uri nullable

En la API devuelve la URL actual del DTE; en un webhook refleja el valor disponible al entregar ese evento y puede ser null aunque una emisión posterior tenga éxito.

paymentIntentPayment

Changes

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to array for status

    • breaking

      the / response's property type changed from object to array for status

    • breaking

      the / response's property type changed from object to array for status

    • warning

      deleted the header request parameter X-SECRET-KEY

    • info

      the endpoint scheme security secretKey was added to the API