4-Cambio de estado y ciclo de vida de un shipping

Modificado el Mar, 25 Abr, 2023 a 9:03 A. M.

Los únicos cambios de estado permitidos son :

Estado READY (a) lo que significa que el paquete está listo para que se realice el pickup, estado CANCELED (b) para cancelar un envío que todavía no pasó una hora o no se preparó, o estado TOBERETURNED (c) en ocasiones que ya hace más de una hora que fue el pedido, o el repartidor ya tiene el paquete y lo va a entregar, en el caso de que este esté mal o necesiten recuperar el paquete, se puede hacer con este estado que lo cancela y regresa el paquete al depósito con el mismo Moover.

a) Cambio a READY

Response

{
  "status": "READY",
  "shipping_id": "bf7ef9f0-6165-11ea-a9a8-c5eab9a8e071",                                          
  "updated_at": "2020-03-08 23:47:19",
  "created_at": "2020-03-08 23:47:19",
  "id": 8267
}

Curl example

curl -X POST "https://api-dev.moova.io/b2b/shippings/bf7ef9f0-6165-11ea-a9a8-c5eab9a8e071/READY?appId=999a9999-9999-aaaa-aa9a-99aaaa9a9999" -H "accept:   application/json" -H "Authorization: aa9999999a9999999aaa9aaaa9999a999aa9aa9a"

Request URL

https://api-dev.moova.io/b2b/shippings/bf7ef9f0-6165-11ea-a9a8-c5eab9a8e071/READY?appId=999a9999-9999-aaaa-aa9a-99aaa99a9999

O bien con el URL, Ej: https://api-dev.moova.io/b2b/shippings/{ID Shipping}/READY?appId={appId}

b) Cambio a CANCEL.

Response

{
  "status": "CANCELED",
  "details": {
    "reason": "Creado por error"
  }, 
  "shipping_id": "bf7ef9f0-6165-11ea-a9a8-c5eab9a8e071",                                      
  "updated_at": "2020-03-08 23:55:36",
  "created_at": "2020-03-08 23:55:36",
  "id": 8268
}

Curl

curl --location 'https://api-dev.moova.io/b2b/shippings/b4470a80-e073-11ed-b343-676e8816ee3a/CANCELED?appId={appId}' \

--header 'Authorization: {Authorization}' \

--header 'Content-Type: application/json' \

--data '{

   "reason":"reason why youa re canceling",

   "details":{

      "reason":"reason duplicagted of cancelation"

   }

}'

c) Cambio a TOBERETURNED.

Response

{
  "status": "TOBERETURNED",
  "details": {
    "reason": "Posible estafa, falta controlar factura"
  }, 
  "shipping_id": "bf7ef9f0-6165-11ea-a9a8-c5eab9a8e071",                                        
  "updated_at": "2020-03-08 23:55:36",
  "created_at": "2020-03-08 23:55:36",
  "id": 8268
}

Curl

curl --location 'https://api-dev.moova.io/b2b/shippings/73c51ae0-e074-11ed-b177-af1dda4b7e24/TOBERETURNED?appId={apiId}' \
--header 'Authorization: {Authorization}' \
--header 'Content-Type: application/json' \
--data '{
   "reason":"reason why youa re canceling",
   "details":{
      "reason":"reason duplicagted of cancelation"
   }
}'

URL base para el entorno de prueba: https://api-dev.moova.io/b2b

URL base para el entorno de Producción: https://api-prod.moova.io/b2b

En el caso de tener alguna duda sobre el estado de vida de un envío puede revisar la siguiente documentación.