List received invoices

get

https://api.bemmbo.com/v1/invoices/received

Lista las facturas recibidas (cuentas por pagar) de la organización del token.

Paginación: options_page empieza en 0; options_pageSize por defecto 10, máximo 1000 (valores mayores se recortan sin aviso). Cada factura incluye payments, logs, accountingEntries y approvalsSummary, por lo que páginas grandes pueden superar los 6 MB de respuesta y responder 502: se recomienda options_pageSize ≤ 500.
El endpoint recupera todas las facturas de la organización antes de paginar, por lo que la latencia (10–25 s en organizaciones con miles de facturas) no depende de options_pageSize. Si supera los 29 s la respuesta es 502: reintente.
Todos los filtros son opcionales; los que aceptan varios valores se separan por coma.
categories y costCenters siempre traen un único elemento (la categoría y el centro de costo principales).
errors siempre viene vacío en este endpoint.
Un options_sortBy desconocido no da error: se ignora el orden.
Las rendiciones de gastos de colaboradores se entregan como documentos RECEIPT, CUSTOM_WORKER_INVOICE, INVOICE o EXEMPT_INVOICE; hoy no hay un filtro ni un campo que las distinga (está en curso: campo y filtro reimbursementStatus, CORE-2787).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

number

string

Filtra por número de factura (coincidencia exacta).

status

string

Estados, separados por coma. Valores: REJECTED, PENDING, APPROVED, PAY_SCHEDULED, ARCHIVED, PAID.

documentType

string

Tipos de documento, separados por coma. Los más comunes: INVOICE, EXEMPT_INVOICE, DEBIT_NOTE, CREDIT_NOTE, FEE_INVOICE, ELECTRONIC_PURCHASE, REIMBURSEMENT, CUSTOM_INVOICE, CUSTOM_PENDING_INVOICE, CUSTOM_FOREIGN_INVOICE, CUSTOM_CUSTOMER_INVOICE, CUSTOM_WORKER_INVOICE, CUSTOM_DEBIT_NOTE, CUSTOM_CREDIT_NOTE, RECEIPT, SALARY, EXEMPT_SS_INVOICE. La lista no es exhaustiva: se acepta cualquier tipo de documento de la plataforma (p. ej. PURCHASE_INVOICE, EXPORT_INVOICE, ELECTRONIC_BALLOT); un valor desconocido no da error, devuelve vacío.

documentConfirmationStatus

string

Estado fiscal (SII) del documento, separados por coma. Valores: PENDING, REGISTERED, NULLIFIED, REJECTED, OBSERVED.

issuerFiscalIds

string

RUT de los proveedores, separados por coma, sin puntos ni guion y con el dígito verificador en minúscula (76076325k). Un dígito verificador K en mayúscula pasa la validación pero no coincide con ningún documento (devuelve vacío). Si ninguno de los RUT existe en Buk Finanzas la respuesta es 400.

receivedDateSince

string

Facturas recibidas desde esta fecha. Formato ISO 8601, por ejemplo 2024-01-01 o 2024-01-01T00:00:00Z. Un valor no parseable responde 400.

receivedDateUntil

string

Facturas recibidas hasta esta fecha. Formato ISO 8601, por ejemplo 2024-01-01 o 2024-01-01T00:00:00Z. Un valor no parseable responde 400.

dueDateSince

string

Facturas con vencimiento desde esta fecha. Formato ISO 8601, por ejemplo 2024-01-01 o 2024-01-01T00:00:00Z. Un valor no parseable responde 400.

dueDateUntil

string

Facturas con vencimiento hasta esta fecha. Formato ISO 8601, por ejemplo 2024-01-01 o 2024-01-01T00:00:00Z. Un valor no parseable responde 400.

options_page

string

Número de página, empezando en 0. Un valor no numérico equivale a 0.

options_pageSize

string

Resultados por página. Por defecto 10, máximo 1000 (se recorta sin aviso). Recomendado ≤ 500 para evitar respuestas 502 por tamaño.

options_sortBy

string

enum

Campo de orden. Sin valor, los resultados no vienen ordenados.

Allowed:

options_sortOrder

string

enum

Sentido del orden. Por defecto ASC.

Allowed:

Responses

200OK

400Query inválida, ninguno de los RUT de issuerFiscalIds existe, o fallo interno al recuperar las facturas. El cuerpo puede venir vacío si ocurre una excepción no controlada.

401Falta el header Authorization.

403Token inválido, expirado, con prefijo Bearer o de una empresa desactivada; o bien la URL no existe (mensaje con Credential/Signature).

500Error interno.

502La página supera el tamaño máximo de respuesta (6 MB) o la consulta superó los 29 s (organizaciones con muchas facturas). Reduzca options_pageSize o reintente.