HomeGuíasAPI ReferenceChangelog
Log In
API Reference

Ingestar Account Payables

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Lote de Account Payables con el que se crea un Payout Request.

accounts_payable
array of objects
required

Filas de Account Payable sin procesar; cada objeto se valida por fila al registrarse (un objeto vacío {} se omite).

Accounts Payable*
length ≥ 1

Convenio con el que se procesa todo el lote; se registra en el Payout Request y lo valida el servicio de payouts.

DisbursementType | null

Forma de desembolso para todo el lote; se registra en el Payout Request y el servicio de payouts la infiere cuando no viene o la valida cuando sí.

string
required

Identificador externo de la solicitud de ingesta

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

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json