Llistar tots els packs

Llista els packs de l'empresa amb paginació per cursor. - Filtra per search, slug (també troba slugs anteriors), sku, tag, channel, status, availability[in] i updated[gte]. - Ordena amb sort per created, name o price (prefix - per a ordre descendent). - view=storefront retorna només els packs a la venda a la web, sense camps interns. - Lectures condicionals: envia If-None-Match per obtenir 304 sense cos.

Authorization

AuthorizationBearer <token>

La teva API key com a token Bearer: fact_live_… en producció, fact_test_… en sandbox. Consulta la guia d'autenticació.

A: header

Paràmetres de ruta

company*string

Identificador públic (UUID v7) de l'empresa. Obtén-lo de GET /v1/me (data.scope[].id).

Formatuuid

Paràmetres de consulta

date?|

Dia (YYYY-MM-DD, zona horària de l'empresa) per al qual es resol la promotion. Per defecte, avui. Una data amb hora fa servir el seu dia. Format incorrecte: 400 parameter_invalid_iso8601.

limit?integer

Nombre d'objectes a retornar, entre 1 i 100 (25 per defecte).

Predeterminat25

Rang1 <= value <= 100

starting_after?string

Cursor de paginació cap endavant: passa l'id de l'últim objecte de la pàgina anterior (el next_cursor de la resposta anterior).

Formatuuid

ending_before?string

Cursor de paginació cap enrere: passa l'id del primer objecte de la pàgina actual.

Formatuuid

slug?string

Slug del pack. També troba els packs que el van fer servir abans. Coincidència exacta amb slug.

sku?string

SKU del pack. Coincidència exacta amb sku.

tag?string

Etiqueta de classificació. Coincidència exacta amb tag.

channel?string

Canal de venda per al qual està habilitat el pack: documents o web. Coincidència exacta amb channel.

Valor a"documents" | "web"

status?string

Estat del pack: active, inactive o archived. Coincidència exacta amb status.

Valor a"active" | "inactive" | "archived"

availability?string

Disponibilitat: in_stock, low, out_of_stock o untracked. Admet diversos valors amb availability[in]. Coincidència exacta amb availability.

Valor a"in_stock" | "low" | "out_of_stock" | "untracked"

availability[in]?string

Disponibilitat: in_stock, low, out_of_stock o untracked. Admet diversos valors amb availability[in]. Llista separada per comes. Coincideix qualsevol dels valors.

updated[gte]?string

Data de l'última actualització (ISO 8601). Major o igual que el valor indicat.

Formatdate-time

sort?string

Ordre: created, name, price ascendent, o amb prefix - per a descendent (per defecte created, el més antic primer).

search?string

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.

Longitudlength <= 80

view?string

Forma del pack: all (per defecte) retorna el pack complet i storefront només el que pot mostrar una botiga web, i únicament dels packs a la venda allà. Qualsevol altre pack respon 404.

Predeterminat"all"

Valor a"all" | "storefront"

Headers

If-None-Match?string

Petició condicional: envia l'ETag que has desat d'una resposta anterior d'aquesta operació (entre cometes, tal com es va rebre) per obtenir 304 Not Modified sense body quan el contingut no ha canviat. Omet-lo per rebre sempre la resposta completa.

Factuarea-Version?string

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.

Formatdate

Cos de la resposta

`application/json`

Exemple de petició

const apiKey = process.env.FACTUAREA_API_KEY;if (!apiKey) throw new Error("Set FACTUAREA_API_KEY");const response = await fetch("https://api.factuarea.com/v1/companies/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01/packs?limit=25", {  method: "GET",  headers: { Authorization: `Bearer ${apiKey}`, ...{"Accept":"application/json","If-None-Match":"\"5d41402abc4b2a76b9719d911017c592\""} },});if (!response.ok && response.status !== 304) throw new Error(await response.text());if (response.status !== 204 && response.status !== 304) console.log(await response.json());

Exemple de resposta

GET /v1/companies/{company}/packs · 200

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9b01",
      "object": "pack",
      "name": "Pack Huerto urbano",
      "slug": "pack-huerto-urbano",
      "previous_slugs": [
        "kit-huerto-urbano"
      ],
      "sku": "PACK-HUERTO",
      "summary": "Todo lo necesario para empezar tu huerto en casa.",
      "description": "Dos macetas de barro de 30 cm, sustrato universal de 20 L y cuatro sobres de semillas de temporada.",
      "tags": [
        "huerto",
        "jardin"
      ],
      "seo": {
        "title": "Pack Huerto urbano",
        "description": "Todo lo necesario para empezar tu huerto en casa."
      },
      "currency": "EUR",
      "price": {
        "net": "50.53",
        "tax": "9.37",
        "gross": "59.90"
      },
      "tax_breakdown": [
        {
          "rate": 21,
          "base": "39.25",
          "tax": "8.24"
        },
        {
          "rate": 10,
          "base": "11.28",
          "tax": "1.13"
        }
      ],
      "separately": {
        "net": "61.53",
        "gross": "72.91"
      },
      "savings": {
        "gross": "13.01",
        "percent": 17.8
      },
      "promotion": null,
      "available_from": "2026-09-01",
      "available_until": "2026-11-10",
      "cover": {
        "url": "https://files.factuarea.com/packs/huerto-urbano-1.webp",
        "thumb_url": "https://files.factuarea.com/packs/huerto-urbano-1-thumb.webp",
        "alt": "Huerto urbano en balcón",
        "source": "own"
      },
      "gallery": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9d01",
          "url": "https://files.factuarea.com/packs/huerto-urbano-1.webp",
          "thumb_url": "https://files.factuarea.com/packs/huerto-urbano-1-thumb.webp",
          "alt": "Huerto urbano en balcón",
          "width": 1200,
          "height": 900,
          "position": 1,
          "content_type": "image/webp"
        },
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9d02",
          "url": "https://files.factuarea.com/packs/huerto-urbano-2.webp",
          "thumb_url": "https://files.factuarea.com/packs/huerto-urbano-2-thumb.webp",
          "alt": "Contenido del pack",
          "width": 1200,
          "height": 900,
          "position": 2,
          "content_type": "image/webp"
        }
      ],
      "components": [
        {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c01",
          "variant_id": null,
          "presentation_id": null,
          "configuration_id": null,
          "name": "Maceta de barro 30 cm",
          "slug": "maceta-barro-30",
          "quantity": "2.0000",
          "unit": {
            "code": "C62",
            "label": "Unidad"
          },
          "image": {
            "url": "https://files.factuarea.com/products/maceta-barro-30.jpg",
            "alt": "Maceta de barro 30 cm"
          },
          "variant_name": null,
          "presentation_name": null,
          "sku": "MAC-BARRO-30",
          "configuration_signature": null,
          "options": [],
          "position": 1
        },
        {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c02",
          "variant_id": null,
          "presentation_id": null,
          "configuration_id": null,
          "name": "Sustrato universal 20 L",
          "slug": "sustrato-universal-20l",
          "quantity": "1.0000",
          "unit": {
            "code": "C62",
            "label": "Unidad"
          },
          "image": {
            "url": "https://files.factuarea.com/products/sustrato-20l.jpg",
            "alt": "Sustrato universal 20 L"
          },
          "variant_name": null,
          "presentation_name": null,
          "sku": "SUST-UNI-20",
          "configuration_signature": null,
          "options": [],
          "position": 2
        },
        {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c03",
          "variant_id": null,
          "presentation_id": null,
          "configuration_id": null,
          "name": "Semillas de huerto (sobre)",
          "slug": "semillas-huerto",
          "quantity": "4.0000",
          "unit": {
            "code": "C62",
            "label": "Unidad"
          },
          "image": {
            "url": "https://files.factuarea.com/products/semillas-huerto.jpg",
            "alt": "Semillas de huerto (sobre)"
          },
          "variant_name": null,
          "presentation_name": null,
          "sku": "SEM-HUERTO",
          "configuration_signature": null,
          "options": [],
          "position": 3
        }
      ],
      "status": "active",
      "channels": {
        "documents": true,
        "web": true
      },
      "pricing": {
        "mode": "fixed",
        "value": "59.90",
        "basis": "gross"
      },
      "sellable": {
        "documents": true,
        "web": true,
        "reason": null,
        "code": null
      },
      "availability": {
        "status": "low",
        "quantity": "3",
        "limited_by": {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c02",
          "variant_id": null
        }
      },
      "attention": [
        {
          "code": "ends_soon",
          "message": "La vigencia termina en 12 días",
          "product_id": null
        }
      ],
      "metadata": {
        "erp_ref": "HUERTO-2026"
      },
      "created_at": "2026-09-15T09:30:00Z",
      "updated_at": "2026-10-20T08:15:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

