Entorn de proves
Bilteo separa producció i proves en tenants diferents, no mitjançant un indicador dins del mateix tenant. El teu tenant de proves (sandbox) té les seves pròpies sèries, clients i factures, aïllats del tenant real, i les seves claus API tenen el prefix bk_test_.
Amb OAuth2, l'usuari pot autoritzar una connexió per al tenant de proves al selector d'empreses (o amb el seu tenant_id). L'access token queda vinculat a aquest tenant i fa servir els mateixos scopes que una clau API. Per accedir al tenant real, autoritza-hi una altra connexió. Consulta Autenticació i scopes.
Producció i proves
Producció (bk_live_…) | Proves (bk_test_…) | |
|---|---|---|
| Dades | El teu tenant real | Tenant sandbox, aïllat |
| Numeració | Sèries legals reals | Sèries pròpies (no consumeix números reals) |
| AEAT | Producció | Homologació (mai producció) |
| Documents | Factura vàlida | Marca d'aigua TEST, sense validesa fiscal |
Una factura emesa en proves mai no és un document fiscal real: inclou la marca d'aigua «TEST» i la llegenda de document de prova, i el seu registre Veri*Factu mai no s'envia a producció de l'AEAT.
Comportament de Veri*Factu en proves
Per defecte, emetre en un tenant de proves funciona igual que en producció, però contra els serveis de test de l'AEAT: es genera el registre i s'envia a homologació. Així pots provar tot el cicle asíncron (pending → in-process → accepted | rejected), inclòs el flux de subsanació d'un registre rebutjat.
Si només vols provar la teva integració sense dependre de l'AEAT, configura el tenant de proves (des del panell de Bilteo) amb l'ajust verifactu.test_behavior:
| Valor | En emetre en proves |
|---|---|
aeat_test (per defecte) | Genera el registre Veri*Factu i l'envia a l'entorn d'homologació de l'AEAT. |
skip | No genera ni envia cap registre. La factura s'emet (es numera i passa a issued), però sense cap registre Veri*Factu associat. |
Només afecta les proves
verifactu.test_behavior no té cap efecte en producció. Un tenant live sempre genera i envia el seu registre Veri*Factu a l'AEAT: no es pot desactivar.
skip i l'anul·lació
En mode skip, la factura no té registre i, per tant, no es pot anul·lar mitjançant Veri*Factu (l'anul·lació exigeix un registre acceptat per l'AEAT). És una drecera per provar el flux d'emissió, no el cicle complet. Per provar acceptacions, rebutjos i anul·lacions, utilitza aeat_test.