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

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

PATCHhttps://api.shippify.co/v1/deliveries/{id}/status

Authorization

Basic_Auth

Path parameters

id*string

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

Body

application/json

Aqui vai a descrição

status*enum

Novo estado da rota.

Example: "hold_by_courier"

pending_to_reviewprocessingbroadcastingassignedconfirmed_to_pickupgoing_to_pickupat_pickupon_deliverygoing_to_dropoffat_dropoffdropped_offcompletedcanceledgoing_to_returnat_return_pointreturnednot_picked_upnot_picked_up_payablehold_by_courier

comment*string

Comentário da alteração

Example: "Zona de perigo."

reasonByCompanyarray of object

Motivos predefinidos da alteração de estado.

authorobject

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

Response

200401

Operação bem sucedida

Body

application/json

codestring

Example: "OK"

messagestring

Example: "Successo"

Request

JavaScriptCurlPython

const response = await fetch('https://api.shippify.co/v1/deliveries/{id}/status', {
    method: 'PATCH',
    headers: {
      "Authorization": "basic <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "status": "hold_by_courier",
      "comment": "Zona de perigo."
    }),
});
const data = await response.json();

Response

200401

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