Ir al contenido
Logotipo de mrdc.tech
mrdc.tech
Guatemalan based, for all the world

Manual de usuario · Inventario y ventas

Envíos con Cargo Expreso para Odoo 19

Cómo configurar y usar el módulo Cargo Expreso (Caex) Delivery: cotizar el envío con la tarifa de Caex en la orden de venta, generar la guía al validar la entrega, imprimir la guía y la recolección, dar seguimiento al paquete y anular guías, todo desde Odoo y con los catálogos oficiales de poblados y tipos de pieza de Cargo Expreso.

Plataforma: Odoo 19 · módulo mrdc_delivery_caex 19.0.1.0 Depende de: Inventario, Ventas, Métodos de envío (stock_delivery) y Contactos Autor: Rodrigo Contreras — mrdc.tech

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.

PerfilQué le interesa
Administrador de OdooCapítulos 3 al 5 y 15: instalación, credenciales, remitente, catálogos de Caex, tareas automáticas y registro de peticiones.
Ventas y atención al clienteCapítulos 6 y 8: preparar el contacto con su poblado Caex y cotizar el envío en la orden de venta.
Bodega y despachoCapítulos 7 y 9 al 14: tipos de paquete, validar la entrega, imprimir la guía, armar varios paquetes, cobro contra entrega, seguimiento y anulación.

Cómo leer las pantallas

Todas las capturas provienen de un ambiente de demostración: la empresa Distribuidora La Ceiba, S.A., con bodega en la zona 4 de la ciudad de Guatemala, que despacha a clientes en Antigua Guatemala, Quetzaltenango, Cobán, Puerto Barrios, Escuintla, San Benito Petén y Mixco. Las guías, las tarifas y los estados de seguimiento los produjo el módulo contra un simulador de los servicios de Cargo Expreso que reproduce las respuestas reales de Caex. Por eso las guías impresas dicen «etiqueta de demostración» y algunas URL apuntan a un servidor local. Los poblados son los del catálogo real de Caex.

Antes de empezar. Para operar con Cargo Expreso necesita una cuenta de cliente con ellos: usuario y contraseña del servicio web, código de crédito y la tarifa asignada a su cuenta. Esos datos los entrega Caex, no el módulo. El capítulo 4 explica dónde se capturan.

2.Qué resuelve el módulo

Odoo trae la mecánica de métodos de envío, pero no conoce a Cargo Expreso. El módulo conecta esa mecánica con el servicio web de Caex para cotizar en línea y para que la guía se genere sola al despachar.

Lo que aporta

  • Un proveedor de envío Cargo Expreso dentro de los métodos de entrega de Odoo, con sus credenciales, el remitente, el poblado de origen y el tipo de servicio.
  • Los catálogos de Caex: departamentos, municipios, poblados y tipos de pieza, sincronizados desde el servicio de Caex y actualizados cada semana.
  • Un campo Poblado Caex en cada contacto, que se propone solo a partir del departamento y la ciudad.
  • La tarifa de Caex al agregar el envío a la cotización, calculada por Caex con el destino, el peso y el tipo de pieza.
  • La generación de la guía al validar la entrega, con una guía por paquete, y la guía y la recolección en PDF adjuntas al chatter.
  • El seguimiento de cada guía (botón en la entrega y actualización automática cada 4 horas) y la anulación de la guía desde Odoo.
  • Los servicios de Caex: Estándar, Collect, cobro contra entrega (COD), Especial y Comprobante de entrega.

El flujo completo

Sincronizar catálogos
→
Contacto con poblado Caex
→
Cotización con tarifa Caex
→
Validar entrega
→
Guía y recolección
→
Seguimiento

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 actúa al cotizar y en el momento en que la entrega pasa a Hecho, cuando pide la guía a Caex y guarda el resultado en la entrega. Si Caex 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.

SituaciónSin el móduloCon el módulo
Costo del envíoConsultar la tarifa con Caex y capturarla a manoOdoo la pide a Caex al cotizar
Generar la guíaCapturar cada envío en el sistema de CaexSe genera al validar la entrega en Odoo
Guía impresaDescargarla aparteQueda adjunta en el chatter de la entrega
Estado del paqueteConsultarlo guía por guíaOdoo lo actualiza cada 4 horas y deja el historial
Poblados con coberturaBuscar el código de cada pobladoCatálogo en Odoo, propuesto en el contacto
Anular una guíaLlamar a CaexEnlace Cancelar en la entrega

3.Instalación y requisitos

El módulo se instala como cualquier otro: necesita Inventario, Ventas y Contactos, que ya incluyen los métodos de envío de Odoo.

Requisitos

