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
ruc: cadena requerida de 11 caracteres.usuario_sol: cadena requerida.clave_sol: cadena requerida.
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.