Envíos con GuatEx para Odoo 19

1.Para quién es este manual

El manual cubre las tres caras del módulo: la del administrador que lo configura, la del vendedor que cotiza el envío y la del personal de bodega que despacha y genera la guía.

Cómo leer las pantallas

Todas las capturas provienen de un ambiente de demostración real: la empresa Distribuidora El Quetzal, S.A., con bodega en la zona 12 de la ciudad de Guatemala, que despacha a clientes en Antigua Guatemala, Quetzaltenango, Cobán, Mixco, Puerto Barrios y Dolores, Petén. Las guías, los números de seguimiento y las etiquetas que aparecen los produjo el módulo contra un simulador de los servicios de GuatEx que responde igual que el servicio real, no montajes; por eso las etiquetas dicen «de demostración». En producción se usan las URL reales de GuatEx que se muestran en el capítulo 4.

2.Qué resuelve el módulo

Odoo trae la mecánica de métodos de envío, pero no conoce a GuatEx. El módulo conecta esa mecánica con los servicios de GuatEx para que la guía se genere sola al despachar y para que el estado del paquete llegue solo a Odoo.

Lo que aporta

• Un proveedor de envío GuatEx dentro de los métodos de entrega de Odoo, con sus credenciales, datos del remitente y opciones.
• El catálogo de destinos de GuatEx (municipios con cobertura, punto de cobertura, tipo de tarifa, si se puede recoger en oficina) y los tipos de envío de su código de cobro, sincronizados a diario.
• Un campo Destino GuatEx en cada contacto, que se llena solo a partir del departamento y la ciudad, incluso con direcciones como «Zona 10, Guatemala» o «Xela».
• Una tabla de tarifas por tipo de envío y cobertura (local, normal o extra), con libras incluidas y precio por libra adicional, para cotizar el envío en la venta.
• La generación de la guía al validar la entrega: guía madre, una guía hija por cada pieza adicional y la etiqueta en ZPL o PDF adjunta al chatter.
• El seguimiento de cada guía en una pestaña de la entrega, actualizado cada dos horas, con aviso en el chatter cuando GuatEx la reporta como entregada.
• Botones de Seguimiento y Guía PDF en la entrega, y la cancelación de la guía desde Odoo.
• Opciones de cobro contra entrega y recoger en oficina.

El flujo completo

Lo que no cambia

La orden de venta, la entrega y el producto de envío son los mismos de Odoo. El módulo no toca el flujo de inventario: solo se ejecuta en el momento en que la entrega pasa a Hecho, pide la guía a GuatEx y guarda el resultado en la entrega. Si GuatEx rechaza la petición, la entrega no se valida y Odoo muestra el motivo, así que nunca queda un despacho sin guía sin que alguien lo sepa.