Saltar al contenido principal

Integración Multi-tenant (Múltiples Empresas / Clientes)

Si eres una casa de software, desarrollador de ERP, sistema de POS o integrador SaaS, es probable que tu plataforma gestione la facturación de decenas o cientos de empresas (RNCs) diferentes desde una misma infraestructura central.

Etribux está diseñado desde su núcleo con aislamiento estricto multi-inquilino (multi-tenant) para permitirte operar de forma centralizada sin mezclar datos, certificados ni secuencias entre contribuyentes.

Diagrama de Aislamiento Multi-tenant​

Principios de Aislamiento en Etribux​

1. Custodia Independiente de Certificados Digitales​

Cada empresa registrada en Etribux carga su propio archivo de certificado digital (.p12 o .pfx) con su contraseña correspondiente.

  • El certificado de la Empresa A nunca se utiliza para firmar comprobantes de la Empresa B.
  • La firma digital se realiza de forma estrictamente aislada y cifrada para cada empresa.

2. Control de Secuencias e-NCF por RNC​

Las secuencias de comprobantes fiscales están vinculadas exclusivamente al RNC del emisor. Si la Empresa A emite el comprobante E310000000001, la Empresa B puede emitir su propio E310000000001 sin colisión ni interferencia alguna, ya que cada serie pertenece a su respectivo contribuyente ante la DGII.

3. Autenticación y Tokens por Tenant​

Para emitir en nombre de un cliente, tu sistema utiliza las credenciales (API Key o token JWT) emitidas para ese tenant específico:

# Emisión para Empresa A
curl -X POST "https://api.etribux.com/ecf/api/v1/documents" \
  -H "Authorization: Bearer <TOKEN_EMPRESA_A>" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

# Emisión para Empresa B
curl -X POST "https://api.etribux.com/ecf/api/v1/documents" \
  -H "Authorization: Bearer <TOKEN_EMPRESA_B>" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Cómo Configurar Nuevos Clientes desde tu ERP​

  1. Creación de la Cuenta del Cliente: Cada uno de tus clientes se da de alta en el portal de Etribux con su RNC y datos de emisor.
  2. Carga de Certificado Digital: Se carga el archivo .p12 del cliente en el portal o vía API segura de aprovisionamiento.
  3. Generación de Credenciales de API: Se genera una API Key para el entorno deseado (testecf, certecf o ecf).
  4. Almacenamiento en tu ERP: Tu ERP asocia esa API Key a la configuración de la sucursal o empresa en su base de datos interna.

Monitoreo y Facturación por Consumo​

Desde el panel de integrador en el Portal de Etribux puedes:

  • Visualizar el volumen mensual de e-CF emitidos por cada una de tus empresas cliente.
  • Monitorear el estado de salud de los certificados (alertas de vencimiento con 30 y 15 días de anticipación).
  • Revisar el registro de acuses comerciales y eventos de entrega de cada cliente en tiempo real.