Bienvenida

AvenioCloud expone APIs monetizables en su ambiente sandbox UAT (https://api.uat.aveniocloud.com). Este portal reúne guías, referencia de endpoints y ejemplos listos para probar de inmediato.

Que incluye

• Boletas de honorarios (sandbox): emision, anulacion, descarga de PDF y consulta de operaciones.
• Auth: obtencion de tokens OAuth2 client_credentials con scopes segmentados por dominio.
• Observabilidad: correlacion con X-Correlation-Id y trazas en respuestas.

Requisitos rapidos

• Un client_id y client_secret emitidos por AvenioCloud. Para sandbox puedes solicitar uno (ver seccion de claves) o usar un cliente publico de prueba con cuotas limitadas.
• URL base sandbox: https://api.uat.aveniocloud.com
• Headers obligatorios para Boletas:
  • Idempotency-Key: UUID por operacion.
  • X-Company-Id: GUID de la empresa (cuando aplique) o claim companyId en el token.

Flujos comunes

1. Obtener token client_credentials en Auth (/api/v1/connect/token).
2. Invocar Boletas (/api/v1/bhe/...) pasando Authorization: Bearer <token> y Idempotency-Key.
3. Consultar estado de operacion asincrona o recibir webhook si configuraste callbackUrl.

Datos sensibles y sandbox

• Las credenciales SII en sandbox son de prueba; no cargues credenciales reales.
• Las respuestas incluyen traceId; compartenlo al abrir tickets.
• El sandbox esta rate limited por client_id; contaco para aumentar cuotas.

Proximos dominios

El portal crecera con Billing, Catalog y otros microservicios monetizables. Mantendremos versionado en la referencia de API.