Consultar un pack

Consulta un pack por su id, con su precio, componentes, galería y, en view=all, su disponibilidad y su estado interno. - view=storefront devuelve la vista web.

Un pack que no está a la venta ahí responde 404 como un id desconocido. - Lecturas condicionales: envía If-None-Match para obtener 304 sin cuerpo.

Authorization

AuthorizationBearer <token>

Tu API key como token Bearer: fact_live_… en producción, fact_test_… en sandbox. Consulta la guía de autenticación.

En: header

Parámetros de ruta

company*string

Identificador público (UUID v7) de la empresa. Obtenlo de GET /v1/me (data.scope[].id).

Formatouuid

pack*string

Identificador público (UUID v7) del pack.

Formatouuid

Parámetros de consulta

date?|

Día (YYYY-MM-DD, zona horaria de la empresa) para el que se resuelve la promotion. Por defecto, hoy. Una fecha con hora usa su día. Formato incorrecto: 400 parameter_invalid_iso8601.

view?string

Forma del pack: all (por defecto) devuelve el pack completo y storefront solo lo que puede mostrar una tienda web, y únicamente de los packs a la venta ahí. Cualquier otro pack responde 404.

Predeterminado"all"

Valor en"all" | "storefront"

Petición condicional: envía el ETag que guardaste de una respuesta anterior de esta operación (entrecomillado, tal como se recibió) para obtener 304 Not Modified sin cuerpo cuando el contenido no ha cambiado. Omítelo para recibir siempre la respuesta completa.

Factuarea-Version?string

Fija la versión de la API (YYYY-MM-DD, versionado por fecha estilo Stripe) para esta petición; omítelo para usar la versión fijada de la clave, o la última si no hay ninguna. Versión no soportada → 400 unsupported_api_version; malformada → 400 parameter_invalid_format. La versión efectiva se refleja en la cabecera de respuesta Factuarea-Version. Consulta la guía de Versioning.

Formatodate

Cuerpo de la respuesta

`application/json`

Ejemplo de petición

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/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01", {  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());

Ejemplo de respuesta

GET /v1/companies/{company}/packs/{pack} · 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"
  }
}

GET /v1/companies/{company}/packs/{pack} · 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"
  }
}

GET /v1/companies/{company}/packs/{pack} · 200 (view=storefront, on promotion)

{
  "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": {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f9e02",
      "name": "Precio especial Pack Huerto",
      "label": "Oferta",
      "price": {
        "net": "46.12",
        "tax": "8.78",
        "gross": "54.90"
      },
      "regular_price": {
        "net": "50.53",
        "tax": "9.37",
        "gross": "59.90"
      },
      "previous_price": {
        "net": "50.53",
        "tax": "9.37",
        "gross": "59.90"
      },
      "reduction_percent": 8.35,
      "announce_reduction": true,
      "starts_at": "2026-11-14T00:00:00+01:00",
      "ends_at": "2026-11-30T23:59:59+01:00",
      "is_extension": false,
      "history_complete": true
    },
    "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"
  }
}

Esta respuesta no tiene cuerpo.

Query param desconocido

{
  "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ámetro tiene un formato no válido

{
  "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ámetro está fuera de rango

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

Se envió la cabecera 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"
  }
}

Cabecera 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 admitida

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

Formato de API key no válido

{
  "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ón fuera de la lista de acceso de la 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"
  }
}

La API key carece del scope requerido

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

Se requiere mejorar el plan

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

Plan sin acceso a la 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ódulo no disponible con una clave de prueba

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

Privilegio de proveedor de cuentas no concedido

{
  "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ón de la cuenta propietaria sobre un NIF al que se llega por una relación

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

Recurso no encontrado

{
  "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 encontrada o fuera del alcance de la 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"
  }
}

Límite de peticiones superado

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

Demasiados fallos de autenticación (bloqueo 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"
  }
}

Demasiadas subidas simultáneas en curso

{
  "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ímite de peticiones de toda la empresa superado (todas las claves combinadas)

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

Cuota mensual de toda la empresa agotada (todas las claves combinadas)

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

Cuota mensual de la API key agotada

{
  "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ímite de peticiones de la cartera superado (todos los NIF de la cuenta juntos)

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

Cuota mensual de la cartera agotada (todos los NIF de la cuenta juntos)

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

Consultar un pack

Authorization

Parámetros de ruta

Parámetros de consulta

Headers

Cuerpo de la respuesta

200application/json

304

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`