RequisitoDetalle
Odoo 19 (Community o Enterprise)Depende de stock_delivery (métodos de envío, que trae Ventas e Inventario) y de contacts. No requiere otros módulos de mrdc.tech.
Cuenta con Cargo ExpresoUsuario y contraseña del servicio web, código de crédito y una tarifa asignada a la cuenta. Caex entrega también un ambiente de pruebas (QA) con sus propias credenciales.
Salida a internet desde el servidorEl servidor de Odoo debe alcanzar ws.caexlogistics.com (servicio), tracking.caexlogistics.com (seguimiento) y wz.caexlogistics.com (PDF de las guías). En pruebas, wsqa.caexlogistics.com por el puerto 1880.
Pesos en los productosCaex cotiza y cobra por peso. Capture el peso en la ficha de cada producto; el módulo lo convierte a libras.

Instalación

  1. Copie la carpeta mrdc_delivery_caex a una ruta del addons_path del servidor y reinicie Odoo.
  2. Active el modo desarrollador y actualice la lista de aplicaciones.
  3. En Aplicaciones quite el filtro «Aplicaciones», busque Cargo Expreso e instale Cargo Expreso (Caex) Delivery.
  4. Vaya a Inventario → Configuración → Métodos de envío: el módulo ya creó el método Cargo Expreso listo para configurar (capítulo 4).
El módulo Cargo Expreso en la lista de aplicaciones
Figura 1. El módulo en Aplicaciones. Es un módulo técnico, no una aplicación: para verlo hay que quitar el filtro «Aplicaciones» de la barra de búsqueda.

Qué crea la instalación

  • El método de envío Cargo Expreso con su producto de envío, restringido a Guatemala y sus 22 departamentos.
  • El tipo de paquete Paquete Caex (capítulo 7).
  • Dos acciones planificadas: Caex: actualizar catálogos (semanal) y Caex: actualizar seguimiento de guías (cada 4 horas). Capítulo 15.
  • El menú Contactos → Cargo Expreso con Poblados y Tipos de pieza, y el campo Poblado Caex en el contacto.

Actualizar

Reemplace la carpeta y actualice el módulo (Aplicaciones → Cargo Expreso (Caex) Delivery → Actualizar o -u mrdc_delivery_caex desde la línea de comandos). Las credenciales y la configuración del método de envío no se tocan al actualizar.

4.Configurar el método de entrega

Toda la configuración vive en un solo lugar: la pestaña Configuración Cargo Expreso del método de envío. Cuatro grupos: credenciales, remitente, URLs y opciones.

Abra Inventario → Configuración → Métodos de envío y entre al método Cargo Expreso. Si prefiere crear uno nuevo, elija Cargo Expreso en el campo Proveedor y la pestaña aparece sola.

Listado de métodos de envío con Cargo Expreso
Figura 2. Los métodos de envío. En el ambiente de demostración hay dos con proveedor Cargo Expreso: el de servicio Estándar y uno con cobro contra entrega (capítulo 12).
Cabecera del método de envío Cargo Expreso
Figura 3. La cabecera del método. Nivel de integración debe quedar en «Obtener tarifa y crear el envío» para que la guía se genere al validar la entrega. Arriba, el botón Entorno de prueba / producción y Solicitudes de depuración (capítulo 15).
Pestaña Configuración Cargo Expreso con credenciales, remitente, URLs y opciones
Figura 4. La pestaña Configuración Cargo Expreso con las URL reales de producción, pruebas y seguimiento. La contraseña se guarda oculta y solo la ve el administrador del sistema. Abajo, los botones para sincronizar y consultar los catálogos (capítulo 5).

Credenciales

CampoQué capturar
Usuario CaexEl usuario del servicio web que le asignó Cargo Expreso.
Contraseña CaexLa clave de ese usuario.
Código de créditoEl código con el que Caex identifica su cuenta y su tarifa (por ejemplo 0090001). Caex lo usa para cotizar y para cobrar las guías a crédito.
Pruebas y producción tienen credenciales distintas. El usuario de pruebas no funciona en producción y al revés. Además, el código de crédito y la tarifa tienen que estar asociados al usuario en el mismo ambiente; si no, Caex responde con los códigos 14 y 41 del capítulo 16.

Remitente

Son los datos que Caex imprime como remitente en cada guía: nombre, dirección y teléfono, más el Poblado de origen, que es el poblado de Caex desde donde salen sus paquetes y que Caex usa para calcular la tarifa. El nombre, la dirección y el poblado de origen son obligatorios. El teléfono se envía solo con sus 8 dígitos: si lo captura con +502, espacios o guiones, el módulo los quita.

URLs

Vienen llenas y no hay que tocarlas. El botón Entorno de prueba / producción decide cuál se usa:

CampoValor por defectoCuándo se usa
URL del servicio (producción)https://ws.caexlogistics.com/wsCAEXLogisticsSB/wsCAEXLogisticsSB.asmxCotizar, generar, anular y catálogos, con el método en producción.
URL del servicio (pruebas)http://wsqa.caexlogistics.com:1880/wsCAEXLogisticsSB/wsCAEXLogisticsSB.asmxTodo, incluido el seguimiento, con el método en prueba.
URL de seguimiento Caexhttps://tracking.caexlogistics.com/wsCAEXLogisticsSB/wsCAEXLogisticsSB.asmxConsultar el estado de las guías en producción.

