Criação de entregas
Nesta seção vamos aprender a criar sua primeira entrega na Shippify.
Com este endpoint, você poderá criar até um máximo de 100 entregas por request e 100 requests por minuto.
Casos de uso
Criando entregas com referenceID
Esse é o payload mais básico que você pode usar na API, mas é provável que a tarefa seja criada com o estado "pendente de revisão" se o endereço não puder ser geolocalizado
{
"deliveries": [
{
"pickup": {
"contact": {
"phonenumber": "0976565643",
"email": "test@test.com",
"name": "Iliana Bolaños"
},
"location": {
"address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
"instructions": "Apartamento 203"
}
},
"dropoff": {
"contact": {
"name": "Estefanía Fajardo",
"email": "test-1998@hotmail.com"
},
"location": {
"address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
"instructions": "Local 890"
}
},
"packages": [
{
"name": "Caja de colores",
"qty": 1,
"size": 1
}
],
"referenceId": "FACT-000123"
}
]
}Criando uma entrega com endereço e com latitude e longitude
Com esse payload, você poderá criar entregas com pontos de coleta e entrega precisos, garantindo que a tarefa sempre seja criada com o estado "processando".
{
"deliveries": [
{
"pickup": {
"contact": {
"name": "Emilio Benavides",
"phonenumber": "12345"
},
"location": {
"address": "Av. Echeñique 8861, 7860169 La Reina, Región Metropolitana, Chile",
"lat": "-33.44299381045172",
"lng": "-70.53898694556675"
}
},
"dropoff": {
"contact": {
"name": "MAYGER RENE MONTERO SAAVEDRA",
"email": "mrmontero@shippify.cl",
"phonenumber": "777"
},
"location": {
"address": "Los Castaños 11989, 8010277 Santiago, El Bosque, Región Metropolitana, Chile",
"lat": "-33.56751",
"lng": "-70.67549"
}
},
"packages": [
{
"name": "149123156552",
"size": "XS",
"qty": "1"
}
]
}
]
}Criando entregas com endereço por componentes
Com esse payload, você poderá criar entregas com um ponto de coleta ou entrega um pouco mais preciso e com menos probabilidades de ser criado como "pendente de revisão". Consiste em separar o endereço por país, cidade, rua e código postal.
{
"deliveries": [
{
"pickup": {
"contact": {
"name": "Emilio Benavides",
"phonenumber": "12345"
},
"location": {
"address": "R. Dona Claudina, 401 - Méier, Rio de Janeiro - RJ, 20725-060, Brasil",
"lat": -22.906846699999996,
"lng": -43.28275978125001
}
},
"dropoff": {
"contact": {
"name": "MAYGER RENE MONTERO SAAVEDRA",
"email": "mrmontero@shippify.cl",
"phonenumber": "777"
},
"location": {
"address": {
"zipcode": "60348450",
"neighborhood": "VILA VELHA",
"streetName": "RUA 24,656",
"state": "CE",
"country": "Brazil",
"city": "FORTALEZA"
},
"instructions": "CONJ DOS BANCARIOS - REF.ENDERECO: PROX A UPA"
}
},
"packages": [
{
"name": "149123156552",
"size": "XS",
"qty": "1"
}
]
}
]
}Criando entrega com um galpão já configurado
Com esse payload, você poderá criar entregas com um ponto de coleta salvo anteriormente na seção de galpões/depósito.
{
"deliveries": [
{
"pickup": {
"contact": {
"name": "Emilio Benavides",
"phonenumber": "12345"
},
"location": {
"warehouse": 9
}
},
"dropoff": {
"contact": {
"name": "MAYGER RENE MONTERO SAAVEDRA",
"email": "mrmontero@shippify.cl",
"phonenumber": "777"
},
"location": {
"address": {
"zipcode": "60348450",
"neighborhood": "VILA VELHA",
"streetName": "RUA 24,656",
"state": "CE",
"country": "Brasil",
"city": "FORTALEZA"
},
"instructions": "CONJ DOS BANCARIOS - REF.ENDERECO: PROX A UPA"
}
},
"packages": [
{
"name": "149123156552",
"size": "XS",
"qty": "1"
}
]
}
]
}Criando entregas com tags e extradata
Com essas etiquetas digitais, você pode adicionar características adicionais à tarefa para depois poder filtrá-las, por exemplo: frágil.
Com os dados extras, você pode vincular informações adicionais à entrega.
{
"deliveries": [
{
"pickup": {
"contact": {
"phonenumber": "0976565643",
"email": "test@test.com",
"name": "Iliana Bolaños"
},
"location": {
"address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
"instructions": "Apartamento 203"
}
},
"dropoff": {
"contact": {
"name": "Estefanía Fajardo",
"email": "test-1998@hotmail.com"
},
"location": {
"address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
"instructions": "Local 890"
}
},
"packages": [
{
"name": "Caixa de lapís",
"qty": 1,
"size": 1
}
],
"tags" : [
"fragil"
],
"extraData": [
{
"name": "GUIA DE REMISION",
"value": "0001-000344-2233",
"searchable": true
}
],
"referenceId": "FACT-000123"
}
]
}Criando entrega para uma empresa filha
Com esse payload, você pode criar entregas para uma empresa filha com a autorização da empresa matriz.
{
"deliveries": [
{
"pickup": {
"contact": {
"phonenumber": "0976565643",
"email": "test@test.com",
"name": "Iliana Bolaños"
},
"location": {
"address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
"instructions": "Apartamento 203"
}
},
"dropoff": {
"contact": {
"name": "Estefanía Fajardo",
"email": "test-1998@hotmail.com"
},
"location": {
"address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
"instructions": "Local 890"
}
},
"packages": [
{
"name": "Caixa de lapís",
"qty": 1,
"size": 1
}
],
"referenceId": "FACT-000123"
}
]
}Última actualización