CRUD Transportes

• https://preservices.ictower.net/eTransports

Autenticación

La autenticación será por apikey que deberá ser solicitada por correo a la cuenta de support.act@altialogistic.com

---

Este servicio se utilizará para gestionar la creación y edición de cualquier tipo de transportes en Control Tower. Será necesario que la estructura de los datos tenga el formato que se indica a continuación.

Los métodos que contendrá este webservice serán los siguientes:

• Alta transporte: Permitirá crear la planificación de un transporte en CT.
• Modificar transporte: Permitirá asignar matrículas cambiar datos de un transporte.
• Baja transporte: Permitirá cancelar transportes (Siguiendo las mismas reglas que en la web).

Descripción de campos

info

Cuando se da de alta un nuevo transporte, será obligatorio utilizar el identificador interno del transportista. En el resto de los casos, se pueden utilizar tanto el interno del transportista como el id de CT.

Campo	Descripción
courierId	Identificador externo del transportista.
externalTransportId	Identificador externo del transporte.
serviceType	Identificador del tipo de servicio. Valores de serviceType: 0: Normal 1: Express (Doble conductor) 2: UltraExpress (Tres conductores)
businessType	Modo o naturaleza del transporte. Es obligatorio ajustarse a los valores numéricos. Valores de businessType: 1: Importación 2: Exportación 4: E-Commerce 8: Obras 16: Devoluciones 32: Fábricas 64: Plancha Aérea
transportType	Tipo del medio en el que se origina este transporte. Valores de transportType: 0: Terrestre 1: Ferrocarril 2: Marítimo 3: Aéreo
transportObservation	Comentarios del transportista asociados al transporte.
transportBilling	Referencia del cliente.
operationType	Operación a realizar. Los valores de este campo pueden ser los siguientes: Valores de operationType: 1: Alta 2: Modificación 3: Baja
Cancelación de un transporte	Este apartado solo es necesario cuando el tipo de operación es baja (3).
Reason	Motivo de la baja del transporte.
idTrailerType	Identificador del tipo de camión que realizará el transporte. Valores de idTrailerType: 0: Ninguno 1: Furgoneta 2: Lona 3: Lona rodillos 4: Prenda colgada 5: Cualquiera 6: Marítimo 7: Doble piso 8: Minitir 9: Box rodillos 10: RoadTrain 11: Gigatráiler 12: Gigatráiler rodillos 13: Box 14: Dúo tráiler terrestre 15: Dúo tráiler aéreo
truckLicensePlate	Matrícula de la tractora que realizará el transporte.
trailerLicensePlate	Matrícula del remolque que realizará el transporte.
containerLicensePlate	Lista de matrículas de contenedores.
phoneNumber	Número de contacto asociado al transporte.
RUTA DEL TRANSPORTE	Indica los puntos que componen la ruta. La ruta se formará en el orden de esta y siempre se enviarán todos los puntos de la misma.
warehouseId	Identificador externo asociado a la ubicación.
ETA	Reflejará, en caso de disponer de dicha información, la fecha-hora solicitada de llegada a la ubicación.
ETD	Reflejará, en caso de disponer de dicha información, fecha-hora solicitada de salida de la ubicación.
activityType	En CT, solo se admiten tres tipos de actividad: Valores de activityType: 0: Carga 1: Descarga 2: Carga y descarga
ETACarrier	Fecha/hora inicio estimada para la actividad por parte del transportista.
ETDCarrier	Fecha/hora fin estimada para la actividad por parte del transportista.
Seal	Se añade si se dispone de la información.
dockReference	Muelle del almacén en el que se realizará la actividad.

info

Las matrículas activas (Tractora, Trailer y Container) se introducirán a nivel de datos del camión y no son obligatorias para la creación del transporte.

Ejemplo de REQUEST

{
    "*client": "CLIENTE@ictower.net",
    "transports": [
        {
            "*externalTransportId": 302,
            "*operationData": {
                "*operationType": 1,
                "*operationDateUTC": "2023-11-06T09:20:45.992Z",
                “reason”: “transporte duplicado”
            },
            “*courierId”: 1111,
            "*serviceType": "2",
            "*businessType": "2",
            "*transportType": "3",
            "transportObservation": "Prueba Servicio Creacion transporte",
            "transportBilling": "CLIENTE",
            "truckData": {
                "idTrailerType": "4",
                "containerLicensePlate": "SDFDFD",
                "truckLicensePlate": "SDFDFD",
                "trailerLicensePlate": "SDFDFD",
                "phoneNumber": "981 121212"
            },
            "aditionalClientData": [
                {
                    "key": "CAMPO",
                    "value": "VALOR"
                }
            ],
            "stops": [
                {
                    "*activityType": "0",                   
                    "*warehouseId": "30",
                    "*ETA": "2021-08-17T14:00:00.000Z",
                    "*ETD": "2021-08-17T14:30:00.000Z",
                    "ETACarrier": "2021-08-17T14:00:00.000Z",
                    "ETDCarrier": "2021-08-17T14:30:00.000Z",               
                    "dockReference": "2",
                    "seal": "dd"
                }           ]
        }
    ]
}

NOTA: Los campos marcados con * son obligatorios.

info

El elemento aditionalClientData permitirá añadir campos personalizados por cliente. Este elemento no es obligatorio, actualmente el campo “key” puede tomar los valores CLIENT, REFERENCE1 Y REFERENCE2.

Response

CÓDIGO	DESCRIPCIÓN
200	OK
400	Bad Request. Error de validación en la entrada de datos
401	Unauthorized
403	Forbidden
404	Not Found. Recurso no encontrado
405	Method not Allowed
500	Internal Server Error. Contactar con Altia

---

info

Además, el método devolverá el id del transporte creado en caso de que la respuesta sea 200.

CAMPO	TIPO DE DATO	DESCRIPCIÓN
TrId	int	Identificador interno del transporte

Endpoint

ENTORNO DE PRE-PRODUCCIÓN (Pruebas)

https://preservices.ictower.net/etransports

Ejemplo en SOAP UI de una llamada.

Descargar