Integración con GLS¶

GLS es uno de los transportistas de paquetería más utilizados en Hungría, y ofrece tanto entrega a domicilio como recogida en una red nacional de tiendas de paquetería (la variante de GLS de los puntos de recogida). La integración de eYssen con GLS conecta Odoo con la API MyGLS para que una tienda web pueda ofrecer ambos modos de entrega, dejar que el comprador elija una tienda de paquetería en el mapa oficial de GLS al finalizar la compra, imprimir etiquetas de envío directamente desde los albaranes de entrega, seguir cada paquete a través de los estados de seguimiento de GLS, cobrar contra reembolso y, además, convertir automáticamente en pedidos de devolución (RMA) los paquetes que se devuelven al remitente.

La funcionalidad la proporciona el módulo eyssen_delivery_gls, con dos extensiones opcionales: rma_delivery_gls para la automatización de devoluciones y eyssen_stock_multi_warehouse_delivery_gls para los envíos entre almacenes.

Ver también

Configuración de la cuenta¶

La integración se comunica con el sistema MyGLS de GLS, por lo que se requiere un contrato comercial de MyGLS. GLS proporciona lo siguiente, que se introduce en el método de envío en Odoo:

un número de cliente que identifica el contrato;
un usuario de API y una contraseña de API para el sistema de producción;
un usuario de API de prueba y una contraseña de API de prueba independientes para el entorno de prueba de GLS (el formulario del método de envío requiere que todos los campos de credenciales estén rellenos).

Solicite también las credenciales de prueba durante la incorporación: permiten probar de principio a fin la generación de etiquetas y el seguimiento frente al sistema de prueba independiente de GLS antes de pasar a producción.

Nota

Odoo nunca transmite la contraseña de MyGLS en texto plano: cada llamada a la API se autentica con un resumen SHA-512 de la contraseña, tal y como exige la convención de la API de MyGLS.

Configuración del método de envío¶

Al instalar eyssen_delivery_gls se crean dos métodos de envío ya preparados, GLS Parcel Shop y GLS Home delivery. Para configurarlos (o crear métodos GLS adicionales), vaya a Inventory app ‣ Configuration ‣ Delivery Methods y abra el método. Con el Provider establecido en GLS, aparecen dos pestañas adicionales en el formulario: Pricing y GLS Configuration.

Para los campos genéricos compartidos por todos los transportistas (Delivery Product, países de disponibilidad, publicación del método en el sitio web), consulte Conectores de transportistas. Recuerde publicar cada método que deba ofrecerse en la tienda web.

screenshot: setup-configuration-gls-configuration-tab

menu: Inventory ‣ Configuration ‣ Delivery Methods ‣ GLS Home delivery
shows: A GLS shipping method form with Provider set to "GLS" and the "GLS Configuration" tab open, showing the API User, API Password, Test API User, Test API Password and Client number fields, plus the Delivery type selection.
highlight: The "GLS Configuration" tab (red frame).
data: Shipping method "GLS Home delivery".
module: eyssen_delivery_gls
notes: English UI, light theme, 1440px width.

Credenciales¶

En la pestaña GLS Configuration, rellene:

API User y API Password: las credenciales de producción de MyGLS.
Test API User y Test API Password: las credenciales del sistema de prueba de GLS.
Client number: el número de cliente de MyGLS.

El interruptor estándar Environment del método de envío decide todo a la vez: en el entorno Test, Odoo llama a la API de prueba de GLS con el par de credenciales de prueba; en el entorno Production, llama a la API en vivo con el par de producción. No es necesario ningún otro cambio al pasar a producción.

Nota

Los campos de credenciales solo son visibles para los usuarios con acceso de Administration / Settings. Si las credenciales aplicables se dejan vacías, validar una entrega GLS no falla: el albarán se valida normalmente y una nota en el chatter registra que no se creó ningún paquete GLS, de modo que un método sin configurar nunca bloquea al almacén.

Tipos de entrega¶

El campo Delivery type de la pestaña GLS Configuration selecciona cómo llega el paquete al cliente:

