Saltar al contenido
Facturador

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 en warnings.
  • Si el servidor responde que el cifrado es antiguo, exporta el certificado de nuevo con cifrado AES.

Errores:

  • 403 si el usuario no es administrador.
  • 403 si 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.
  • 422 en message.password si la contraseña es incorrecta (o el archivo no es un .pfx).
  • 422 en message.file si no es .pfx/.p12, no tiene clave privada, está vencido o aún no es válido, o es de otro RUC.
  • 401 sin 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.