Saltar al contenido
Facturador

Periodos del registro

GET /api/sire/{sire_type}/periods

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Ejercicios y periodos (meses) del libro en SIRE con su estado. {sire_type}: sale (Registro de Ventas, RVIE) o purchase (Registro de Compras, RCE).

Quién puede usarlo: administradores y usuarios con el nivel de acceso Resumen de cuentas (account_summary), el mismo que exige el panel en SIRE.

Formato de respuesta: estándar {success, data, message?} con códigos HTTP reales.

Cada periodo trae period (AAAAMM), status_code y status tal como los devuelve SUNAT.

Errores comunes: 422 faltan las credenciales SUNAT de la empresa o SUNAT las rechazó; 502 SUNAT respondió con error (su cuerpo va en sunat_error y su código en sunat_code); 504 no hubo conexión con SUNAT; 403 sin permiso.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
sire_type ruta sí sale

Respuestas

200 — Periodos

{
  "success": true,
  "data": [
    {
      "year": "2026",
      "status": "Activo",
      "periods": [
        {
          "period": "202610",
          "status_code": "01",
          "status": "Pendiente"
        },
        {
          "period": "202609",
          "status_code": "02",
          "status": "Presentado"
        }
      ]
    }
  ]
}

422 — Credenciales rechazadas

{
  "success": false,
  "message": "SIRE. SUNAT rechazó las credenciales de la empresa (usuario/clave SOL o Client ID/Secret).",
  "sunat_code": 400,
  "sunat_error": {
    "error": "invalid_grant",
    "error_description": "Usuario o clave incorrecto"
  }
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.