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.