Corregir y reemitir el DTE de un intent | Documentación API de Recurrente

curl -X PUT https://app.recurrente.com/api/intents/in_abcdefgh/tax_invoice \
     -H "X-SECRET-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "tax_invoice": {
    "tax_id": "1234567-8"
  }
}'

{
  "type": "payment",
  "id": "in_123",
  "status": "pending",
  "raw_status": "string",
  "receipt_number": 1,
  "api_version": "2026-06-01",
  "created_at": "2024-01-15T09:30:00Z",
  "amount_in_cents": 1,
  "currency": "string",
  "customer_id": "string",
  "user_id": "string",
  "customer": {},
  "product": {},
  "tax_invoice_url": "string",
  "checkout": {
    "id": "ch_lmgbvesmihkqzma3",
    "status": "paid",
    "items": [
      {
        "id": "it_eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBQT09IiwiZXhwIjpudWxsLCJwdXIiOiJjaGVja291dF9pdGVtIn19",
        "price_id": "price_rky4dog7",
        "quantity": 2,
        "metadata": {}
      }
    ],
    "total_in_cents": 3000,
    "subtotal_in_cents": 3500,
    "discount": {
      "amount_in_cents": 500,
      "coupon": {
        "id": "coup_ugwoxcp4",
        "name": "VERANO25",
        "discount_mode": "code",
        "display_name": "string",
        "amount_off_in_cents": 1500,
        "percent_off": 1.1,
        "automatically_applies": false,
        "max_redemptions": 1,
        "times_redeemed": 0,
        "currency": "GTQ",
        "duration": "once",
        "expires_at": "2024-01-15T09:30:00Z",
        "status": "active"
      }
    },
    "currency": "GTQ",
    "payment_method_types": [
      "card",
      "bank_transfer"
    ],
    "available_installments": [
      3,
      6
    ],
    "live_mode": true,
    "success_url": "string",
    "cancel_url": "string",
    "expires_at": "2024-01-15T09:30:00Z",
    "created_at": "2024-01-15T09:30:00Z",
    "metadata": {},
    "custom_fields": [
      {
        "field_id": "ccf_xxxxxxxxxxxx",
        "key": "engraving",
        "type": "text",
        "value": "string"
      }
    ],
    "transfer_setups": [
      {
        "id": "tr_4a7b9c8d",
        "status": "pending",
        "amount_in_cents": 1,
        "amount_percent": 1.1,
        "currency": "string",
        "recipient_id": "ac_123456",
        "purpose": "fund_split"
      }
    ],
    "latest_intent": {
      "id": "string",
      "type": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "data": {
        "auth_code": "string"
      }
    },
    "payment": {
      "id": "string",
      "paymentable": {
        "type": "Subscription",
        "id": "string",
        "tax_name": "string",
        "tax_id": "string",
        "address": {
          "address_line_1": "string",
          "address_line_2": "string",
          "city": "string",
          "region": "string",
          "country": "string",
          "zip_code": "string"
        },
        "phone_number": "string"
      }
    },
    "payment_method": {
      "id": "string",
      "type": "card",
      "card": {
        "last4": "4242",
        "expiration_month": 12,
        "expiration_year": 2028,
        "network": "visa",
        "issuer_name": "string"
      },
      "address": {
        "address_line_1": "string",
        "address_line_2": "string",
        "city": "string",
        "region": "string",
        "country": "string",
        "zip_code": "string"
      },
      "phone_number": "string"
    }
  },
  "payment": {},
  "details": {
    "channel": "POS"
  }
}

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.

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

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.

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.

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

Request

This endpoint expects an object.

tax_invoiceobjectRequired

Response

DTE corregido y reemitido; devuelve el intent actualizado

typeenum

Tipo de pago subyacente

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

raw_statusstring

Estado concreto sin normalizar (ej. requires_capture)

receipt_numberintegerOptional

api_versionstringOptional

created_atdatetimeOptional

amount_in_centsintegerOptional

currencystringOptional

customer_idstringOptional

user_idstringOptional

customerobjectOptional

Datos del cliente

productobjectOptional

Producto principal

tax_invoice_urlstring or nullOptionalformat: "uri"

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.

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

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.

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.