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.
La plataforma Medasoft e-CF está diseñada nativamente con una arquitectura Multi-Tenant que permite a desarrolladores, casas de software (ISVs) e integradores gestionar N empresas (RNCs) bajo un único panel de control de desarrollador.
🏛️ Beneficios de la Arquitectura Multi-Tenant
- Unificación de Credenciales de API: Administra múltiples RNCs emisores utilizando una sola API Key de desarrollador o generando claves independientes por cliente.
- Aislamiento Total de Datos: Cada empresa cuenta con sus secuencias de e-NCF, certificados digitales PFX, historial de comprobantes y logs de errores totalmente independientes.
- Asignación Flexible de Planes: Registra a cada cliente con la cuota mensual ajustada a su volumen estimado (desde planes micro hasta planes corporativos de más de 500,000 comprobantes).
- Entorno Sandbox Compartido Ilimitado: Todos los clientes y empresas secundarias pueden realizar pruebas de homologación ante la DGII sin costo adicional.
🔄 Enrutamiento Dinámico de Clientes por Encabezado HTTP
Para emitir o consultar comprobantes a nombre de una empresa o cliente específico dentro de tu cuenta multi-tenant, incluye el encabezado X-RNC-Emisor en cada solicitud HTTP:
POST /fe/recepcion/ecf HTTP/1.1
Host: medasoftfe.com
Authorization: Bearer YOUR_JWT_TOKEN
X-Api-Key: sec_live_9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d
X-RNC-Emisor: 131592511
Content-Type: application/jsonEl motor de Medasoft intercepta la petición, verifica que tu cuenta tenga permisos sobre el RNC 131592511, recupera el certificado PFX correspondiente de esa empresa y realiza la firma digital y transmisión a la DGII de forma transparente.
📊 Monitoreo de Cuotas y Consumo por Inquilino
A través del endpoint GET /company/me o el panel administrativo, puedes auditar en tiempo real el consumo de cada cliente:
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "EMPRESA CLIENTE 1 SRL",
"registryNumber": "131592511",
"isActive": true,
"dgiiServer": "Production",
"invoicesCountCurrentMonth": 3380,
"invoiceLimitPerMonth": 5000,
"signatureExpirationDate": "2027-05-15T00:00:00Z"
}Si un cliente alcanza el 90% o el 100% de su cuota mensual, el sistema envía notificaciones automáticas por correo electrónico vía SMTP Office 365 para prevenir interrupciones en la facturación.
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.
Vista General de la API REST
Especificación oficial de los endpoints de la API de Facturación Electrónica Medasoft.
