Modificar entrega

Endpoint para atualizar dados da entrega, isso inclui o endereço e as informações de contato do ponto de entrega, assim como também propriedades como pacotes, etiquetas, pacotes, cod, identificador de referência, entre outros.

Editar dados da entrega

Endpoint que permite editar os dados de uma ou várias entregas.

PATCHhttps://api.shippify.co/v1/deliveries/dropoff

Authorization

Basic_Auth

Body

application/json

Aqui vai a descrição.

deliveryIds*array of string

Lista dos identificadores das entregas que vão ser editadas (é possível editar em um mesmo request até 10 entregas).

referenceIdsarray of string

Lista dos ids de referência dos pedidos que vão ser editados (é possível editar em um mesmo request até 10 entregas). Se colocae esta propiedade, não colocar deliveryIds.

deliveryChanges*object

Mudanças a serem feitas na tarefa.

recalculatePricebool

Indica se vai recalcular o preço após as alterações (reomendável).

Example: true

reorderRoutebool

Indica se vai reorndenar a rota (caso a entrega pertença a uma rota) após as alterações (recomendável).

Example: true

recalculateCitybool

Indica se vai recalcular a cidade após as alterações (recomendável).

Example: true

Response

200401

Operação bem sucedida

Body

application/json

codestring

Example: "OK"

messagestring

Example: "Sucesso"

dataobject

Informações dos processos adicionais criados (caso a entrega pertença a uma rota).

Request

JavaScriptCurlPython

const response = await fetch('https://api.shippify.co/v1/deliveries/dropoff', {
    method: 'PATCH',
    headers: {
      "Authorization": "basic <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "deliveryIds": [
        "t-pruaas-4973"
      ],
      "deliveryChanges": {}
    }),
});
const data = await response.json();

Response

200401

{
  "code": "OK",
  "message": "Sucesso",
  "data": {
    "jobs": "JOB-1234"
  }
}

Casos de uso

Modificar entrega por deliveryId

{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "reorderRoute": true,
    "recalculatePrice": true,
    "recalculateCity": false,
    "deliveryChanges": {
        "location": {
            "address": "av. echeñique 8861, 7860169 la reina, región metropolitana, chile",
            "instructions": "CLIENTE RETIRA PRODUTOS NO POLICENTRO 2",
            "lat": -23.557166,
            "lng": -46.664559
        },
        "contact": {
            "name": "iliana",
            "email": "[e-mail]"
        },
        "packages": [
            {
                "id": "SSSTP002",
                "name": "XIAOMI REDMI 10S",
                "size": 2,
                "price": 0,
                "weight": 5,
                "qty": 1
            }
        ],
        "cod": 10,
        "referenceId": "0987837468",
        "addTags":[1003],
        "removeTags": [],
        "extraData": [{"name":"Billing", "value":"0000-123-334"}]
    }
}

Modificar entrega por referenceId

{
    "referenceIds": [
        "0987837468"
    ],
    "reorderRoute": true,
    "recalculatePrice": true,
    "recalculateCity": false,
    "deliveryChanges": {
        "location": {
            "address": "av. echeñique 8861, 7860169 la reina, región metropolitana, chile",
            "instructions": "CLIENTE RETIRA PRODUTOS NO POLICENTRO 2",
            "lat": -23.557166,
            "lng": -46.664559
        },
        "contact": {
            "name": "iliana",
            "email": "[e-mail]"
        },
        "packages": [
            {
                "id": "SSSTP002",
                "name": "XIAOMI REDMI 10S",
                "size": 2,
                "price": 0,
                "weight": 5,
                "qty": 1
            }
        ],
        "cod": 10,
        "referenceId": "0987837468",
        "addTags":[1003],
        "removeTags": [],
        "extraData": [{"name":"Billing", "value":"0000-123-334"}]
    }
}

Modificar dados do destinatário

{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "contact": {
            "name": "iliana",
            "email": "[e-mail]"
        }
    }
}

Modificar endereço de entrega

{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "location": {
            "address": "av. echeñique 8861, 7860169 la reina, región metropolitana, chile",
            "instructions": "CLIENTE RETIRA PRODUTOS NO POLICENTRO 2",
            "lat": -23.557166,
            "lng": -46.664559
        }
    }
}

Modificar etiquetas

{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "addTags":[1003],
        "removeTags": []
    }
}

Modificar referenceId

{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "referenceId": "0987837468"
    }
}

Modificar pacotes da entrega

{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
       "packages": [
            {
                "id": "SSSTP002",
                "name": "XIAOMI REDMI 10S",
                "size": 2,
                "price": 0,
                "weight": 5,
                "qty": 1
            }
        ]
    }
}