OCA / delivery-carrier  🇪🇸🇵🇹  AGPL-3.0

CTT Express Connector

Integra CTT Express (API Iberic Web Services) directamente en Odoo. El módulo gestiona el ciclo completo del envío: etiquetas en múltiples formatos (Single, MULTI3, MULTI4), manifiestos en Excel o PDF, recogidas programadas con código de confirmación y tracking en tiempo real — sin salir de Odoo. Cobertura para España, Portugal y Andorra.

delivery_cttexpress
Odoo 12.0 → 18.0
CTT Express (Tourline)
🇪🇸 España · 🇵🇹 Portugal · Andorra
CTT Express
delivery_cttexpress
AGPL-3.0
Versiones12 → 18
APISOAP (zeep)
EtiquetasSingle/MULTI
CoberturaES · PT · AND
Flujo de trabajo
¿Cómo funciona en tu día a día?

Una vez implantado, el proceso de envío con CTT Express queda completamente integrado en Odoo. Así es el flujo paso a paso:

1
Configuras el método de envío

En Inventario → Métodos de envío creas un nuevo carrier con CTT Express como proveedor e introduces tus credenciales de acceso al servicio Iberic Web Services de CTT (antes Tourline Express).

2
Validas el albarán

Al confirmar la entrega, el módulo contacta con la API SOAP de CTT, genera el código de envío y obtiene la etiqueta en el formato que hayas configurado (Single, MULTI1, MULTI3 o MULTI4 para multi-bulto).

3
Imprimes y solicitas recogida

La etiqueta queda adjunta al albarán para imprimir directamente. Desde Odoo también puedes solicitar la recogida en origen y obtener el código de confirmación de CTT Express.

4
Generas el manifiesto

Al final del día genera el manifiesto de entregas en formato Excel o PDF directamente desde Odoo para entregarlo al repartidor de CTT Express, sin acceder al portal web del transportista.

Funcionalidades
Todo lo que incluye el módulo

Funcionalidades verificadas directamente en el repositorio OCA y en implantaciones reales de FlexigoTech.

Etiquetas en múltiples formatos

Generación de etiquetas CTT Express en formato Single, MULTI1, MULTI3 y MULTI4. El formato MULTI permite imprimir varias etiquetas en una sola hoja A4, optimizando el consumo de papel en operaciones de alto volumen.

Single · MULTI3 · MULTI4
Manifiestos Excel y PDF

Generación de manifiestos de entrega directamente desde Odoo en formato Excel o PDF. Imprescindible para la entrega diaria al repartidor de CTT Express sin necesidad de acceder al portal web del transportista.

Desde Odoo
Recogidas con código de confirmación

Solicita recogidas programadas en la dirección del remitente directamente desde Odoo. CTT Express devuelve un código de confirmación que queda registrado en el chatter del albarán para su seguimiento.

Código de confirmación
Tracking en tiempo real

Seguimiento automático del estado del envío (en tránsito, entregado, incidencia) actualizado directamente en el stock.picking de Odoo mediante el módulo delivery_state de OCA.

Sin portal CTT
Regeneración de etiquetas

Si se borran accidentalmente los archivos adjuntos del albarán, el módulo permite regenerar las etiquetas CTT Express sin necesidad de cancelar y volver a registrar el envío en la API.

Recuperación sin incidencias
Cancelación y configuración avanzada

Cancela envíos desde el albarán sin acceder al portal CTT. Configura el offset de impresora para ajustar la posición de impresión de etiquetas según tu hardware, y activa el entorno de test para validar antes de producción.

Test · Producción

Requisitos técnicos

  • Odoo 12.0 a 18.0 — Compatible con las versiones activas principales.
  • Python: zeep — Librería SOAP requerida para comunicarse con los Web Services de CTT Express (iberws.tourlineexpress.com).
  • Módulos OCA dependientes: delivery_package_number, delivery_price_method, delivery_state (OCA/delivery-carrier).
  • Credenciales CTT: Usuario y contraseña del servicio Iberic Web Services de CTT Express.
  • Entorno de test: Puerto 8686 (iberws.tourlineexpress.com). Producción: Puerto 8700.
  • Sin cálculo de tarifas: La API CTT no devuelve precios. Se usa delivery_price_method para definir tarifas en Odoo.

Configuración en Odoo

  • Inventario → Configuración → Métodos de envío → Nuevo
  • Proveedor: CTT Express
  • Usuario y contraseña del portal Iberic Web Services
  • Selecciona el formato de etiqueta preferido
  • Configura el offset de impresora si es necesario
  • Activa "Entorno de test" para pruebas previas
# Dependencia Python (requirements.txt)
zeep>=4.0.0
# Endpoints CTT Express
# Test: iberws.tourlineexpress.com:8686
# Prod: iberws.tourlineexpress.com:8700
Versiones de Odoo soportadas
Odoo 12.0 13.0 14.0 15.0 16.0 17.0 18.0 ★ actual

FlexigoTech mantiene activamente las versiones 17 y 18. Para versiones anteriores realizamos auditoría previa de compatibilidad.

Cobertura geográfica
España, Portugal y Andorra: CTT Express opera en la Península Ibérica con red propia en España y Portugal, cubriendo también envíos a Andorra como destino. Anteriormente conocida como Tourline Express, es la marca ibérica del grupo CTT (Correos de Portugal).

Licencia AGPL-3.0 — Open Source

Este módulo es desarrollado y mantenido por la comunidad OCA bajo licencia AGPL-3.0, con soporte financiado por CTT Express. El código fuente es público y auditable, nunca queda bloqueado a un proveedor. FlexigoTech lo implanta, configura y mantiene profesionalmente.

¿Qué significa la AGPL para tu empresa? Guía completa →

Ver código en GitHub OCA

¿Usas CTT Express y tienes Odoo?

FlexigoTech instala, configura y adapta este conector a tu operativa real. Etiquetas, manifiestos, recogidas y tracking funcionando desde el primer día.

Solicitar implantación

Sin compromiso · Respuesta en menos de 24h · Presupuesto cerrado

¿En qué te podemos ayudar?

Equipo especializado · Responde en <1 día

Agendar una demo Envíanos un WhatsApp Envíanos un mensaje