Rastreamento
Leia o status e os pontos de controle de um envio, e confirme uma entrega.
Rastrear um envio
Envie o número de rastreamento da WeShipYou (WSY…), que fica em label.trackingNumber depois que a etiqueta é comprada. A resposta tem o status atual, o carrierName e os checkpoints. Como dono do envio você também recebe os detalhes (endereços, itens, locais), que ficam ocultos para os outros.
curl https://sandbox.weshipyou.com/api/v1/tracking/WSY0000000000US \
-H "Authorization: Bearer $WSY_ACCESS_TOKEN"O rastreamento precisa de um token de acesso. Consulte no máximo algumas vezes por hora por envio: os pontos de controle vêm das transportadoras e não mudam mais rápido que isso.
Estados do envio
O state de um envio vai de created, passando por label_created, até delivered, ou até cancelled. Leia o próprio envio para saber o state; leia o rastreamento para os pontos de controle da transportadora.
Confirmar uma entrega
O destinatário pode registrar que um envio chegou. Não precisa de token: o número de rastreamento e o número da conta identificam o envio. Um envio que já está delivered sempre pode ser confirmado. Um envio in_transit só pode ser confirmado quando está atrasado (a etiqueta foi comprada há pelo menos 30 dias e, se ele tem uma data prometida de entrega, passaram pelo menos 15 dias desde essa data) e não chegou à WeShipYou no destino. Quando o pacote já está com a WeShipYou em Cuba (retirado no aeroporto ou no porto, em uma viagem de trânsito ou em uma rota de entrega), só a WeShipYou o marca como entregue. Uma recusa é um 400 com data.code: delivery-confirmation-at-destination, ou delivery-confirmation-too-early com data.availableFrom.