# API_QUOTA_STATUS

## Despues de la primera prueba de lectura - 06/11/2026

PRODUCCION iClientes: 10 -> 13. TEST iClientes: 6 -> 6. REST: 5 -> 5.
Historico TEST/laboratorio 11 sin cambios. Total externo: 21 -> 24.
Tres GetExpCli, un intento por identificador, sin otras operaciones.

Gestor central: 3 consumidas, 0 retenidas, limite interno 20 y disponibles
internas estimadas 17; reserva 5. Cuota oficial iClientes desconocida: no se
inventa limite ni restante oficial. Scope restaurado a inactivo y worker cerrado.
HTTP 200 no es exito de importacion: los tres resultados tienen Error GLS.
El ledger conserva HTTP y añade resultado de negocio/error sanitizado.

## Registro historico: etapa D

## Etapa D - consumo sin cambios

| Familia | Entorno | Peticiones registradas |
| --- | --- | --- |
| iClientes | PRODUCCION | 10 |
| iClientes | TEST | 6 |
| Authentication/ShipIT/T&T REST | Sandbox historico | 5 |
| Total externo | Todos | 21 |

Historico TEST/laboratorio: 11 = 6 iClientes TEST + 5 REST.
Cero llamadas GLS en etapa D. Simulaciones y pruebas aisladas no alteran ledger.
No se activan cuotas GLS ni trabajadores. La politica ordinaria sigue 50% de
cuotas oficiales conocidas, con reserva para operaciones interactivas; APIs
sin cuota oficial exigen limite interno. No se reutiliza el limite T&T de
500 para iClientes. La estimacion del importador no es una reserva ni una llamada.

Cada despacho futuro obtiene reserva por cuenta, producto y entorno; cada
respuesta contabiliza una vez por reservation_id. Reconciliar o releer evidencia
no duplica consumo. Resultados inciertos conservan presupuesto por seguridad.
No se promete superar un limite tecnico oficial con una excepcion interna.
El transporte conserva Retry-After y el trabajador lo entrega al gestor
central al recibir 429, sin repetir automaticamente la consulta afectada.

## Estado historico previo

## Etapa C: administracion y simulacion

Contadores GLS conservados: iClientes production 10, test 6, Authentication
1, ShipIT 1 y T&T 3; total externo 21. Historico TEST/laboratorio 11.
No se ha hecho una peticion GLS para probar cuotas o la interfaz.

Se incorpora ambito LOCAL de simulacion, proveedor local-simulation, API
simulation, test, presupuesto interno 1000/ventana movil diaria, reserva 0.
NO es una cuota GLS. Su uso se registra por reservas/operaciones locales y
no produce api_requests externos ni altera api_usage_daily de GLS.

Puerto 88 /admin/quotas: administrador y CSRF. Permite editar presupuesto
porcentual, limite interno, reserva, horario/dias y activacion de los ambitos
existentes. Fuente y limite oficial acreditado se mantienen; no se permite
inventarlos como un valor nuevo desde este formulario inicial.
Las excepciones exigen motivo y coste acotado, con vigencia UI de 1 a 60
minutos, siempre sin superar el limite oficial. Aprobacion/uso auditados.

Guardar no llama al proveedor, no inicia workers y no desbloquea creacion
real de 80. Los clientes legacy del laboratorio mantienen sus controles
anteriores; no se afirma una cobertura global nueva de todos ellos.
Los ambitos GLS permanecen con su estado previo. La simulacion esta aislada.

El consumo solo refleja TH; otras aplicaciones con la misma credencial
pueden consumir cuota no visible. Los estados inciertos no se reembolsan
automaticamente. Un fallo antes de claim/envio se distingue de un timeout
posterior y no autoriza a repetir una creacion ambigua.

## Registro historico: etapa B

## Etapa B: estado de contadores

