Rastreo
Lee el estado y los puntos de control de un envío, y confirma una entrega.
Rastrear un envío
Envía el número de rastreo de WeShipYou (WSY…), que encuentras en label.trackingNumber cuando la etiqueta está comprada. La respuesta tiene el status actual, el carrierName y los checkpoints. Como dueño del envío también recibes sus detalles (direcciones, artículos, ubicaciones), que se ocultan a los demás.
curl https://sandbox.weshipyou.com/api/v1/tracking/WSY0000000000US \
-H "Authorization: Bearer $WSY_ACCESS_TOKEN"El rastreo necesita un token de acceso. Consúltalo como mucho unas pocas veces por hora por envío: los puntos de control vienen de los transportistas y no cambian más rápido que eso.
Estados del envío
El state de un envío va de created, pasando por label_created, hasta delivered, o hasta cancelled. Lee el propio envío para conocer su state; lee el rastreo para los puntos de control del transportista.
Confirmar una entrega
El destinatario puede registrar que un envío llegó. No hace falta token: el número de rastreo y el número de cuenta identifican el envío. Un envío que ya está delivered siempre se puede confirmar. Un envío in_transit solo se puede confirmar cuando está atrasado (su etiqueta se compró hace al menos 30 días y, si tiene una fecha prometida de entrega, pasaron al menos 15 días desde esa fecha) y no ha llegado a WeShipYou en destino. Cuando el paquete ya está con WeShipYou en Cuba (recogido en el aeropuerto o el puerto, en un viaje de tránsito o en una ruta de entrega), solo WeShipYou lo marca como entregado. Un rechazo es un 400 con data.code: delivery-confirmation-at-destination, o delivery-confirmation-too-early con data.availableFrom.