API REST Profesional

Potencia tu aplicación con la API de BuzOne

Integra las notificaciones de SUNAT y SUNAFIL en tu aplicación con nuestra API REST robusta, documentada y fácil de implementar.

Ejemplo de Integración
GET /api/v1/sunat/buzon
// Consulta buzón SUNAT

"ruc": "20123456789"
"api_key": "your_api_key"
99.9%
Uptime
50ms
Tiempo de Respuesta
1000+
Clientes Activos
24/7
Soporte Técnico

Características de la API

Diseñada para desarrolladores que necesitan integración rápida y confiable

Alta Velocidad

Respuestas en menos de 50ms con infraestructura optimizada para consultas masivas.

Seguridad Certificada

ISO 27001/2022, cifrado AES-256 y autenticación JWT para máxima seguridad.

Fácil Integración

SDKs para múltiples lenguajes, documentación completa y ejemplos de código.

Escalabilidad

Infraestructura cloud que se adapta a tu crecimiento y demanda de consultas.

Soporte Técnico

Equipo especializado disponible 24/7 para resolver dudas y optimizar tu integración.

Monitoreo en Tiempo Real

Dashboard con métricas de uso, logs de consultas y alertas de rendimiento.

Endpoints Principales

API RESTful con endpoints intuitivos y respuestas consistentes

SUNAT
POST /api/v1/sunat/
// Consulta buzón SUNAT

{
  "ruc": "string",
  "usuario": "string",
  "password": "string",
  "buzon": // 1: Mensajes, 2: Notificaciones,
  "tipo": // 1: listar, 2: resoluciones
}
SUNAFIL
POST /api/v1/sunafil/
// Consulta buzón SUNAFIL

{
  "ruc": "string",
  "usuario": "string",
  "password": "string",
  "buzon": // 1: Notificaciones de Fiscalización, 2: Notificaciones de Cobranza, 3: Acciones Previas,
  "tipo": // 1: listar, 2: resoluciones
}

Planes y Precios

Elige el plan que mejor se adapte a tus necesidades de consultas

Starter

S/29/mes
  • 100 créditos/mes
  • API REST completa
  • Uptime 99%
  • Listar = 1 crédito
  • Resoluciones = 3 créditos
Comenzar

Basic

S/99/mes
  • 1,000 créditos/mes
  • API REST completa
  • Soporte por WhatsApp 12/6
  • Documentación completa
  • Panel de gestión
  • Uptime 99%
  • Listar = 1 crédito
  • Resoluciones = 3 créditos
Comenzar

Documentación y Ejemplos

Todo lo que necesitas para integrar la API en tu aplicación

Autenticación

Utiliza tu API Key como parámetro en el JSON de la petición:

// Consulta de mensajes (1 crédito)
POST /api/v1/sunat/

{
  "api_key": "tu_token",
  "ruc": "20123456789",
  "usuario": "usuario_sunat",
  "password": "password_sunat",
  "buzon": 1,
  "tipo": 1
}
Consumo de Créditos
Importante: El consumo varía según el tipo de consulta:
  • Listar: 1 crédito
  • Resoluciones: 3 créditos
Códigos de Error y Respuestas
Error 402 - Créditos Insuficientes
{
  "success": false,
  "error": {
    "code": 402,
    "message": "Créditos insuficientes. Se requieren 3 créditos para este tipo de consulta."
  }
}
Código Descripción
200 Consulta exitosa
400 Parámetros inválidos
401 API key inválida
402 Créditos insuficientes
403 Cliente expirado

Ejemplo de Respuesta

Respuesta JSON estructurada y consistente:

