Registro de Cuenta & Configuración Inicial
Guía completa paso a paso para crear tu cuenta de desarrollador, registrar tu empresa por RNC, cargar tu certificado PFX y obtener credenciales de API.
Esta guía te acompañará durante el proceso de alta en el portal Medasoft e-CF, desde la creación de tu usuario hasta la obtención de tus claves de acceso para los entornos Sandbox y Producción.
1. Registro de Cuenta de Desarrollador
- Accede al formulario de registro en el portal oficial Medasoft e-CF.
- Ingresa tus datos de acceso: Nombre Completo, Correo Electrónico Corporativo, Nombre de la Empresa / Casa de Software y Contraseña Segura.
- Revisa tu bandeja de entrada y confirma tu dirección de correo electrónico a través del enlace de activación.
- Inicia sesión en el portal para acceder al Dashboard Principal.
2. Alta de Empresa y Asociación de RNC
Para emitir comprobantes fiscales electrónicos autorizados por la DGII, debes dar de alta al contribuyente emisor:
- En el menú lateral, dirígete a Empresas y haz clic en + Nueva Empresa.
- Completa los datos fiscales de la entidad:
- RNC (Registro Nacional del Contribuyente): Formato de 9 dígitos (empresas) u 11 dígitos (personas físicas).
- Razón Social: Nombre legal registrado ante la DGII.
- Nombre Comercial: Nombre de fantasía o marca de cara a los clientes.
- Dirección Fiscal & Teléfono: Datos de contacto corporativos.
- Selecciona el Servidor DGII de destino:
Sandbox / Test: Para desarrollo, pruebas y homologación.Production / Live: Para emisión de facturas fiscales reales.
3. Carga del Certificado Digital (Firma PFX / P12)
Conforme a la Ley 32-23, todos los e-CF deben estar firmados digitalmente mediante un certificado cualificado X.509:
- En la pestaña de la empresa, selecciona Certificado Digital.
- Sube tu archivo con extensión
.pfxo.p12emitido por una entidad de certificación autorizada en RD (ej: Cámara de Comercio de Santo Domingo - CCPSD o Viafirma). - Ingresa la Contraseña del Certificado.
- El sistema validará en memoria la vigencia, la cadena de confianza y que el RNC del certificado coincida exactamente con el RNC emisor.
[!IMPORTANT] Seguridad Criptográfica: Las claves privadas de los certificados se procesan estrictamente en memoria y no se almacenan desprotegidas en disco.
4. Generación de API Keys (Entornos Sandbox y Live)
- Ve a la sección API Keys en el menú principal.
- Haz clic en Generar Nueva API Key.
- Asigna un nombre descriptivo (ej:
ERP-Produccion-Servidor-1oPOS-Sucursal-Centro). - Selecciona el entorno deseado:
- Sandbox (
sec_test_...): Acceso al servidor de pruebas DGII con cuota ilimitada para homologación. - Producción (
sec_live_...): Acceso al entorno fiscal oficial.
- Sandbox (
- Copia la API Key y el API Secret generados. Guardalos de inmediato en un lugar seguro (variables de entorno
.envde tu servidor).
Bienvenido a la Documentación de Medasoft e-CF
Plataforma API para integración de Facturación Electrónica (e-CF) en República Dominicana certificada por la DGII.
Arquitectura Multi-Tenant & Casas de Software (ISVs)
Guía de integración para casas de software, sistemas ERP y plataformas POS que gestionan múltiples empresas o RNCs emisores desde una sola cuenta.
