List issued invoices

get

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

Lista las facturas emitidas (cuentas por cobrar) de la organización del token.

Paginación: options_page empieza en 0; options_pageSize por defecto 10. Respuestas con más de 1729 resultados se comprimen con gzip si se envía Accept-Encoding: gzip.
Todos los filtros son opcionales. Los que aceptan varios valores se separan por coma, salvo assignmentApprovalStatus y assignmentStatus, que se separan por #.
errors viene vacío salvo cuando alguno de los RUT de customerFiscalIds no existe en Buk Finanzas (respuesta parcial). Si ninguno existe, la respuesta es 400.
status en la respuesta puede ser OVERDUE (calculado: factura emitida o parcialmente pagada con fecha de vencimiento cumplida).
files[].fileUrl es un enlace firmado válido por 24 horas que redirige (302) al archivo.
assignedReceicableInvoiceId (sic) y assignedReceivableInvoice solo aparecen cuando la factura tiene una asignación; tags solo cuando tiene etiquetas.
movements viene con elementos null para organizaciones fuera de Chile.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

number

string

Filtra por número de factura.

status

string

Estados, separados por coma. Valores: SYNCYNG_BILLER, ISSUED, PARTIALLY_PAID, PAID, NULLIFIED, MANUALLY_MARKED_AS_PAID, MANUALLY_ARCHIVED, ARCHIVED, NON_RECOVERABLE, OVERDUE. OVERDUE es un filtro especial que equivale a las facturas vencidas (emitidas o parcialmente pagadas con vencimiento cumplido).

documentType

string

Tipos de documento, separados por coma. Valores: INVOICE, EXEMPT_INVOICE, DEBIT_NOTE, CREDIT_NOTE, FEE_INVOICE, CUSTOM_INVOICE, CUSTOM_ASSIGNABLE_ISSUED_DOCUMENT, entre otros.

documentConfirmationStatus

string

enum

Condición de pago del documento.

Allowed:

totalAmount

string

Filtra por monto total exacto del documento.

customerFiscalIds

string

RUT de los clientes, separados por coma (con o sin puntos y guion). Un RUT que no existe en Buk Finanzas se reporta en errors.

emissiondateSince

string

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

emissiondateUntil

string

Facturas emitidas 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.

updatedAtSince

string

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

updatedAtUntil

string

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

includeMovements

string

enum

Incluye los movimientos bancarios conciliados en movements. Valores true o false (texto).

Allowed:

includeTags

string

enum

Incluye las etiquetas de la factura en tags. Valores true o false (texto).

Allowed:

includeReceivableInvoiceAssignmentInfo

string

enum

Incluye la información de asignación en assignmentInfo. Valores true o false (texto).

Allowed:

hasRemainingAssignmentAmount

string

enum

Solo facturas con monto de asignación pendiente.

Allowed:

assignmentApprovalStatus

string

enum

Estado de aprobación de la asignación. Varios valores separados por # (no por coma). Un valor fuera de la lista responde 400.

Allowed:

assignmentStatus

string

enum

Estado de asignación. Varios valores separados por # (no por coma). Un valor fuera de la lista responde 400.

Allowed:

options_page

string

Número de página, empezando en 0.

options_pageSize

string

Resultados por página. Por defecto 10. Con más de 1729 resultados la respuesta se comprime (gzip) si el cliente lo acepta.

options_sortBy

string

enum

Campo de orden. Por defecto DATE. Un valor desconocido no da error: se ignora el orden.

Allowed:

options_sortOrder

string

enum

Sentido del orden. Por defecto ASC.

Allowed:

Responses

200OK

400Query inválida (fecha no parseable, assignmentApprovalStatus/assignmentStatus fuera de la lista, etc.), o ninguno de los RUT de customerFiscalIds existe. 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.