Integración API
Vista General de la API REST
Especificación oficial de los endpoints de la API de Facturación Electrónica Medasoft.
La API REST de Medasoft e-CF expone la suite completa de servicios para la recepción, transmisión, consulta y aprobación comercial de Comprobantes Fiscales Electrónicos (e-CF) bajo la Ley 32-23 y el Decreto 587-24 de la DGII.
🛠️ Endpoints Oficiales de la Plataforma
🔐 1. Autenticación & Perfil de Empresa
POST /login: Autenticación de Empresa porapiKey/apiSecretoid/password. Devuelve el token JWT Bearer.GET /company/me: Obtiene el perfil de la empresa autenticada, servidor DGII configurado, facturas consumidas en el mes y vencimiento del certificado digital PFX.
⚡ 2. Emisión e-CF
POST /fe/recepcion/ecf: Emisión en formato JSON para los 9 tipos de e-CF (e31,e32,e33,e34,e41,e43,e45,e46,e47). Firma automáticamente el XML y lo transmite a la DGII.
🔄 3. Recepción B2B & Aprobación Comercial
POST /fe/recepcion/api/ecf: Recepción B2B de archivos XML multipart/form-data. Genera y firma el Acuse de Recibo (ARECF) en XML.POST /fe/aprobacioncomercial/api/ecf: Recepción y registro de XML de Aprobación Comercial emitida por compradores o la DGII.
📊 4. Consultas, Reportes & Logs de Auditoría
GET /reports/encf: Reporte unificado y paginado de todos los e-NCFs procesados (Aceptados y Rechazados) con filtros avanzados.GET /fe/compras: Consulta paginada de facturas electrónicas de compras recibidas de proveedores.GET /logs/errors: Historial paginado de errores XML y fallas de comunicación para auditoría técnica.
📡 Entornos de Ejecución
- Sandbox (Pruebas & Homologación):
https://medasoftfe.com(Ambiente de Pruebas DGII) - Producción (Live Fiscal):
https://medasoftfe.com(Ambiente de Certificación / Producción 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.
Autenticación API & Endpoint /login
Cómo autenticarse en la API de Medasoft mediante credenciales API Key/Secret o endpoint /login, gestión de tokens JWT y consulta de perfil de empresa.
