Casilla electrónica SUNAFIL
Lee la casilla electrónica de SUNAFIL del RUC con sus credenciales SOL (el acceso a la casilla usa el mismo usuario y Clave SOL de SUNAT) y descarga los PDF de una fila de Acciones Previas. Las credenciales solo se reenvían al servicio de consulta y nunca se registran.
Consulta de la casilla
Campos requeridos
ruc: 11 dígitos.usuario_solyclave_sol: credenciales SOL del RUC.
curl --request POST "https://api.factosperu.com/api/v1/sunafil/casilla" \
--header "Authorization: Bearer TU_TOKEN" \
--header "Content-Type: application/json" \
--data '{"ruc":"20123456789","usuario_sol":"TU_USUARIO_SOL","clave_sol":"TU_CLAVE_SOL"}'
Devuelve las seis categorías de la casilla (Notificaciones de Fiscalización, Notificaciones de Cobranza, Acciones Previas, Formalización, Seguridad y Salud en el Trabajo y Orientación). Cada categoría trae sus encabezados y sus registros tal como los muestra SUNAFIL.
{
"success": true,
"code": "found",
"retryable": false,
"data": {
"total": 2,
"categorias": [
{
"nombre": "Acciones Previas",
"url": "https://casillaelectronica.sunafil.gob.pe/si.inbox/ActosAdministrativos/ListadoRequerimientos",
"encabezados": ["Tipo de Requerimiento", "Registro", "Fecha de Depósito"],
"total": 2,
"registros": [ { "Tipo de Requerimiento": "CARTAS INDUCTIVAS GENERAL", "Registro": "0000000000 - 2026 - SUNAFIL", "Fecha de Depósito": "01/10/2026 10:00" } ]
}
]
},
"time": 5.4
}
Consumo: 1 unidad por solicitud. Si la categoría no existe en el menú de SUNAFIL se informa con error dentro de esa categoría.
Documentos de Acciones Previas
Además de ruc, usuario_sol y clave_sol, envía indice: la posición (desde 0) de la fila en la categoría Acciones Previas de la consulta anterior.
{
"success": true,
"code": "found",
"retryable": false,
"data": {
"documentos": [
{ "nombre": "CONSTANCIA_DEPOSITO.pdf", "bytes": 25580, "sha256": "…", "pdf_base64": "JVBERi0x…" },
{ "nombre": "ACUSE.pdf", "bytes": 42717, "sha256": "…", "pdf_base64": "JVBERi0x…" }
]
},
"time": 3.1
}
- Se entregan la constancia de depósito y el acuse de recibo. La carta de la notificación no se descarga: abrirla en SUNAFIL la marca como leída.
- Si la fila aún no tiene constancia ni acuse responde
404concode: "documento_no_disponible"(no se reintenta). - Cada PDF trae su huella
sha256; la API la comprueba antes de responder. Los PDF no se almacenan. - Consumo: 1 unidad por solicitud.