Tema	Parcel Shop (predeterminado)	Entrega a domicilio
Adónde va el paquete	Una tienda de paquetería GLS elegida por el comprador	La propia dirección del cliente
Comportamiento en el proceso de compra	Se abre el mapa de GLS para elegir una tienda	Se comporta como cualquier transportista normal
Dirección de envío	Opcionalmente reemplazada por una dirección de tienda de paquetería creada automáticamente	La dirección de entrega del cliente
Requisito para la etiqueta	Debe seleccionarse una tienda de paquetería antes de poder generar una etiqueta	Sin requisitos adicionales

Para los métodos de tienda de paquetería, la opción adicional Create Delivery Address for PS controla qué ocurre con la dirección de envío del pedido una vez elegida una tienda:

Activada: se crea bajo el cliente una dirección de entrega independiente denominada según la tienda (su nombre e identificador), con la calle, el código postal, la ciudad y el país de la tienda, y pasa a ser la dirección de envío del pedido. Las direcciones de tienda creadas automáticamente se ocultan del selector de direcciones del proceso de compra y se eliminan automáticamente cuando ningún pedido las utiliza ya.
Desactivada (predeterminado): la dirección de envío sigue siendo la propia del cliente; solo se guarda en el pedido el identificador de la tienda de paquetería, que se envía a GLS junto con la etiqueta.

screenshot: setup-configuration-gls-delivery-type

menu: Inventory ‣ Configuration ‣ Delivery Methods ‣ GLS Parcel Shop
shows: The "GLS Configuration" tab of a parcel-shop method, showing the "Delivery type" field set to "Parcel Shop" and the "Create Delivery Address for PS" option below it.
highlight: The "Delivery type" and "Create Delivery Address for PS" fields (red frame).
module: eyssen_delivery_gls
notes: English UI, light theme, 1440px width.

Precios¶

La pestaña Pricing ofrece dos modos de tarificación:

Precios por tramos: añada una o varias líneas a la lista Pricing Rules. Cada regla se compara con el peso, el volumen, el precio o la cantidad del pedido; las reglas se evalúan en orden y la primera regla que coincide establece el precio de envío (convertido a la divisa del pedido cuando la divisa de la empresa es distinta). Si ninguna regla coincide, por ejemplo, si el carrito pesa más que el último tramo, el método sigue apareciendo en el proceso de compra, pero no se puede seleccionar: Odoo muestra Not available for current order.
Precio fijo: cuando no se define ninguna regla de precios, el precio de envío es el precio de venta del Delivery Product del método, resuelto a través de la tarifa del pedido; el campo Fixed Price edita el precio de venta base de ese producto, y las reglas de tarifa sobre el producto de entrega lo sobrescriben por tarifa (y, por tanto, por sitio web).

Example

Dos reglas —weight <= 2 kg → 990 Ft y weight <= 10 kg → 1 590 Ft— cobran 990 Ft por un carrito de 1,5 kg y 1590 Ft por uno de 7 kg, y muestran el método GLS como Not available for current order para un carrito de 25 kg.

La opción básica del transportista Free if order amount is above sigue funcionando junto a ambos modos: cuando se aplica, el precio de envío baja a cero mientras el coste real se sigue registrando en el pedido.

Pago contra reembolso¶

Instalar el módulo también crea el proveedor de pago específico de GLS Payment on Delivery, un proveedor de tipo pago contra reembolso que permite al comprador realizar el pedido en línea y pagar al mensajero o en la tienda de paquetería en el momento de la entrega; el pedido de venta en sí se sigue confirmando en el back-office (véase Métodos de pago según el método de envío). Se crea desactivado, como cualquier proveedor de pago, y debe activarse y publicarse antes de usarse.

Ambos métodos GLS incluidos por defecto tienen este proveedor preconfigurado como única entrada de su lista Enabled payment acquirers, por lo que, de forma predeterminada, una entrega GLS ofrece únicamente el pago contra reembolso en el paso de pago, siempre que no esté activado el proveedor de pago contra reembolso de otro transportista: la lista blanca restringe de forma fiable los proveedores en línea, mientras que los proveedores de pago contra reembolso se validan por su propia vía (compatibilidad de la dirección de envío). Añada los proveedores de tarjeta o transferencia bancaria de la tienda a cada método para ofrecer más opciones. El funcionamiento del filtrado de pagos por transportista y la experiencia de pago contra reembolso en el proceso de compra se describe en Métodos de pago según el método de envío; cómo se calcula el importe exacto a cobrar en cada envío (envíos parciales, anticipos, límite del total del pedido) se describe en Pago contra reembolso (COD). Para retener las entregas hasta recibir realmente el pago, véase Entrega condicionada al pago.

