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.
Medasoft e-CF admite autenticación segura mediante tokens JWT Bearer generados a través del endpoint POST /login.
🔐 Endpoint: POST /login
Autentica una empresa registrada utilizando sus credenciales de servicio apiKey y apiSecret.
Petición HTTP (POST)
POST /login HTTP/1.1
Host: medasoftfe.com
Content-Type: application/json
accept: */*
{
"apiKey": "ak_live_8f9e0a1b2c3d4e5f",
"apiSecret": "sk_live_9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d"
}Respuesta Exitosa (200 OK)
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI0NzY1NGYwMS0yZjJhLTQ9..."
}Expiración y Uso del Token: El token devuelto tiene una validez estándar de 24 horas (verificable en el claim
expdel JWT). Debe incluirse en todas las peticiones protegidas dentro de la cabeceraAuthorization: Bearer <token>.
🏢 Endpoint: GET /company/me
Devuelve la información del perfil de la empresa vinculada al token JWT, el ambiente de la DGII conectado, el estado del certificado digital y el consumo mensual de comprobantes.
Petición HTTP (GET)
GET /company/me HTTP/1.1
Host: medasoftfe.com
Authorization: Bearer YOUR_JWT_TOKENRespuesta Exitosa (200 OK)
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "MEDASOFT SRL",
"registryNumber": "131592511",
"isActive": true,
"dgiiServer": "testecf",
"invoicesCountCurrentMonth": 42,
"invoiceLimitPerMonth": 500,
"signatureName": "MEDASOFT_CERT_2026.pfx",
"signatureExpirationDate": "2028-07-19T00:00:00Z"
}Descripción de Propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
id | Guid | Identificador único unívoco de la empresa en el sistema. |
name | string | Razón Social legal registrada en la DGII. |
registryNumber | string | RNC o Cédula fiscal de la empresa emisora. |
isActive | boolean | Estado operativo de la cuenta en el portal. |
dgiiServer | string | Servidor DGII al que transmite la cuenta: testecf (Precertificación/Test), certecf (Certificación) o ecf (Producción). |
invoicesCountCurrentMonth | int | Total de comprobantes emitidos en el mes calendario actual. |
invoiceLimitPerMonth | int | Cuota máxima de comprobantes mensuales contratada. |
signatureName | string | Nombre del archivo de certificado digital registrado. |
signatureExpirationDate | string (ISO) | null | Fecha de expiración del certificado digital X.509 (.p12/.pfx). En sandbox puede retornar null si no está configurada fecha explícita. |
Vista General de la API REST
Especificación oficial de los endpoints de la API de Facturación Electrónica Medasoft.
Especificación y Estructura de Documentos e-CF (E31 - E47)
Guía exhaustiva sobre los 10 tipos de Comprobantes Fiscales Electrónicos de la Ley 32-23, estructura de nodos JSON/XML, diccionarios de datos y reglas tributarias.