---
title: "Revertir conciliaciones de deuda por factura"
method: POST
path: "/debt-reconciliation/undo-by-invoices"
tags: ["Debt Reconciliation Public"]
---

# Revertir conciliaciones de deuda por factura

`POST /debt-reconciliation/undo-by-invoices`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/debt-reconciliation/undo-by-invoices`
- Auth: API key in header `x-api-key`

Revierte las conciliaciones de deuda (RAT) que referencian a las facturas indicadas.

Se revierte toda conciliación de la organización que esté en estado `SUGGESTED`, `APPROVED` o `MANUALLY_RECONCILED` y que incluya al menos una de las facturas del cuerpo. Las que ya están en `DISMISSED` o `DEPRECATED` se ignoran, por lo que reintentar sobre facturas ya revertidas responde `404`.

Por cada conciliación revertida el servicio: libera los movimientos bancarios asociados (los deja disponibles para volver a conciliar, o los reembolsa si la conciliación ya estaba aprobada), elimina las transacciones de pago que había generado, vuelve a dejar las facturas como disponibles e impagas, y deja la conciliación en estado `DISMISSED` sin transacciones asociadas.

La operación no es transaccional: si la reversión de una conciliación del lote falla, esa conciliación conserva su estado original y no aparece en la respuesta, mientras que el resto del lote sí se revierte. La respuesta lista únicamente las conciliaciones efectivamente revertidas, así que conviene compararla con lo enviado.

## Headers

- `x-account-key` string

## Request body

- UndoDebtReconciliationByInvoiceRequest: Undo debt reconciliation by invoice request schema
  - `id_invoices` string[], required: Identificadores públicos de las facturas (`inv_...`) cuyas conciliaciones se quieren revertir. Se revierte toda conciliación de la organización que incluya al menos una de estas facturas.

## Response `200`

Las conciliaciones de deuda revertidas

- UndoDebtReconciliationsByInvoiceResponse: Undo debt reconciliations by invoice response schema
  - `debt_reconciliations` DebtReconciliationSchema[], required: Conciliaciones de deuda efectivamente revertidas, ya en estado `DISMISSED` y sin transacciones asociadas. No incluye las que fallaron al revertirse.
    - `account_number` string, required
    - `adjustment_documents` LeanAdjustmentDocument[]
      - `_id` string
      - `amount` number, required
      - `created_at` string, date-time, nullable
      - `currency_code` string, required
      - `deleted_at` string, date-time, nullable
      - `external_id` string, required
      - `id_account` string, required
      - `id_adjustment_document` string, required
      - `id_customer` string, required
      - `id_origin_invoice` string, nullable
      - `issued_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `client_bank_movements` LeanBankMovement[], required
      - `_id` string
      - `amount` number, required
      - `created_at` string, date-time, nullable
      - `currency_code` string, required
      - `deleted_at` string, date-time, nullable
      - `description` string, nullable
      - `destination_account_number` string, nullable
      - `destination_bank_entity` string, nullable
      - `full_amount` number, nullable
      - `id_client_bank_movement` string, required
      - `origin_account_number` string, required
      - `origin_bank_entity` string, required
      - `origin_government_id` string, required
      - `origin_holder_name` string, nullable
      - `original_amount` number, nullable
      - `reported_amount` number, nullable
      - `transferred_at` string, date-time, required
      - `updated_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `id_adjustment_documents` string[]
    - `id_client_bank_movements` string[], required
    - `id_customer` string, required
    - `id_debt_reconciliation` string, required
    - `id_invoices` string[], required
    - `id_match_run` string, nullable
    - `id_transactions` string[], required
    - `invoices` LeanInvoice[], required
      - `_id` string
      - `adjustment_amount` number
      - `amount` number, required
      - `created_at` string, date-time, nullable
      - `currency_code` string, required
      - `customer_name` string, nullable
      - `deleted_at` string, date-time, nullable
      - `due_date` string, date-time, required
      - `external_id` string, required
      - `government_id` string, required
      - `id_account` string, required
      - `id_cache_invoice` string, required
      - `id_customer` string, required
      - `id_invoice` string, required
      - `original_amount` number, nullable
      - `product_id` string, required
      - `updated_at` string, date-time, nullable
    - `payer` 'CUSTOMER' | 'UNKNOWN' | 'RELATED'
    - `reconciled_at` string, date-time, nullable
    - `status` 'SUGGESTED' | 'DISMISSED' | 'APPROVED' | 'MANUALLY_RECONCILED' | 'DEPRECATED', required
    - `status_log` object[], required
    - `total_adjustment_amount` number
    - `total_invoice_amount` number, required
    - `total_movement_amount` number, required
    - `transactions` LeanTransaction[], required
      - `_id` string
      - `amount` number, required
      - `created_at` string, date-time, nullable
      - `currency` string, required
      - `deleted_at` string, date-time, nullable
      - `external_id` string, required
      - `id_account` string, required
      - `id_customer` string, required
      - `id_transaction` string, required
      - `invoices` object[], required
      - `movement_amount` number, nullable
      - `payment_method_detail` string, required
      - `transaction_date` string, date-time, required
      - `updated_at` string, date-time, nullable
    - `type` 'ONE_TO_ONE' | 'ONE_TO_MANY' | 'MANY_TO_ONE' | 'MANY_TO_MANY', required
    - `updated_at` string, date-time, required

## Other responses

- `401`: La `x-api-key` es inválida o no corresponde a ninguna organización
- `403`: No tienes acceso a este recurso.
- `404`: Ninguna de las facturas indicadas tiene una conciliación de deuda reversible en la organización
- `422`: El cuerpo de la petición no cumple el esquema esperado
- `429`: Se superó el límite de peticiones permitidas.
- `500`: No se pudo revertir ninguna conciliación del lote

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/debt-reconciliation/undo-by-invoices/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)