Aprovisionar un compte gestionat

Aprovisiona un compte SEPARAT per a un dels teus clients, amb el seu NIF, el seu pla i el teu access_level; el teu compte el paga. - Retorna 201 amb el val de reclamació mostrat EXACTAMENT UNA VEGADA, o enviat per email amb send_email: true. - Repetir un external_ref retorna 200 sense un val nou; Idempotency-Key és obligatòria. - Requereix l'scope privilegiat accounts:write.

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

Headers

Idempotency-Key*string

Clau opaca generada pel client (fins a 255 caràcters; es recomana UUID v7) que permet reintents segurs: la primera resposta s'emmagatzema i es reprodueix en les repeticions sense tornar a executar la mutació. Reutilitzar una clau amb un cos diferent retorna 422 idempotency_key_reused; els valors dels camps secrets (password, secret…) compten com a part del cos, així que reintentar amb un secret corregit sota la mateixa clau és una petició diferent, mai la repetició de la resposta anterior. Consulta la guia d'idempotència. Obligatòria en aquesta operació: repetir-la produeix un efecte irreversible (un correu enviat, un fitxer generat, una crida a un tercer o un càrrec), per la qual cosa una petició sense aquesta capçalera es rebutja amb 422 idempotency_key_required abans d'executar lògica de negoci.

Longitud1 <= length <= 255

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 petició

application/json

Definicions de TypeScript

Usa el tipus request body a TypeScript.

external_ref*string

La teva pròpia referència del compte (fins a 128 caràcters), única per proveïdor de comptes. Aprovisionar-lo de nou retorna el mateix compte (200) sense un val nou.

Longitudlength <= 128

plan*string

Pla del compte gestionat: emprendedor, empresario o integral. enterprise retorna 422 managed_account_plan_not_self_serve.

Valor a"emprendedor" | "empresario" | "integral" | "enterprise"

access_level?string

Nivell d'accés que el teu compte conserva sobre el compte gestionat: none (per defecte, només aprovisionament), view (només lectura) o operate.

Valor a"none" | "view" | "operate"

tax_id*string

Identificador fiscal espanyol (NIF, CIF o NIE) del compte gestionat.

Longitudlength <= 20

legal_name*string

Raó social del compte gestionat.

Longitud2 <= length <= 100

display_name?|

Nom visible del compte i del seu NIF; sense ell, la raó social.

Longitud2 <= length <= 120

address?|

Adreça fiscal.

Longitudlength <= 255

city?|

Ciutat de l'adreça fiscal.

Longitudlength <= 100

postal_code?|

Codi postal (deriva la zona AEAT).

Longitudlength <= 10

province?|

Província.

Longitudlength <= 100

country?|

País.

Longitudlength <= 100

language?|

Idioma del compte i del seu val de reclamació: es (per defecte), en o ca.

Valor a"es" | "en" | "ca" | null

owner_email?|

Email del titular del compte. Obligatori amb una clau live i sempre que send_email és true.

Formatemail

Longitudlength <= 255

send_email?boolean

Envia l'enllaç de reclamació per email a owner_email (true) o retorna el val una vegada a la resposta (false, per defecte).

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/accounts", {  method: "POST",  headers: { Authorization: `Bearer ${apiKey}`, ...{"Accept":"application/json","Content-Type":"application/json","Idempotency-Key":"erp-2026-public-api-v1-managed_accounts-create"} },  body: JSON.stringify({  "external_ref": "cliente-0042",  "plan": "emprendedor",  "access_level": "operate",  "tax_id": "B12345674",  "legal_name": "Talleres García SL",  "owner_email": "administracion@talleresgarcia.example",  "send_email": false}),});if (!response.ok) throw new Error(await response.text());if (response.status !== 204) console.log(await response.json());

Exemple de resposta

{
  "data": {
    "id": "0199a1f0-1c22-7a10-b111-6a6b6c6d6e6f",
    "object": "managed_account",
    "external_ref": "cliente-0042",
    "status": "provisioned",
    "environment": "live",
    "plan": "empresario",
    "pending_plan": null,
    "billing_interval": "monthly",
    "access_level": "operate",
    "display_name": "Talleres García",
    "language": "es",
    "companies": [
      {
        "id": "0199a1f0-1c22-7a10-b111-7a7b7c7d7e7f",
        "tax_id": "B12345674",
        "name": "Talleres García SL"
      }
    ],
    "claimed": false,
    "claimed_at": null,
    "management": {
      "status": "active",
      "ended_at": null
    },
    "paid_by_provider": true,
    "created_at": "2026-09-27T09:00:00+00:00",
    "claim": {
      "status": "valid",
      "issued_at": "2026-09-27T09:00:00+00:00",
      "expires_at": "2026-10-11T09:00:00+00:00",
      "ttl_days": 14,
      "sent_by_email": false,
      "masked_email": null
    },
    "payment_assumed_at": null,
    "plan_renews_at": "2026-10-27T09:00:00+00:00",
    "claim_token": "c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1",
    "claim_url": "https://app.factuarea.com/account-claims/accept?token=c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1c1a1",
    "claim_expires_at": "2026-10-11T09:00:00+00:00",
    "reactivated": false
  }
}

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

