Mode test
Prova la integració sense tocar producció.
Prova el flux real amb dades i numeració aïllades. Res no arriba a Hisenda, FACe ni als teus clients.
- El mateix contracte al flux principal
- Dades i numeració separades
- El prefix decideix l'entorn
Integracions i formats compatibles
WhatsApp
Anatomia de la clau
El prefix decideix l'entorn
Empresa sandbox aïllada. Efectes externs bloquejats.
La teva empresa real. Numeració fiscal, AEAT, correus i webhooks reals.
Cap paràmetre pot enviar per error una petició de test a producció. L'entorn el decideix la clau que envies.
Comprova la connexió
export FACTUAREA_API_KEY='fact_test_…'
curl https://api.factuarea.com/v1/account \
-H 'Authorization: Bearer $FACTUAREA_API_KEY'Desa la clau fact_test_ a la variable i executa la primera crida.
La frontera
Tot s'executa. Res no surt fora.
Crea la factura, calcula impostos i recorre els estats. El sandbox conserva el resultat i neutralitza només les sortides que tocarien tercers.
- Prova respostes realsValidacions, totals, estats i errors fan servir el mateix contracte del flux principal.
- Aïlla cada sortidaL'AEAT queda en local, el correu no s'entrega, l'esdeveniment es desa i FACe torna un registre sintètic.
- Coneix les dues excepcionsEl ping sí que comprova connectivitat i signatura. Les operacions irreversibles ho continuen sent.
Factura
201 · creada
AEAT
registre només local
Correu
no entregat
Webhook
livemode: false
Dades separades de debò
Prova amb numeració pròpia sense tocar la real
El sandbox és una altra empresa amb clients, documents i sèries propis. Una clau de producció no veu ni consumeix mai els seus recursos.
- Numeració a partLa numeració de proves fa servir les sèries del sandbox. Mai no consumeix ni altera la seqüència de les teves sèries de producció.
- Aïllament per empresaNo és un filtre sobre les mateixes dades: són dues empreses. Una clau live no veu els recursos de test, ni a l'inrevés.
- Recursos independentsLes dades creades en test no passen a producció. El sandbox serveix per validar la integració, no per preparar l'arrencada real.
fact_live_…
FRA 2026/0183
FRA 2026/0184
fact_test_…
FRA 2026/0006
FRA 2026/0007
De proves a producció
Canviar d'entorn és canviar una variable
No hi ha doble implementació per a les operacions disponibles als dos entorns. La forma de la petició és idèntica: el que canvia és la clau que envies.
- Crea la clau liveAmb els mateixos scopes que ja vas validar en proves. El secret es retorna en clar exactament un cop: desa'l en aquell moment.
- Substitueix la clauAllà on la tinguis: la variable d'entorn, el gestor de secrets, la configuració del desplegament. Res més.
- No toquis el codiLa forma de la petició és la mateixa per a les operacions disponibles als dos entorns, així que no hi ha res per adaptar en aquest flux.
24 h
La finestra de gràcia en rotar
Secret anterior
Secret nou
Rotar emet un secret nou i el retorna un sol cop. L'anterior es continua acceptant durant 24 hores, així que pots desplegar sense tallar el servei. Quan es tanca la finestra, l'anterior deixa de valer.
Superfície publicada
Una integració que encaixa amb el teu stack
El contracte OpenAPI, els SDK i el servidor MCP parteixen de la mateixa API. Les xifres es revisen contra la superfície publicada perquè puguis avaluar l'abast i el manteniment abans d'integrar.
- operacions API
- 413
- recursos
- 37
- eines MCP
- 391
- pàgines de documentació
- 797
Tecnologies i clients compatibles
TypeScript
PHP
OpenAPI
Cursor
Els logotips identifiquen tecnologies o clients compatibles; no impliquen una relació comercial ni un testimoni.
Dubtes
Tres dubtes abans de començar
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.
Prova la integració amb dades aïllades
Crea una clau fact_test_ i valida tot el circuit abans d'activar producció.