OdooWiki OCA HUB

Delivery GLS-ASM

delivery_gls_asm folder_open OCA/l10n-spain open_in_new
Stock Licencia: AGPL-3

Este módulo integra la API de GLS España (antigua API de ASM) con Odoo. No es válido para integraciones de GLS en otros países, que podrían usar otras APIs.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Conecta Odoo con el servicio de envíos de GLS España (ASM): crea envíos y recogidas de GLS desde los pedidos de entrega, imprime etiquetas, rastrea paquetes e imprime el manifiesto diario.

Este módulo añade GLS ASM como transportista de entrega en Odoo. En un método de entrega eliges el servicio GLS, el tiempo de envío, el tipo de franqueo y opciones como contra reembolso o 'con devolución'. El sistema sabe automáticamente si el servicio elegido es un servicio de recogida.

Desde una orden de entrega (stock.picking) puedes enviar el envío a GLS, que devuelve un código de barras, una referencia GLS y una etiqueta PDF adjunta a la entrega. También puedes solicitar una recogida, cancelar un envío (solo mientras siga registrado en GLS) y actualizar el estado de seguimiento. Se generan enlaces de seguimiento para el cliente, con un enlace especial para Portugal.

Los estados de GLS se asignan a los estados de entrega de Odoo (en tránsito, entregado, incidencia, etc.) y se muestran en la entrega, junto con el estado del envío GLS y el estado de recogida. Los archivos de prueba de entrega de GLS se pueden descargar y adjuntar.

Un menú 'GLS Deliveries Manifest' en los informes de Almacén abre un asistente donde eliges un rango de fechas y un transportista e imprimes el informe del manifiesto GLS. Se utiliza una configuración de usuario de demostración cuando el transportista no está en modo de producción.

Menús que añade

GLS Deliveries Manifest
Modelos y campos (3)
  • stock.picking · amplía un modelo existentegls_pickup_state (Estado recogida GLS), gls_shipment_state (Estado envío GLS), gls_shipping_notes (Notas de envío GLS), gls_asm_picking_ref (GLS Picking Reference), gls_asm_public_tracking_ref (GLS Barcode), gls_carrier_is_pickup_service
  • delivery.carrier · amplía un modelo existentegls_asm_uid (GLS UID), delivery_type, gls_asm_service (GLS Service), gls_asm_shiptime (Shipping Time), gls_asm_with_return (GLS/ASM With return), gls_asm_postage_type (Postage Type), gls_is_pickup_service (Pick-up service), gls_asm_cash_on_delivery (Cash on delivery)
  • gls.asm.minifest.wizard · modelo nuevodate_from, carrier_id (GLS Service)

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 7 confirmadas, 2 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Este módulo necesita la librería python suds-py3 y depende igualmente de los módulos de OCA/delivery-carrier delivery_package_number y delivery_state.

La API de GLS/ASM no provee métodos de cálculo de precio, de modo que para poder calcular los costes de envío sería recomendable instalar el módulo delivery_price_method.

Para configurar el transportista:

  • Vaya a Inventario \> Configuración \> Entrega \> Método de envío y cree uno nuevo.
  • Escoja GLS ASM Como proveedor.
  • Configure los datos de servicio que tiene contratados y el producto de envío que desea utilizar.

Si no tiene credenciales todavía, puede poner datos inventados y dejar el método de envío en "Entorno de prueba". Se utilizará el usuario de pruebas de la API GLS ASM.

Si GLS cambiase en un futuro el usuario de prueba, puede cambiarlo en los Parámetros del sistema en la clave delivery_gls_asm.api_user_demo.

Estas son las distintas operaciones posibles con este módulo:

Grabar servicios

> 1. Al confirmar el albarán, el servicio se grabará en GLS. > 2. Con la respuesta, se registrará en el chatter la referencia de > envío y las etiquetas correspondientes. > 3. Para gestionar los bultos del envío, se puede utilizar el campo de > número de bultos que añade delivery_package_number (ver el README > para mayor información) o bien el flujo nativo de Odoo con > paquetes de envío. El módulo mandará a la API de GLS/ASM el número > correspondiente y podremos descargar las etiquetas en PDF con su > correspondiente numeración.

Pedir recogidas

> 1. Al confirmar el albarán con un servicio de recogida, el envío NO > se grabará en GLS. > 2. Aparecerá un botón de "Enviar recogida" en la parte superior para > solicitarlo > 3. Con la respuesta, se registrará en el chatter la referencia de > envío > 4. Para gestionar los bultos del envío, se puede utilizar el campo de > número de bultos que añade delivery_package_number (ver el README > para mayor información) o bien el flujo nativo de Odoo con > paquetes de envío.

Cancelar servicios

> 1. Al igual que en otros métodos de envío, en los albaranes de salida > podemos cancelar un servicio determinado mediante la acción > correspondiente en la pestaña de Información Adicional, sección > Información de entrega una vez el pedido esté confirmado y la > expedición generada. > 2. Podremos generar una nueva expedición una vez cancelado si fuese > necesario.

Obtener etiquetas

> 1. Si por error hubiésemos eliminado el adjunto de las etiquetas que > obtuvimos en la grabación del servicio, podemos obtenerlas de > nuevo pulsando en el botón "Etiqueta GLS" que tenemos en la parte > superior de la vista formulario del albarán.

Seguimiento de envíos

> 1. El módulo está integrado con delivery_state para poder recabar la > información de seguimiento de nuestros envíos directamente desde > la API de GLS-ASM. > 2. Para ello, vaya al albarán con un envío GLS ya grabado y en la > pestaña de Información adicional verá el botón Actualizar > seguimiento para pedir a la API de GLS que actualice el estado de > este envío en Odoo.

Manifiesto de envíos

> 1. Para obtener el manifiesto de expediciones que firmaría el > repartidor, puede ir al menú Inventario \> Informes \> Manifiesto > de Envíos GLS. > 2. También puede obtener el manifiesto desde un smart button en el > formulario del transportista. > 3. En el asistente, seleccione el servicio GLS del cual quiere sacar > el manifiesto y la fecha desde la que desea listar los envíos. > 4. Pulse en el botón "Manifiesto GLS" para obtener un listado en PDF > de los envíos del servicio seleccionado.

Depuración de errores

> 1. Es importante tener en cuenta que solo funcionará con códigos > postales de España. > 2. En cada servicio GLS-ASM dispone de una pestaña llamada "Técnico" > en la que puede consultar la última petición y respuesta a la API > de GLS-ASM. Esto le servirá como ayuda a la hora de depurar > posibles errores de comunicación. > 3. También puede activar Odoo con --log-level=debug para registrar > las peticiones y las respuestas en el log.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.