API Facturación

Comparación de Entornos

La API de Facturación Electrónica proporciona dos entornos distintos: Pruebas (Sandbox) y Producción. Esta guía detalla las diferencias clave entre ambos y cuándo utilizar cada uno.

Importante

Los documentos emitidos en el entorno de producción tienen validez fiscal real. Asegúrate de que tu implementación está completamente probada antes de pasar a producción.

Tabla comparativa de entornos

Característica Pruebas (Sandbox) Producción
Código de ambiente 00 01
Certificado digital Se puede usar certificado de prueba Requiere certificado oficial emitido por una autoridad certificadora
Validez fiscal Sin validez fiscal Validez fiscal completa

¿Cuándo usar cada entorno?

Entorno de Pruebas (Sandbox)

Utiliza el entorno de pruebas para:

  • Desarrollo y pruebas iniciales de la integración
  • Pruebas de escenarios y casos de uso específicos
  • Validación de formatos y reglas de negocio de su sistema
  • Pruebas de rendimiento y estrés (con límites)
  • Capacitación a usuarios
  • Simulación de contingencias

💡 Consejo: En el entorno de pruebas, puedes simular diferentes escenarios de error cambiando los valores de los documentos. Por ejemplo, puedes forzar un error de "InvalidTotalAmount" enviando un total que no coincida con la suma de los ítems.

Entorno de Producción

Utiliza el entorno de producción para:

  • Emisión de documentos fiscales oficiales
  • Operaciones comerciales reales
  • Después de haber validado completamente la integración en el entorno de pruebas
  • Cuando se cuenta con la certificación del Ministerio de Hacienda para el ambiente de producción

⚠️ Advertencia: El entorno de producción está sujeto a auditorías por parte del Ministerio de Hacienda. Asegúrate de seguir todas las normativas fiscales y de mantener respaldos adecuados de tus operaciones.

Migración de Pruebas a Producción

Al migrar de pruebas a producción, ten en cuenta estos aspectos clave:

Antes de migrar

  • Verifica todos los escenarios en el entorno de pruebas
  • Obtén el certificado digital oficial autorizado
  • Realiza la certificación con el Ministerio de Hacienda
  • Prepara un plan de contingencia y recuperación

Después de migrar

  • Monitoriza las primeras emisiones de documentos
  • Verifica los documentos recibidos en el portal de Hacienda
  • Establece un sistema de respaldo y auditoría
  • Prueba regularmente el sistema de contingencia

Cambiando entre entornos

Para cambiar entre entornos, debes actualizar dos aspectos en tu implementación:

  1. Código de ambiente: Modifica el campo MH_AMBIENT_CODE en las variables de entorno y la API internamente se configurará para cada ambiente.