Pedir la propuesta (ticket)
POST /api/sire/{sire_type}/periods/{sire_period}/ticket
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Pide a SUNAT que genere la propuesta del periodo {sire_period} (AAAAMM) y devuelve el ticket del proceso. {sire_type}: sale (Registro de Ventas, RVIE) o purchase (Registro de Compras, RCE).
SUNAT procesa en diferido: consulta el ticket con Estado del ticket hasta que finished sea true (estado 06).
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.
Límite: 10 peticiones por minuto.
Errores: 422 periodo con formato distinto de AAAAMM. 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 |
|
sire_period |
ruta | sí | 202610 |
Respuestas
200 — Ticket generado
{
"success": true,
"data": {
"type": "sale",
"period": "202610",
"ticket": "20260300000077"
},
"message": "SUNAT está generando la propuesta. Consulte el ticket hasta que su estado sea 06."
}
422 — Periodo inválido
{
"success": false,
"message": "El periodo debe tener el formato AAAAMM.",
"errors": {
"period": [
"El periodo debe tener el formato AAAAMM."
]
}
}
502 — Error de SUNAT
{
"success": false,
"message": "SIRE. SUNAT respondió con error 500: Servicio no disponible",
"sunat_code": 500,
"sunat_error": {
"cod": "500",
"msg": "Servicio no disponible"
}
}
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.