{"id":"API_QUOTA_STATUS","title":"Estado de cuotas API","version":"nav88-20261106-v1","date":"2026-11-06T13:00:28.123217+01:00","classification":"PUBLIC_REVIEW","sha256":"1486fbe2c31975afc6b6a40c4108dbc07ad6a36bfca173646d542b5757eb6866","read_url":"/api/review/API_QUOTA_STATUS","total_bytes":7340,"fragment_count":1,"document_sha256":"1486fbe2c31975afc6b6a40c4108dbc07ad6a36bfca173646d542b5757eb6866","fragmented":false,"content_markdown":"# API_QUOTA_STATUS\n\n## Despues de la primera prueba de lectura - 06/11/2026\n\nPRODUCCION iClientes: 10 -> 13. TEST iClientes: 6 -> 6. REST: 5 -> 5.\nHistorico TEST/laboratorio 11 sin cambios. Total externo: 21 -> 24.\nTres GetExpCli, un intento por identificador, sin otras operaciones.\n\nGestor central: 3 consumidas, 0 retenidas, limite interno 20 y disponibles\ninternas estimadas 17; reserva 5. Cuota oficial iClientes desconocida: no se\ninventa limite ni restante oficial. Scope restaurado a inactivo y worker cerrado.\nHTTP 200 no es exito de importacion: los tres resultados tienen Error GLS.\nEl ledger conserva HTTP y añade resultado de negocio/error sanitizado.\n\n## Registro historico: etapa D\n\n## Etapa D - consumo sin cambios\n\n| Familia | Entorno | Peticiones registradas |\n| --- | --- | --- |\n| iClientes | PRODUCCION | 10 |\n| iClientes | TEST | 6 |\n| Authentication/ShipIT/T&T REST | Sandbox historico | 5 |\n| Total externo | Todos | 21 |\n\nHistorico TEST/laboratorio: 11 = 6 iClientes TEST + 5 REST.\nCero llamadas GLS en etapa D. Simulaciones y pruebas aisladas no alteran ledger.\nNo se activan cuotas GLS ni trabajadores. La politica ordinaria sigue 50% de\ncuotas oficiales conocidas, con reserva para operaciones interactivas; APIs\nsin cuota oficial exigen limite interno. No se reutiliza el limite T&T de\n500 para iClientes. La estimacion del importador no es una reserva ni una llamada.\n\nCada despacho futuro obtiene reserva por cuenta, producto y entorno; cada\nrespuesta contabiliza una vez por reservation_id. Reconciliar o releer evidencia\nno duplica consumo. Resultados inciertos conservan presupuesto por seguridad.\nNo se promete superar un limite tecnico oficial con una excepcion interna.\nEl transporte conserva Retry-After y el trabajador lo entrega al gestor\ncentral al recibir 429, sin repetir automaticamente la consulta afectada.\n\n## Estado historico previo\n\n## Etapa C: administracion y simulacion\n\nContadores GLS conservados: iClientes production 10, test 6, Authentication\n1, ShipIT 1 y T&T 3; total externo 21. Historico TEST/laboratorio 11.\nNo se ha hecho una peticion GLS para probar cuotas o la interfaz.\n\nSe incorpora ambito LOCAL de simulacion, proveedor local-simulation, API\nsimulation, test, presupuesto interno 1000/ventana movil diaria, reserva 0.\nNO es una cuota GLS. Su uso se registra por reservas/operaciones locales y\nno produce api_requests externos ni altera api_usage_daily de GLS.\n\nPuerto 88 /admin/quotas: administrador y CSRF. Permite editar presupuesto\nporcentual, limite interno, reserva, horario/dias y activacion de los ambitos\nexistentes. Fuente y limite oficial acreditado se mantienen; no se permite\ninventarlos como un valor nuevo desde este formulario inicial.\nLas excepciones exigen motivo y coste acotado, con vigencia UI de 1 a 60\nminutos, siempre sin superar el limite oficial. Aprobacion/uso auditados.\n\nGuardar no llama al proveedor, no inicia workers y no desbloquea creacion\nreal de 80. Los clientes legacy del laboratorio mantienen sus controles\nanteriores; no se afirma una cobertura global nueva de todos ellos.\nLos ambitos GLS permanecen con su estado previo. La simulacion esta aislada.\n\nEl consumo solo refleja TH; otras aplicaciones con la misma credencial\npueden consumir cuota no visible. Los estados inciertos no se reembolsan\nautomaticamente. Un fallo antes de claim/envio se distingue de un timeout\nposterior y no autoriza a repetir una creacion ambigua.\n\n## Registro historico: etapa B\n\n## Etapa B: estado de contadores\n\n| Familia | Entorno registrado | Peticiones antes | Peticiones despues |\n|---|---|---:|---:|\n| iClientes | production | 10 | 10 |\n| iClientes | test | 6 | 6 |\n| Authentication | sandbox | 1 | 1 |\n| ShipIT | sandbox | 1 | 1 |\n| Track And Trace | sandbox | 3 | 3 |\n| Total ledger | todos | 21 | 21 |\n\nHistorico TEST/laboratorio = 6 iClientes + 5 REST = 11. No se reclasifican\nfilas anteriores. La etiqueta legacy sandbox no prueba que un host REST\nsea productivo o de pruebas: su separacion historica se conserva.\n\n## Politicas preparadas, inactivas\n\n| API | Oficial | Presupuesto habitual | Reserva | Ventana | Activada |\n|---|---|---|---|---|---|\n| iClientes production | No acreditada | Limite interno 20 | 5 | Movil 24 h | No |\n| iClientes test | No acreditada | Limite interno 20 | 5 | Movil 24 h | No |\n| T&T familia OAuth legacy | 500/dia segun OpenAPI preservado | 250 | 50 | Movil conservadora | No |\n\nEl valor 20 de iClientes NO es una cuota GLS. Es un limite interno inicial\nconservador, pendiente de revision antes de activarlo. No se asigna la\ncuota T&T a OAuth, ShipIT ni iClientes. El reset oficial no acreditado no\nse presenta como una hora garantizada; la ventana movil evita liberarla\npor un cambio de fecha asumido.\n\n## Motor implementado\n\n- Ambitos por proveedor/API/entorno/credencial logica y asociaciones de cuenta.\n- Varias ventanas y politicas por peticion, reserva atomica y locks ordenados.\n- Prioridad 0 interactiva, 1 urgente, 2 normal, 3 historica; las no interactivas\n  no consumen la reserva protegida.\n- Umbral habitual 50 %; limite interno configurable y mas estricto si procede.\n- Reserva persistida antes de transmitir. No se pierde al reiniciar.\n- Estados reserved/sent/settled/released/uncertain y clave de peticion unica.\n- Devolucion solo antes de enviar o cuando el transporte acredita no envio.\n- Excepcion interna con permiso quota:override, actor, motivo, expiracion\n  maxima 24 h y coste extra acotado. El proveedor sigue siendo limite duro.\n- 429: Retry-After/cooldown; sin reintento automatico del gestor.\n- Registro api_requests enlazado a reserva y agregacion diaria idempotentes.\n\nLos contadores representan llamadas de TH, no otras aplicaciones con la\nmisma credencial. El estado incierto consume presupuesto conservadormente;\nno equivale a una llamada confirmada en el ledger. No se liberan reservas\nantiguas automaticamente, porque una operacion enviada podria estar ambigua.\n\n## Integracion pendiente\n\nNo hay llamadas nuevas ni ambitos activos. Los clientes del laboratorio\nprevio mantienen sus controles anteriores; no se afirma que ya esten todos\ninterceptados por este nucleo. Etapa C debe asociar el ambito correcto y\nenvolver cada transporte real una sola vez, incluidos OAuth y fallos.\nLa pantalla administrativa nueva muestra la preparacion, sin habilitar\nejecucion ni ofrecer cambios peligrosos desde una visita GET.\n\n## Registro historico: etapa A\n\nContadores previos comprobados: iClientes PRODUCCION 10; iClientes TEST 6;\nREST registrados 5; historico TEST/laboratorio 11; global api_requests 21.\nNo son contadores certificados por GLS de todo el trafico historico.\n\nLa etapa A no consume APIs GLS. Las consultas al canal documental o sus\ncomprobaciones locales HTTP no son llamadas al transportista.\n\nPolitica aprobada para desarrollar: uso ordinario del 50 por ciento de\ncuotas oficiales conocidas. Ejemplo T&T 500/dia, presupuesto 250. No se\natribuye esa cuota a iClientes ni se inventa un limite oficial SOAP.\n\nFuturo gestor: proveedor/API/entorno/cuenta/ambito compartido; reservas\natomicas, prioridades P0 interactiva/P1 seguimiento/P2 historico/P3 POD,\nlimites internos conservadores, ventanas y excepciones auditadas. Las\nexcepciones no superaran limites oficiales ni ignoraran respuestas 429.\n\nNo se afirma que ese gestor centralizado este implementado con este hito.\n"}