> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fegora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes: pruebas y producción

> Cómo funciona el modo de pruebas de Fegora y qué implica para la validez fiscal de un DTE.

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 `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) |

<Note>
  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.
</Note>

## 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**.

<Warning>
  No use documentos emitidos en ambiente de pruebas como comprobantes fiscales reales frente a sus clientes o ante la autoridad tributaria.
</Warning>

## 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.