Opciones

CampoQué hace
Tipo de servicioEstándar, Collect, COD (cobro contra entrega), Especial o Comprobante de entrega. Viaja en la cotización y en la guía (capítulo 12).
Formato de impresiónEl formato en que Caex arma la guía: Sticker 4"x4", Carta, Sticker 4"x6" o Sticker 4"x6" (guía de remisión HN).
Tipo de paquete CaexEl tipo de paquete que se usa cuando la entrega no tiene paquetes armados (capítulo 7). Obligatorio.
Tipo de pieza por defectoEl tipo de pieza de Caex (sobre, paquete…) que se envía cuando el paquete no indica uno propio (capítulo 7).
Declarar valor aseguradoEnvía el total de la venta como monto asegurado de la guía, para que Caex aplique el seguro adicional de su contrato.
Código de referencia (sub-cliente)Un código interno que Caex usa para separar las guías en el manifiesto, por ejemplo por sucursal. Déjelo en 0 si Caex no le asignó uno.

Disponibilidad

Pestaña Disponibilidad con Guatemala y sus departamentos
Figura 5. La pestaña Disponibilidad viene con Guatemala y sus 22 departamentos. Así el método solo se ofrece a direcciones guatemaltecas.
Listo para probar. Guarde el método y presione Sincronizar catálogos Caex (capítulo 5). Si las credenciales son correctas, verá la notificación con la cantidad de poblados y tipos de pieza cargados; si no, el error de Caex aparece en pantalla.

5.Catálogos de Caex: poblados y tipos de pieza

Cargo Expreso no cotiza ni genera guías con una dirección libre: necesita el código del poblado de destino y el código del tipo de pieza. El módulo trae esos catálogos a Odoo y los mantiene al día.

La primera carga

En la pestaña Configuración Cargo Expreso del método de envío presione Sincronizar catálogos Caex. El módulo consulta a Caex los departamentos, los municipios, los poblados y los tipos de pieza, y crea o actualiza un registro por código.

Notificación de catálogos sincronizados
Figura 6. Al terminar, Odoo muestra cuántos poblados y tipos de pieza se sincronizaron. Se puede repetir cuantas veces haga falta: no duplica, actualiza por código.

Si Caex deja de enviar un poblado o un tipo de pieza, la sincronización lo archiva en Odoo. Los contactos que lo tenían asignado lo conservan, pero conviene revisarlos.

Dónde se consultan

En Contactos → Cargo Expreso, o con los botones Ver poblados y Ver tipos de pieza del método de envío.

Menú Cargo Expreso dentro de Contactos
Figura 7. El menú Cargo Expreso en la aplicación Contactos.
Listado de poblados Cargo Expreso
Figura 8. El listado de poblados: código, nombre, municipio, departamento tal como lo escribe Caex, el departamento equivalente de Odoo y las marcas de cabecera municipal y zona roja.
Poblados agrupados por departamento
Figura 9. Agrupados por departamento, con Guatemala abierto. Cada municipio tiene su cabecera (Ciudad Capital 1393, Mixco 1065, Villa Nueva 0696) y varios poblados más: colonias, aldeas y agencias de Caex.
Ficha de un poblado Caex
Figura 10. La ficha del poblado Antigua Guatemala con sus códigos de Caex.
CampoQué significa
CódigoEl identificador del poblado en Caex. Es lo que viaja en la cotización y en la guía.
Departamento (Odoo)El departamento de Odoo equivalente, que el módulo asigna por nombre. Es lo que permite proponer el poblado en el contacto.
Departamento / Municipio y sus códigosComo los escribe Caex.
Cabecera municipalEl poblado principal del municipio. Es el que el módulo propone cuando la ciudad del contacto coincide con el municipio.
Zona rojaLa marca con la que Caex identifica poblados con condiciones especiales de entrega. El módulo solo la muestra; las condiciones las define su contrato con Caex.

Tipos de pieza

Tipos de pieza Cargo Expreso
Figura 11. Los tipos de pieza de la cuenta. Caex define cuáles tiene cada cliente; los más comunes son SOBRES y PAQUETES.

Actualización automática

La acción planificada Caex: actualizar catálogos repite la sincronización una vez por semana para cada método Cargo Expreso, así que los poblados nuevos aparecen solos (capítulo 15).

No edite los poblados a mano. Cualquier cambio se sobrescribe en la siguiente sincronización. Si un poblado no aparece, presione Sincronizar catálogos Caex; si sigue sin aparecer, consúltelo con Caex.

6.Preparar los contactos

Cada cliente al que se envía por Cargo Expreso necesita un Poblado Caex en su ficha. En la mayoría de los casos el módulo lo propone solo.

El campo Poblado Caex

En la ficha del contacto, junto al puesto de trabajo, aparece el campo Poblado Caex. Solo se muestra cuando el país del contacto es Guatemala.

