Saltar al contenido
Facturador

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.
  • ok es true si ninguna prueba dio error.

Errores:

  • 403 si el usuario no es administrador.
  • 429 si superas el límite de pruebas por minuto.
  • 401 sin 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.