GET /v1/companies/{company}/packs · 200 (view=storefront)

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9b01",
      "object": "pack",
      "name": "Pack Huerto urbano",
      "slug": "pack-huerto-urbano",
      "previous_slugs": [
        "kit-huerto-urbano"
      ],
      "sku": "PACK-HUERTO",
      "summary": "Todo lo necesario para empezar tu huerto en casa.",
      "description": "Dos macetas de barro de 30 cm, sustrato universal de 20 L y cuatro sobres de semillas de temporada.",
      "tags": [
        "huerto",
        "jardin"
      ],
      "seo": {
        "title": "Pack Huerto urbano",
        "description": "Todo lo necesario para empezar tu huerto en casa."
      },
      "currency": "EUR",
      "price": {
        "net": "50.53",
        "tax": "9.37",
        "gross": "59.90"
      },
      "tax_breakdown": [
        {
          "rate": 21,
          "base": "39.25",
          "tax": "8.24"
        },
        {
          "rate": 10,
          "base": "11.28",
          "tax": "1.13"
        }
      ],
      "separately": {
        "net": "61.53",
        "gross": "72.91"
      },
      "savings": {
        "gross": "13.01",
        "percent": 17.8
      },
      "promotion": null,
      "available_from": "2026-09-01",
      "available_until": "2026-11-10",
      "cover": {
        "url": "https://files.factuarea.com/packs/huerto-urbano-1.webp",
        "thumb_url": "https://files.factuarea.com/packs/huerto-urbano-1-thumb.webp",
        "alt": "Huerto urbano en balcón",
        "source": "own"
      },
      "gallery": [
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9d01",
          "url": "https://files.factuarea.com/packs/huerto-urbano-1.webp",
          "thumb_url": "https://files.factuarea.com/packs/huerto-urbano-1-thumb.webp",
          "alt": "Huerto urbano en balcón",
          "width": 1200,
          "height": 900,
          "position": 1,
          "content_type": "image/webp"
        },
        {
          "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9d02",
          "url": "https://files.factuarea.com/packs/huerto-urbano-2.webp",
          "thumb_url": "https://files.factuarea.com/packs/huerto-urbano-2-thumb.webp",
          "alt": "Contenido del pack",
          "width": 1200,
          "height": 900,
          "position": 2,
          "content_type": "image/webp"
        }
      ],
      "components": [
        {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c01",
          "variant_id": null,
          "presentation_id": null,
          "configuration_id": null,
          "name": "Maceta de barro 30 cm",
          "slug": "maceta-barro-30",
          "quantity": "2.0000",
          "unit": {
            "code": "C62",
            "label": "Unidad"
          },
          "image": {
            "url": "https://files.factuarea.com/products/maceta-barro-30.jpg",
            "alt": "Maceta de barro 30 cm"
          }
        },
        {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c02",
          "variant_id": null,
          "presentation_id": null,
          "configuration_id": null,
          "name": "Sustrato universal 20 L",
          "slug": "sustrato-universal-20l",
          "quantity": "1.0000",
          "unit": {
            "code": "C62",
            "label": "Unidad"
          },
          "image": {
            "url": "https://files.factuarea.com/products/sustrato-20l.jpg",
            "alt": "Sustrato universal 20 L"
          }
        },
        {
          "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9c03",
          "variant_id": null,
          "presentation_id": null,
          "configuration_id": null,
          "name": "Semillas de huerto (sobre)",
          "slug": "semillas-huerto",
          "quantity": "4.0000",
          "unit": {
            "code": "C62",
            "label": "Unidad"
          },
          "image": {
            "url": "https://files.factuarea.com/products/semillas-huerto.jpg",
            "alt": "Semillas de huerto (sobre)"
          }
        }
      ],
      "availability": {
        "status": "low",
        "quantity": "3"
      },
      "updated_at": "2026-10-20T08:15:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Aquesta resposta no té cos.

