Subir certificado digital
POST /api/company/certificate
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Sube el certificado digital de la empresa (archivo .pfx o .p12 emitido por una entidad acreditada) con su contraseña. Antes de guardarlo se verifica que la contraseña lo abra, que contenga la clave privada, que esté vigente y que su RUC sea el de la empresa. Reemplaza al certificado anterior.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Formato de respuesta: estándar {success, data, message?} (registro único). data trae certificate (datos públicos), ready_for_production y warnings. Nunca devuelve el certificado ni la contraseña.
Cuerpo (multipart/form-data):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
file |
archivo | Sí | Certificado .pfx o .p12 (máx. 100 KB). |
password |
string | Sí | Contraseña del certificado. No se guarda. |
Reglas:
- El RUC se busca en el titular del certificado (serialNumber, organizationIdentifier, OU o CN). Si el certificado no trae RUC (p. ej. de persona natural con DNI) se acepta y se avisa en
warnings(certificate_ruc_unknown): verifica que sea de la empresa. - Renueva el certificado antes de
valid_to: un certificado vencido no permite emitir. Desde 30 días antes se avisa enwarnings. - Si el servidor responde que el cifrado es antiguo, exporta el certificado de nuevo con cifrado AES.
Errores:
403si el usuario no es administrador.403si el proveedor del sistema bloqueó la configuración del entorno de la empresa (editable: false): no se pueden cambiar entorno, modo de envío, credenciales SOL/OSE ni el certificado.422enmessage.passwordsi la contraseña es incorrecta (o el archivo no es un .pfx).422enmessage.filesi no es .pfx/.p12, no tiene clave privada, está vencido o aún no es válido, o es de otro RUC.401sin token o con un token inválido.
Cuerpo
Content-Type: multipart/form-data
| Campo | Tipo | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
file |
archivo | sí | Certificado .pfx o .p12. | |
password |
texto | sí | Contraseña del certificado. |
Respuestas
200 — Certificado guardado
{
"success": true,
"data": {
"certificate": {
"file_exists": true,
"readable": true,
"subject": "EMPRESA DEMO S.A.C.",
"organization": "EMPRESA DEMO S.A.C.",
"issuer": "ENTIDAD DE CERTIFICACION ACREDITADA",
"serial_number": "5A3F09C1D2",
"ruc": "20123456789",
"ruc_matches": true,
"valid_from": "2026-11-01 10:15:00",
"valid_to": "2027-11-01 10:15:00",
"days_to_expire": 358,
"expired": false,
"not_yet_valid": false
},
"ready_for_production": {
"ok": true,
"missing": []
},
"warnings": [
{
"code": "demo_documents",
"message": "Hay documentos creados en demo: bórrelos para evitar conflictos en producción.",
"types": [
{
"description": "Factura/Boleta o Nota de Crédito o Nota de Débito",
"count": 12
}
]
}
]
},
"message": "Certificado guardado."
}
422 — Contraseña incorrecta
{
"success": false,
"message": {
"password": [
"No se pudo abrir el certificado: la contraseña es incorrecta o el archivo no es un .pfx/.p12 válido."
]
}
}
422 — Otro RUC
{
"success": false,
"message": {
"file": [
"El certificado pertenece al RUC 20999999999 y la empresa es 20123456789."
]
}
}
422 — Vencido
{
"success": false,
"message": {
"file": [
"El certificado venció el 2026-10-31 23:59:59."
]
}
}
403 — Usuario no administrador
{
"success": false,
"message": "Solo un administrador puede gestionar este recurso."
}
403 — Configuración bloqueada
{
"success": false,
"message": "El proveedor del sistema bloqueó el cambio de entorno, modo de envío y credenciales SOL/OSE de esta empresa. Campos no permitidos: soap_send_id."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.