Pontos de coleta
Este endpoint permite que o vendedor (seller) consulte os pontos de coleta disponíveis para expedição de etiquetas de envio.
O endpoint leva em consideração a transportadora/empresa escolhida pelo comprador e retorna uma lista de pontos de coleta disponíveis.
O vendedor poderá optar por permitir que a plataforma Eu Preciso escolha automaticamente o ponto de coleta mais próximo ao gerar a etiqueta de envio, com base em coordenadas de latitude e longitude. Portanto, este endpoint só deve ser usado caso o vendedor deseje escolher o ponto de entrega.
Escopo requerido
| Valor | Descrição |
|---|---|
order-delivery:read | Permite a leitura de entregas e dados relacionados. |
Parâmetros da URL
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
id | ObjectId | ID da entrega na plataforma. | Sim |
Paginação
A resposta contém uma chave meta com informações sobre a paginação, como o número máximo de registros por página (limit), o deslocamento atual (offset), o número total de registros (count) e o limite máximo de registros por página (max_limit).
A chave links contém URLs para as páginas anterior, próxima e atual, permitindo a navegação entre os registros.
Chamada:
GET /v1.0/marketplace/orders/deliveries/{id}/pickup_companies \
Host: apps.eupreciso.com.br \
Authorization: Bearer {access_token} \
Content-Type: application/json \Resposta:
{
"meta": {
"page": {
"limit": 50,
"offset": 0,
"count": 3,
"max_limit": 100
},
"links": {
"previous": null,
"next": null,
"self": "?_offset=0&_limit=50"
}
},
"results": [
{
"id": 18345,
"name": "[DROPIT] - MaxTools Ferramentas - Ponto de Coleta",
"initials": "SP",
"email": "[email protected]",
"type": "drop",
"note": "Horário de funcionamento: Seg à Sab - 08:00:00 às 20:00:00 - Aceita envios de: Correios, Azul Cargo, Total Express, Sequoia e Rapidex",
"distance": 0.78,
"address": {
"postal_code": "01234001",
"address": "Avenida Paulista",
"number": "1450",
"complement": "Loja 5",
"district": "Bela Vista",
"city": {
"city": "São Paulo",
"state": {
"state_abbr": "SP",
"state": "São Paulo"
}
},
"latitude": -23.564849,
"longitude": -46.652776
},
"phone": {
"phone": "11987654321"
},
"companies": [
{
"id": 3
},
{
"id": 7
},
{
"id": 9
},
{
"id": 18
}
],
"services": [
{
"id": 5
},
{
"id": 8
},
{
"id": 10
},
{
"id": 15
},
{
"id": 20
},
{
"id": 23
}
],
"term": 0,
"cost": 0,
"pudos_company": 3
},
{
"id": 18346,
"name": "[DROPIT] - FastMoto Courier - Ponto de Coleta",
"initials": "SP",
"email": "[email protected]",
"type": "drop",
"note": "Horário de funcionamento: Seg à Sex - 07:30:00 às 18:30:00 - Aceita envios de: Correios, Azul Cargo, Total Express, Sequoia e Rapidex",
"distance": 1.95,
"address": {
"postal_code": "01045000",
"address": "Rua Sete de Abril",
"number": "120",
"complement": "Sala 110",
"district": "República",
"city": {
"city": "São Paulo",
"state": {
"state_abbr": "SP",
"state": "São Paulo"
}
},
"latitude": -23.54779,
"longitude": -46.63611
},
"phone": {
"phone": "11998765432"
},
"companies": [
{
"id": 5
},
{
"id": 11
},
{
"id": 13
},
{
"id": 20
}
],
"services": [
{
"id": 6
},
{
"id": 11
},
{
"id": 12
},
{
"id": 17
},
{
"id": 21
},
{
"id": 25
}
],
"term": 0,
"cost": 0,
"pudos_company": 3
},
{
"id": 18347,
"name": "[DROPIT] - TechStore - Ponto de Coleta",
"initials": "SP",
"email": "[email protected]",
"type": "drop",
"note": "Horário de funcionamento: Seg à Sex - 09:00:00 às 19:00:00 - Aceita envios de: Correios, Azul Cargo, Total Express, Sequoia e Rapidex",
"distance": 3.87,
"address": {
"postal_code": "04534000",
"address": "Rua Funchal",
"number": "480",
"complement": "Loja 1",
"district": "Vila Olímpia",
"city": {
"city": "São Paulo",
"state": {
"state_abbr": "SP",
"state": "São Paulo"
}
},
"latitude": -23.59505,
"longitude": -46.68583
},
"phone": {
"phone": "11987654321"
},
"companies": [
{
"id": 8
},
{
"id": 15
},
{
"id": 21
},
{
"id": 22
}
],
"services": [
{
"id": 7
},
{
"id": 14
},
{
"id": 16
},
{
"id": 18
},
{
"id": 24
},
{
"id": 27
}
],
"term": 0,
"cost": 0,
"pudos_company": 3
}
]
}Campo necessário
O campo que deve ser anotado para a geração da etiqueta de envio é id. Este campo é utilizado para identificar o ponto de coleta escolhido pelo vendedor e deverá ser informado no momento da geração da etiqueta de envio.