Skip to main content
Cada cuenta (empresa emisora) configurada en Fegora tiene asignado un ambiente: Pruebas o Producción. El ambiente determina contra qué entorno del certificador (SAT/MH/DGII, vía Digifact u otro certificador) se certifican los DTE emitidos por esa cuenta.

El ambiente vive en la cuenta

El campo que define el ambiente es estaEnAmbienteDePruebas 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.
Al crear una cuenta nueva (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 con POST /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 forzarAmbientePruebasCuenta en producciónCuenta en pruebas
(omitido)Se certifica en producciónSe certifica en pruebas
trueSe certifica en pruebasSe certifica en pruebas
falseSe certifica en producciónSe 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.
No use documentos emitidos en ambiente de pruebas como comprobantes fiscales reales frente a sus clientes o ante la autoridad tributaria.

Filtrar documentos y cuentas por ambiente

  • GET /dte acepta el parámetro enAmbienteDePruebas (true/false) para listar sólo los documentos de un ambiente. Si se omite, se usa el ambiente configurado en la cuenta indicada por idCuenta.
  • GET /cuenta acepta el parámetro estaEnAmbienteDePruebas (true/false) para listar sólo cuentas de un ambiente.