v1

latestOpenAPI 3.0.32026-07-24398641.3 MB

Gastos

bills__list_bills

MCP

Herramienta lógica list_bills. Nombre típico: bills__list_bills (p. ej. expenses__list_bills según el servidor).

HTTP

GET /v1/bills — Query: todos los parámetros opcionales van en arguments como claves planas (equivalente a query string).

Respuesta exitosa

HTTP 200: arreglo de bills, o { metadata: { total }, data: [...] } si metadata=true.

Errores frecuentes

Código	Significado	Acción
903	Paginación inválida (start/limit)	start≥0; limit dentro del máximo del API
400	Validación	Revisar message y code en el cuerpo

Filtros proveedor

client_id exacto: si no existe ese proveedor, cero resultados (no es error). No combinar lógica de intersección con client_name/provider_name; usar id o nombre (ver guía list_filter_semantics en la fuente).

Campos expandidos

Usar fields como lista separada por comas; ver fields_query_param y fields_guidance en la guía pública (stamp, xml, retentions, journal, etc.).

post/tools/bills__list_bills

Request body

startinteger

Offset ≥0

limitinteger

Tamaño de página (máx. típico 200)

fieldsstring

Campos extra separados por comas

decimalMode'calculation' | 'display'

simpleboolean

metadatastring

'true' para envoltorio metadata+data

order_field'billNumber' | 'name' | 'date' | 'dueDate' | 'id'

order_direction'ASC' | 'DESC'

uuidstring

uuidsstring

idsstring

idGlobalstring

exclude_idstring

fullNumberstring

billNumber_equalsstring

statusstring

draft,open,paid,void (separados por coma)

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

Colombia suele default bill

client_idinteger

client_namestring

provider_namestring

datestring date

date_afterOrNowstring

date_beforeOrNowstring

dueDatestring

dueDate_earlierThanOrEqualTostring

dueDate_laterThanOrEqualTostring

dueDate_betweenstring

start,end

createdAt_laterThanOrEqualTostring date-time

createdAt_earlierThanOrEqualTostring date-time

createdBystring

item_idinteger

purchaseOrder_idinteger

currencystring

warehouse_idinteger

costCenter_idstring

emissionStatusstring

areElectronicboolean

excludePaidBillsboolean

excludePrefixstring

includeVoidPayments'yes' | 'no'

Response

Lista de bills o metadata+data