Ver configuración SUNAT
GET /api/company/sunat-config
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Estado de la configuración de facturación electrónica de la empresa: entorno, modo de envío, credenciales (sin secretos), certificado digital, PSE y qué falta para pasar a producción (ready_for_production). Úsalo antes y después de cada paso.
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).
Entorno (soap_type_id):
| Valor | Alias environment |
Significado |
|---|---|---|
01 |
demo |
Demo / beta: los comprobantes se envían al ambiente de pruebas de SUNAT (u OSE/PSE), sin validez legal. |
02 |
production |
Producción: los comprobantes se envían a SUNAT con validez legal. |
Modo de envío (soap_send_id):
| Valor | Descripción | Credenciales que necesita |
|---|---|---|
01 |
Sunat (envío directo) | Usuario secundario SOL (sunat_sol_username = RUC + usuario) y su clave (sunat_sol_password). |
02 |
Ose | Usuario y clave del OSE (ose_username, ose_password) y la URL del servicio (soap_url). |
04 |
OseSendfact | Usuario y clave del OSE (ose_username, ose_password). |
El envío por PSE (el proveedor firma y envía) no es un valor de soap_send_id: se activa con Configurar PSE (send_document_to_pse: true) y tiene prioridad sobre el modo de envío.
Campos de la respuesta (data):
| Campo | Descripción |
|---|---|
editable |
false si el proveedor del sistema bloqueó la configuración del entorno (los cambios de entorno, modo, credenciales SOL/OSE y certificado responden 403). |
environment |
soap_type_id (01/02), code (demo/production) y description. |
send_mode |
soap_send_id, description, channel efectivo (sunat, ose o pse) y uses_pse. |
sol_user / has_sol_password |
Usuario secundario SOL vigente y si tiene clave guardada. La clave nunca se devuelve. |
soap_url |
URL del servicio del OSE (solo modo 02). |
ose |
username y has_password del OSE (solo en modo OSE). |
sunat_api |
client_id y has_client_secret de la aplicación API de SUNAT (guías de remisión y SIRE). |
has_certificate / certificate |
Datos públicos del certificado: titular (subject), emisor, RUC detectado, si coincide con la empresa, vigencia (valid_from, valid_to), days_to_expire y expired. null si no hay certificado. Nunca incluye el certificado ni su clave. |
pse |
Configuración PSE sin la contraseña: enabled, provider, user_pse, has_password, has_credentials y las URL opcionales. |
ready_for_production |
ok y missing[] ({code, message}): lo que falta para pasar a producción. |
warnings[] |
Avisos que no bloquean ({code, message}): certificado por vencer (certificate_expiring, 30 días o menos), RUC del certificado no determinado (certificate_ruc_unknown), documentos creados en demo (demo_documents). |
Códigos de missing: certificate (no hay certificado), certificate_file (falta el archivo en el servidor), certificate_invalid (no se puede leer), certificate_expired, certificate_ruc_mismatch, send_mode, sol_credentials, sol_username (no empieza con el RUC), ose_credentials, ose_url, pse_provider, pse_user, pse_password. Con PSE no se pide certificado (firma el proveedor).
Errores:
403si el usuario no es administrador.401sin token o con un token inválido.
Respuestas
200 — Lista para producción
{
"success": true,
"data": {
"editable": true,
"environment": {
"soap_type_id": "01",
"code": "demo",
"description": "Demo"
},
"send_mode": {
"soap_send_id": "01",
"description": "Sunat",
"channel": "sunat",
"uses_pse": false
},
"sol_user": "20123456789VENTAS01",
"has_sol_password": true,
"soap_url": null,
"ose": {
"username": null,
"has_password": false
},
"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
}
]
}
]
}
}
200 — Faltan requisitos
{
"success": true,
"data": {
"editable": true,
"environment": {
"soap_type_id": "01",
"code": "demo",
"description": "Demo"
},
"send_mode": {
"soap_send_id": "01",
"description": "Sunat",
"channel": "sunat",
"uses_pse": false
},
"sol_user": "20123456789VENTAS01",
"has_sol_password": false,
"soap_url": null,
"ose": {
"username": null,
"has_password": false
},
"sunat_api": {
"client_id": "8c1f2a9e-0b6d-4c1e-9f3a-2d7e5b4a1c90",
"has_client_secret": true
},
"has_certificate": false,
"certificate": null,
"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": false,
"missing": [
{
"code": "certificate",
"message": "Suba el certificado digital (.pfx) de la empresa."
},
{
"code": "sol_credentials",
"message": "Faltan el usuario secundario SOL y su clave."
}
]
},
"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
}
]
}
]
}
}
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.