TRANSPORT HUBRevision documental

GLS Integration Master

Version de conocimiento: 05/11/2026, Europe/Madrid. Documento rector de la integracion; los informes anteriores conservan su valor historico, pero no sustituyen las decisiones y fuentes fechadas aqui. Auditoria sin llamadas GLS.

Fuentes y grado de certeza

Comunicaciones y cuatro casos

1. Arquitectura de integracion

Nucleo neutral respecto a carrier, SOAP/REST y cuenta. iClientes domestico es el conector principal seleccionado documentalmente. T&T es complementario; ShipIT se conserva como investigacion NO seleccionada para esta operativa. No se cambia ninguna configuracion del sistema con esta decision documental.

2. APIs disponibles

iClientes: https://ws-customer.gls-spain.es/b2b.asmx, UID por cuenta/entorno. Authentication v2/ShipIT y OAuth v1/T&T tienen contratos y tokens distintos. GLS Iberia desaconseja ShipIT para esta cuenta: alcance nacional, BusinessParcel y Shop Delivery y soporte/documentacion limitados, segun comunicacion recibida. No extrapolar esa limitacion comercial al catalogo global de todos los paises.

3. Operaciones verificadas

GrabaServicios: TEST y una alta PRODUCCION. GetExpCli: TEST y PRODUCCION, incluida una historica Extranet entregada. EtiquetaEnvioV2: EPL/PDF TEST. Anula: una PRODUCCION, resultado 0. T&T: OAuth, catalogo 336 y dataset oficial. Anula se ejecuto mediante auxiliar aislado, NO es una funcion reusable del panel.

4. Operaciones documentadas

GetExp, GetExpCli, GrabaServicios, EtiquetaEnvioV2 y Anula tienen manuales o XML oficiales. El WSDL declara 25 operaciones; su existencia no equivale a implementacion. Matriz completa.

5. Operaciones pendientes

GetEnvios/GetManifiesto: contrato interno sin localizar, no descartadas. GetExp no probado. POD confirmado por GLS a traves de GetExp/GetExpCli; formato, entrega de binario/enlace y acceso real pendientes. No nuevo ensayo hoy.

6. Identificadores

Numero GLS completo, p.ej. 2004-[IDENTIFICADOR OMITIDO], identificador operativo visible principal. ID TH independiente. Conservar CODEXP, GUID, barcode, albaran, referencias tipadas y cuenta. No asumir unicidad global de CODEXP ni equivalencia con TrackID REST. Unicidad fuerte por carrier/cuenta/entorno/tipo/valor.

7. Autenticacion

UID TEST y PRODUCCION separados en ficheros cifrados, referencias en BD. Key/Secret REST cifrados en connector_credentials; tokens no persistentes. Master local en [RUTA INTERNA OMITIDA] modo 600. No exponer a intranet. El acceso comun Aeizoon/OpenBao de administracion no implica que el conector actual consulte OpenBao: el almacenamiento GLS observado es CryptoBox/Fernet.

8. Etiquetas

JPG original de alta productiva preservado. EPL nativo TEST e impresion LP2844 verificados fisicamente por Juan; PDF TEST validado estructuralmente. Originales inmutables. Perfil ASM_100x150_LP2844: solo S4 activo como derivado, sin calibracion automatica ni cambios de geometria/densidad. No imprimir hoy.

9. Expediciones

No existe aun repositorio operativo poblado: shipments/parcels/tracking_events estan vacias. Laboratorio y evidencias son reutilizables como fuentes, no equivalen al modelo definitivo. Creacion general productiva sigue bloqueada en app_config; las pruebas previas fueron autorizaciones puntuales.

10. Seguimiento

GetExpCli consulta conocidos: UIDCLIENTE mas codigo GLS/barcode/referencia. GetExp usa GUID de expedicion. Extranet permite busquedas, pero eso no define un XML de listado SOAP. Enlace publico de ejemplo comunicado por Juan: [ENLACE PERSONAL OMITIDO] . No se abrio. La plantilla CODEXP/CP es hipotesis de un ejemplo, no garantia universal.

11. Estados y eventos

Conservar tipo/codigo/literal originales, namespace, fecha original y fuente. Separar administrativo, logistico, ciclo de vida y resultado. CERRADO DEFINITIVO no es ENTREGADO; codigo 5 ANULADA no es por si solo terminal en el maestro. No mezclar 336 codigos REST con estados iClientes o etiquetas de Extranet.

12. Anulaciones

Anula admite envios y recogidas segun XML nuevos y GLS; no operaciones en diferido o con tracking operativo. Los registros permanecen. Corregir anulando y creando otro es procedimiento confirmado, no autorizacion para automatizarlo. TH-P-001: Anula HTTP 200/0; GET inmediato siguio GRABADO. Juan comunica despues ANULADA y CERRADO DEFINITIVO en Extranet. No asumir ausencia de cargos.

13. POD

Confirmado por GLS mediante GetExp/GetExpCli. Ejemplos incluyen digitalizaciones; no hay prueba de formato uniforme ni retencion universal. Primera importacion solo datos/referencias; segunda pasada binarios progresivos, sin redescargar los verificados. No se descargan POD en esta auditoria.

14. Limitaciones y profundidad historica

SOAP: historica API demostrada de 26/10/2026 ([IDENTIFICADOR OMITIDO]). Extranet, segun Juan: 61 resultados entre 04/11/2025 y 04/12/2025, con fichas/eventos/POD cuando aplica. Eso NO demuestra enumeracion ni retencion API desde agosto de 2025. Cuenta anterior = otro ambito, sin presumir misma UID/permisos.

15. Consumo API

Comprobado hoy: SOAP PRODUCCION 10, SOAP TEST 6, REST registrados 5; global 21. Historico TEST/laboratorio 11 = 6 SOAP TEST + 5 REST. Son registros internos, no contador certificado de todo HTTP historico. Cuota 500/dia pertenece a T&T; limites SOAP no acreditados. Lote futuro 20 significa trabajo local, no batch SOAP.

16. Evidencias

16 originales oficiales registrados (incluida referencia Zebra), 54 Markdown previos y 15 respuestas SOAP cifradas verificadas localmente. IN de Anula cifrado y sin preview/descarga por contener credencial de ejemplo. Inventario y hashes.

17. Decisiones arquitectonicas

Repositorio historico persistente, no cache temporal ni purga por antiguedad. Reutilizar las tablas base existentes, sin doble repositorio. Lote inicial 20 configurable; fases datos y POD separadas. API intranet /internal/v1 propuesta, sin SMS en TH. Puerto 80 operativo futuro; 88 tecnico actual, mismo nucleo.

18. Riesgos

Contrato de descubrimiento ausente, retencion API desconocida, backups/restauracion sin demostrar, modelo sin ambito de cuenta, evidencias antiguas REST incompletas, sanitizacion que puede truncar listas/fechas y migraciones automaticas al arrancar. Registro priorizado.

19. Preguntas abiertas y siguiente paso

Solicitar solo contrato listado cuenta/fechas IN/OUT, alcance historico y permisos; preparar consulta reciente de alto rendimiento informativo antes de prospectar historico. Primero aprobar plan, backup/restauracion y modelo/ingesta offline; no implementar ni ejecutar pruebas con este documento.

Dossier de consolidacion