Nota

La opción Payment on Delivery solo aparece en el proceso de compra cuando al menos un método GLS está publicado en el sitio web y el carrito contiene productos físicos.

FlexDeliveryService y opciones¶

FlexDeliveryService: cuando está activado, los paquetes se anuncian a GLS con la dirección de correo electrónico del destinatario, de modo que GLS notifica al cliente sobre la entrega y le permite interactuar con ella (servicio FDS de GLS). La lista FDS Countries restringe el servicio a los países de destino seleccionados; déjela vacía para aplicarlo en todos ellos.
Se incluye un tipo de paquete GLS Box (transportista GLS) en Inventory app ‣ Configuration ‣ Package Types, listo para usarse al empaquetar paquetes GLS.

Proceso de compra en el sitio web: elegir una tienda de paquetería¶

Cuando el comprador selecciona un método de tienda de paquetería GLS en el proceso de compra, el mapa oficial de GLS se abre automáticamente en un diálogo: muestra todas las tiendas de paquetería GLS de Hungría con sus propios controles de búsqueda y de mapa. Después de que el comprador elija una tienda, el diálogo se cierra y la selección se guarda en el pedido. Según Create Delivery Address for PS, la dirección de envío se cambia a la dirección de tienda creada automáticamente o se deja sin modificar.

Cambiar a otro método de entrega revierte la dirección de envío a la propia del cliente y elimina la dirección de tienda que ha dejado de usarse; seleccionar una tienda distinta reemplaza a la anterior de la misma manera.

screenshot: setup-configuration-gls-checkout-map

menu: (webshop) Checkout ‣ Delivery step ‣ GLS Parcel Shop
shows: The official GLS parcel-shop map opened in a dialog over the webshop checkout, with the shop search field and map pins, before a shop is picked.
highlight: The selected parcel shop pin (red frame).
module: eyssen_delivery_gls
notes: English UI, light theme, 1440px width.

Importante

Elegir una tienda no es obligatorio en el proceso de compra: el comprador puede cerrar el mapa sin elegir una y aun así completar el pedido. La red de seguridad actúa en el momento de la preparación: generar la etiqueta para ese pedido se detiene con el mensaje «Please select a GLS parcel shop on the sales order or transfer before validating the delivery.», y el personal completa la tienda que falta antes de enviar.

Los usuarios del back-office también pueden ver y cambiar la tienda elegida: en el pedido de venta (y en el albarán vinculado), aparece un campo GLS parcel shop junto a la dirección de entrega para los métodos de tienda de paquetería, junto con un botón Select on map que abre el mismo mapa de GLS dentro del backend. El identificador también se puede escribir manualmente (por ejemplo, HU-123456). El campo se bloquea en cuanto existe una etiqueta o el pedido está hecho o cancelado, de modo que la tienda ya no puede diferir de lo que figura impreso en la etiqueta.

Etiquetas de envío¶

Las etiquetas se generan desde el albarán saliente, ya sea automáticamente mediante el flujo estándar del transportista al validar el albarán, o manualmente con el botón Print GLS Label del formulario del albarán.

Se registra un envío GLS por cada albarán. El GLS parcel count equivale al número de paquetes del albarán (o 1 cuando la mercancía no está empaquetada), por lo que en los albaranes con varios paquetes debe usarse Put in Pack una vez por cada paquete físico antes de imprimir.
GLS requiere datos de contacto completos: deben estar establecidos el número de teléfono y el correo electrónico de la empresa, así como el número de teléfono y el correo electrónico del destinatario; en caso contrario, la generación de la etiqueta se detiene con un mensaje explícito que indica qué falta.
Si tiene éxito, el albarán guarda el GLS parcel ID y el GLS parcel number (un número por paquete, separados por comas), el PDF de la etiqueta se guarda en el campo GLS label y se adjunta al chatter con un nombre basado en el número de paquete, y cada paquete del albarán recibe su propio número de paquete: la lista de paquetes obtiene las columnas GLS parcel number y Parcel state.
Cuando el pedido se realizó con Payment on Delivery, el importe a cobrar se calcula para el albarán saliente en el momento de generar la etiqueta y se envía a GLS junto con la solicitud de etiqueta: un único importe cubre todos los paquetes del albarán (véase Pago contra reembolso (COD)).