Ficha de contacto con el campo Poblado Caex
Figura 12. Ana Lucía Pérez, cliente de Antigua Guatemala, con su poblado [0223] Antigua Guatemala, Sacatepéquez. La dirección, el teléfono y el NIT viajan en la guía.

Propuesta automática

Al capturar el departamento y la ciudad, el módulo busca en el catálogo de ese departamento, sin distinguir acentos ni mayúsculas, en este orden:

  1. la cabecera del municipio que se llama como la ciudad;
  2. un poblado que se llame como la ciudad;
  3. cualquier poblado del municipio que se llama como la ciudad.

Si encuentra uno, lo asigna. Al revés también funciona: si elige el poblado a mano, el módulo ajusta el departamento y la ciudad al municipio de ese poblado.

Contacto nuevo con el poblado propuesto automáticamente
Figura 13. Un contacto nuevo: bastó elegir Guatemala, Sacatepéquez y escribir «Antigua Guatemala» para que Poblado Caex quedara en [0223] Antigua Guatemala.
Colonias y aldeas. La propuesta toma la cabecera del municipio. Si el cliente vive en una colonia o aldea que Caex tiene como poblado aparte (por ejemplo «Aldea Lo De Fuentes», en Mixco), elíjala a mano: la tarifa y la ruta de Caex dependen del poblado.

Qué datos del contacto usa la guía

DatoUso en Caex
NombreDestinatario y contacto de la guía. Si la dirección de entrega es un contacto de una empresa, el destinatario es la empresa y el contacto, la persona.
Calle, Calle 2 y CiudadDirección de entrega, unidas con coma.
TeléfonoTeléfono del destinatario, solo los 8 dígitos.
NITNIT del destinatario en la guía.
Poblado CaexEl código de destino. Sin él no hay cotización ni guía.
Sin poblado no hay guía. Si la dirección de entrega no tiene poblado Caex, la cotización no obtiene tarifa y la validación de la entrega se detiene con el mensaje «El contacto … no tiene configurado un poblado Caex». Se corrige en la ficha del contacto (capítulo 16).
Direcciones de entrega. El poblado se lee del contacto que aparece como Dirección de entrega en la orden; si no lo tiene, del contacto principal de la empresa. Si el cliente tiene varias direcciones, cada una puede llevar su propio poblado.

7.Tipos de paquete y tipos de pieza

Caex cobra por pieza, por peso y por tipo de pieza. Odoo describe cada bulto con un tipo de paquete, y el módulo le agrega a cada tipo de paquete su tipo de pieza de Caex.

Los tipos de paquete están en Inventario → Configuración → Tipos de paquete (requiere la opción Paquetes activa en los ajustes de Inventario). La instalación crea Paquete Caex; puede crear los que necesite siempre que el campo Transportista sea Cargo Expreso.

Listado de tipos de paquete
Figura 14. Los tipos de paquete del ambiente de demostración: Paquete Caex, Caja Caex grande para bultos pesados y Sobre Caex para documentos.
Ficha del tipo de paquete Paquete Caex
Figura 15. La ficha de Paquete Caex: transportista Cargo Expreso, su código y el campo Tipo de pieza Caex, que solo aparece cuando el transportista es Cargo Expreso.

Cómo se arma lo que viaja a Caex

  • Sin paquetes armados en la entrega, el módulo envía una pieza con el peso total, usando el Tipo de paquete Caex del método de envío.
  • Con paquetes armados (botón Incluir en el paquete), envía una pieza por paquete, cada una con su peso. Caex devuelve una guía por pieza (capítulo 11).
  • El tipo de pieza sale del tipo de paquete; si el tipo de paquete no tiene uno, se usa el Tipo de pieza por defecto del método.
  • El peso viaja en libras, con dos decimales: un paquete de 3 kg viaja como 6.61 lb.
Pesos. Odoo suma el peso de los productos según la cantidad entregada más el peso base del tipo de paquete. Revise que los productos tengan peso; el peso de la entrega se ve y se corrige en la pestaña Información adicional (campo Peso para envío) antes de validar.

8.Cotizar el envío en la orden de venta

El envío se agrega a la cotización como una línea más, con el asistente estándar de Odoo. La diferencia es que el costo lo calcula Cargo Expreso en línea.

  1. En la cotización presione Agregar envío, abajo de las líneas.
  2. Elija el método Cargo Expreso. Si el cliente lo tiene como método preferido en su ficha, ya viene seleccionado.
  3. Presione Obtener tarifa y luego Agregar.
Cotización antes de agregar el envío
Figura 16. La cotización S00008 de María José Gómez, en Mixco, con dos productos.
Asistente Agregar un método de envío con Cargo Expreso
Figura 17. El asistente con Cargo Expreso seleccionado y el peso total de la orden, calculado con los pesos de los productos.
Asistente con la tarifa de Caex
Figura 18. Tras Obtener tarifa, el costo que devolvió Caex: Q 35.48 por 3.5 kg (7.72 lb) de la capital a Mixco.
Cotización con la línea de envío Cargo Expreso
Figura 19. La línea Envío Cargo Expreso agregada. Si después cambian los productos, el botón Actualizar costo de envío vuelve a pedir la tarifa.

