Entorno de pruebas
Bilteo separa producción y pruebas en tenants distintos, no con un flag sobre el mismo tenant. Tu tenant de pruebas (sandbox) tiene sus propias series, clientes y facturas, aislados del tenant real, y sus API keys llevan el prefijo bk_test_.
Con OAuth2, el usuario puede autorizar la conexión para el tenant de pruebas en el selector de empresas (o con su tenant_id). El access token queda ligado a ese tenant y usa los mismos scopes que una API key. Para operar en producción, autoriza otra conexión para el tenant real. Consulta Autenticación y scopes.
Producción vs pruebas
Producción (bk_live_…) | Pruebas (bk_test_…) | |
|---|---|---|
| Datos | Tu tenant real | Tenant sandbox, aislado |
| Numeración | Series legales reales | Series propias (no quema números reales) |
| AEAT | Producción | Homologación (nunca producción) |
| Documentos | Factura válida | Marca de agua TEST, sin validez fiscal |
Una factura emitida en pruebas nunca es un documento fiscal real: lleva marca de agua «TEST» con la leyenda de documento de prueba, y su registro Veri*Factu nunca se remite a producción de la AEAT.
Comportamiento Veri*Factu en pruebas
Por defecto, emitir en un tenant de pruebas funciona igual que en producción pero contra los servicios de test de la AEAT: se genera el registro y se remite a homologación. Así puedes probar el ciclo asíncrono completo (pending → in-process → accepted | rejected), incluido el flujo de subsanación de un registro rechazado.
Si solo quieres ejercitar tu integración sin depender de la AEAT, configura tu tenant de pruebas (desde el panel de Bilteo) con el ajuste verifactu.test_behavior:
| Valor | Al emitir en pruebas |
|---|---|
aeat_test (por defecto) | Genera el registro Veri*Factu y lo remite a la homologación de la AEAT. |
skip | No genera ni remite registro. La factura se emite (se numera y pasa a issued) pero sin registro Veri*Factu asociado. |
Solo afecta a pruebas
verifactu.test_behavior no tiene ningún efecto en producción. Un tenant live genera y remite siempre su registro Veri*Factu a la AEAT: no existe ninguna forma de desactivarlo.
skip y la anulación
En modo skip la factura no tiene registro, así que no se puede anular vía Veri*Factu (la anulación exige un registro aceptado por la AEAT). Es un atajo para probar tu flujo de emisión, no el ciclo completo. Para probar aceptaciones, rechazos y anulaciones, usa aeat_test.