Cargar certificado
Asocia el certificado .crt a las credenciales del sistema de transmisión de factura electrónica para poder firmar digitalmente y transmitir los DTE.
Este certificado lo obtienes al momento de registrar a la empresa como emisor de factura electrónica desde el portal factura.gob.sv.
Lumen requiere de este certificado para poder firmar digitalmente y transmitir las facturas emitidas en nombre de la empresa.
Asocia el certificado digital (.crt) a tus credenciales de facturación electrónica registradas en la empresa emisora. Útiliza este endpoint en el onboarding del emisor, justo después de configurar credenciales, para dejar la configuración en READY y poder emitir documentos tributarios electrónicos.
Método: POST
Nota
Es necesario el envío del token de acceso <access_token> para hacer uso de este endpoint. Para ver cómo generar el token, vea Cómo generar un token de acceso.
Recuerde: El token de acceso caduca cada hora.
Endpoint
https://api-sandbox.lumendte.com/v1/tax-compliance/{configId}/certificateconfigId es el UUID que recibiste al configurar credenciales. El body que debes enviar es multipart/form-data (no JSON).
Payload
| Campo | Tipo | Descripción |
|---|---|---|
certificateFile | file (binary) | Archivo del certificado digital de la empresa emisora. Debe tener extensión .crt |
Ejemplo de Solicitud
curl -X POST https://api-sandbox.lumendte.com/v1/tax-compliance/28adc4f9-31bc-45fe-a817-e36404145276/certificate \
-H "Accept: application/json" \
-H "Authorization: Bearer tu_access_token" \
-F "certificateFile=@./certificado.crt"Response Success
Status: 200 OK
Con status: READY la configuración queda lista para emitir DTEs. certificateName se deriva del NIT de la empresa emisora.
{
"configId": "28adc4f9-31bc-45fe-a817-e36404145276",
"environment": "SANDBOX",
"certificateName": "06142803901234.crt",
"status": "READY",
"updatedAt": "2026-08-07T20:15:00.000Z"
}Ejemplo de errores
400 — Extensión inválida
El archivo no tiene extensión .crt.
{
"errorCode": "INVALID_CERTIFICATE_FILE",
"message": "certificateFile must have a .crt extension",
"error": "Bad Request",
"statusCode": 400
}Fix: Asegurate de que estes enviando el archivo con extensión .crt.
404 — Configuración no encontrada
No existe una configuración de cumplimiento con ese configId bajo tu cuenta.
{
"errorCode": "COMPANY_CREDENTIAL_NOT_FOUND",
"message": "Compliance configuration with configId 28adc4f9-31bc-45fe-a817-e36404145276 was not found",
"error": "Not Found",
"statusCode": 404
}Fix: Usa el configId del 201 de configurar credenciales y verifica que el token corresponda al mismo tenant.