Configurar envío por OSE
PATCH /api/company/sunat-config
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Mismo endpoint que Configurar envío directo a SUNAT: este ejemplo cambia el envío a un OSE con su usuario, clave y URL.
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 completa.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
soap_send_id |
string | No | 01 Sunat, 02 Ose, 04 OseSendfact. Ver la tabla de modos de envío. |
sunat_sol_username |
string (máx. 255) | No | Usuario secundario SOL: RUC de la empresa + usuario (p. ej. 20123456789VENTAS01). |
sunat_sol_password |
string (máx. 255) | No | Clave SOL. Solo escritura. Si no se envía se conserva la guardada; si cambias el usuario debes enviar su clave. |
ose_username |
string (máx. 255) | No | Usuario del OSE (modos 02 y 04). |
ose_password |
string (máx. 255) | No | Clave del OSE. Solo escritura. Si no se envía se conserva la guardada. |
soap_url |
string (URL, máx. 255) | No | URL del servicio del OSE (obligatoria en modo 02 para producción). |
soap_username / soap_password |
string | No | Alias: se guardan como usuario/clave SOL en modo 01 o del OSE en modos 02/04. Con PSE responden 422. |
sunat_client_id |
string (máx. 255) | No | Client ID de la aplicación API de SUNAT (guías de remisión, SIRE). |
sunat_client_secret |
string (máx. 255) | No | Client Secret. Solo escritura. Va en pareja con sunat_client_id. |
soap_type_id |
string | No | 01 (demo) o 02 (producción). Solo para cambiar de entorno: ver Pasar a producción y Volver a demo. |
environment |
string | No | Alias de soap_type_id: demo o production. |
confirm_production |
boolean | Para pasar a producción | true para confirmar el paso a producción. |
confirm_demo |
boolean | Para volver a demo | true para confirmar el regreso a demo. |
Reglas:
- Edición parcial: solo cambia lo que envías; lo demás se conserva. Un campo de clave vacío o ausente conserva la clave guardada.
- Las claves (
sunat_sol_password,ose_password,sunat_client_secret) son de solo escritura: la respuesta solo dice si existen (has_*). - En modo
01(Sunat) el envío de comprobantes usa el usuario y la clave SOL. - Si la empresa ya está en producción, un cambio que la deje sin poder emitir (p. ej. pasar a OSE sin URL) responde
409con los faltantes que agrega. - Al cambiar credenciales se invalidan los tokens de SUNAT guardados; el siguiente envío pide uno nuevo.
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.422{success: false, message: {campo: [errores]}}si falla la validación de campos. (faltaose_usernameuose_password).409conmissingsi la empresa está en producción y el cambio la dejaría sin poder emitir (p. ej. sinsoap_url).401sin token o con un token inválido.
Cuerpo
Content-Type: application/json
{
"soap_send_id": "02",
"ose_username": "usuario-ose",
"ose_password": "********",
"soap_url": "https://ose.proveedor.pe/ol-ti-itcpe/billService"
}
Respuestas
200 — Guardado
{
"success": true,
"data": {
"editable": true,
"environment": {
"soap_type_id": "01",
"code": "demo",
"description": "Demo"
},
"send_mode": {
"soap_send_id": "02",
"description": "Ose",
"channel": "ose",
"uses_pse": false
},
"sol_user": "20123456789VENTAS01",
"has_sol_password": true,
"soap_url": "https://ose.proveedor.pe/ol-ti-itcpe/billService",
"ose": {
"username": "usuario-ose",
"has_password": true
},
"sunat_api": {
"client_id": "8c1f2a9e-0b6d-4c1e-9f3a-2d7e5b4a1c90",
"has_client_secret": true
},
"has_certificate": true,
"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
},
"pse": {
"enabled": false,
"provider": null,
"pse_provider_id": null,
"user_pse": null,
"has_password": false,
"has_credentials": false,
"url_signature_pse": null,
"url_send_cdr_pse": null,
"url_login_pse": null,
"client_id_pse": null
},
"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": "Configuración SUNAT actualizada."
}
422 — Faltan credenciales del OSE
{
"success": false,
"message": {
"ose_username": [
"El usuario del OSE es obligatorio."
],
"ose_password": [
"La clave del OSE es obligatoria."
]
}
}
409 — Dejaría producción sin emitir
{
"success": false,
"message": "La empresa está en producción y el cambio la dejaría sin poder emitir.",
"missing": [
{
"code": "ose_url",
"message": "Falta la URL del servicio del OSE (soap_url)."
}
]
}
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.