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.

Autorizaciones

Parámetros de ruta

idstringRequerido

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

Cuerpo

statusstring · enumRequerido

Nuevo estado de la ruta

Example: hold_by_courierValores posibles:

commentstringRequerido

Comentario del cambio

Example: Zona peligrosa

Respuestas

200

Successful operation

application/json

401

Unauthorized

application/json

patch

HTTPcURLJavaScriptPython

PATCH /v1/deliveries/{id}/status HTTP/1.1
Host: api.shippify.co
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 209

{
  "status": "hold_by_courier",
  "comment": "Zona peligrosa",
  "reasonByCompany": [
    {
      "reasonId": 67,
      "reason": "ZONA PELIGROSA"
    }
  ],
  "author": {
    "type": "operator",
    "id": 1149,
    "name": "Developers",
    "email": "[e-mail]"
  }
}

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

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]"
    }
}