Preguntas Frecuentes (FAQ)
Respuestas técnicas detalladas para desarrolladores e integradores sobre la normativa e-CF, errores comunes y arquitectura.
1. ¿Cómo se protegen la clave privada y la contraseña de mi certificado PFX?
Las claves privadas de los certificados se procesan estrictamente en memoria (System.Security.Cryptography.X509Certificates) al momento de realizar la firma XMLDSig. Las contraseñas se almacenan cifradas en reposo utilizando AES-256 y jamás se escriben en disco desprotegidas.
2. ¿Tengo un entorno de pruebas gratuito para integrar mi sistema?
Sí. El entorno Sandbox es 100% ilimitado y gratuito. Al generar una API Key con el prefijo sec_test_... puedes enviar comprobantes de prueba y validar el comportamiento de tu sistema ante los servidores de homologación de la DGII sin costo alguno.
3. ¿Qué sucede si los servidores de la DGII están fuera de línea (HTTP 503)?
Medasoft detecta automáticamente la indisponibilidad de la DGII, aplica la firma digital con código de contingencia y entrega de inmediato la representación gráfica con código QR para no detener la operación de venta. El portal reintenta automáticamente la transmisión en segundo plano cuando los servidores tributarios se restablecen.
4. ¿Puedo emitir e-CF para múltiples RNCs desde una sola cuenta de desarrollador?
Sí. A través de la arquitectura Multi-Tenant, puedes dar de alta N empresas en tu panel y especificar a cuál cliente pertenece cada solicitud mediante la cabecera HTTP X-RNC-Emisor: 130862345.
5. ¿Qué diferencia existe entre un e31 (Crédito Fiscal) y un e32 (Consumo)?
El e31 está destinado a transacciones B2B que sustenten crédito fiscal de ITBIS (18%) y costos para Impuesto sobre la Renta (ISR), requiriendo un RNC de comprador válido. El e32 está dirigido a consumidores finales; si el monto es menor a RD$250,000 no requiere RNC/Cédula del comprador.
6. ¿Cómo se renueva un certificado PFX a punto de vencer?
Ingresa al módulo Empresas, selecciona la pestaña Certificado Digital, sube el nuevo archivo .pfx emitido por la Cámara de Comercio de Santo Domingo e ingresa la contraseña. El portal reemplaza el certificado en memoria sin causar caídas en el servicio.
7. ¿Dónde puedo consultar los logs de errores cuando la DGII rechaza un comprobante?
Puedes consumir el endpoint GET /logs/errors?Page=1&PageSize=20 o acceder a la sección Logs del portal, donde verás el motivo exacto del rechazo informado por la DGII (ej: ERR-DGII-404: RNC del comprador no se encuentra activo).