Importante

Volver a imprimir crea un paquete nuevo. El botón Print GLS Label desaparece en cuanto existe una etiqueta, porque volver a hacer clic en él no vuelve a descargar la etiqueta existente, sino que borra los datos de paquete guardados y registra un paquete completamente nuevo en GLS, mientras que el paquete creado anteriormente sigue activo en el sistema de GLS (no existe ninguna llamada de cancelación). En el modo desarrollador hay disponible una segunda copia del botón, siempre visible, para una regeneración deliberada; utilícela solo cuando el paquete original realmente no vaya a enviarse.

Seguimiento y estados¶

El módulo incluye un catálogo de 90 estados de paquete de GLS, editable en Inventory app ‣ Configuration ‣ GLS Parcel States (visible para los administradores). Cada estado tiene un código, un nombre traducible y una casilla Delivered State; los dos estados de «parcel has been delivered» (códigos 05 y 92) vienen marcados de antemano como entregados.

El seguimiento se sincroniza automáticamente mediante dos acciones programadas que se ejecutan cada tres horas: una consulta todos los albaranes etiquetados en curso, y la otra recorre por turnos los paquetes etiquetados (un lote limitado por ejecución, cada paquete como máximo una vez por hora de forma predeterminada). El último texto de estado, el estado mapeado y la fecha de estado se guardan en el albarán y en el paquete correspondiente. Los usuarios también pueden actualizar bajo demanda con el botón Update GLS Status en la cabecera del albarán, o con la flecha en línea Update junto al Parcel state.

Dos automatizaciones se basan en el catálogo de estados:

Autovalidación: en el tipo de operación (Inventory app ‣ Configuration ‣ Operations Types), marque Validate Picking on Delivery y elija los estados en Validate on GLS States. El albarán se valida entonces automáticamente en cuanto su paquete, o, en el caso de los albaranes empaquetados, todos sus paquetes, alcanza uno de los estados elegidos. Los albaranes empaquetados se validan sin crear una entrega parcial pendiente; un albarán no empaquetado solo se autovalida cuando puede validarse por completo (un albarán no empaquetado parcial se deja abierto para procesamiento manual). Esto se adapta a los flujos en los que el albarán se mantiene abierto hasta que GLS confirma la entrega al transportista o al cliente.
Fecha de entrega: cuando un paquete alcanza un estado marcado como Delivered State, se registra en el albarán la fecha en la que el cliente recibió realmente la mercancía. Esto alimenta el estado de entrega y las fechas que se muestran en los pedidos de venta y en el portal del cliente; véase Estado y fechas de entrega.

Nota

El texto de estado en bruto devuelto por GLS está en húngaro independientemente del idioma del usuario; el nombre del estado mapeado del catálogo es traducible y es el que debe utilizarse en bases de datos multilingües.

Devoluciones: RMA automático al devolverse al remitente¶

El módulo opcional rma_delivery_gls automatiza el lado de las devoluciones del envío GLS. No se instala automáticamente junto con los demás módulos: crear pedidos de devolución automáticamente tiene consecuencias financieras, por lo que un administrador debe instalarlo deliberadamente en cada base de datos.

RMA automático cuando un paquete se devuelve¶

GLS notifica los paquetes que el cliente nunca recogió con el estado «The parcel has been returned to sender.» (códigos 23 y 40). El módulo marca previamente estos dos estados en sus datos; la marca es un campo técnico del registro de estado y no se muestra en la lista GLS Parcel States; ajústela en modo desarrollador si se necesita un conjunto de estados distinto. El módulo también amplía el cron de seguimiento para seguir consultando los paquetes enviados recientemente después de que el albarán esté hecho, hasta que alcancen un estado de entregado o devuelto.

Cuando una entrega de cliente saliente alcanza un estado marcado, se crea un único RMA de solo devolución y aprobado automáticamente en su pedido de venta, que cubre todas las líneas entregadas susceptibles de devolución, y el pedido se marca como pendiente de reembolso. La automatización es de mejor esfuerzo y segura: un fallo nunca interrumpe la actualización de seguimiento; se registra y se escala como una actividad pendiente (Automatic non-pickup RMA failed) en el comercial, y la siguiente actualización de estado vuelve a intentarlo sin problemas. Las actualizaciones de estado repetidas nunca crean RMA duplicados.

