Saltar al contenido
Facturador

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.