{
  "error": {
    "type": "payment_required_error",
    "code": "payment_method_required",
    "message": "Tu cuenta no tiene un método de pago: añade uno para dar de alta cuentas gestionadas.",
    "doc_url": "https://docs.factuarea.com/guides/errors#payment_method_required",
    "request_id": "req_0d7a1f0c22e4b8a91c3f5e0001"
  }
}

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

Secció retirada a la persona que va emetre la clau

{
  "error": {
    "type": "authorization_error",
    "code": "emitter_capability_restricted",
    "message": "El acceso a la sección «invoices» está restringido para la persona emisora de esta credencial en esta empresa. Pide al administrador de la empresa que lo habilite.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#emitter_capability_restricted",
    "request_id": "req_01J8Y3M2Q40000000000000012"
  }
}

Clau de prova en una escriptura que canvia un compte live

{
  "error": {
    "type": "authorization_error",
    "code": "live_credential_required",
    "message": "Esta operación modifica la cuenta y exige una clave de producción (fact_live_)",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#live_credential_required",
    "request_id": "req_01J8Y3M2Q40000000000000010"
  }
}

Escriptura amb accés de només lectura a l'empresa

{
  "error": {
    "type": "authorization_error",
    "code": "company_read_only",
    "message": "Tu acceso a esta empresa es de solo lectura.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#company_read_only",
    "request_id": "req_01J8Y3M2Q40000000000000011"
  }
}

El titular ja ha reclamat el compte

{
  "error": {
    "type": "conflict_error",
    "code": "provisioning_account_claimed",
    "message": "El titular ya ha reclamado esta cuenta: ya no se puede reclamar, reemitir su vale ni volver a provisionar.",
    "doc_url": "https://docs.factuarea.com/guides/errors#provisioning_account_claimed",
    "request_id": "req_01J8Y3M2Q4CF0000000000PAC1"
  }
}

`external_ref` utilitzat a l'altre entorn

{
  "error": {
    "type": "conflict_error",
    "code": "managed_account_external_ref_in_other_environment",
    "message": "Esta referencia externa ya la usa una cuenta gestionada del otro entorno (real o de pruebas): usa otra referencia.",
    "doc_url": "https://docs.factuarea.com/guides/errors#managed_account_external_ref_in_other_environment",
    "request_id": "req_01J8Y3M2Q4CF0000000000MER1"
  }
}

Reserva concurrent d'identificadors (reintentable)

{
  "error": {
    "type": "conflict_error",
    "code": "resource_conflict",
    "message": "Hay otra operación reservando identificadores sobre 'accounts' en este momento y no ha podido completarse la reserva. Vuelve a intentarlo dentro de unos segundos; la operación es reintentable y no ha dejado nada a medias.",
    "doc_url": "https://docs.factuarea.com/guides/errors#resource_conflict",
    "request_id": "req_01J8Y3M2Q4CF0000000000IDR1"
  }
}

El paràmetre no ha superat la validació

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

Format d'Idempotency-Key no vàlid

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_param_format",
    "message": "La Idempotency-Key debe tener entre 1 y 255 caracteres ASCII printable.",
    "param": "Idempotency-Key",
    "doc_url": "https://docs.factuarea.com/guides/errors#invalid_param_format",
    "request_id": "req_01HKQS5NIDEMPKEYFORMAT0007"
  }
}

Enterprise no és un pla d'autoservei

{
  "error": {
    "type": "invalid_request_error",
    "code": "managed_account_plan_not_self_serve",
    "message": "Una cuenta gestionada se crea en «emprendedor», «empresario» o «integral»; enterprise solo lo asigna Factuarea por contrato.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#managed_account_plan_not_self_serve",
    "request_id": "req_01HKQS5NMGDACCTPLANENTR01"
  }
}

Pla de pagament mentre el proveïdor de comptes està en trial

