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:

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: 03/09/2026