{
  "status": 200,
  "message": "Consulta exitosa",
  "id_cliente": 1,
  "notificacion": [
    {
      "id": 783776169,
      "asunto": "ASUNTO: Notificación de Orden de Pago N° ### en Buzón Electrónico SOL",
      "fecha_envio": "26/06/2025",
      "fecha_publica": "26/06/2025 21:12:45",
      "ind_estado": 1
    },
    {
      "id": 693011288,
      "asunto": "ASUNTO: Notificación de Resolución de Fraccionamiento N° ###",
      "fecha_envio": "21/01/2025",
      "fecha_publica": "21/01/2025 00:23:50",
      "ind_estado": 1
    },
    {
      "id": 687515318,
      "asunto": "NOTIFICACION DE007301 No: 1830070937295",
      "fecha_envio": "09/01/2025",
      "fecha_publica": "09/01/2025 00:00:01",
      "ind_estado": 1
    }
  ],
  "mensaje": [
    {
      "id": 823382735,
      "asunto": "Generación de Registro de Compras y Ventas extemporánea - 202507",
      "fecha_envio": "23/08/2025",
      "fecha_publica": "23/08/2025 03:57:43",
      "ind_estado": 1
    },
    {
      "id": 822500728,
      "asunto": "Vencimiento del Registro de Compras y Ventas - 202507",
      "fecha_envio": "22/08/2025",
      "fecha_publica": "22/08/2025 09:20:32",
      "ind_estado": 1
    },
    {
      "id": 815485697,
      "asunto": "(608) 7 Generación de los Registros Electrónicos a través del SIRE.",
      "fecha_envio": "14/08/2025",
      "fecha_publica": "14/08/2025 11:15:00",
      "ind_estado": 1
    }
  ]
}

API SUNAT - Buzones Electrónicos

Consulta buzones electrónicos de SUNAT para mensajes y notificaciones tributarias

API SUNAT Disponible

La API SUNAT te permite consultar 2 buzones diferentes con 2 tipos de consulta cada uno:

  • Buzones: 1 (Mensajes), 2 (Notificaciones)
  • Tipos: Listar (1 crédito) y Resoluciones (3 créditos)
  • Total: 4 combinaciones disponibles
Estructura de Respuesta SUNAT
{
  "mensaje": [
    {
      "numero": "0000000001",
      "fecha": "2025-01-15",
      "asunto": "Notificación de Devolución"
    }
  ],
  "notificacion": [
    {
      "codigo": "001-2025",
      "tipo": "Orden de Pago",
      "monto": "1500.00"
    }
  ]
}
Características SUNAT
Mensajes

Comunicaciones del buzón 1

Notificaciones

Alertas del buzón 2

Resoluciones

Documentos completos (tipo 2)

Créditos

Control automático de consumo

API SUNAFIL - Fiscalización Laboral

Consulta buzones electrónicos de SUNAFIL para fiscalización laboral y acciones previas

Nueva API Disponible

La API SUNAFIL te permite consultar 3 buzones diferentes con 2 tipos de consulta cada uno:

  • Buzones: 1, 2, 3 (diferentes tipos de contenido)
  • Tipos: Listar (1 crédito) y Resoluciones (3 créditos)
  • Total: 6 combinaciones disponibles
Estructura de Respuesta SUNAFIL
{
  "fiscalizacion": [
    {
      "orden_inspeccion": "0000000046-2022-SUNAFIL/IRE-SMA",
      "intendencia": "INTENDENCIA REGIONAL DE SAN MARTÍN",
      "estado": "LEÍDO"
    }
  ],
  "acciones_previas": [
    {
      "tipo_requerimiento": "CARTAS DISUASIVAS GENERAL",
      "registro": "0000000487 - 2025 - SUNAFIL/IRE-SMA/SIFN",
      "fecha_limite_presentacion": "28/02/2025"
    }
  ]
}
Características SUNAFIL
Fiscalización

Órdenes de inspección y detalles

Acciones Previas

Cartas y requerimientos

Cobranza

Notificaciones de pago

PDFs

Documentos completos (tipo 2)

Consejos de Uso
  • Las consultas de listado son ideales para monitoreo diario (1 crédito)
  • Las consultas de resoluciones son para análisis detallado (3 créditos)
  • La API incluye fallback automático entre servidores para máxima confiabilidad
  • Todas las consultas se registran en logs para auditoría y estadísticas
¿Listo para comenzar?
Obtén tu API Key gratuita y comienza a integrar las notificaciones oficiales de SUNAT y SUNAFIL en tu aplicación en menos de 5 minutos.