Alteração de estado da rota

Você pode usar este endpoint para alterar o estado de todas as entregas de uma rota.

Atualiza o estado de uma rota

patch

Atualiza o estado de uma rota, incluindo todas suas entregas.

Authorizations

Path parameters

idstringrequired

Identificador da rota a alterar o estado.

Body

statusstring · enumrequired

Novo estado da rota.

Example: hold_by_courierAvailable options:

commentstringrequired

Comentário da alteração

Example: Zona de perigo.

reasonByCompanyobject[]optional

Motivos predefinidos da alteração de estado.

authorobjectoptional

Informação do usuário que esta fazendo a alteração.

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 '{
    "status": "hold_by_courier",
    "comment": "Zona de perigo.",
    "reasonByCompany": [
      {
        "reasonId": 67,
        "reason": "ZONA  DE PERIGO"
      }
    ],
    "author": {
      "type": "operador",
      "id": 1149,
      "name": "Developers",
      "email": "[e-mail]"
    }
  }'

200

401

200

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

Operação bem sucedida.

Casos de uso

Cancelar rota

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

Completar rota

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