# 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

- CONFIRMADO POR GLS: comunicaciones transmitidas por Juan el 05/11;
  se identifica esa procedencia, no se afirma haber visto el correo original.
- DEMOSTRADO MEDIANTE PRUEBAS: evidencia original local y auditoria API.
- INFERIDO: interpretacion razonable, no contrato ni prueba remota.
- PENDIENTE DE VALIDACION: falta documentacion, acceso o prueba autorizada.
- Las observaciones de Extranet comunicadas por Juan se etiquetan aparte;
  no se presentan como nuevas respuestas API obtenidas por TH.

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

- Ejecutivo y respuestas de cierre
- Inventario documental
- Operaciones
- GetEnvios y descubrimiento
- Prospeccion historica
- PostgreSQL
- Infraestructura
- Modelo historico
- Sincronizacion y POD
- Consumo y prioridades
- API intranet
- Interfaces 80/88
- Plan de implementacion
- Comunicaciones/casos
- Anexo completo de esquema