Llistar tots els pressupostos
Llista els teus pressupostos de venda amb paginació per cursor. Admet filtratge per `status[in]`, `client_id`, `issued_on[gte|lte]`.
A: header
Paràmetres de consulta
Nombre d'objectes a retornar. Enter entre 1 i 100. Per defecte 25.
251 <= value <= 100Cursor per a paginació cap endavant. Fes servir l'uuid de l'últim objecte de la pàgina anterior.
uuidCursor per a paginació cap enrere. Fes servir l'uuid del primer objecte de la pàgina actual.
uuidEstat del pressupost. Coincidència exacta a status.
Estat del pressupost. Llista separada per comes. Coincideix qualsevol dels valors.
Client ID (UUID v7). Coincidència exacta amb client_id.
uuidClient ID (UUID v7). Llista separada per comes. Coincideix qualsevol dels valors.
Series ID (UUID v7). Coincidència exacta amb series_id.
uuidSeries ID (UUID v7). Llista separada per comes. Coincideix qualsevol dels valors.
Data de creació (ISO 8601). Major o igual que el valor donat.
date-timeData de creació (ISO 8601). Menor o igual que el valor donat.
date-timeData de creació (ISO 8601). Estrictament major que el valor donat.
date-timeData de creació (ISO 8601). Estrictament menor que el valor donat.
date-timeData de validesa. Major o igual que el valor donat.
dateData de validesa. Menor o igual que el valor donat.
dateData de validesa. Estrictament major que el valor donat.
dateData de validesa. Estrictament menor que el valor donat.
dateImport 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.
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 els pressupostos 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 els pressupostos 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, number, valid_until. 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).
"created" | "-created" | "total" | "-total" | "number" | "-number" | "valid_until" | "-valid_until"Cos de la resposta
application/json
application/json
application/json
application/json
application/json
application/json
{
"data": [
{
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a04",
"object": "quote",
"number": "P-2026-00012",
"series": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",
"code": "F-2026"
},
"client": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
"name": "Acme Corporation"
},
"status": "sent",
"issued_on": "2026-01-18",
"valid_until": "2026-02-17",
"accepted_at": null,
"rejected_at": null,
"converted_to_id": null,
"converted_invoice_number": "F-2025-001",
"subtotal": 500,
"taxes_total": 105,
"total_vat": 105,
"total_retention": 0,
"total_surcharge": 0,
"total": 605,
"currency": "EUR",
"notes": "Presupuesto válido 30 días.",
"terms": "Presupuesto valido durante 30 dias desde la fecha de emision.",
"external_id": "CRM-PRES-2026-0012",
"lines": [
{
"object": "quote_line",
"description": "Auditoria inicial",
"product": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
"name": "Consultoría hora estándar"
},
"quantity": 5,
"unit_price": 100,
"tax_rate": 21,
"retention_rate": 0,
"surcharge_rate": 0,
"discount_percent": 0,
"subtotal": 500,
"taxes": 105,
"total": 605
}
],
"metadata": {
"erp_code": "IVA-GEN",
"ledger_account": "477000"
},
"tags": [
"comercial",
"q1-2026"
],
"custom_fields": [
{
"field": "campania",
"value": "Promo primavera"
}
],
"link_expires_at": "2026-07-01T09:53:57+02:00",
"link_is_active": true,
"created_at": "2026-01-18T16:20:00Z",
"updated_at": "2026-01-18T16:25:00Z"
}
],
"has_more": true,
"next_cursor": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0c"
}{
"error": {
"type": "authentication_error",
"code": "missing_api_key",
"message": "No se ha proporcionado una API key válida en el header Authorization.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
"request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
}
}{
"error": {
"type": "authorization_error",
"code": "insufficient_scope",
"message": "Esta API key no tiene el scope requerido para esta operación.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
"request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
}
}{
"error": {
"type": "invalid_request_error",
"code": "parameter_invalid",
"message": "El campo `name` es obligatorio y no puede estar vacío.",
"param": "name",
"doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
"request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
"request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
"param": null,
"doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
"request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
}
}Cercar un pressupost per external ID
Cerca un únic pressupost pel seu `external_id` (enviat al body JSON), la clau d'integració que el mapeja a un registre en un sistema de tercers (ERP/CRM/e-commerce). Retorna el pressupost coincident o 404 `quote_not_found` si cap pressupost fa servir aquest external_id dins de la teva empresa.
Descarregar el PDF del pressupost
Descarrega la representació en PDF d'un pressupost.