Probar conexión
POST /api/company/sunat-config/test
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Prueba la configuración guardada sin enviar comprobantes: solo valida el certificado y pide tokens de acceso.
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 = {ok, checks: {certificate, pse?, sunat_api, ose?}}; cada prueba tiene status (ok, error o skipped) y message.
Qué prueba:
| Prueba | Cómo |
|---|---|
certificate |
Validación local: vigente y del RUC de la empresa. skipped con PSE. |
pse |
Pide un token al proveedor PSE en el ambiente de la empresa (Gior, QPSE, Validapse). Otros proveedores: skipped. |
sunat_api |
Pide un token a la API de SUNAT producción con el usuario SOL, la clave y el Client ID/Secret: confirma que las credenciales SOL son válidas. Sin Client ID/Secret: skipped. |
ose |
skipped: un OSE solo se puede probar enviando un comprobante (hazlo en demo). |
Reglas:
- Máximo 5 pruebas por minuto (luego
429). SUNAT puede bloquear temporalmente un usuario SOL tras varios intentos fallidos: no repitas la prueba si falla, corrige las credenciales primero. okestruesi ninguna prueba dioerror.
Errores:
403si el usuario no es administrador.429si superas el límite de pruebas por minuto.401sin token o con un token inválido.
Respuestas
200 — Resultado
{
"success": true,
"data": {
"ok": true,
"checks": {
"certificate": {
"status": "ok",
"message": "Certificado vigente hasta 2027-11-01 10:15:00."
},
"sunat_api": {
"status": "ok",
"message": "SUNAT aceptó el usuario SOL y la aplicación (Client ID)."
}
}
}
}
200 — Con errores
{
"success": true,
"data": {
"ok": false,
"checks": {
"certificate": {
"status": "skipped",
"message": "Con PSE el proveedor firma los comprobantes."
},
"pse": {
"status": "error",
"message": "El PSE rechazó las credenciales o no respondió."
},
"sunat_api": {
"status": "skipped",
"message": "Configure usuario SOL, clave, Client ID y Client Secret para probar la API de SUNAT."
}
}
}
}
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.