Nivel de servicio y parámetros para gestionar el shipment
Cada integración tiene parámetros adicionales asociados al nivel de servicio, así como utilizados para la gestión del shipment por parte del shipper.
Para el caso particular del nivel de servicio se tienen dos fechas. El campo de shipperDropoffDate indica la fecha aproximada en que el paquete será entregado en el centro de distribución de última milla de Cargamos. El campo de expectedDeliveryDate hace alusión a la promesa de entrega, es decir, en qué fecha se espera que Cargamos entregue el paquete al destinatario final.
Si las fechas se acogen a los parámetros, pero al momento de hacer la entrega la misma se hace fuera del tiempo estipulado, esto conlleva a otros flujos logísticos que deben de acordarse con el departamento comercial.
Para el caso de información de gestión, se permite suministrar un Id de lote (lotId), opcional, que sugiere que los paquetes que tengan el mismo valor de lotId arribarán juntos (mas no consolidados) al centro de distribución de última milla de Cargamos. No es necesario proveer un lotId, pero si es posible generarlo y aplica, ayuda a optimizar los tiempos de entrega. Adicionalmente, se tiene el campo shipmentTrackingId en el que el shipper indica cuál es el valor que será escaneado en la etiqueta del paquete una vez el mismo es entregado en el centro de distribución de última milla de Cargamos. En otras palabras, el valor registrado en el código de barras de la etiqueta (i.e. codificado en QR code o code128). Este valor es opcional, en caso de no ser suministrado se asume que el shipper utilizará (colocará una etiqueta con) el valor de trackingId proporcionado en la respuesta de la integración.
Es importante que el paquete tenga un código de barras escaneable (i.e. QR code o code128 son soportados en este momento). Este código de barras escaneable DEBE de coincidir con el shipmentTrackingId si fue proporcionado al momento de la integración, o con el trackingId generado por Cargamos en la respuesta de la integración. Si no se tiene una etiqueta con un código de barras con cualquiera de estos dos valores, NO ES POSIBLE REALIZAR LA ENTREGA DEL PAQUETE.
Campos
| Campo | Tipo de dato | Requerido | Default |
|---|---|---|---|
| shipperDropoffDate | String | No | Fecha de integración + 24hrs |
| expectedDeliveryDate | String | No | Fecha de integración + 24hrs |
- Cadena de texto que representa un timestamp en
ISO 8601-1:2019expresado en tiempo universal coordinadoUTC
shipperDropoffDate
Fecha en la cual se espera entregar el paquete (la custodia) en el centro de distribución de última milla de Cargamos. Se debe acoger a ISO 8601-1:2019 expresado en tiempo universal coordinado UTC.
Ejemplos:
2023-06-10T16:18:05Z
El estándar ISO 8601-1:2019 expresado en tiempo universal coordinado UTC no hace uso de zonas horarias sino que expresa cualquier tiempo en horario Greenwich o Zulu. La cadena de texto termina en una ‘Z’.
expectedDeliveryDate
Fecha/hora en la cual se desea se realice la entrega al destinatario final. La precisión de la misma depende de parámetros firmados en el contrato de nivel de servicio con Cargamos. Se debe acoger a ISO 8601-1:2019 expresado en tiempo universal coordinado UTC.
Ejemplos:
2023-06-10T16:18:05Z
El estándar ISO 8601-1:2019 expresado en tiempo universal coordinado UTC no hace uso de zonas horarias sino que expresa cualquier tiempo en horario Greenwich o Zulu. La cadena de texto termina en una ‘Z’.
Tabla. Campos para gestión del shipment proporcionados por el shipper
| Campo | Tipo de dato | Requerido | Default |
|---|---|---|---|
| lotId | String | NO | |
| shipperTrackingId | String | NO |
lotId
Valor agrupador que indica que los paquetes arribarán al centro de distribución de última milla de Cargamos juntos. Este no es un indicador de consolidación. Si se tienen varios paquetes consolidados, para efectos prácticos estos paquetes son un único paquete. Este campo sugiere que arribará un solo vehículo con X cantidad de paquetes al mismo tiempo. Todos estos paquetes idealmente tendrían el mismo lotId. Este campo es opcional y facilita la optimización. No afecta el cumplimiento del nivel de servicio pactado.
Ejemplos:
1
shipperTrackingId
Como se mencionó anteriormente en esta subsección, este es un identificador escaneable, es decir, se encuentra impreso en una etiqueta estampada en el paquete. Un Id escaneable alterno al trackingId; es el de Cargamos (trackingId) si le resulta conveniente. Sin embargo, es necesario tener en cuenta que SIEMPRE DEBE DE HABER UNA ETIQUETA YA SEA CON EL SHIPPERTRACKINGID O EL TRACKINGID.
Ejemplos:
MYID0001
Si el shipper ya tiene una etiqueta en el paquete y no desea imprimir una etiqueta adicional, este campo siempre debería de ser suministrado.