Configurar credenciales
Registra las credenciales del sistema de transmisión de factura electrónica de una empresa.
Registra las credenciales de facturación electrónica generadas al momento de registrar a la empresa como emisor de factura electrónica desde el portal factura.gob.sv. Útiliza este endpoint en el onboarding del emisor, antes de cargar el certificado y facturar.
Lumen requiere de estas credenciales para poder facturar en nombre de la empresa cuando realices peticiones HTTP a nuestra API. Así mismo, firmar de manera digital las facturas emitidas con el propio certificado otorgado por el portal de factura.gob.sv.
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/companies/{taxRegistrationNumber}/compliance-configstaxRegistrationNumber es el NRC de la empresa. Puedes enviarlo con o sin guiones. La empresa debe existir previamente; ver Crear empresa.
Payload
| Campo | Tipo | Descripción |
|---|---|---|
environment | string | Ambiente: SANDBOX o PRODUCTION |
apiKey | string | Es la clave de acceso a la API de facturación electrónica. Se almacena cifrada. |
publicKey | string | Es la clave pública de firma simple. Se almacena cifrada. |
privateKey | string | Es la clave privada de firma simple. Se almacena cifrada. |
Puedes tener una configuración por empresa y ambiente. Tras el 201, el estado queda en PENDING_CERTIFICATE hasta que cargues el certificado de firma electrónica.
Ejemplo de Solicitud
curl -X POST https://api-sandbox.lumendte.com/v1/companies/123456-7/compliance-configs \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tu_access_token" \
-d '{
"environment": "SANDBOX",
"apiKey": "ak_live_8f3c9d2b7a1e4f5b",
"publicKey": "pk_8f3c9d2b7a1e4f5b",
"privateKey": "sk_8f3c9d2b7a1e4f5b"
}'Response Success
Status: 201 Created
Guarda el configId: lo necesitas para cargar el certificado digital. La respuesta no incluye apiKey, publicKey ni privateKey.
{
"configId": "28adc4f9-31bc-45fe-a817-e36404145276",
"status": "PENDING_CERTIFICATE",
"taxRegistrationNumber": "123456-7",
"environment": "SANDBOX",
"createdAt": "2026-08-07T18:30:00.000Z"
}Ejemplo de errores
404 — Empresa no encontrada
No existe una empresa con ese NRC bajo tu cuenta.
{
"errorCode": "COMPANY_NOT_FOUND",
"message": "Company with taxRegistrationNumber 123456-7 was not found for tenant <tenant-uuid>",
"error": "Not Found",
"statusCode": 404
}Fix: Verifica el NRC del path o crea la empresa antes de registrar credenciales.
409 — Configuración duplicada
Ya existe una configuración de cumplimiento para esa empresa en el mismo environment.
{
"errorCode": "COMPANY_CREDENTIAL_ALREADY_EXISTS",
"message": "A compliance configuration already exists for taxRegistrationNumber 123456-7 in environment SANDBOX",
"error": "Conflict",
"statusCode": 409
}Fix: No intentes configurar las credenciales nuevamente. Continúa con el configId ya creado para cargar el certificado.