Mejores Prácticas de Integración & Producción

Esta guía reúne las mejores prácticas recomendadas por el equipo de ingeniería de Medasoft SRL para asegurar una integración de facturación electrónica resiliente, segura y de alto rendimiento.

---

🔒 1. Seguridad de Secretos y Firma Digital

• Variables de Entorno: Almacena siempre tus llaves X-Api-Key y contraseñas de certificados PFX en variables de entorno seguras (.env, AWS Secrets Manager o Azure Key Vault). NUNCA agregues claves en repositorios de código.
• Aislamiento de Claves: Emplea claves sec_test_... exclusivamente en entornos locales o staging de desarrollo. Reserva las llaves sec_live_... únicamente para servidores de producción.
• Custodia de Certificados PFX: Actualiza la firma digital en el portal con al menos 15 días de anticipación antes de la fecha de caducidad informada por la Cámara de Comercio.

---

⚡ 2. Estrategias de Rendimiento & Manejo de Reintentos

• Manejo de Respuestas HTTP 503 (Servicio DGII Interrumpido): Si la DGII presenta intermitencias, el portal firma el comprobante en modo Contingencia y lo encola. Tu aplicación debe capturar el estado Contingencia y no duplicar el envío del eNCF.
• Reintentos con Backoff Exponencial: Para consultas de reportes o estados, implementa reintentos exponenciales (1s, 2s, 4s, 8s) utilizando librerías como Polly (.NET) o Axios Retry (Node.js).
• Procesamiento Asíncrono de Lotes: Para facturación masiva o cierres de día (ej: supermercados o farmacias), envía las facturas en hilos en paralelo utilizando pools de conexiones HTTP con Keep-Alive.

---

📦 3. Sincronización y Respaldo Local (Ley 32-23)

• Retención Tributaria de 10 Años: Aunque Medasoft custodia tus archivos XML firmados y representaciones impresas en la nube por 10 años, se recomienda mantener un respaldo secundario en tus servidores locales mediante tareas programadas GET /reports/encf.