Integración de la API de servicios web de CTT Express Iberic con Odoo. Válido para Portugal y España.
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 19.0Conecta Odoo con el servicio de envíos CTT Express (Portugal/España): crea envíos y etiquetas desde los transfers, sigue el estado de seguimiento, cancela envíos, solicita recogidas de mensajería y descarga manifiestos de envío.
Este módulo añade CTT Express como opción de transportista en Odoo. En un método de envío se introducen los datos de la cuenta de CTT Express (usuario, contraseña, cliente, agencia y códigos de contrato), se elige un servicio de envío del catálogo de CTT y se selecciona el diseño de la etiqueta (una o varias etiquetas por hoja), el formato de archivo (PDF, PNG o BMP) y un desplazamiento. Un botón "Test connection" comprueba las credenciales, y al elegir un servicio se verifica que la cuenta tenga realmente permiso para usarlo.
Cuando se valida una transferencia con un transportista de CTT Express, Odoo envía el envío a CTT Express, almacena el número de seguimiento devuelto, publica los documentos de envío en el chatter de la transferencia y establece el precio de entrega a cero (los precios no se obtienen del transportista). Un botón "CTT Express Label" en la transferencia permite descargar de nuevo la etiqueta; si las etiquetas aún no están listas, un mensaje indica que se reintente más tarde.
Las actualizaciones de seguimiento rellenan el historial de seguimiento de la transferencia y asignan los estados de CTT a los estados de entrega de Odoo (en tránsito, entregado, incidencia, cancelado). Los envíos se pueden cancelar desde Odoo, y un enlace de seguimiento apunta al área de cliente de CTT Express.
Se añaden dos asistentes: una solicitud de recogida (fecha y franja horaria, que devuelve un código de solicitud) disponible desde el formulario del transportista, y un informe de manifiesto en Inventory > Reporting que descarga la lista de envíos para un rango de fechas en Excel o PDF.
Menús que añade
Modelos y campos (4)
- stock.picking · amplía un modelo existente
- delivery.carrier · amplía un modelo existentedelivery_type, cttexpress_user (CTT Express User), cttexpress_agency (Agency code), cttexpress_contract (Contract code), cttexpress_customer (Customer code), cttexpress_password (Password), cttexpress_shipping_type (Shipping type), cttexpress_document_format (Document format), cttexpress_document_offset (Document Offset), cttexpress_document_model_code (Document model)
- cttexpress.pickup.wizard · modelo nuevocode, state, max_hour, min_hour, carrier_id, delivery_date
- cttexpress.manifest.wizard · modelo nuevostate, to_date, from_date, carrier_ids (Filter accounts), document_type (Format), attachment_ids (Manifests)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 8 confirmadas, 1 sin información de 9 versiones.
Fuentes · Odoo 16.0
Confirmado el 2026-11-03 en la rama 16.0 de OCA/delivery-carrier.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Instalación
Fuente · Odoo 19.0Este módulo necesita la librería python zeep. Depende de los módulos delivery_package_number, delivery_price_method y delivery_state que se pueden encontrar en OCA/delivery-carrier.
Los siguientes puertos y hosts deben ser visibles desde su despliegue de Odoo:
- Test: iberws.tourlineexpress.com:8686
- Producción: iberws.tourlineexpress.com:8700
Configuración
Fuente · Odoo 19.0La API de servicios web de CTT Express Iberic no proporciona métodos de cálculo del precio de envío. Por lo tanto, tendrás que confiar en los métodos estándar de Odoo seleccionándolos en el campo Price method.
Para configurar tus servicios de CTT Express, ve a:
- Inventory/Sales \> Configuration \> Delivery methods y crea uno nuevo.
- Elige CTT Express como proveedor.
- Configura tus credenciales de CTT: contract, agency, customer code, user y password.
- Configura tu formato de etiqueta:
- Single: Thermal printer (single label).
- MULTI1: One label per sheet.
- MULTI3: Protrait 3 labels per sheet.
- MULTI4: Landscape 4 labels per sheet.
- También puedes configurar el desplazamiento de tu impresora.
- Elige tu servicio de envío.
Si deseas configurar varios servicios con las mismas credenciales, duplica el primero que creaste y cambia el servicio en la copia.
Los códigos de envío se generan cuando se valida un stock picking cuyo transportista está configurado con CTT Express como proveedor. La etiqueta se genera y se adjunta al documento según los parámetros de generación de etiquetas configurados previamente.
En caso de que elimines accidentalmente el adjunto de la etiqueta, puedes generarla de nuevo haciendo clic en el botón CTT Express Label en la parte superior del formulario del picking.
Como es habitual, para cancelar el envío, ve a la pestaña Additional Information y haz clic en la acción Cancel delivery junto al campo Shipping code.
Para imprimir el manifiesto de envíos entre fechas, ve a:
- Inventory \> Reports \> CTT Express Manifest
- En el asistente podemos configurar el formato del documento (Excel o PDF) y la fecha que comprender.
- También podemos filtrar los métodos de entrega en caso de que gestionemos diferentes cuentas de CTT.
- Haz clic en Get Manifest para recopilar los archivos solicitados.
Para realizar una solicitud programada de recogida de envíos:
- Ve al método de envío de cuya cuenta queremos programar la recogida y haz clic en el botón Pickup request.
- En el asistente, selecciona la fecha y la hora mínima y máxima de recogida.
- Después de hacer clic en el botón Request pickup obtendrás un código de solicitud de recogida que deberías conservar en caso de que haya algún problema con él.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
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.