VeriFactu i AEAT
No es transmeten registres a l’AEAT. Les rutes del mòdul VeriFactu directe no estan disponibles al sandbox. Una prova no acredita acceptació fiscal.
Sandbox de facturació
Prova les factures en un entorn separat
Des de l’app o amb l’API, comprova documents, totals i estats abans de treballar amb dades reals. Les proves tenen empresa i numeració pròpies.
- Des de Factuarea
- Dades i numeració separades
- Des de la teva integració
FacturaEsborrany
Sense número assignatClientEstudio Ribera
Consultoria de dissenyQuantitat: 2 × 150,00 €300,00 €
- Base imposable
- 300,00 €
- IVA 21 %
- 63,00 €
- Total
- 363,00 €
Document de prova sense validesa fiscal
Dues empreses, dues numeracions
Sèrie de provesF-2026-0006
Sèrie de produccióF-2026-0184
L’esborrany no consumeix número. En emetre, només avança la sèrie de proves.
Validacions i resultats
Comprova també què passa quan alguna cosa falla
El sandbox aplica les validacions de les operacions disponibles. Pots revisar els totals d’una factura, corregir dades rebutjades i preparar la integració per respondre als errors.
POST /v1/invoices
fact_test_…Camps de la línia
"lines": [{
"quantity": 2,
"unit_price": 150,
"tax_rate": 21
}]Resultat201 Created
{
"data": {
"status": "draft",
"number": null,
"total": 363,
"currency": "EUR"
}
}Esborrany creat: 300,00 € de base i 63,00 € d’IVA. Encara no consumeix número.
També pots provar permisos, estats i idempotència. Fes servir les capacitats habilitades pel teu pla; el mode de proves no amplia l’accés ni elimina els límits de l’API.
Entendre els errors de l’APIQuè es comprova de debò
Prova el procés i coneix-ne els límits
Les dades estan separades de producció. Els enviaments fiscals i els correus de documents no arriben a tercers. Els webhooks tenen una excepció concreta: el ping de connexió.
Correu de documents
Pots recórrer l’enviament i els estats sense lliurar el correu al destinatari, tampoc a la teva bústia.
FacturaE i FACe
La presentació a FACe se simula. El registre FACE-SANDBOX-* no és una presentació real davant l’Administració.
Automatitzacions
Pots revisar disparadors i execucions. Els passos queden omesos amb sandbox_neutralized: no s’executa l’adaptador ni s’aplica la seva acció.
invoice.createdNomés registre internRegistrat, sense lliurament extern
Els esdeveniments de prova es poden consultar amb livemode: false. No s’envien al receptor extern.
GET /v1/events "livemode": false
Passa a producció amb el que has validat
Mateix contracte, recursos diferents
Per a les operacions disponibles als dos entorns, reutilitzes la integració. Prepares les dades reals i fas servir una credencial de producció nova; editar el prefix no converteix una clau en una altra.
Des de Factuarea
Entra al Mode de proves i comprova els documents. En tornar a Producció, recuperes el context de l’empresa real. Les dades de prova romanen separades.
Mode de provesProducció
A l’app tries l’entorn des de la capçalera; en mòbil, des del menú d’usuari. Una confirmació precedeix el canvi.Abans d’activar producció
0 de 3 punts revisatsMarca els punts que ja has comprovat a la teva integració.
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
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
Dubtes
Dubtes sobre el sandbox
No. Una clau fact_test_ opera sobre l'empresa sandbox i fa servir les sèries d'aquella empresa. La seqüència de les teves sèries de producció no es toca ni es consumeix.
El teu negoci, més connectatProva la integració amb dades aïllades
Genera una clau fact_test_ al panell de desenvolupadors. Envia-la a la mateixa URL de l’API, amb els permisos que necessiti l’aplicació.