v1

latestOpenAPI 3.0.32026-07-24398641.3 MB
Facturas de proveedor

Lista de facturas de proveedor

Endpoint que permite consultar las facturas de proveedor registradas en la aplicación

get/bills

Query parameters

metadataboolean

Incluir en los resultados metadatos. Se debe tener en cuenta que si se envía este parámetro el objeto que retorna la aplicación incluye un atributo "metadata" y otro "data" en donde se envían las facturas. Actualmente la información que se envía en metadata incluye el total de facturas que tiene registrada la empresa.

startinteger

Desde cuál factura de proveedor se quiere consultar. Por ejemplo para consultar desde la factura de proveedor 20, se envía start=20.

limitinteger

Cantidad de facturas de proveedor a partir del inicio que se desea retornar. Por defecto retorna 30 facturas de proveedor. Si este valor es mayor que 30, la aplicación retorna error.

order_direction'ASC' | 'DESC'

Orden ascendente o descendente en el cual se quieren retornar las facturas de proveedor. Opciones disponibles son DESC o ASC. Por defecto es ASC (ascendente).

order_field'date' | 'name' | 'dueDate'

Campo por el cual se desea ordenar.

billNumberstring

Filtrar resultados según el número de la factura de proveedor. Se retornarán todas las facturas de proveedor cuyo número coincida total o parcialmente con el valor enviado en este parámetro.

client_namestring

Filtrar resultados según según el nombre del cliente de la factura de proveedor. Se retornarán todas las facturas de proveedor cuyo nombre de cliente coincida total o parcialmente con el valor enviado en este parámetro.

datestring date

Filtrar resultados según la fecha de creación de la factura de proveedor. Se retornarán todas las facturas de proveedor cuya fecha de creación (atributo date) coincida exactamente con el valor enviado en este parámetro. El formato para la fecha es YYYY-MM-DD.

dueDatestring date

Filtrar resultados según la fecha de vencimiento de la factura de proveedor. Se retornarán todas las facturas de proveedor cuya de vencimiento (atributo dueDate) coincida exactamente con el valor enviado en este parámetro. El formato para la fecha es YYYY-MM-DD.

statusstring

Filtra resultados según el estado de la factura de proveedor. Las opciones disponibles son open, closed y void.

item_idinteger

Filtrar las facturas de proveedor por el id del item.

client_idinteger

Filtra las facturas por id del cliente (proveedor).

provider_namestring

Filtrar resultados según el nombre del proveedor de la factura. Se retornarán todas las facturas de proveedor cuyo nombre de proveedor coincida total o parcialmente con el valor enviado en este parámetro.

uuidstring

Para Mexico se pueden filtrar los resultados segun el parámetro uuid de la factura de proveedor.

purchaseOrder_idinteger

Filtras las facturas de proveedor por id de la orden de compra.

type'bill' | 'supportDocument' | 'all'

Para el caso donde se cuente con diferentes tipos de factura de proveedor, permite obtener el tipo deseado. Colombia permite el valor supportDocument para listar documentos soporte, bill para facturas de proveedor y all para listar ambos tipos.