Query param desconegut

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_unknown",
    "message": "El parámetro 'per_page' no está reconocido por este endpoint.",
    "param": "per_page",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_unknown",
    "request_id": "req_01HKQS5N7UR6PWJ8K2T5BWPMZ9"
  }
}

El paràmetre té un format no vàlid

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_format",
    "message": "El parámetro 'created' debe seguir el formato ISO-8601 (YYYY-MM-DDTHH:mm:ssZ).",
    "param": "created",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_format",
    "request_id": "req_01HKQS5N7UR6PWJ8K2T5BWPMZA"
  }
}

El valor del paràmetre està fora de rang

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_range",
    "message": "El parámetro 'limit' debe estar entre 1 y 100, recibido: 500.",
    "param": "limit",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_range",
    "request_id": "req_01HKQS5N7UR6PWJ8K2T5BWPMZB"
  }
}

S'ha enviat la capçalera X-Active-Profile retirada

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_unknown",
    "subcode": "retired_active_profile_header",
    "message": "La cabecera 'X-Active-Profile' fue retirada de la API v1: la empresa efectiva se indica en el segmento de empresa de la ruta.",
    "param": "X-Active-Profile",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_unknown",
    "request_id": "req_01J8Y3M2Q40000000000000001"
  }
}

Capçalera Factuarea-Version malformada

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_format",
    "message": "El header 'Factuarea-Version' debe tener formato YYYY-MM-DD.",
    "param": "Factuarea-Version",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_format",
    "request_id": "req_01J8Y3M2Q40000000000000002"
  }
}