Qué envía Odoo para cotizar

DatoDe dónde sale
Poblado de destinoEl poblado Caex de la dirección de entrega de la orden.
Poblado de origenEl del método de envío.
Tipo de piezaEl del tipo de paquete del método (capítulo 7).
Tipo de servicioEl del método de envío.
Peso totalLa suma de los pesos de los productos de la orden, en libras.
Código de créditoEl del método de envío: con él Caex aplica la tarifa de su cuenta.
Política de facturación. Con Costo estimado (la opción por defecto) al cliente se le cobra lo cotizado. Con Costo real, al validar la entrega Odoo ajusta la línea al monto de las guías que devuelva Caex. En el servicio Collect Caex no devuelve monto porque el envío lo paga el destinatario.
Si Caex no devuelve tarifa, el asistente muestra el error de Caex y no agrega la línea. El caso más común es el código 14, «No fue posible calcular la Tarifa favor de comunicarse a Cargo Expreso»: la cuenta no tiene tarifa para ese código de crédito (capítulo 16).

9.Generar la guía al validar la entrega

No hay un botón «generar guía»: la guía se pide a Caex en el momento en que la entrega se valida. Si Caex responde con éxito, la entrega queda en Hecho con su número de guía.

Listado de entregas
Figura 20. Las entregas del ambiente de demostración: las validadas ya tienen guía; las que están en Listo, todavía no.

Antes de validar

Entrega lista para validar
Figura 21. La entrega BC/OUT/00007 de Lucas Hernández, en San Benito, Petén, en estado Listo. Aún no aparecen los botones de la guía porque no la hay.
Pestaña Información adicional antes de validar
Figura 22. En Información adicional se ve el transportista que heredó de la orden y el peso que viajará a Caex. La referencia de rastreo está vacía.

Validar

Presione Validar. Odoo confirma las cantidades y, como el método es Cargo Expreso, llama al servicio de Caex con el remitente, el destinatario, el poblado y las piezas. En un par de segundos la entrega pasa a Hecho.

Entrega validada con número de guía
Figura 23. BC/OUT/00007 validada con la guía 4W260020106. Arriba aparecen los botones Guía PDF, Recolección PDF y Seguimiento Caex; en el chatter, el mensaje de Caex con la guía y la recolección adjuntas.
Información de envío con la referencia de rastreo
Figura 24. La Referencia de rastreo es el número de guía de Caex. A su lado, el enlace Cancelar (capítulo 14).

Lo que queda en el chatter

  • El mensaje estándar de Odoo con el número de seguimiento y el costo.
  • El mensaje del módulo, Guía generada en Cargo Expreso: número de guía, tarifa, los enlaces a la guía y a la recolección en el sistema de Caex y, si aplica, el monto COD.
  • Dos PDF adjuntos: LabelShipping-caex-.pdf (la guía) y ShippingDoc-caex-.pdf (la recolección). El capítulo 10 los explica.

El mensaje del módulo se publica en todas las entregas de la orden de venta, no solo en la que se validó, para que quien consulte cualquiera de ellas encuentre la guía.

Qué viaja a Caex

Dato de la guíaDe dónde lo toma el módulo
Remitente y origenNombre, dirección, teléfono y poblado de origen del método de envío.
DestinatarioNombre, dirección, teléfono, NIT y poblado de la dirección de entrega.
Referencia 1 (y número de recolección)El número de la entrega, por ejemplo BC/OUT/00007.
Referencia 2La referencia del cliente de la orden de venta; si no hay, el número de la orden.
Servicio y formatoTipo de servicio y formato de impresión del método.
PiezasUna por paquete de la entrega, o una sola con el peso total, con su tipo de pieza (capítulo 7).
Monto CODSolo con el servicio COD (capítulo 12).
Monto aseguradoEl total de la venta, si el método tiene Declarar valor asegurado.
ObservacionesLa pestaña Nota de la entrega, hasta 250 caracteres.
Si Caex rechaza la guía, la entrega no se valida. Odoo muestra el mensaje de Caex y todo queda como estaba. Las causas típicas están en el capítulo 16.

10.La guía y la recolección en PDF

Caex genera dos documentos por cada envío: la guía de cada pieza y la recolección, que reúne todas las guías del envío. El módulo descarga los dos y los adjunta al validar.

La guía

Guía de Cargo Expreso en sticker 4x6
Figura 25. La guía 4W260020101 de Ana Lucía Pérez en sticker 4"×6": código de barras, guía madre y número de pieza, remitente, destinatario con su poblado, piezas, peso en libras, monto a cobrar y las dos referencias. Es la guía del simulador; la real la produce Caex con su diseño y logotipo.
DocumentoContenidoDónde está
GuíaLa etiqueta de la primera pieza (la guía madre).Adjunto LabelShipping-caex-… y botón Guía PDF.
RecolecciónUna página por pieza, con todas las guías del envío.Adjunto ShippingDoc-caex-… y botón Recolección PDF.

