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:
403si 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).409conmissingsi la empresa está en producción y el cambio la dejaría sin poder emitir.401sin 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.