Ambientes

El MH tiene dos ambientes, y Open Factura los mantiene separados de punta a punta:

Ambiente	Código	Clave de API	Valor fiscal
Pruebas	00	of_test_…	Ninguno
Producción	01	of_live_…	Legal

• El prefijo de la clave decide el ambiente. Una clave de pruebas nunca toca producción, ni al revés.
• El panel usa el ambiente guardado en el emisor (Emisor → Datos fiscales → Ambiente).
• Las credenciales del MH (contraseña de API y certificado) son distintas en cada ambiente: las de pruebas no sirven en producción.
• Cada clave ve sólo los documentos y eventos de su ambiente. Las claves de idempotencia también son independientes por ambiente.
• Los PDF del ambiente de pruebas advierten que el documento no tiene valor legal.

Si opera sobre un documento de otro ambiente, la API responde 409 ambiente_distinto.

Pasar a producción

1. Complete las pruebas mínimas que exige Hacienda y obtenga la autorización como emisor (vea Ser emisor ante Hacienda).
2. En el Sitio Emisores DTE, ambiente productivo, genere el certificado y la contraseña de API de producción.
3. En Emisor → Credenciales del MH, cárguelos para el ambiente 01 (PUT /api/v1/emisor/credenciales/01).
4. Para el panel, cambie el ambiente del emisor a producción. Para integraciones, cree una clave of_live_… con los permisos mínimos.
5. Emita un primer documento real y verifique su sello y su urlConsulta.

Precaución

Con una clave of_live_… cada emisión tiene efecto fiscal y consume un número de control. La CLI pide confirmación en producción; un asistente MCP debe pedirle a usted un “sí” explícito antes de emitir.