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

# Operación y seguridad

> Requisitos antes de desplegar o emitir comprobantes en producción.

# Operación y seguridad

Esta página reúne los controles operativos mínimos del ecosistema. Cada componente conserva además su guía específica de despliegue.

## Separación de ambientes

Mantén separados los ambientes `TEST`, `CERT` y `PRODUCTION`, sus empresas, API keys, rangos e-NCF y credenciales. No pruebes solicitudes de escritura con una API key de producción.

## Credenciales y datos fiscales

* Guarda secretos en el gestor de secretos del entorno y rótalos según el procedimiento operativo.
* No registres API keys, contraseñas, certificados privados, tokens DGII ni XML fiscales completos.
* No subas archivos `.env`, `.p12`, `.pfx`, `.pem` ni claves privadas al repositorio.
* Limita scopes y accesos a lo que cada integración requiere.

## FactrAPI en producción

* Completa la certificación real de la DGII antes de emitir documentos fiscales.
* Configura PostgreSQL con roles separados y controles RLS, Redis persistente para colas y almacenamiento S3 con Object Lock.
* Configura copias de seguridad y realiza una restauración de prueba.
* Publica API, worker y scheduler, y monitorea `/ready`, métricas y colas.
* Habilita `/docs` solo si la política de exposición de la API lo permite.

## Registro de pruebas

La colección Postman incluida en el repositorio de FactrAPI solo realiza comprobaciones de salud y consultas de lectura. Las pruebas de creación de documentos, reservas, respuestas comerciales y envíos a la DGII pueden modificar estado fiscal; ejecútalas únicamente en un ambiente aislado y con datos de prueba.

Consulta `factrApi/docs/OPERATIONS.md`, `factrApi/docs/SECURITY.md`, `factraCloud/docs/PRODUCCION.md` y `factraCloud/docs/OPERACION.md` para los procedimientos específicos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.