Saltar al contenido principal
Docs Sitio Planes

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

POST https://api.factosperu.com/api/v1/sunafil/casilla

Campos requeridos

  • ruc: 11 dígitos.
  • usuario_sol y clave_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

POST https://api.factosperu.com/api/v1/sunafil/documento

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 404 con code: "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.