🛠️ 4 - Actualizar un shipping

🔄 Cambios de Estado Permitidos

En Moova, los únicos cambios de estado permitidos para un envío son:

READY: Indica que el paquete está listo para que se realice el pickup.
CANCELED: Para cancelar un envío que todavía no pasó una hora o no se preparó.
TOBERETURNED: Si ya pasó más de una hora desde que se creó el pedido o el repartidor ya tiene el paquete y se necesita recuperar, se puede usar este estado para cancelarlo y que el paquete regrese al depósito con el mismo Moover.

Ejemplos de Cambios de Estado

Cambio a READY

curl -X POST "https://api-dev.moova.io/b2b/shippings/{Shipping ID}/READY?appId={appId}" \ -H "accept: application/json" \ -H "Authorization: {Authorization Token}"

Cambio a CANCELED

curl --location 'https://api-dev.moova.io/b2b/shippings/{Shipping ID}/CANCELED?appId={appId}' \ --header 'Authorization: {Authorization Token}' \ --header 'Content-Type: application/json' \ --data '{ "reason": "Creado por error", "details": { "reason": "Duplicado" } }'

Cambio a TOBERETURNED

curl --location 'https://api-dev.moova.io/b2b/shippings/{Shipping ID}/TOBERETURNED?appId={appId}' \ --header 'Authorization: {Authorization Token}' \ --header 'Content-Type: application/json' \ --data '{ "reason": "Posible estafa", "details": { "reason": "Falta controlar factura" } }'

Nota: Reemplaza {Shipping ID}, {appId} y {Authorization Token} con los valores correspondientes.

✏️ Actualizar un Shipping

Para actualizar un envío existente, puedes utilizar el método PUT en la siguiente URL:

https://api-dev.moova.io/b2b/shippings/{Shipping ID}?appId={appId}

Parámetros

appId: Tu identificador de aplicación.
Shipping ID: El identificador único del envío que deseas actualizar.

Cuerpo de la Solicitud (Body)

Puedes actualizar todos los campos que se enviaron al momento de la creación del envío. Si realizas un cambio en alguna de las direcciones, el envío se volverá a cotizar según las nuevas distancias.

{
   "scheduledDate":"2021-02-20 15:00:00",
   "currency":"ARS",
   "type":"minutes_90",
   "flow":"automatic",
   "from":{
      "googlePlaceId":"ChIJYVOqvJrKvJURbO0qQqXC8MA",
      "floor":"6to",
      "apartment":"C",
      "instructions":"No funciona el timbre. Llamar antes",
      "contact":{
         "firstName":"Juan",
         "lastName":"Perez",
         "email":"",
         "phone":"+54 11 8786 1232"
      },
      "message":""
   },
   "to":{
      "googlePlaceId":null,
      "street":"Avenida Córdoba",
      "number":"1500",
      "floor":"3to",
      "apartment":"F",
      "city":"CABA",
      "state":"CABA",
      "postalCode":"1055",
      "country":"AR",
      "instructions":"Entregar al Portero. Almuerza a la 1",
      "contact":{
         "firstName":"Juan",
         "lastName":"Perez",
         "email":"[email protected]",
         "phone":"+54 11 6765 8765"
      },
      "message":""
   },
   "internalCode":"X23454",
   "description":"string",
   "label":"string",
   "extra":{
      
   },
   "settings":[
      1,
      2
   ],
   "conf":{
      "assurance":false,
      "items":[
         {
            "item":{
               "description":"iPhone",
               "price":150,
               "weight":2000,
               "length":20,
               "width":20,
               "height":20
            }
         }
      ]
   }
}

Ejemplo en cURL

curl -X PUT "https://api-dev.moova.io/b2b/shippings/{Shipping ID}?appId={appId}" \ -H "accept: application/json" \ -H "Authorization: {Authorization Token}" \ -H "Content-Type: application/json" \ -d '{ ... }'

Nota: Reemplaza {Shipping ID}, {appId}, {Authorization Token} y el cuerpo de la solicitud con los valores correspondientes.

📌 Consideraciones Importantes

Re-cotización: Si modificas las direcciones de origen o destino, el envío se volverá a cotizar automáticamente según las nuevas distancias.
Estados del Envío: Solo puedes cambiar el estado de un envío a READY, CANCELED o TOBERETURNED mediante la API.
Autenticación: Asegúrate de incluir el token de autorización en la cabecera de la solicitud para autenticarte correctamente.