Cambiar de estado una ruta

Puede utilizar este endpoint para cambiar el estado de todas las entregas de una ruta.

Actualiza el estado de una ruta

Actualiza el estado de una ruta, incluyendo todas sus entregas.

patch

/v1/routes/{id}/status

Authorizations

Path parameters

idstringrequired

Identificador de la ruta a cambiar de estado.

Body

commentstringrequired

Comentario del cambio

Example: Zona peligrosa

statusstring · enumrequired

Nuevo estado de la ruta

Example: hold_by_courier

Options: pending_to_review, processing, broadcasting, assigned, confirmed_to_pickup, going_to_pickup, at_pickup, on_delivery, going_to_dropoff, at_dropoff, dropped_off, completed, canceled, going_to_return, at_return_point, returned, not_picked_up, not_picked_up_payable, hold_by_courier

authorobject

Información del usuario que esta realizando el cambio de estado

reasonByCompanyobject[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://api.shippify.co/v1/routes/{id}/status' \
  --header 'Authorization: Basic username:password' \
  --header 'Content-Type: application/json' \
  --data '{
    "comment": "Zona peligrosa",
    "status": "hold_by_courier",
    "author": {
      "id": 1149,
      "name": "Developers",
      "email": "[e-mail]",
      "type": "operator"
    },
    "reasonByCompany": [
      {
        "reasonId": 67,
        "reason": "ZONA PELIGROSA"
      }
    ]
  }'

200

401

200

{
  "code": "OK",
  "message": "Success"
}

Successful operation

Casos de uso

Cancelar ruta

{
    "status": "canceled",
    "comment": "",
    "author": {
        "type": "operator",
        "id": 1149,
        "name": "Developers",
        "email": "[e-mail]"
    }
}

Completar ruta

{
    "status": "completed",
    "comment": "",
    "author": {
        "type": "operator",
        "id": 1149,
        "name": "Developers",
        "email": "[e-mail]"
    }
}