Alterar estados de entrega

Você pode utilizar este endpoint para alterar o status de uma entrega, aqui você pode adicionar comentários ou incluir razões para problemas criados anteriormente no sistema. Para saber mais sobre os status do Shippify entre aqui.

Atualiza o estado de uma entrega

patch

Atualiza o estado de uma entrega seja pelo id da entrega ou id de referência.

Autorizaciones

Parámetros de ruta

idstringRequerido

Identificador do Id de referência da entrega a mudar de estado.

Cuerpo

statusstring · enumRequerido

Novo estado da rota.

Example: hold_by_courierValores posibles:

commentstringRequerido

Comentário da alteração

Example: Zona de perigo.

Respuestas

200

Operação bem sucedida

application/json

401

Não autorizado

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: 211

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

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

Casos de uso

Alteração de estado por referenceId

Utilize o referenceid da entrega na url da petição para alterar o estado.

Cancelar entrega

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

Alterar estado à em posse do motorista baseado nos motivos e problemas

{
    "status": "hold_by_courier",
    "comment": "Sul da cidade",
    "reasonByCompany": [
        {
            "companyId": "9065",
            "reasonId": 67,
            "reason": "ZONA DE PERIGO"
        }
    ],
    "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]"
    }
}