---
title: "Actualizar Transactions externas en lote"
method: PATCH
path: "/transactions/external/bulk"
tags: ["Transactions"]
---

# Actualizar Transactions externas en lote

`PATCH /transactions/external/bulk`

## Request

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

Actualiza un lote de Transactions externas.

Se usa para corregir muchos registros en una sola llamada: cada elemento de `transactions` lleva el identificador de su Transaction y los campos a modificar. Acepta como máximo 100 por llamada.

Cada elemento se procesa por separado, así que la llamada responde `200` incluso si algunos no se pudieron actualizar: `response_counts` resume el resultado y `transaction_ids` agrupa los identificadores por resultado —actualizados, 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

- UpdateBulkExternalTransactionRequest: Lote de actualizaciones de Transactions externas.
  - `transactions` UpdateExternalTransactionItemRequest[], required: Actualizaciones que componen el lote; hasta 100 por llamada.
    - `external_id` string: Nueva referencia externa que la Organization asigna a la Transaction.
    - `id_transaction` string, required: Identificador público de la Transaction externa a actualizar.
    - `payment_method_detail` string: Nuevo detalle del medio con que se pagó.
    - `provider_external_id` string: Nueva referencia que el proveedor del pago asigna a la Transaction.
    - `reported_amount` number: Monto que la Organization reporta para el pago.
    - `transaction_date` string, date-time: Nueva fecha del pago registrado.

## Response `200`

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

- PublicUpdateBulkExternalTransactionResponse: Variante del resultado de actualizació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/patch.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)