Quins permisos cal demanar?

El catàleg està tancat i utilitza permisos del tipus invoices:write o series:read. Es trien en crear la clau. El quickstart només demana els necessaris. Si en sol·licites un que el teu pla no inclou, l'error salta en crear la clau i no a mitja integració.

L'API cobreix el mateix que el programa?

Els 50 recursos van dels pressupostos al tancament mensual del control horari i als projectes i tasques, passant per VeriFactu, la factura electrònica per a l'Administració i els informes d'impostos. La regla és simple: el que no és a l'OpenAPI públic no és a l'API.

Es pot integrar sense escriure codi?

Sí, pel servidor MCP: són 581 eines que un agent pot fer servir directament, i 468 si la connexió és d'una aplicació de tercers per OAuth. És la mateixa API amb els mateixos permisos, cridada des d'un altre lloc.

API i MCP estan inclosos. La prova permet 10 peticions per minut i 100 al mes; Esencial, 30 i 5.000; Profesional i Avanzado, 300 i 50.000. Enterprise segons contracte. El cabal segueix el pla; els webhooks depenen del pla i els permisos.

Developers · API de facturació

API de facturació.Integrada al teu programari.

Integra factures, clients, PDF i Verifactu al teu ERP, SaaS o botiga en línia. Treballa amb REST, SDK oficials o MCP i valida el recorregut en un entorn de proves.

Crear el meu compte de proves Seguir el Quickstart

API i MCP inclosos als plans de pagament. Límits segons el pla.

Integracions i formats compatibles

Factuarea APIv1

GET/v1/invoices invoices:read

1curl --fail-with-body --silent --show-error \2  "https://api.factuarea.com/v1/invoices" \3  --header "Authorization: Bearer $FACTUAREA_API_KEY"

1import { Factuarea } from "@factuarea/sdk";23const factuarea = new Factuarea({4  apiKey: process.env.FACTUAREA_API_KEY!,5});67const invoices = await factuarea.invoices.list();89for await (const item of invoices) {10  const invoice = item as { id: string };11  console.log(invoice.id);12}

1use Factuarea\Sdk\Custom\FactuareaClient;2use Factuarea\Sdk\Custom\Pagination\PageIterator;3use Factuarea\Sdk\Models\Operations\PublicApiV1InvoicesListRequest;45$factuarea = FactuareaClient::create(getenv('FACTUAREA_API_KEY'));6$pages = new PageIterator(7  fn (?string $cursor) => $factuarea->invoices->publicApiV1InvoicesList(8    new PublicApiV1InvoicesListRequest(startingAfter: $cursor),9  )->rawResponse,10);11foreach ($pages->items() as $invoice) {12  echo $invoice['id'], PHP_EOL;13}

Extracte de resposta 200 OK

FAC-2026-00042Acme Soluciones SL

1.210,00 €status: paid

La teva aplicacióFactuarea APIResposta JSON

Fes servir una clau amb permís invoices:read al teu servidor. El codi consulta les teves factures; no crea documents.

Tria com integrar

Un compte. La teva manera de construir.

Connecta el teu programari, rep esdeveniments o dona accés a un assistent. Cada recorregut té la seva guia, permisos i exemples.

API REST

Els documents del teu negoci, des del teu codi.

Crea clients i esborranys, emet factures i recupera’n el PDF. El contracte OpenAPI documenta els camps, permisos i errors de cada operació.

1GET    /v1/contacts2POST   /v1/invoices3POST   /v1/invoices/{id}/send4GET    /v1/invoices/{id}/pdf

Clients, catàleg, vendes, despeses i informes en una mateixa API.

Explorar l’API REST

480 rutes publicades50 recursos

Consultar la referència completa

Prova abans d’emetre

El mateix contracte. Dos entorns separats.

Prova la integració amb una clau fact_test_. Quan estigui llesta, configura l’empresa, revisa els permisos i utilitza una clau de producció.

1Crea una clau amb els permisos necessaris.
2Prepara client, sèrie i impostos.
3Recorre esborrany, emissió i descàrrega del PDF.

Conèixer el sandbox Recórrer la meva primera factura

api.factuarea.com/v1

Proves

fact_test_•••• •••• ••••

Documents de prova, sense tramesa fiscal real. Els cobraments i WhatsApp estan restringits.

Producció

fact_live_•••• •••• ••••

Documents i operacions reals, subjectes a la configuració de l’empresa i al teu pla.

Control a cada petició

Dissenyada també per als reintents.

Una integració necessita saber què ha passat, què pot repetir i quan ha d’esperar. Aquests senyals estan documentats i es poden comprovar.

Una operació, encara que ho reintentis

Petició originalPOST /invoices

Mateixa clau i mateix cosIdempotency-Key

Mateix resultat · sense duplicar el document

Evita duplicats: Utilitza Idempotency-Key en les operacions compatibles. Un cos diferent amb la mateixa clau retorna un 409.
Accés limitat: Assigna scopes a cada clau. La integració rep els permisos que necessita per a la seva feina.
Quotes visibles: Consulta X-RateLimit-Remaining. Si reps un 429, respecta Retry-After abans de tornar-ho a intentar.
Esdeveniments verificables: Comprova Factuarea-Signature sobre el cos original del webhook abans de processar-lo.

Revisar autenticació i garanties Consultar plans i límits

Tria com connectar

Una integració que encaixa amb el teu stack

Treballa amb un SDK, consulta el contracte de l’API o connecta el teu assistent. Tria la teva eina per trobar el punt de partida i la documentació que necessites.

Tecnologies i clients compatibles

La teva eina → Factuarea

SDK oficial

La teva integració, en TypeScript

Instal·la l’SDK oficial per treballar amb l’API des de Node.js. Inclou reintents, paginació i verificació de la signatura de webhooks.

npm install @factuarea/sdkConnectar TypeScript

operacions API: 595
recursos: 50
eines MCP: 581
pàgines de documentació: 1306

Preguntes

El que es pregunta abans d'escriure la primera línia

Crea el teu compte i una clau de proves als ajustos de developers. El Quickstart explica els permisos, les dades prèvies i les peticions necessàries per recórrer una factura fins al PDF.

El teu negoci, més connectat

La teva propera integració comença amb una clau.

Crea el teu compte, tria els permisos i segueix el Quickstart fins a la primera factura a l’entorn de proves.

Comença gratis Anar al quickstart