Saltar al contenido principal
Docs Sitio Planes

Consulta de buzón

Con la Clave SOL del RUC trae las notificaciones y mensajes del buzón electrónico SOL, con sus detalles y adjuntos. Consume una unidad por solicitud.

POST https://api.factosperu.com/api/v1/buzon

Campos requeridos

Ejemplo de solicitud

{
  "ruc": "20123456789",
  "usuario_sol": "TU_USUARIO_SOL",
  "clave_sol": "TU_CLAVE_SOL"
}

Encabezados: Authorization: Bearer TU_TOKEN y Content-Type: application/json.

Respuesta

Toda respuesta trae success, code, retryable y time, más data si hubo éxito o message si hubo error. Códigos: 200 procesado, 422 campos inválidos, 500 si SUNAT no completó la consulta.

Ejemplo de respuesta de un buzón sin mensajes:

{
  "success": true,
  "code": "found",
  "retryable": false,
  "data": {
    "timestamp": "2026-10-09T12:00:00-05:00",
    "buzon_notificaciones": { "nombre": "", "contador": 0, "mensajes": [] },
    "buzon_mensajes": { "nombre": "", "contador": 0, "mensajes": [] },
    "mis_carpetas": [],
    "mis_etiquetas": [],
    "todos_los_mensajes": [],
    "detalles_mensajes": [],
    "ajax_notificaciones": [],
    "ajax_mensajes": [],
    "resumen": {
      "total_mensajes": 0,
      "total_detalles": 0,
      "total_carpetas": 0,
      "total_etiquetas": 0,
      "ajax_noti": 0,
      "ajax_msj": 0
    }
  },
  "time": 0.12
}

La Clave SOL se usa solo para esa consulta: no se almacena ni se registra.