En un envío de una sola pieza los dos documentos traen la misma etiqueta. En envíos de varias piezas, imprima la recolección: es la que trae una etiqueta por bulto (capítulo 11).

Los botones de la entrega

Guía PDF y Recolección PDF abren el documento directamente en el sistema de Caex, en una pestaña nueva. Sirven para reimprimir cuando se perdió el adjunto. El formato (sticker 4"×6", 4"×4" o carta) es el que se eligió en el método de envío al generar la guía.

Si no aparecen los adjuntos. El módulo descarga los PDF desde los enlaces que devuelve Caex. Si el servidor de Odoo no alcanza esos enlaces en ese momento, la guía se genera igual y los documentos se abren con los botones de la entrega.

11.Envíos con varios paquetes

Si un pedido va en más de una caja, se arman los paquetes en la entrega antes de validar. Caex emite una guía por paquete, todas bajo la misma recolección.

  1. En la pestaña Operaciones de la entrega, marque las líneas que van en la primera caja y presione Incluir en el paquete. Elija el tipo de paquete.
  2. Repita para cada caja. Cada paquete recibe un nombre (PACK0000001, PACK0000002…).
  3. Valide la entrega.
Botón Incluir en el paquete en la entrega
Figura 26. El botón Incluir en el paquete en una entrega lista para validar. Para verlo hay que activar la opción Paquetes en los ajustes de Inventario.
Entrega con dos paquetes y su chatter
Figura 27. BC/OUT/00002 de Carlos Ramírez, en Quetzaltenango: licuadora y cafetera en PACK0000001, el kit de herramientas en PACK0000002. Caex devolvió dos guías, 4W260020102 y 4W260020103, y la tarifa es la suma de las dos: Q 118.95.
Referencia de rastreo con dos guías
Figura 28. La Referencia de rastreo guarda las dos guías separadas por coma. La primera es la guía madre.
Recolección con una guía por pieza
Figura 29. La recolección BC/OUT/00002: una página por pieza, «1 de 2» y «2 de 2», cada una con su peso (13.23 lb y 9.04 lb) y la misma guía madre. Es el documento que hay que imprimir y pegar en cada caja.
SituaciónPiezas enviadasGuías
Entrega sin paquetes armados1, con el peso total1
Entrega con 2 paquetes2, cada una con su peso2 (la primera es la madre)
Entrega con N paquetesNN
Seguimiento y anulación. El seguimiento consulta la guía madre, que representa al envío. La anulación (capítulo 14) anula todas las guías del envío.

12.Cobro contra entrega y otros servicios

El tipo de servicio se elige por método de envío. Lo habitual es tener un método Cargo Expreso normal y otro «contra entrega», y elegir el que corresponda en cada orden.

Los servicios de Caex

ServicioQuién paga el envíoNotas
EstándarEl remitente, a créditoEl servicio normal. Necesita un código de crédito válido.
CollectEl destinatarioNo usa el código de crédito y Caex no devuelve el monto de la guía.
COD (cobro contra entrega)El remitente, a créditoCaex cobra al destinatario el valor de la mercadería y lo liquida al remitente.
Especial y Comprobante de entregaSegún contratoServicios que Caex habilita por cliente. Confírmelos con su ejecutivo.
Método Cargo Expreso contra entrega
Figura 30. El método Cargo Expreso contra entrega del ambiente de demostración: las mismas credenciales y el remitente del método normal, con Tipo de servicio en COD.

Cómo se calcula el monto COD

Con el servicio COD, el módulo envía como monto a cobrar el total de la orden de venta, que ya incluye la línea de envío. Si el envío lleva varias piezas, el monto se reparte en partes iguales entre ellas. El monto aparece en el mensaje del chatter y en la guía, en el campo Pago.

Entrega con cobro contra entrega
Figura 31. BC/OUT/00003 de Ferretería La Esperanza, en Cobán: tres kits de herramientas (Q 2,160.00) más el envío (Q 121.42). Caex cobrará Q 2,281.42 al entregar.
Revise la fórmula con su ejecutivo de Caex. El monto COD incluye el flete porque el cliente pagó la orden completa. Si su acuerdo con Caex indica que el flete no se suma al cobro, pida a mrdc.tech ajustar la fórmula.
Un método por servicio. Como el servicio es del método de envío, cree uno por cada servicio que use. El cliente puede tener su método preferido en la ficha, en la pestaña Ventas y compras.

13.Seguimiento de la guía

Odoo consulta a Caex el estado de cada guía y lo guarda en la entrega, con el historial de movimientos en el chatter. Se actualiza solo cada 4 horas o a pedido con un botón.

El botón Seguimiento Caex

En la parte superior de la entrega, el botón Seguimiento Caex muestra el estado actual. Al presionarlo, Odoo pregunta a Caex y actualiza la entrega.

