Como conectar CTT v2

Veamos cómo puedes conectar CTT con ShippyPro en solo unos pocos pasos.

Resumen

1. Antes de empezar
2. Configuración del transportista
3. Servicios compatibles
4. Opciones adicionales
5. Errores y Soluciónes

1. Antes de empezar

Para conectar el transportista, primero debes solicitar a tu representante de ventas de CTT las credenciales necesarias, tales como:

• Center code

• Client ID

• Client Secret

¿Ya tienes una conexión activa con CTT y quieres pasar a CTTv2?

Si ya dispones de credenciales de CTT y deseas crear una nueva conexión con la versión CTTv2, es necesario solicitar nuevas credenciales específicas para esta integración.

Las credenciales deben solicitarse escribiendo a: integracion@cttexpress.com

2. Configuración del transportista

Ahora puedes ir a la página de Transportistas y hacer clic en el logo de CTT v2.
Luego podrás completar los campos requeridos:

• Center code

• Client ID

• Client Secret

• Servicio

• Tipo de etiqueta

Si no sabes cómo hacerlo, intenta echar un vistazo al siguiente ejemplo:

3. Servicios compatibles

• C24: CTT 24

• C48: CTT 48

• C14E: CTT PREMIUM EMPRESAS

• C14: CTT 14

• C10: CTT 10

• CCA24: CTT CANARIAS AÉREO

• CCAE: CTT CANARIAS DOCUMENTACIÓN

• CCAM: CTT CANARIAS MARÍTIMO

• CBA24: CTT BALEARES EXPRESS

• CBA48: CTT BALEARES ECONOMY

• CIEX: CTT INTERNACIONAL EXPRESS

• CIES: CTT INTERNACIONAL ECONOMY

4. Opciones adicionales

Destinos:

• Nacional: ES/PT
• Internacional: Sí, pero la salida debe ser desde España

Características:

• Etiqueta PDF: Disponible
• Etiqueta ZPL: Disponible
• Etiqueta EPL: No disponible (Especificar dimensiones y orientación)
• Track & Trace: Disponible
• Sin papel (Paperless): No disponible
• PickUp/DropOff (PUDO): No disponible
• Pago contra reembolso (COD): Disponible
• Tarifas en tiempo real: No disponible
• Etiquetas de devolución: No disponible
• Etiquetas de devolución (en la caja): No disponible
• Reserva/programación de recogida: No disponible
• Verificación de dirección: No disponible
• Prueba de entrega (POD): No disponible
• Opciones en caso de no entrega: No disponible
• Seguro: Disponible
• Multipaquete: Disponible
• Eliminar envío (Anulación): Disponible
• Cierre de jornada: No disponible
• CN22: No disponible
• CN23: No disponible
• Validación de credenciales: Disponible

Además de tus credenciales, también verás algunas opciones adicionales, ¡vamos a verlas!

El Test mode te permite realizar algunos envíos de prueba.

La opción "Modo de Prueba" solo debe estar activada si tienes credenciales de prueba, ¡no de producción!

Si lo deseas, también puedes introducir una Etiqueta Personalizada para reconocer esta conexión entre las demás.

5. Errores y Soluciónes

Error interno del servidor

Verifica si tu conexión con CTT está en Test mode

Client error: `POST https://api.cttexpress.com/integrations/manifest/v1.0/shippings` resulted in a `401 Unauthorized` response:
{
"error": "Invalid token."
}

Comprueba que tus credenciales son correctas.

¿Es posible usar ShippyPro para CTT con recogidas y devoluciones en Portugal?

La integración de CTT disponible en ShippyPro está basada en el endpoint español (CTT Express Spain), que es un proveedor distinto de CTT Portugal y cuenta con sus propios endpoints, credenciales y servicios. Por este motivo, actualmente no es posible conectar a ShippyPro un contrato directo con CTT Portugal.

Además, los servicios de recogida y devoluciones no están disponibles por el momento en la integración de CTT, independientemente del país. Todos los servicios visibles en la plataforma están basados en España y se aplican a envíos nacionales y a determinados destinos internacionales.

`POST https://api.cttexpress.com/integrations/oauth2/token` resulted in a `403 Forbidden` response: {"error": {"error_code": 403,"error_date_time": "2026-07-31T06:17:50.561+00:00","error_type": "FORBIDDEN

Si aparece este mensaje de error, verifica las credenciales con tu representante de CTT y solicita unas nuevas si es necesario.