Recursos & Soporte
Historial de Versiones & Changelog
Registro completo de publicaciones exitosas, nuevas funcionalidades y actualizaciones del portal Medasoft e-CF.
Este documento registra el historial de publicaciones exitosas del portal SaaS y la API de Facturación Electrónica Medasoft e-CF bajo la normativa de la Ley 32-23 y Decreto 587-24 de la DGII.
🚀 Versión Actual: v1.6.0 (18 de Agosto de 2026)
⚙️ Mejoras de Comportamiento del Motor & API
- [Motor XML / e-CF] Corrección de Notas de Crédito Código 2 (Corrección de Texto):
- En la sección
<Totales>, la evaluación de campos condicionales (MontoGravadoTotal,MontoGravadoI1..3,MontoExento,ITBIS1..3,TotalITBIS,TotalITBIS1..3) se realiza ahora sobre importes sumados mayores a cero (> 0) y no solo por la existencia de la línea. - Para comprobantes con
MontoTotal = 0.00(E34 con Código 2),<Totales>emite exclusivamente<MontoTotal>0.00</MontoTotal>, eliminando los rechazos 1930 y 1960 de la DGII.
- En la sección
- [Esquema XSD] Limpieza de Descuentos Globales en
<Totales>:- Remoción de los elementos
<MontoDescuentosGlobales>y<MontoRecargosGlobales>del interior de<Totales>, alineando la estructura estrictamente a la secuencia esperada por el validador XSD oficial de la DGII. Los descuentos globales se aplican directamente en el cálculo deMontoTotaly se declaran en<DescuentosORecargos>.
- Remoción de los elementos
- [Robustez de Validación HTTP]:
- Peticiones enviadas sin la sección
DetallesItems, con array vacío o sinEncabezadodevuelven ahora una respuesta estructurada400 Bad Requestcon detalle claro en lugar de una excepción interna500.
- Peticiones enviadas sin la sección
- [Cálculo de OtraMoneda]:
- Alineación estricta de la fórmula
TotalITBISOtraMoneda = Math.Round(TotalITBIS / TipoCambio, 2)y garantía de sumatoria exactaTotalITBIS1OtraMoneda + TotalITBIS2OtraMoneda == TotalITBISOtraMoneda.
- Alineación estricta de la fórmula
📚 Actualizaciones Documentales & Guías
- Payload de Ejemplo para Notas de Crédito Código 2: Inclusión del ejemplo JSON completo y validado en la Guía de Notas de Crédito y en la ficha del E34.
- Clarificación de Reenvíos Idempotentes (
codigo: "0"/reenviado: true): Documentación del comportamiento de retransmisiones para comprobantes previamente aceptados por la DGII. - Regla del Balance Disponible y Anulación Total: Explicación de la incompatibilidad de emitir una anulación total (Código 1) sobre facturas que ya tienen notas parciales (Código 3) aceptadas.
🛠️ Versión: v1.5.0 (17 de Agosto de 2026)
- 10 Guías Maestras por Tipo de e-CF (E31 al E47): Creación de la sección dedicada con documentación técnica detallada para cada comprobante electrónico:
E31: Factura de Crédito Fiscal Electrónica (B2B).E32: Factura de Consumo Electrónica (B2C con umbral de RD$250,000).E33: Nota de Débito Electrónica conInformacionReferencia.E34: Nota de Crédito Electrónica (Códigos 1 al 5 y balance disponible).E41: Comprobante de Compras Electrónico con retenciones de ITBIS e ISR.E43: Comprobante de Gastos Menores Electrónico (100% Exento).E44: Regímenes Especiales Electrónico (Zonas Francas y Turismo).E45: Comprobante Gubernamental Electrónico (Instituciones del Estado).E46: Exportaciones Electrónico (Tasa Cero 0%, datos aduanales e Incoterms).E47: Pagos al Exterior Electrónico (Servicios no residentes y retención ISR).
- Matrices de Obligatoriedad Específicas: Desglose de campos obligatorios
[1], condicionales[2], opcionales[3]y prohibidos[0]por tipo de documento. - Payloads JSON Copiables (1-Clic): Ejemplos completos y validados listos para emitir mediante
POST /fe/recepcion/ecf.
🛠️ Versión: v1.4.0 (17 de Agosto de 2026)
- Enriquecimiento Integral con Estándares DGII v1.0: Incorporación directa de especificaciones del Formato e-CF v1.0 y del Informe Técnico v1.0 de la DGII.
- Catálogos Maestros Oficiales: Publicación de páginas dedicadas para los 10 tipos de e-CF (E31 al E47), catálogo completo de 62 Unidades de Medida (Tabla IV DGII, aclarando Unidad 43 vs Galón 15), 39 códigos de Impuestos Adicionales e ISC (Tabla I DGII) con fórmulas y codificación ONE de provincias/municipios (Tabla III).
- Guía de Notas de Crédito (E34) & Débito (E33): Documentación de
InformacionReferencia, códigos de modificación (1: Anula, 2: Corrige texto con total en 0, 3: Corrige montos, 4: Reemplazo contingencia, 5: Consumo), plazo de 30 días para ITBIS (IndicadorNotaCredito) y la regla del balance disponible de la DGII. - Tolerancias de Cuadratura & Precisión Decimal: Documentación de la regla de $\pm 1.00$ DOP de tolerancia por línea y global de la DGII, así como soporte de hasta 4 decimales en
PrecioUnitarioItem. - Protocolos de Contingencia & Formatos XML: Guía sobre contingencia física con comprobantes Serie B preimpresos, regularización en Serie E con código 4 y flujos de XML
<ARECF>,<ACECF>y<ANECF>. - Códigos de Rechazo DGII: Catálogo de errores frecuentes (615, 645, 1930, 1960) y soluciones prácticas.
- Detalle de Autenticación & Perfil: Documentación del modo oficial
{ apiKey, apiSecret }, respuesta{ token }y contrato actualizado deGET /company/me.
🛠️ Versión: v1.3.3 (10 de Agosto de 2026)
- Migración de
SysTbAcusedeRecibospor Empresa: La consulta y almacenamiento de registros de compras (acuses de recibo) se realiza de forma aislada dentro de la base de datos dedicada de cada empresa (Db_{RNC}_FE). - Creación Dinámica Automática (DDL): Verificación condicional
IF NOT EXISTSal consultar o aprovisionar bases de datos para garantizar la presencia de la tablaSysTbAcusedeRecibos. - Filtros de Fecha en Registro de Compras: Optimización de consultas directamente sobre la base de datos de cada empresa por rango de fechas
Desde/Hasta.
🛠️ Versión: v1.3.1 (10 de Agosto de 2026)
- Corrección de Navegación del Header: Configuración explícita de
nav.url = /docsen el sitio Fumadocs para asegurar que el clic en la marca/logo lleve al inicio de la documentación en lugar del Portal Principal. - Acceso Directo al Portal Principal: Inclusión del enlace "Volver al Portal" en la barra de navegación superior.
🛠️ Versión: v1.3.0 (10 de Agosto de 2026)
- Reestructuración y Enriquecimiento de Documentación: Eliminación de textos repetitivos en
docs-sitey especialización técnica de cada sección. - Guía Multi-Tenant & Casas de Software (ISVs): Explicación detallada del enrutamiento dinámico por cabecera
X-RNC-Emisor, aislamiento de secuencias e-NCF y monitoreo de cuotas de facturación. - Especificación de Comprobantes e-CF (E31 - E47): Desglose completo de las reglas tributarias de la DGII para los 9 tipos de comprobantes y esquemas de nodos JSON de emisión.
- Protocolos B2B y Conformidad Comercial: Integración de diagramas de secuencia para el flujo de Acuse de Recibo (
ARECF) y Aprobación/Rechazo Comercial. - Resiliencia & Contingencia: Guía de mejores prácticas con estrategias de reintento exponencial, manejo de errores
HTTP 503y conservación legal por 10 años. - Glosario Ampliado & FAQ: Definición de 12 términos clave de la DGII y respuestas técnicas para integradores.
🛠️ Versión: v1.2.0 (10 de Agosto de 2026)
- Enriquecimiento del Developer Portal: Documentación oficializada de los 8 endpoints principales de la plataforma REST.
- Botón de Copiado 1-Clic: Incorporación del botón "Copiar Payload" en formatos JSON y XML en la especificación interactiva.
- SDK Multilenguaje: Ejemplos optimizados de integración para C# .NET 9, Java 21, Node.js (Axios), Python 3, PHP 8 y cURL CLI.
- Políticas de Seguridad: Remoción total de dependencias públicas Swagger UI en producción.
- Sistema de Versionado: Integración del modal de notas de versión (Changelog) en la interfaz del portal.
🛠️ Versión: v1.1.0 (1 de Agosto de 2026)
- Firma Digital en Memoria: Módulo criptográfico
System.Security.Cryptography.X509Certificatespara firma XMLDSig con certificados PFX sin almacenar archivos desprotegidos en disco. - Seguridad Hash SHA-256: Autenticación de llaves API mediante algoritmos hashing unidireccionales.
- Recepción B2B de Comprobantes: Generación y firma del Acuse de Recibo (
ARECF) en formato XML. - Reportes Paginados: Consultas eficientes de comprobantes emitidos, facturas de compras y logs de auditoría de errores.
🏛️ Versión: v1.0.0 (15 de Julio de 2026)
- Lanzamiento Inicial: Plataforma C-Suite eCF Developer Portal & API.
- Tipos de e-CF Soportados: Emisión y validación completa para los 9 tipos de comprobantes fiscales electrónicos (
e31,e32,e33,e34,e41,e43,e45,e46,e47). - Sistema de Alertas SMTP: Notificaciones por correo vía Office 365 para caídas del servicio DGII y vencimiento de certificados digitales.
Protocolos de Contingencia y Formatos XML del Ecosistema
Procedimientos de contingencia física con comprobantes Serie B, regularización posterior en Serie E (Código 4) y especificación de XMLs ARECF, ACECF y ANECF.
Códigos de Error Frecuentes y Respuestas DGII
Catálogo de códigos de rechazo comunes de la DGII (615, 645, 1930, 1960, etc.), validaciones tributarias y guía de resolución rápida.