Entrega con el seguimiento de Caex completo
Figura 32. BC/OUT/00001 de Ana Lucía Pérez, ya Entregado. En Información adicional: el estado de Caex, el último evento, quién recibió, la fecha de entrega y cuándo se actualizó el seguimiento. En el chatter, la tabla con cada movimiento: fecha, agencia, ruta y movimiento.
Entrega en ruta de traslado
Figura 33. BC/OUT/00002 a Quetzaltenango, todavía En ruta de traslado.

El chatter solo recibe un mensaje nuevo cuando el estado cambia, así que el historial no se llena de consultas repetidas.

Los estados de Caex

CódigoEstadoQué significa
SRSin recolectarLa guía existe; Caex no ha pasado por el paquete.
RRecolectadoCaex tiene el paquete.
BDAlmacenado en bodegaEl paquete está en una bodega de Caex.
RB / RUEn ruta hacia bodega destino / En ruta de trasladoViaja entre bodegas.
REEn ruta de entrega finalSalió a entregar al destinatario.
A / AAEntregado / Entregado y liquidadoEntregado; en COD, «liquidado» indica que Caex ya liquidó el cobro.
D / DDDevolución / Devolución entregadaEl paquete regresa al remitente.
NMAnomalíaUn problema en la entrega; consulte con Caex.
ANAnuladaLa guía se anuló (capítulo 14).

Actualización automática

La acción planificada Caex: actualizar seguimiento de guías corre cada 4 horas y consulta todas las entregas validadas con guía de Caex que todavía no llegan a un estado final (Entregado, Entregado y liquidado, Devolución entregada o Anulada). Si una consulta falla, se registra en el log y sigue con las demás.

Rastreo para el cliente. Caex no ofrece una página pública de rastreo por número de guía, así que Odoo no muestra el botón estándar «Seguimiento» en estas entregas. Si tiene activo el correo de confirmación de entrega de Inventario, el cliente recibe ahí el número de guía y puede consultarlo con Caex.

14.Anular una guía

Si el pedido se cancela después de despachar o la guía salió con datos equivocados, se anula en Caex desde la misma entrega.

  1. Abra la entrega validada y vaya a Información adicional.
  2. Junto a la referencia de rastreo, presione Cancelar y confirme.
  3. El módulo pide a Caex anular cada guía del envío. Si Caex acepta, la referencia y el costo se limpian, el estado queda en Anulada y el chatter deja constancia.
Entrega con la guía anulada
Figura 34. BC/OUT/00004 de Tienda Doña Rosa tras anular: la referencia de rastreo quedó vacía, el estado es Anulada y el chatter muestra «La guía 4W260020105 fue anulada en Cargo Expreso». Arriba aparece Enviar al transportista.

Volver a generar

Una entrega en Hecho sin referencia de rastreo muestra el botón Enviar al transportista. Con él se pide una guía nueva sin repetir la validación; sirve para reenviar después de corregir la dirección o el poblado del contacto.

Cómo confirma Odoo la anulación. Si la guía ya estaba anulada, Caex responde «La guía ya fue anulada» y Odoo lo toma como anulación correcta, así que puede repetir la operación sin problema. Si Caex rechaza la anulación por cualquier otro motivo, el módulo consulta además el seguimiento: si la guía ya figura como Anulada, da la anulación por buena.
Caex decide. Si la guía ya fue recolectada o facturada, Caex rechaza la anulación; en ese caso Odoo muestra el mensaje de Caex y la referencia se conserva. Coordine la devolución con Caex.

15.Tareas automáticas y registro de peticiones

Herramientas para el administrador: las dos acciones planificadas del módulo, el registro de cada petición enviada a Caex y el cambio entre pruebas y producción.

Las acciones planificadas

En Ajustes → Técnico → Acciones planificadas están:

AcciónFrecuenciaQué hace
Caex: actualizar catálogosCada semanaSincroniza poblados y tipos de pieza de todos los métodos Cargo Expreso (capítulo 5).
Caex: actualizar seguimiento de guíasCada 4 horasConsulta el estado de las guías que todavía no llegan a un estado final (capítulo 13).
Acción planificada Caex: actualizar seguimiento de guías
Figura 35. La acción de seguimiento. Se puede cambiar la frecuencia o ejecutarla a mano con Ejecutar de forma manual.

Registro de peticiones

El botón Solicitudes de depuración del método de envío activa el registro de todo lo que se envía y se recibe de Caex. Los registros se consultan en Ajustes → Técnico → Registro.

Listado del registro con peticiones a Caex
Figura 36. Cada llamada deja dos entradas: la petición (caex_request) y la respuesta (caex_response).
Detalle de una respuesta de Caex
Figura 37. Una respuesta completa de seguimiento: estado, eventos con agencia, ruta y movimiento. Cuando Caex rechaza algo, aquí está el código y el mensaje exacto que hay que mandarle a Caex.
La petición incluye las credenciales. El registro guarda el cuerpo enviado, con el usuario y la contraseña de Caex. Actívelo para diagnosticar y desactívelo después; los registros se pueden borrar desde el mismo listado.