{
  "error": {
    "type": "invalid_request_error",
    "code": "managed_account_provider_in_trial",
    "message": "Durante tu periodo de prueba solo puedes crear cuentas gestionadas de pruebas.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#managed_account_provider_in_trial",
    "request_id": "req_01HKQS5NMGDACCTPROVTRIAL1"
  }
}

El NIF ja pertany a un altre compte

{
  "error": {
    "type": "invalid_request_error",
    "code": "business_rule_violation",
    "subcode": "nif_already_claimed_by_another_account",
    "message": "Este NIF ya pertenece a otra cuenta. Para traerlo a la tuya, pide a la cuenta que lo tiene un traspaso de NIF y acéptalo; un NIF no puede estar en dos cuentas a la vez.",
    "param": "tax_id",
    "doc_url": "https://docs.factuarea.com/guides/errors#business_rule_violation",
    "request_id": "req_01HKQS5NMGDACCTNIFCLAIMED1"
  }
}

Límit de comptes gestionats assolit

{
  "error": {
    "type": "invalid_request_error",
    "code": "managed_accounts_limit_reached",
    "message": "Has alcanzado el máximo de cuentas gestionadas de tu cuenta. Contacta con Factuarea para ampliarlo.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#managed_accounts_limit_reached",
    "request_id": "req_01HKQS5NMGDACCTLIMITRCH1"
  }
}

Un compte de proves no es pot reclamar

{
  "error": {
    "type": "invalid_request_error",
    "code": "managed_account_not_claimable",
    "message": "Esta cuenta no se puede reclamar: es una cuenta de pruebas.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#managed_account_not_claimable",
    "request_id": "req_01HKQS5NMGDACCTNOTCLAIM1"
  }
}

Pujar el nivell després de la reclamació

{
  "error": {
    "type": "invalid_request_error",
    "code": "access_level_raise_forbidden",
    "message": "El cliente ya ha reclamado su cuenta: solo él puede subir tu nivel de acceso.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#access_level_raise_forbidden",
    "request_id": "req_01HKQS5NMGDACCTLEVELRAI1"
  }
}

Contracte Enterprise sense pla de destinació

{
  "error": {
    "type": "invalid_request_error",
    "code": "enterprise_contract_transition_required",
    "message": "Tu cuenta tiene un contrato enterprise: Factuarea tiene que fijar antes el plan con el que continúas.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#enterprise_contract_transition_required",
    "request_id": "req_01HKQS5NMGDACCTENTTRANS1"
  }
}

Massa files en un fitxer d'importació

{
  "error": {
    "type": "invalid_request_error",
    "code": "import_row_limit_exceeded",
    "message": "El fichero de cuentas supera el máximo de 100 filas por importación: divídelo en varias.",
    "param": "accounts_file",
    "doc_url": "https://docs.factuarea.com/guides/errors#import_row_limit_exceeded",
    "request_id": "req_01HKQS5NMGDACCTIMPROWLIM1"
  }
}

Fitxer d'importació il·legible o falta una columna

{
  "error": {
    "type": "invalid_request_error",
    "code": "import_file_invalid",
    "message": "Falta la columna obligatoria «mode» en el fichero de cuentas: descarga la plantilla y conserva sus columnas.",
    "param": "accounts_file",
    "doc_url": "https://docs.factuarea.com/guides/errors#import_file_invalid",
    "request_id": "req_01HKQS5NMGDACCTIMPFILEIN1"
  }
}

Idempotency key reutilitzada amb un payload diferent

{
  "error": {
    "type": "idempotency_error",
    "code": "idempotency_key_reused",
    "message": "La Idempotency-Key 'order-2026-0001' ya se usó con un payload distinto.",
    "param": "Idempotency-Key",
    "doc_url": "https://docs.factuarea.com/guides/errors#idempotency_key_reused",
    "request_id": "req_01J8Y3M2Q40000000000000007"
  }
}

Falta la Idempotency-Key en una escriptura amb efecte extern

{
  "error": {
    "type": "invalid_request_error",
    "code": "idempotency_key_required",
    "message": "La operación «public-api.v1.invoices.send» exige la cabecera Idempotency-Key desde el 2026-10-01. Envía una clave única por operación (un UUID sirve) y, si reintenta, repite exactamente la misma clave para que la operación no se ejecute dos veces.",
    "param": "Idempotency-Key",
    "doc_url": "https://docs.factuarea.com/guides/errors#idempotency_key_required",
    "request_id": "req_01J8Y3M2Q40000000000000009"
  }
}

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

Aprovisionar un compte gestionat

Authorization

Headers

Cos de la petició

Cos de la resposta

201application/json

400application/json

401application/json

402application/json

403application/json

409application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`