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
- 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
- 429: Retry-After/cooldown; sin reintento automatico del gestor.
- Registro api_requests enlazado a reserva y agregacion diaria idempotentes.
no consumen la reserva protegida.
maxima 24 h y coste extra acotado. El proveedor sigue siendo limite duro.
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.