Etiquetas de devolución GLS¶

Para un RMA de devolución aprobado, el módulo genera una etiqueta de devolución GLS: la dirección del cliente es el punto de recogida y la dirección de la empresa es el destino. El Return Method del RMA selecciona el servicio de devolución de GLS:

Return Method	Comportamiento
Parcel Locker	El cliente deja el paquete en un casillero GLS; cuando GLS emite un PIN de casillero para el paquete, se guarda como GLS Locker PIN junto a la etiqueta.
Parcel Shop	El cliente entrega el paquete en cualquier tienda de paquetería GLS.
Collect from Customer	Un mensajero de GLS recoge el paquete en la dirección del cliente.

El resultado se guarda en la pestaña GLS Return del RMA: el número de GLS Return Parcel, el GLS Locker PIN (en devoluciones por casillero, cuando GLS emite uno), el PDF descargable GLS Return Label y el GLS Return Status. Se genera automáticamente una etiqueta de devolución cuando se aprueba una devolución B2C iniciada por el cliente (portal de la tienda web); para los RMA creados en el backend, los gestores de RMA generan la etiqueta con el botón Generate GLS Return Label. Una vez que existe un paquete de devolución, se omite la regeneración, de modo que no se registran paquetes duplicados. Buscar RMA por un número de paquete de devolución escaneado encuentra el registro directamente.

Las Withdrawal declarations quedan excluidas: se gestionan manualmente y no se puede generar ninguna etiqueta de devolución GLS para ellas.

Una acción programada diaria, GLS: Update Return Parcel Tracking, sigue los paquetes de devolución hasta que alcanzan un estado de entregado, actualizando el GLS Return Status en cada RMA.

Transferencias entre varios almacenes¶

El módulo opcional eyssen_stock_multi_warehouse_delivery_gls adapta el transportista GLS al flujo de traslados internos multialmacén de eYssen, para empresas que envían mercancía entre sus propios almacenes con GLS:

Las etiquetas impresas para un paso de un traslado interno se dirigen de almacén a almacén: el almacén de origen es el remitente y el almacén de destino el destinatario (cada uno mostrado como el nombre de la empresa junto con la dirección del almacén), en lugar de empresa a cliente.
Cuando una cadena de albaranes recrea los paquetes para su siguiente paso, la identidad del paquete GLS (ID de paquete y número de paquete) se copia junto con ellos, de modo que el seguimiento sigue al paquete físico a lo largo de los tramos del traslado, incluidos los tramos entre empresas.
La lista de traslados internos se puede buscar por número de paquete GLS a través de su campo de búsqueda Tracking Number.

Instale este puente solo cuando tanto el módulo multialmacén como el transportista GLS estén en uso; no tiene configuración propia.

Configuración¶

Una implantación completa de GLS afecta a los siguientes ajustes:

Módulos: instale eyssen_delivery_gls; añada rma_delivery_gls (automatización de devoluciones, una decisión deliberada por base de datos) y eyssen_stock_multi_warehouse_delivery_gls (envío de almacén a almacén) solo donde sea necesario.
Métodos de envío (Inventory app ‣ Configuration ‣ Delivery Methods): en GLS Parcel Shop y GLS Home delivery, rellene la pestaña GLS Configuration (credenciales, Client number, Delivery type, Create Delivery Address for PS, FlexDeliveryService), establezca el Environment, configure la pestaña Pricing y publique los métodos en el sitio web.
Pagos: active y publique el proveedor Payment on Delivery; revise la lista Enabled payment acquirers de cada método GLS y añada los demás proveedores de la tienda (véase Métodos de pago según el método de envío).
Tipos de operación (Inventory app ‣ Configuration ‣ Operations Types): active opcionalmente Validate Picking on Delivery y seleccione los Validate on GLS States para el tipo de operación saliente.
Catálogo de estados (Inventory app ‣ Configuration ‣ GLS Parcel States): revise las marcas de Delivered State (códigos 05 y 92 de forma predeterminada). Con rma_delivery_gls, las marcas que activan el RMA por falta de recogida (códigos 23 y 40 de forma predeterminada) son campos técnicos de los registros de estado, no se muestran en la lista; ajústelas en modo desarrollador.
Acciones programadas: los crons de seguimiento de albaranes y de paquetes se ejecutan cada tres horas; el cron de seguimiento de devoluciones (con rma_delivery_gls) se ejecuta diariamente.

