Shipment
Un shipment es cómo se denomina en Cargamos al servicio de entrega de paquetes. Los shipments son solicitados por los shippers por medio de la “integración” de una órden. Al solicitar un shipment, es necesario proveer la siguiente información:
- Información de identificación del shipper: dependiendo del mecanismo utilizado para realizar la integración (i.e. API, SDK, hoja de cálculo, etc.), esta información suele ser suministrada de forma implícita (i.e. tokens de acceso, usuario logueado en la consola, etc.)
- Destinatario o recipient: se requiere la ubicación (dirección de entrega) y se requiere información básica de contacto que se utiliza en caso de que se presenten problemas a la hora de localizar dicha dirección. La ubicación, y en particular el campo de código postal, es utilizado para determinar si se tiene cobertura para realizar la entrega, es decir, si existe la red logística necesaria para entregar el paquete al destinatario en la ubicación indicada.
- Características del paquete: se requiere el peso y las dimensiones del paquete, y en caso de estar disponible, la información requerida para Carta Porte.
- Información asociada al nivel de servicio del shipment: incluye la fecha en la que se espera transferir la custodia del paquete al centro de distribución de última milla de Cargamos que fue designado, la fecha promesa de entrega, e identificadores adicionales (opcionales) asociados al paquete.
Ciclo de vida de un Shipment
El proceso de entrega de un paquete por parte de Cargamos puede ser descrito por medio de varias etapas. Dichas etapas pueden ser representadas en una máquina de estados finitos (FSM) por medio de estados. El shipper puede solicitar le sea notificado si la FSM cambio a un nuevo estado, y/o puede consultar el estado/estatus de su servicio de shipment. Para tal fin se debe de utilizar la API de webhooks y/o de shipment-tracking respectivamente, la cual es descrita en otras secciones de la presente documentación.
Fig. Estados y eventos que se presentan durante el servicio de shipment
En la figura, los estados con un borde grueso son estados finales. Una descripción de cada uno de estos estados puede observarse en la tabla.
| Estado | Descripción |
|---|---|
| CREATED | La orden es integrada después de completar las validaciones de cobertura y convertida en un shipment con un Id propio el cual sirve de identificador único y referencia para ser trackeado (al igual que el valor del Id de rastreo de shipper) |
| ARRIVAL SCAN | El paquete es recibido físicamente y escaneado en alguno de los centros de distribución operado con tecnología Cargamos |
| OUT FOR DELIVERY | El paquete es confirmado en una ruta para ser entregado en el transcurso del día |
| NEXT IN ROUTE | El paquete es el próximo a ser entregado y está en camino al punto de entrega |
| SHIPMENT AT LOCATION | El repartidor está en el punto de entrega esperando recepción del paquete |
| DELIVERY ATTEMPTED | Posterior a un intento de entrega, el paquete es escaneado y validada la entrega en alguno de los centros de distribución operado con tecnología Cargamos, |
| MISHAP | El paquete fue identificado como roto, perdido o robado y se prepara para ser retornado ya que no es operable |
| DELIVERED | El paquete ha sido entregado al destinatario |
| FLAGGED AS RETURNED | El paquete superó los intentos de entrega o bien no se pudo entregar y está en camino al centro de distribución para ser marcado como retornado al Shipper |
| RETURNED | El Shipper recibió el paquete en centro de distribución operado con tecnología Cargamos |
| CANCELLED | El shipment fue cancelado y la orden no será operada |
Fechas de cambio de custodia y entrega esperada
En relación a las fechas asociadas al nivel de servicio del shipment descritas anteriormente, estas corresponden a las siguientes etapas:
- Entrega del paquete en el centro de distribución de última milla de Cargamos: Esto debe de suceder aproximadamente en la fecha (día) que el shipper establece en el campo shipperDropoffDate.
Fig. Dropoff del paquete por parte del shipper en la red de centros de distribución de última milla
- Entrega del paquete al cliente final: Cargamos garantiza que se realizará el primer intento de entrega (idealmente exitoso), en la fecha (día) establecida por el shipper en el campo expectedDeliveryDate.
Fig. Entrega del paquete al cliente final
Nótese que para poder cumplir con la fecha promesa de entrega, el shipper debe de realizar el dropoff del paquete en el centro de distribución dentro del tiempo especificado en shipperDropoffDate, y el lapso de tiempo entre shipperDrooffDate y expectedDeliveryDate debe de ser acorde a los pactado en el contrato de servicio firmado con Cargamos.