Ir al contenido

GetBills

Lista las facturas de proveedor del proveedor de la clave de API a la empresa de la clave: las mismas facturas que el usuario externo del proveedor ve en el portal, incluidas las que la empresa ha introducido por su cuenta. Utilícelo para seguir el estado, las fechas de vencimiento y los pagos de sus facturas. El funcionamiento de las claves, las respuestas y los estados se describe en API de facturas de proveedor.

GET /api/public/getbills?FromDate=2026-10-01&ToDate=2026-10-31&Status=Outstanding
APIKey: your-api-key
Parámetro Significado
FromDate, ToDate El intervalo de fechas de factura, con el formato yyyy-MM-dd, ambos días incluidos. Como máximo 366 días de diferencia. Obligatorios salvo que se indique BillNumber.
BillNumber Un número de factura. Las mayúsculas y los espacios no importan.
Status Solo las facturas con este estado: Draft, Submitted, Received, Approved, Rejected, Disputed, u Outstanding para las facturas con un importe pendiente.
Page La página que se devuelve. La primera página es 1, el valor predeterminado.
PageSize El número de facturas por página, de 1 a 500. El valor predeterminado es 100.

Las facturas se ordenan de la fecha de factura más reciente a la más antigua.

RetInfo contiene la página y el número total de facturas que coinciden, para que sepa cuántas páginas hay:

{
"Code": 1,
"Info": "",
"RetInfo": {
"Page": 1,
"PageSize": 100,
"Total": 2,
"Bills": [
{ "BillID": 109827, "BillNumber": "INV-2026-0042", "Status": "Approved", "...": "..." },
{ "BillID": 109790, "BillNumber": "INV-2026-0038", "Status": "Rejected", "...": "..." }
]
},
"RowsAffected": 2,
"Scalar": null,
"Identity": 0
}

Cada elemento de Bills es una factura de proveedor. RowsAffected es el número de facturas de esta página. Una página posterior a la última no devuelve ninguna factura.

Regla Info si no se cumple
Se indica un intervalo de fechas o un número de factura. FromDate and ToDate are required (yyyy-MM-dd) unless BillNumber is given
Se indican las dos fechas, con el formato yyyy-MM-dd. FromDate and ToDate must both be dates as yyyy-MM-dd
ToDate no es anterior a FromDate. ToDate cannot be earlier than FromDate
Las fechas tienen como máximo 366 días de diferencia. FromDate and ToDate cannot be more than 366 days apart
Status es uno de los valores anteriores. Status must be one of: ...
PageSize está entre 1 y 500. PageSize must be between 1 and 500