Cambiar estados de entrega

Puedes utilizar este endpoint para cambiar el estado a una entrega, aqui puedes añadir comentarios o agregar razones de problemas creados anteriormente en el sistema. Para conoces mas de los estados de Shippify, entre aqui.

Actualiza el estado de una entrega

patch

Actualiza el estado de una entrega ya sea por el id de entrega o referencia.

Authorizations

Path parameters

idstringrequired

Identificador o Id de referencia de la entrega a cambiar de estado.

Body

statusstring · enumrequired

Nuevo estado de la ruta

Example: hold_by_courier

Available options:

commentstringrequired

Comentario del cambio

Example: Zona peligrosa

reasonByCompanyobject[]optional

Razones predefinidas del cambio de estado

authorobjectoptional

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

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

200

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

Successful operation

Casos de uso

Cambio de estado por referenceId

Puedes utilizar el reference id de la entrega en la url de la petición para cambiar su estado.

Cancelar entrega

{
    "status": "canceled",
    "comment": "TEST",
    "author": {
        "email": "[e-mail]",
        "id": 999,
        "name": "Test operator",
        "type": "operator"
    }
}

Cambiar estado a resguardo del conductor con motivo de problema

{
    "status": "hold_by_courier",
    "comment": "Sur de la ciudad",
    "reasonByCompany": [
        {
            "companyId": "9065",
            "reasonId": 67,
            "reason": "ZONA PELIGROSA"
        }
    ],
    "author": {
        "type": "operator",
        "id": 1149,
        "name": "Developers",
        "email": "[e-mail]"
    }
}

Completar entrega

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