El ambiente vive en la cuenta
El campo que define el ambiente esestaEnAmbienteDePruebas en la cuenta:
estaEnAmbienteDePruebas: true→ la cuenta está en modo pruebas. Sus DTE se certifican contra el ambiente de pruebas del certificador.estaEnAmbienteDePruebas: false→ la cuenta está en producción. Sus DTE se certifican contra el ambiente real y tienen validez fiscal.
POST /cuenta), si no se indica el campo explícitamente, la cuenta se crea en modo pruebas por defecto.
Para pasar una cuenta de pruebas a producción (o viceversa), actualícela con PUT /cuenta/{id} o PATCH /cuenta/{id} indicando estaEnAmbienteDePruebas: false.
Cada DTE hereda el ambiente de su cuenta
Al emitir un documento conPOST /dte, el DTE se certifica en el mismo ambiente que la cuenta emisora — no es necesario indicar nada adicional.
De forma opcional, el body de POST /dte acepta el campo forzarAmbientePruebas para controlar el ambiente de ese documento en particular:
Valor de forzarAmbientePruebas | Cuenta en producción | Cuenta en pruebas |
|---|---|---|
| (omitido) | Se certifica en producción | Se certifica en pruebas |
true | Se certifica en pruebas | Se certifica en pruebas |
false | Se certifica en producción | Se certifica en pruebas (no se puede forzar producción sobre una cuenta de pruebas) |
Una cuenta de pruebas nunca puede emitir documentos con validez fiscal, sin importar el valor de
forzarAmbientePruebas. El campo sólo permite forzar el modo pruebas sobre una cuenta de producción — nunca al revés.Los DTE de prueba no son válidos fiscalmente
Un DTE emitido en ambiente de pruebas se certifica igual que uno de producción — recibe un número de autorización, XML certificado y PDF — pero el certificador lo procesa contra su ambiente de pruebas, no contra el sistema real de la autoridad fiscal (SAT, Ministerio de Hacienda o DGII, según el país). Esto significa que el documento es técnicamente válido (pasa todas las validaciones) pero no tiene validez fiscal.Filtrar documentos y cuentas por ambiente
GET /dteacepta el parámetroenAmbienteDePruebas(true/false) para listar sólo los documentos de un ambiente. Si se omite, se usa el ambiente configurado en la cuenta indicada poridCuenta.GET /cuentaacepta el parámetroestaEnAmbienteDePruebas(true/false) para listar sólo cuentas de un ambiente.