Llistar totes les factures de compra

Nombre d'objectes a retornar. Enter entre 1 i 100. Per defecte 25.

Cursor per a paginació cap endavant. Fes servir l'uuid de l'últim objecte de la pàgina anterior.

Cursor per a paginació cap enrere. Fes servir l'uuid del primer objecte de la pàgina actual.

Estat de la factura de compra. Coincidència exacta a status.

Estat de la factura de compra. Llista separada per comes. Coincideix qualsevol dels valors.

ID del proveïdor (UUID v7). Coincidència exacta a supplier_id.

ID del proveïdor (UUID v7). Llista separada per comes. Coincideix qualsevol dels valors.

Data de creació (ISO 8601). Major o igual que el valor donat.

Data de creació (ISO 8601). Menor o igual que el valor donat.

Data de creació (ISO 8601). Estrictament major que el valor donat.

Data de creació (ISO 8601). Estrictament menor que el valor donat.

Data d'emissió. Major o igual que el valor indicat.

Data d'emissió. Menor o igual que el valor indicat.

Data d'emissió. Estrictament major que el valor indicat.

Data d'emissió. Estrictament menor que el valor indicat.

Import total. Major o igual que el valor donat.

Import total. Menor o igual que el valor donat.

Import total. Estrictament major que el valor donat.

Import total. Estrictament menor que el valor donat.

Codi de moneda ISO 4217. Coincidència exacta amb currency.

Codi de moneda ISO 4217. Llista separada per comes. Coincideix qualsevol dels valors.

Número de factura emès pel proveïdor. Coincidència exacta amb external_invoice_number.

Número de factura emès pel proveïdor. Coincidència parcial sense distingir majúscules (LIKE %term%) sobre external_invoice_number.

Filtrar per tag de classificació (slug en minúscula). Admet múltiples valors amb tags[in]=a,b (JSON_CONTAINS, semàntica OR — coincideix amb les factures de compra que porten QUALSEVOL dels tags). Coincidència exacta sobre tags.

Filtrar per tag de classificació (slug en minúscula). Admet múltiples valors amb tags[in]=a,b (JSON_CONTAINS, semàntica OR — coincideix amb les factures de compra que porten QUALSEVOL dels tags). Llista separada per comes. Coincideix qualsevol dels valors.

Ordre dels resultats. Fes servir un camp per a ascendent o un prefix - per a descendent (p. ex. -created). Camps permesos: created, total, issued_on, due_on. Combinat amb el cursor, l'ordre es manté determinista (un ordre secundari estable per l'id del cursor, a l'estil Stripe). Si s'omet, els resultats segueixen l'ordre de cursor per defecte (created descendent).

Cerca de text lliure. LIKE %term% escapat (sense distingir majúscules, màx. 80 caràcters) sobre les columnes de text clau del recurs, combinat amb la resta de filtres (AND) i compatible amb el cursor.

Filtra per parells clau/valor de metadata usant la sintaxi deepObject metadata[key]=value. Diversos parells es combinen amb AND. Cada clau ha de complir [A-Za-z0-9_.-]{1,64}; es permeten un màxim de 50 parells (més → 422).

Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.

Opera en nom d'una empresa filla (API key mestra de gestoria): passa el seu id públic (UUID v7) i la petició s'executa contra les dades d'aquella filla sense canviar l'scope, el tier ni l'environment de la clau (omet-lo per usar la pròpia empresa de la clau). UUID no vàlid → 400 parameter_invalid_uuid; id desconegut o no propi → 404 profile_not_found. Consulta la guia d'Acting on behalf.