Saltar al contenido
Facturador

Configurar PSE

PUT /api/company/pse-config

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Activa o desactiva el envío por PSE (el proveedor firma y envía los comprobantes; no se necesita certificado propio) y guarda sus credenciales. Edición parcial: lo que no envías se conserva.

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 la configuración PSE sin la contraseña (igual que pse en Ver configuración SUNAT).

Cuerpo (JSON):

Campo Tipo Obligatorio Descripción / valores permitidos
send_document_to_pse boolean No true activa el envío por PSE; false vuelve al modo de envío (soap_send_id).
pse_provider_id integer Si se activa Id de Proveedores PSE (activo).
user_pse string (máx. 255) Si se activa Usuario del PSE.
password_pse string (máx. 255) Si se activa y no hay una guardada Contraseña del PSE. Solo escritura; vacía o ausente conserva la guardada.
client_id_pse string (máx. 255) No Client ID, si el proveedor lo pide.
url_signature_pse, url_send_cdr_pse, url_login_pse string (URL) No URL propias del proveedor, solo si las pide.

Reglas:

  • El proveedor usa el ambiente de la empresa (demo o producción) con las mismas credenciales.
  • Si la empresa está en producción y desactivas el PSE sin tener certificado vigente, responde 409.

Errores:

  • 403 si el usuario no es administrador.
  • 422 {success: false, message: {campo: [errores]}} si falla la validación de campos. (proveedor inexistente o inactivo, falta el usuario o la contraseña al activar).
  • 409 con missing si la empresa está en producción y el cambio la dejaría sin poder emitir.
  • 401 sin token o con un token inválido.

Cuerpo

Content-Type: application/json

{
  "send_document_to_pse": true,
  "pse_provider_id": "3",
  "user_pse": "miusuario",
  "password_pse": "********"
}

Respuestas

200 — Guardado

{
  "success": true,
  "data": {
    "enabled": true,
    "provider": {
      "id": 3,
      "name": "qpse",
      "description": "QPSE",
      "active": true
    },
    "pse_provider_id": 3,
    "user_pse": "miusuario",
    "has_password": true,
    "has_credentials": true,
    "url_signature_pse": null,
    "url_send_cdr_pse": null,
    "url_login_pse": null,
    "client_id_pse": null
  },
  "message": "Configuración PSE guardada."
}

422 — Faltan credenciales

{
  "success": false,
  "message": {
    "user_pse": [
      "Debe ingresar el usuario de autenticación."
    ],
    "password_pse": [
      "Debe ingresar la contraseña de autenticación."
    ]
  }
}

409 — Producción sin certificado

{
  "success": false,
  "message": "La empresa está en producción y el cambio la dejaría sin poder emitir.",
  "missing": [
    {
      "code": "certificate",
      "message": "Suba el certificado digital (.pfx) de la empresa."
    }
  ]
}

403 — Usuario no administrador

{
  "success": false,
  "message": "Solo un administrador puede gestionar este recurso."
}

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.