| Familia | Entorno registrado | Peticiones antes | Peticiones despues |
|---|---|---:|---:|
| iClientes | production | 10 | 10 |
| iClientes | test | 6 | 6 |
| Authentication | sandbox | 1 | 1 |
| ShipIT | sandbox | 1 | 1 |
| Track And Trace | sandbox | 3 | 3 |
| Total ledger | todos | 21 | 21 |

Historico TEST/laboratorio = 6 iClientes + 5 REST = 11. No se reclasifican
filas anteriores. La etiqueta legacy sandbox no prueba que un host REST
sea productivo o de pruebas: su separacion historica se conserva.

## Politicas preparadas, inactivas

| API | Oficial | Presupuesto habitual | Reserva | Ventana | Activada |
|---|---|---|---|---|---|
| iClientes production | No acreditada | Limite interno 20 | 5 | Movil 24 h | No |
| iClientes test | No acreditada | Limite interno 20 | 5 | Movil 24 h | No |
| T&T familia OAuth legacy | 500/dia segun OpenAPI preservado | 250 | 50 | Movil conservadora | No |

El valor 20 de iClientes NO es una cuota GLS. Es un limite interno inicial
conservador, pendiente de revision antes de activarlo. No se asigna la
cuota T&T a OAuth, ShipIT ni iClientes. El reset oficial no acreditado no
se presenta como una hora garantizada; la ventana movil evita liberarla
por un cambio de fecha asumido.

## Motor implementado

- Ambitos por proveedor/API/entorno/credencial logica y asociaciones de cuenta.
- Varias ventanas y politicas por peticion, reserva atomica y locks ordenados.
- Prioridad 0 interactiva, 1 urgente, 2 normal, 3 historica; las no interactivas
  no consumen la reserva protegida.
- Umbral habitual 50 %; limite interno configurable y mas estricto si procede.
- Reserva persistida antes de transmitir. No se pierde al reiniciar.
- Estados reserved/sent/settled/released/uncertain y clave de peticion unica.
- Devolucion solo antes de enviar o cuando el transporte acredita no envio.
- Excepcion interna con permiso quota:override, actor, motivo, expiracion
  maxima 24 h y coste extra acotado. El proveedor sigue siendo limite duro.
- 429: Retry-After/cooldown; sin reintento automatico del gestor.
- Registro api_requests enlazado a reserva y agregacion diaria idempotentes.

Los contadores representan llamadas de TH, no otras aplicaciones con la
misma credencial. El estado incierto consume presupuesto conservadormente;
no equivale a una llamada confirmada en el ledger. No se liberan reservas
antiguas automaticamente, porque una operacion enviada podria estar ambigua.

## Integracion pendiente

No hay llamadas nuevas ni ambitos activos. Los clientes del laboratorio
previo mantienen sus controles anteriores; no se afirma que ya esten todos
interceptados por este nucleo. Etapa C debe asociar el ambito correcto y
envolver cada transporte real una sola vez, incluidos OAuth y fallos.
La pantalla administrativa nueva muestra la preparacion, sin habilitar
ejecucion ni ofrecer cambios peligrosos desde una visita GET.

## Registro historico: etapa A

Contadores previos comprobados: iClientes PRODUCCION 10; iClientes TEST 6;
REST registrados 5; historico TEST/laboratorio 11; global api_requests 21.
No son contadores certificados por GLS de todo el trafico historico.

La etapa A no consume APIs GLS. Las consultas al canal documental o sus
comprobaciones locales HTTP no son llamadas al transportista.

Politica aprobada para desarrollar: uso ordinario del 50 por ciento de
cuotas oficiales conocidas. Ejemplo T&T 500/dia, presupuesto 250. No se
atribuye esa cuota a iClientes ni se inventa un limite oficial SOAP.

Futuro gestor: proveedor/API/entorno/cuenta/ambito compartido; reservas
atomicas, prioridades P0 interactiva/P1 seguimiento/P2 historico/P3 POD,
limites internos conservadores, ventanas y excepciones auditadas. Las
excepciones no superaran limites oficiales ni ignoraran respuestas 429.

No se afirma que ese gestor centralizado este implementado con este hito.