Factuarea-Version no admesa

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_api_version",
    "message": "La versión de API '2020-01-01' no está soportada.",
    "param": "Factuarea-Version",
    "doc_url": "https://docs.factuarea.com/guides/errors#unsupported_api_version",
    "request_id": "req_01J8Y3M2Q40000000000000003"
  }
}

Falta l'API key

{
  "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"
  }
}

Format d'API key no vàlid

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "La API key no tiene el formato esperado (debe empezar por fact_live_ o fact_test_).",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#invalid_api_key",
    "request_id": "req_01HKQS5N9JTQM7HVTQP3FBN5XB"
  }
}

API key revocada

{
  "error": {
    "type": "authentication_error",
    "code": "api_key_revoked",
    "message": "Esta API key ha sido revocada y ya no es válida.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#api_key_revoked",
    "request_id": "req_01HKQS5NA8K7E2V9YDZWMT6RJC"
  }
}

API key caducada

{
  "error": {
    "type": "authentication_error",
    "code": "api_key_expired",
    "message": "Esta API key ha caducado.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#api_key_expired",
    "request_id": "req_01HKQS5NAPIKEYEXPIRED00008"
  }
}

IP de la petició fora de la llista d'accés de l'API key

{
  "error": {
    "type": "authentication_error",
    "code": "ip_not_allowed",
    "message": "La IP 203.0.113.10 no está autorizada para esta API key.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#ip_not_allowed",
    "request_id": "req_01HKQS5NIPNOTALLOWED000009"
  }
}

L'API key no té el scope requerit

{
  "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"
  }
}

Cal millorar el pla

{
  "error": {
    "type": "authorization_error",
    "code": "feature_not_available_in_plan",
    "message": "Esta funcionalidad requiere el plan empresario o superior. Actualiza tu suscripción para acceder.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#feature_not_available_in_plan",
    "request_id": "req_01HKQS5NCK4V9N2L7Y8X3WPMRE"
  }
}

Pla sense accés a l'API pública

{
  "error": {
    "type": "authorization_error",
    "code": "addon_not_active",
    "message": "Tu plan actual no incluye acceso a la API pública. Contrata o renueva un plan de Factuarea para usar la API.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#addon_not_active",
    "request_id": "req_01HKQS5NDP5W0Q3M8Z9A4BVSNF"
  }
}

Mòdul no disponible amb una clau de prova

{
  "error": {
    "type": "authorization_error",
    "code": "module_not_available_in_sandbox",
    "message": "El módulo \"verifactu\" no está disponible en modo de pruebas. Usa una clave fact_live_ para operar sobre este recurso.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#module_not_available_in_sandbox",
    "request_id": "req_01HKQS5NMODULESANDBOX00010"
  }
}

Privilegi de proveïdor de comptes no concedit

{
  "error": {
    "type": "authorization_error",
    "code": "privileged_scope_required",
    "message": "Esta operación exige el privilegio de proveedor de cuentas (accounts:*) y la persona que emitió la clave debe ser propietaria o administradora de la cuenta",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#privileged_scope_required",
    "request_id": "req_01HKQS5NPRIVILEGEDSCOPE001"
  }
}

Operació del compte propietari sobre un NIF al qual s'arriba per una relació

{
  "error": {
    "type": "authorization_error",
    "code": "forbidden_action",
    "message": "Esta operación solo la puede hacer la cuenta dueña del NIF: con un acceso por relación entre cuentas no está disponible.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#forbidden_action",
    "request_id": "req_01HKQS5NRELATIONNIFOWNER01"
  }
}

Empresa desactivada

{
  "error": {
    "type": "authorization_error",
    "code": "company_inactive",
    "message": "Esta empresa está desactivada. Actívala para operar.",
    "param": "company",
    "doc_url": "https://docs.factuarea.com/guides/errors#company_inactive",
    "request_id": "req_01J8Y3M2Q40000000000000005"
  }
}

Recurs no trobat

{
  "error": {
    "type": "not_found_error",
    "code": "resource_not_found",
    "message": "El recurso solicitado no existe o pertenece a otra empresa.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#resource_not_found",
    "request_id": "req_01HKQS5NEQ6X1R4N9B0C5DWTPG"
  }
}

