Estado

Aster depende de Hacienda para entregar cada veredicto, así que publica el estado de los dos.

Páginas y endpoints de estado

Recurso	Qué muestra	Autenticación
/estado	Estado de Aster y de Hacienda en una página	No
/haciendastatus	Disponibilidad de Hacienda en pruebas y en producción, tiempos de respuesta e historial de las últimas verificaciones	No
/status.json	Estado del servicio y de Hacienda en JSON, para tu monitoreo	No
GET /api/v1/status	Estado de la API, la base de datos y la disponibilidad de Hacienda por ambiente	No

/haciendastatus también responde JSON si la pedís con Accept: application/json, con el estado actual de cada ambiente y su historial.

Terminal

curl https://aster.astranexo.com/api/v1/status

{
  "success": true,
  "data": {
    "status": "ok",
    "version": "1.0",
    "database": "connected",
    "hacienda": {
      "staging": { "available": true, "message": "ok" },
      "production": { "available": true, "message": "ok" }
    }
  }
}

Cada ambiente de Hacienda trae también los tiempos de respuesta y un message: ok, token_unavailable (no responde la autenticación), api_unavailable (no responde la recepción) o down. Si Aster no puede atender solicitudes, /api/v1/status responde 503 con data.status = degraded. Para un monitor, basta con revisar el código HTTP y data.hacienda.production.available. Estas rutas se limitan por IP (120 solicitudes por minuto en /status y /status.json).

Cuando Hacienda no está disponible

Hacienda tiene caídas y ventanas de mantenimiento. Aster está hecho para que no tengás que manejarlas:

1. Validás y enviás el comprobante como siempre. Aster lo firma y responde 201 con su clave y su consecutivo.
2. Si Hacienda no responde, el comprobante pasa a queued y recibís el webhook document.queued. El comprobante ya está emitido con su clave; solo falta la respuesta de Hacienda.
3. Aster reintenta el envío automáticamente, las 24 horas, sin límite de intentos, hasta que Hacienda lo recibe.
4. Cuando llega el veredicto, recibís document.accepted o document.rejected como en cualquier otro envío.

No reenvíes un comprobante en queued: ya está en manos de Aster y reenviarlo con otra clave gastaría otro consecutivo. Si querés avisarle al cliente, podés entregarle el comprobante indicando que está pendiente de la respuesta de Hacienda.

Si Hacienda recibe el comprobante pero no llama de vuelta, Aster consulta el estado en Hacienda por su cuenta. Ver ciclo de vida.

Acuerdo de nivel de servicio

Aster se compromete a una disponibilidad del 99,5 %, sin contar las caídas de Hacienda. La página /haciendastatus sirve de registro de esas caídas. Los términos completos están en el SLA.