---
title: "Ingestar Account Payables"
method: POST
path: "/payouts-data-ingestion/ingest-payouts-request/on-demand"
tags: ["Payout Request Ingestion"]
---

# Ingestar Account Payables

`POST /payouts-data-ingestion/ingest-payouts-request/on-demand`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payouts-data-ingestion/ingest-payouts-request/on-demand`
- Auth: API key in header `x-api-key`

Crea un Payout Request a partir de las Account Payables enviadas y registra las filas resultantes.

Se usa para cargar cuentas por pagar desde la integración de la organización sin depender del envío de archivos por SFTP. Cada objeto de `accounts_payable` se valida por separado: los objetos vacíos `{}` se omiten y no se registran, los que fallan la validación quedan registrados para auditoría, y los válidos quedan listos para procesarse. Por eso una respuesta exitosa puede incluir filas fallidas en `ingestion.failed_rows`; conviene revisar siempre los conteos de `ingestion.results`.

El procesamiento posterior es asíncrono: la ingesta responde apenas quedan registradas las filas y el avance de cada una continúa en segundo plano. Si `accounts_payable` viene vacío no se crea ningún Payout Request y el campo `ingestion` llega en `null`.

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

## Request body

- CreateAccountPayableRequest: Lote de Account Payables con el que se crea un Payout Request.
  - `accounts_payable` object[], required: Filas de Account Payable sin procesar; cada objeto se valida por fila al registrarse (un objeto vacío {} se omite).
  - `agreement_code` string, nullable: Convenio con el que se procesa todo el lote; se registra en el Payout Request y lo valida el servicio de payouts.
  - `disbursement_type` 'IMMEDIATE_TRANSFER' | 'BATCH_FILE' | 'CASHOUT': Forma en que se desembolsa un lote de payouts. El valor aplica a toda la solicitud de ingesta.
  - `reference_id` string, required: Identificador externo de la solicitud de ingesta

## Response `200`

Resultado de la ingesta del Payout Request

- OnDemandIngestionResponse: Respuesta de la API para la ingesta on demand del Payout Request (mensaje más resumen opcional del lote).
  - `ingestion` DataIngestionResponse: Resultado de un lote de ingesta: el Payout Request creado y el desglose de sus filas.
    - `batch_row_count` integer, required: Cantidad de elementos en el arreglo accounts_payable enviado
    - `failed_rows` IngestionFailedRow[]: Fallas de validación de ingesta por fila (las filas se registran igualmente cuando es posible).
      - `external_id` string, nullable: external_id de la fila cuando viene en el payload sin procesar
      - `index` integer, required: Índice base 0 en el lote accounts_payable enviado
      - `message` string, required: Resumen legible de la validación o de la persistencia
    - `id_payout_request` string, required: Identificador del Payout Request creado para esta ingesta
    - `results` DataIngestionResults, required: Conteos agregados de un único lote de ingesta.
      - `failed_count` integer, required: Filas con falla de validación que igualmente quedaron registradas para auditoría.
      - `skipped_count` integer, required: Filas que venían como objetos vacíos {} y que no se registraron.
      - `valid_count` integer, required: Filas aceptadas que quedaron registradas para su procesamiento.
  - `message` string, required: Resumen legible del resultado

## Other responses

- `400`: El servicio de configuración respondió con un error de cliente. Su código de estado se propaga sin modificarlo, por lo que cualquier código 4xx de ese servicio puede aparecer aquí.
- `401`: Falta la API key de la organización o no es válida
- `422`: El cuerpo de la petición no cumple el formato esperado

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payouts-data-ingestion/ingest-payouts-request/on-demand/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)