Empresa no trobada o fora de l'abast de l'API key

{
  "error": {
    "type": "not_found_error",
    "code": "profile_not_found",
    "message": "La empresa indicada no existe o no está en el ámbito de tu credencial.",
    "param": "company",
    "doc_url": "https://docs.factuarea.com/guides/errors#profile_not_found",
    "request_id": "req_01J8Y3M2Q40000000000000004"
  }
}

{
  "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"
  }
}

Límit de peticions superat

{
  "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"
  }
}

Massa errors d'autenticació (bloqueig temporal)

{
  "error": {
    "type": "authentication_error",
    "code": "too_many_auth_failures",
    "message": "Has alcanzado el número máximo de intentos de autenticación fallidos. La API key queda bloqueada temporalmente. Reintenta tras el tiempo indicado en `Retry-After`.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#too_many_auth_failures",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVM"
  }
}

Massa pujades simultànies en curs

{
  "error": {
    "type": "rate_limit_error",
    "code": "upload_in_flight_budget_exceeded",
    "message": "Tu empresa tiene demasiadas subidas en curso a la vez: este archivo ocupa 10 MB y el margen simultáneo es de 120 MB. Espera a que terminen las subidas en marcha y vuelve a intentarlo dentro de 45 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#upload_in_flight_budget_exceeded",
    "request_id": "req_01HKQS5NUPLOADINFLIGHT005"
  }
}

Límit de peticions de tota l'empresa superat (totes les claus combinades)

{
  "error": {
    "type": "rate_limit_error",
    "code": "company_rate_limit_exceeded",
    "message": "Tu empresa ha superado su límite conjunto de 900 peticiones por minuto, contando a la vez todas sus credenciales. Es un techo de la empresa, así que repartir el tráfico no lo eleva. Reintenta en 12 segundos, o solicita una ampliación de plan si necesitas más capacidad.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#company_rate_limit_exceeded",
    "request_id": "req_01HKQS5NCOMPANYRATELIMIT06"
  }
}

Quota mensual de tota l'empresa exhaurida (totes les claus combinades)

{
  "error": {
    "type": "rate_limit_error",
    "code": "company_monthly_quota_exceeded",
    "message": "Tu empresa ha agotado su cuota conjunta de 150000 peticiones de este mes, contando a la vez todas sus credenciales. Es un techo de la empresa, así que repartir el tráfico no lo eleva. El contador se reinicia el día 1 del mes siguiente; solicita una ampliación de plan si necesitas más volumen antes.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#company_monthly_quota_exceeded",
    "request_id": "req_01HKQS5NCOMPANYMONTHLY0007"
  }
}

Quota mensual de l'API key esgotada

{
  "error": {
    "type": "rate_limit_error",
    "code": "monthly_quota_exceeded",
    "message": "Has agotado tu cuota mensual de 100000 requests. Mejora tu plan para obtener una cuota superior.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#monthly_quota_exceeded",
    "request_id": "req_01HKQS5NMONTHLYQUOTA000011"
  }
}

Límit de peticions de la cartera superat (tots els NIF del compte junts)

{
  "error": {
    "type": "rate_limit_error",
    "code": "portfolio_rate_limit_exceeded",
    "message": "La cartera de tu cuenta ha superado su límite conjunto de 1800 peticiones por minuto, contando a la vez todos sus NIF. Es un techo de la cartera, así que repartir el tráfico entre NIF no lo eleva. Reintenta en 12 segundos, o solicita una ampliación de plan si necesitas más capacidad.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#portfolio_rate_limit_exceeded",
    "request_id": "req_01HKQS5NPORTFOLIORATE00012"
  }
}

Quota mensual de la cartera esgotada (tots els NIF del compte junts)

{
  "error": {
    "type": "rate_limit_error",
    "code": "portfolio_monthly_quota_exceeded",
    "message": "La cartera de tu cuenta ha agotado su cuota conjunta de 300000 peticiones de este mes, contando a la vez todos sus NIF. Es un techo de la cartera, así que repartir el tráfico entre NIF no lo eleva. El contador se reinicia el día 1 del mes siguiente; solicita una ampliación de plan si necesitas más volumen antes.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#portfolio_monthly_quota_exceeded",
    "request_id": "req_01HKQS5NPORTFOLIOMONTH0013"
  }
}

{
  "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"
  }
}

Llistar tots els packs

Authorization

Paràmetres de ruta

Paràmetres de consulta

Headers

Cos de la resposta

200application/json

304

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`