Entorno de prueba y producción

El botón Entorno de prueba / producción del método decide a qué servicio de Caex se conecta Odoo: en prueba, todo va a la URL de pruebas (incluido el seguimiento); en producción, a la URL de producción y a la de seguimiento. Recuerde cambiar también las credenciales al pasar de un ambiente a otro (capítulo 4).

16.Problemas frecuentes y preguntas

Casi todo lo que se reporta como «no salió la guía» o «no cotiza» es uno de estos casos. Los mensajes son los que devuelve Odoo o Caex, tal cual.

Error de validación por contacto sin poblado
Figura 38. El error más común: la dirección de entrega no tiene poblado Caex. La entrega sigue en Listo; se asigna el poblado en el contacto y se valida de nuevo.
MensajeCausa y solución
«El contacto … no tiene configurado un poblado Caex.»Falta el poblado en la dirección de entrega. Asígnelo en el contacto (o capture departamento y ciudad para que se proponga solo) y vuelva a cotizar o validar (capítulo 6).
«Cargo Expreso solo realiza envíos dentro de Guatemala.»El país de la dirección de entrega no es Guatemala.
«El método de entrega Cargo Expreso no tiene configurado: …»Faltan credenciales, el poblado de origen, el tipo de pieza por defecto o el nombre y la dirección del remitente (capítulo 4).
«No fue posible calcular la Tarifa favor de comunicarse a Cargo Expreso [código 14]»La cuenta no tiene tarifa asignada para ese código de crédito en el ambiente que está usando (pruebas o producción). Pida a Caex que la asigne; no se corrige en Odoo.
«Debe indicar un codigo de Credito valido! [código 41]»El código de crédito no está asociado al usuario en ese ambiente. Afecta a Estándar y COD; Collect sí funciona porque no usa crédito. Se corrige del lado de Caex.
«Usuario / clave inválidos [código 2]»Credenciales incorrectas, o credenciales de pruebas con el método en producción (o al revés).
«El código del poblado no existe y es inválido [código 4]»El poblado del contacto ya no existe en Caex. Sincronice los catálogos y elija otro poblado.
«El valor del peso es inválido… [código 10]»Los productos no tienen peso. Cárguelo en la ficha del producto o corrija Peso para envío en la entrega.
«No fue posible conectar con Cargo Expreso, intente de nuevo más tarde.»El servidor de Odoo no alcanza el servicio de Caex o Caex está fuera de línea. Reintente; si persiste, revise la salida a internet del servidor.
«No fue posible anular la guía … Esta guia ya tiene factura no es posible anularla o no existe.»La guía ya fue recolectada o facturada por Caex. Coordine con Caex (capítulo 14).
«No fue posible anular la guía … Verifique que la guía exista o que tenga la nomenclatura correcta»Caex no encuentra esa guía: se generó en otro ambiente (pruebas o producción) o con otras credenciales. Revise el ambiente del método de entrega.
El botón Seguimiento Caex no apareceLa entrega no tiene referencia de rastreo: no se ha validado o la guía se anuló.
El campo Poblado Caex no se ve en el contactoEl país del contacto no es Guatemala.
Para reportar un problema a Caex, active Solicitudes de depuración, repita la operación y copie la petición y la respuesta del registro (capítulo 15). Con eso Caex ve exactamente lo que recibió y lo que contestó.

Preguntas frecuentes

¿Puedo generar la guía sin validar la entrega? No. La guía se pide al validar, que es cuando Odoo conoce las cantidades y los paquetes definitivos.

¿Qué pasa con las devoluciones? El módulo no genera guías de retorno. La devolución se recibe en Odoo como cualquier otra y el transporte de regreso se coordina con Caex.

¿Sirve con varias compañías? Sí. Cada compañía crea su propio método Cargo Expreso con sus credenciales, su código de crédito y su remitente. Los catálogos son compartidos.

¿Puedo enviar a una dirección que no está en el catálogo? No: Caex exige el código del poblado. Elija el poblado más cercano y detalle la dirección en el campo Calle.

¿La tarifa de Odoo es lo que cobrará Caex? Es la que calcula Caex con su contrato en el momento de cotizar. El cobro real llega en la facturación de Caex; con la política Costo real, la línea de envío se ajusta al monto de las guías generadas.

Logotipo de mrdc.tech
mrdc.tech
Guatemalan based, for all the world

Manual de Envíos con Cargo Expreso para Odoo 19 — módulo Cargo Expreso (Caex) Delivery.
Implementación, soporte y desarrollo a la medida sobre Odoo: facturación electrónica de Guatemala, El Salvador y Panamá, nómina, pasarelas de pago, integraciones con transportistas, aplicaciones móviles e inteligencia artificial.

mrdc.tech · info@mrdc.tech · +502 4288 7385