Medasoft Logo
Medasoft SRLe-CF Docs DGII
Primeros Pasos

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/json

El 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.

On this page