Los parámetros del sistema (Settings ‣ Technical ‣ System Parameters) ajustan el volumen de consultas. Ninguno de estos parámetros existe de forma predeterminada: se aplica el valor predeterminado incorporado hasta que el parámetro se crea manualmente con un valor distinto:

Parámetro	Por defecto	Propósito
`gls_tracking_check_interval_minutes`	60	Minutos mínimos entre dos comprobaciones del mismo paquete por parte del cron de seguimiento de paquetes.
`gls_done_tracking_batch_size`	25	Máximo de albaranes hechos que se vuelven a consultar por ejecución una vez que `rma_delivery_gls` activa la consulta posterior a la entrega (ventana de 60 días).
`gls_return_tracking_check_interval_minutes`	720	Minutos mínimos entre dos comprobaciones del mismo paquete de devolución.
`gls_return_tracking_batch_size`	100	Máximo de paquetes de devolución consultados por ejecución del cron diario de seguimiento de devoluciones.

Nota

Todos los campos de credenciales de GLS, el catálogo de estados y el menú de estados de paquete están restringidos al grupo Administration / Settings; los usuarios normales del almacén ven los datos de seguimiento pero no pueden cambiar la configuración.

Uso¶

Un pedido típico con GLS transcurre de principio a fin de la siguiente manera:

El comprador selecciona GLS Parcel Shop (o GLS Home delivery) en el proceso de compra. Para un método de tienda de paquetería, se abre el mapa de GLS y el comprador elige una tienda; la elección se guarda en el pedido.
El comprador paga en línea con cualquier proveedor habilitado para el método, o realiza el pedido con Payment on Delivery para pagar en el momento de la entrega; en ese caso, el pedido de venta se confirma en el back-office (véase Métodos de pago según el método de envío).
El almacén prepara la entrega, usando Put in Pack una vez por cada paquete físico cuando se envía más de uno.
Al validar el albarán (o al hacer clic en Print GLS Label) se registra el envío en GLS: se asignan números de paquete a los paquetes, el PDF de la etiqueta se guarda en el albarán y se adjunta en el chatter, y cualquier importe de pago contra reembolso se incluye automáticamente.
Los paquetes se entregan a GLS. Las acciones programadas siguen cada paquete a través de los estados de GLS; el Parcel state actual es visible en el albarán y en cada paquete, y se puede actualizar bajo demanda con Update GLS Status.
Cuando GLS informa de que el paquete ha sido entregado, la fecha de recepción del cliente se registra en el albarán (véase Estado y fechas de entrega) y, si está configurado en el tipo de operación, el albarán se valida automáticamente.
Si el cliente nunca recoge el paquete y GLS lo devuelve al remitente, aparece una RMA de devolución aprobada automáticamente en el pedido de venta (con rma_delivery_gls), lista para la decisión de reembolso.
Para las devoluciones iniciadas por el cliente, la RMA genera una etiqueta de devolución de GLS — con un PIN de taquilla, una entrega en punto de recogida o una recolección por mensajero — y el paquete de devolución se rastrea diariamente hasta que regresa.

Alcance y módulos¶

eyssen_delivery_gls — el propio transportista GLS: métodos de envío a punto de recogida y a domicilio, el selector de mapa en el proceso de pago y en el backend, la generación de etiquetas, el catálogo de seguimiento de 90 estados con validación automática, el proveedor de contra reembolso Pago contra entrega y la API de etiquetas de devolución.
rma_delivery_gls — automatización de devoluciones sobre el transportista: RMA automáticas por no recogida para paquetes devueltos al remitente, etiquetas de devolución de GLS (PIN de taquilla, punto de recogida, recolección por mensajero) y seguimiento diario del paquete de devolución.
eyssen_stock_multi_warehouse_delivery_gls — compatibilidad de GLS para traslados internos entre almacenes: direcciones de etiqueta de almacén a almacén, continuidad del número de paquete entre los tramos del traslado y búsqueda por número de seguimiento.