---
title: "Eliminar Transactions externas en lote"
method: PUT
path: "/transactions/external/bulk/delete"
tags: ["Transactions"]
---

# Eliminar Transactions externas en lote

`PUT /transactions/external/bulk/delete`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/transactions/external/bulk/delete`
- Auth: API key in header `x-api-key`

Elimina un lote de Transactions externas y deja sus Invoices impagos.

Se usa para revertir muchos registros de pagos hechos por fuera: el cuerpo lleva los identificadores en `id_transactions`, con un máximo de 100 por llamada. Por cada Transaction eliminada, los Invoices que saldaba vuelven a quedar impagos.

Cada elemento se procesa por separado, así que la llamada responde `200` incluso si algunos no se pudieron eliminar: `response_counts` resume el resultado y `transaction_ids` agrupa los identificadores por resultado —eliminados, no encontrados y con error—.

**Límite de tasa:** 1 solicitud por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Headers

- `x-account-key` string

## Request body

- DeleteBulkExternalTransactionRequest: Lote de Transactions externas a eliminar.
  - `id_transactions` string[], required: Identificadores públicos de las Transactions externas a eliminar; hasta 100 por llamada.

## Response `200`

Resultado del lote, con el recuento por categoría y los ids agrupados por resultado.

- PublicDeleteBulkExternalTransactionResponse: Variante del resultado de eliminación en lote con los identificadores públicos.
  - `response_counts` BulkResponseCounts, required: Recuento de elementos del lote por resultado.
    - `duplicates` integer: Elementos descartados por repetir a otro del mismo lote.
    - `error` integer: Elementos que no se pudieron procesar.
    - `format_error` integer: Elementos descartados porque les faltaba un campo obligatorio.
    - `not_found` integer: Elementos descartados porque una entidad referida no se pudo usar.
    - `success` integer: Elementos que quedaron registrados o actualizados.
    - `unchanged` integer: Elementos que ya existían sin cambios y se dejaron intactos.
  - `success` boolean, required: Indica que el lote se procesó; los resultados por elemento van en los demás campos.
  - `transaction_ids` PublicBulkTransactionIds, required: Variante de los identificadores del lote expresados como ids públicos.
    - `duplicates_ids` string[]: Transactions descartadas por repetir a otra del mismo lote.
    - `error_ids` string[]: Transactions que no se pudieron procesar.
    - `format_error_ids` string[]: Transactions descartadas por un campo obligatorio faltante.
    - `not_found_ids` string[]: Transactions que no existen, no pertenecen a la Organization o no son Transactions externas.
    - `success_ids` string[]: Transactions procesadas correctamente.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/transactions/external/bulk/delete/put.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)