SIRE — Registro de Ventas (RVIE) y Compras (RCE)

Descarga la propuesta que SUNAT ya arma automáticamente a partir de tus comprobantes electrónicos: el RVIE (Registro de Ventas e Ingresos Electrónico) y el RCE (Registro de Compras Electrónico), ambos parte del sistema SIRE. Es la misma información que verías entrando tú mismo a SUNAT Operaciones en Línea (SOL) y generando el reporte — esta API automatiza esos mismos pasos y te devuelve el resultado ya en JSON, curado a los campos que de verdad se usan (no las ~50-80 columnas crudas que expone SUNAT).

1. Antes de empezar: 5 credenciales obligatorias

SIRE necesita los 5 datos juntos — no son credenciales independientes, son un solo login OAuth2 armado con datos de dos orígenes distintos:

Como cliente de esta API, cargas los 5 datos tú mismo en mblapirest.com/api/mi-cuenta → pestaña "Credenciales SUNAT". Si nos administras la cuenta de otro cliente, el mismo formulario existe en el panel admin, en /clientes/{id}/editar.

2. El flujo tiene 4 pasos (siempre en este orden)

Sustituye {ventas|compras} por ventas (RVIE) o compras (RCE) según el registro que necesites — la forma de los 4 endpoints es idéntica para ambos, solo cambian algunos campos del detalle curado (ver sección 4). Un cliente puede tener contratado solo uno de los dos servicios, o ambos, de forma independiente.

3. Los 4 endpoints en detalle

Paso 1 — Periodos disponibles

GET/v1/sire/ventas/periodos (o /v1/sire/compras/periodos)

No recibe parámetros. La respuesta se cachea por cuenta durante el mes en curso, así que llamarlo varias veces el mismo mes no vuelve a consultar a SUNAT.

curl https://mblapirest.com/api/v1/sire/ventas/periodos \
  -H "Authorization: Bearer TU_API_TOKEN"

{
  "success": true,
  "data": [ /* periodos tal como los devuelve SUNAT */ ]
}

Paso 2 — Solicitar ticket

POST/v1/sire/ventas/ticket (o /v1/sire/compras/ticket)

Si ya pediste un ticket para ese mismo periodo hoy (hace menos de 1 hora), se reutiliza el mismo num_ticket en vez de pedirle otro a SUNAT.

curl -X POST https://mblapirest.com/api/v1/sire/ventas/ticket \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -d "periodo=202501"

{
  "success": true,
  "num_ticket": "20260101..."
}

Paso 3 — Consultar y descargar la propuesta

POST/v1/sire/ventas/propuesta (o /v1/sire/compras/propuesta)

curl -X POST https://mblapirest.com/api/v1/sire/ventas/propuesta \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -d "num_ticket=20260101..."

Mientras SUNAT sigue procesando:

{ "success": true, "listo": false, "message": "El ticket aun esta en proceso en SUNAT, consulte mas tarde." }

Cuando ya terminó (aquí es cuando se guardan las filas en tu cuenta):

{ "success": true, "listo": true, "filas_procesadas": 134 }

Paso 4 — Leer el detalle

GET/v1/sire/ventas/detalle (o /v1/sire/compras/detalle)

curl "https://mblapirest.com/api/v1/sire/ventas/detalle?periodo=202501&pagina=1&por_pagina=100" \
  -H "Authorization: Bearer TU_API_TOKEN"

{
  "success": true,
  "periodo": "202501",
  "total": 134,
  "pagina": 1,
  "por_pagina": 100,
  "data": [
    {
      "car_sunat": "...",
      "tipo_comprobante": "01",
      "serie": "F001",
      "numero": "123",
      "numero_final": "123",
      "fecha_emision": "2025-01-15",
      "tipo_documento_identidad": "6",
      "numero_documento_identidad": "20123456789",
      "cliente": "EMPRESA EJEMPLO SAC",
      "moneda": "PEN",
      "total": 1180.00,
      "bi_gravada": 1000.00,
      "igv": 180.00,
      "tipo_operacion": "01",
      "tipo_de_nota": "",
      "estado_comprobante": "1"
    }
  ]
}

4. Diferencias entre Ventas y Compras en el detalle

Los campos son casi los mismos; solo tres cambian de nombre o de presencia según el tipo:

5. Cuota de consultas

Cada paso que responde con datos descuenta una consulta de la cuota de tu plan (la misma bolsa que el resto de servicios, ver Autenticación). No se descuenta cuando SUNAT devuelve un error, ni cuando la respuesta del paso 3 es "el ticket sigue en proceso" — por eso puedes consultarlo cada diez segundos sin gastar cuota. Si ya agotaste tu plan, el endpoint responde success: false antes de molestar a SUNAT.

6. Pasarela con credenciales por petición

POST/v1/sire/ventas/sunat (o /v1/sire/compras/sunat)

Pensada para sistemas que consultan SIRE de varios contribuyentes con un solo token de API (por ejemplo un facturador). En vez de usar las credenciales guardadas en tu cuenta, los 5 datos de SIRE viajan en cada petición por HTTPS; no se guardan ni se registran. Tampoco usa las tablas de propuesta/detalle de tu cuenta: la respuesta es lo que devuelve SUNAT y quien llama guarda sus propios tickets y periodos.

Requiere el servicio sireventas o sirecompras habilitado, según el registro.

Campos comunes (todas las acciones)

Si falta cualquiera de los 5 datos, responde success: false indicando cuál.

Acciones

curl -X POST https://mblapirest.com/api/v1/sire/ventas/sunat \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -d "accion=ticket" \
  -d "ruc=20123456789" \
  -d "usuario_sol=MODDATOS" \
  -d "clave_sol=TU_CLAVE_SOL" \
  -d "client_id=TU_CLIENT_ID" \
  -d "client_secret=TU_CLIENT_SECRET" \
  -d "periodo=202501"

Referencia oficial

Basado en el "Manual de servicios Web Api SIRE Ventas/Compras" publicado por SUNAT. Los códigos de libro internos son 140000 (RVIE) y 080000 (RCE) — no se necesitan para usar esta API, SUNAT los infiere de la URL que se usa internamente.

Última actualización: 02/10/2026