Consultar entregas¶
Recuperar entregas por ID¶
Este endpoint permite que o vendedor (seller) recupere uma entrega utilizando o id como referência.
Escopo requerido
| Valor | Descrição |
|---|---|
open:order-delivery:read |
Permite a leitura de entregas e dados relacionados. |
Parâmetros da URL
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
id |
string | ID da entrega na plataforma. | Sim |
Chamada:
curl -X 'GET' \
'https://services.magalu.com/seller/v1/deliveries/{id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Access Token>' \
-H 'Content-Type: application/json' \
Resposta:
{
"code": "LU-123456789101112-1",
"id": "6c764444-436d-4659-8cec-304414b05259",
"seller": {
"id": "GENPUB.e83ed3c7-7bae-47c4-9dcd-d12f6329fe1a",
"name": "Loja do Edu"
},
"status": "new|approved|invoiced|shipped|delivered|cancelled|frozen",
"amounts": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"discount": {
"currency": "BRL",
"normalizer": 100,
"total": 5000,
"shared": 2500
},
"freight": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"shared": 0
},
"taxes": [
{
"currency": "BRL",
"normalizer": 100,
"type": "icms|prc|...",
"description": "ICMS",
"total": 100
}
],
"commission": {
"currency": "BRL",
"normalizer": 100,
"type": "value", //(value, percentage, etc.)
"total": 14400,
},
},
"items": [
{
"sequencial": "1",
"amounts": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"discount": {
"currency": "BRL",
"normalizer": 100,
"total": 5000,
"shared": 2500
},
"freight": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"shared": 0
},
"comission": {
"normalizer": 100,
"type": "percentage",
"total": 1850,
}
},
"info": {
"sku": "livro_01",
"id": "00839163-486f-4557-8173-c454d22edd64",
"name": "Livro XYZ",
"description": "...",
"images": [
{
"url": "https://imagem.do.livro/foto.jpg"
}
],
"attributes": [
{
"name": "color",
"value": "black"
}
],
"extras": {
"categories": "UD"
},
"dimensions": {
"height": {
"value": 120,
"unit": "cm"
},
"width": {
"value": 100,
"unit": "cm"
},
"length": {
"value": 110,
"unit": "cm"
},
"weight": {
"value": 170,
"unit": "g"
}
}
},
"measure_unit": "PC|KG|G",
"unit_price": {
"currency": "BRL",
"normalizer": 100,
"value": 1999
},
"quantity": 1
}
],
"shipping": {
"posting_date": "2021-07-22T13:06:28.000Z",
"recipient": {
"customer_type": "cnpj|cpf",
"document_number": "12312312311",
"email": "user@mail.com",
"name": "Fu***as",
"phones": [
{
"area_code": "11",
"country_code": "55",
"number": "991232233",
"type": "mobile|comercial|residential"
}
],
"address": {
"zipcode": "86380000",
"street": "1 DE MAIO",
"number": "79",
"district": "VILA INDUSTRIAL",
"city": "ANDIRA",
"state": "PR",
"country": "BR",
"complement": "apto 1023",
"reference": ""
}
},
"drop_details": {
"store": {
"name": "loja magalu 001 franca",
"document": "1928491824"
},
"address": {
"zipcode": "86380000",
"street": "1 DE MAIO",
"number": "79",
"district": "VILA INDUSTRIAL",
"city": "ANDIRA",
"state": "PR",
"country": "BR",
"complement": "apto 1023",
"reference": ""
}
},
"handling_time": {
"value": 15,
"precision": "days",
"workday": true,
"limit_date": "2021-07-22T13:06:28.000Z"
},
"deadline": {
"value": 15,
"precision": "days",
"workday": true,
"limit_date": "2021-07-22T13:06:28.000Z"
},
"provider": {
"id": "integra",
"name": "integra",
"description": "Entrega pelo parceiro",
"extras": {
"chave": "valor"
}
}
},
"invoiced_at": "2021-07-22T13:06:28.000Z",
"delivered_at": "2021-07-22T13:06:28.000Z",
"shipped_at": "2021-07-22T13:06:28.000Z",
"cancelled_at": "2021-07-22T13:06:28.000Z",
"labels": [
{
"value": "etiqueta",
"id": "123"
}
],
"tracking_url": "http://url.de.acompanhamento.da.entrega/",
"invoices": [
{
"key": "55080701212344000127550010000000981364117781",
"issued_at": "2021-07-22T13:06:28.000Z",
"volume_quantity": 1,
"status": "approved|validating|invalid"
}
],
"order": {
"code": "LU-123456789101112",
"id": "c8be6d3d-77e6-4cd9-8d6e-dd556b3e46ee",
"channel": {
"id": "e83ed3c7-7bae-47c4-9dcd-d12f6329fe1a",
"marketplace": {
"document": "18901029000100"
},
"extras": {}
}
}
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |
Recuperar entregas por filtros¶
Este endpoint permite recuperar uma coleção de entregas utilizando filtros como referência.
Escopo requerido
| Valor | Descrição |
|---|---|
open:order-delivery:read |
Permite a leitura de entregas e dados relacionados. |
Filtros
| Campo | Tipo | Descrição | Obrigatorio |
|---|---|---|---|
_limit |
inteiro | Determina a quantidade de registros a serem retornados. Valor padrão 50. | Não |
_offset |
inteiro | Posição de registro de referência, a partir dele serão retornados os próximos N registros. Valor padrão 0. | Não |
status |
string | Status da entrega | Não |
id |
String | Identificador da entrega | Não |
code |
String | Código do pedido | Não |
order__code |
String | Código do pedido | Não |
order__channel__id |
String | Identificador do canal | Não |
Paginação e Ordenação
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
_limit |
Inteiro | Determina a quantidade de registros a serem retornados. Valor padrão 50. | Não |
_offset |
Inteiro | Posição de registro de referência, a partir dele serão retornados os próximos N registros. Valor padrão 0. | Não |
Chamada:
curl -X 'GET' \
'https://services.magalu.com/seller/v1/deliveries' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Access Token>' \
-H 'Content-Type: application/json' \
Resposta:
{
"meta": {
"page": {
"limit": 20,
"offset": 150,
"max_limit": 100
},
"links": {
"previous": "?_offset=130&_limit=20",
"next": "?_offset=170&_limit=20",
"self": "?_offset=150&_limit=20"
}
},
"results": [
{
"code": "LU-123456789101112-1",
"id": "6c764444-436d-4659-8cec-304414b05259",
"seller": {
"id": "GENPUB.e83ed3c7-7bae-47c4-9dcd-d12f6329fe1a",
"name": "Loja do Edu"
},
"status": "new|approved|invoiced|shipped|delivered|cancelled|frozen",
"amounts": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"discount": {
"currency": "BRL",
"normalizer": 100,
"total": 5000,
"shared": 2500
},
"freight": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"shared": 0
},
"taxes": [
{
"currency": "BRL",
"normalizer": 100,
"type": "icms|prc|...",
"description": "ICMS",
"total": 100
}
],
"commission": {
"currency": "BRL",
"normalizer": 100,
"type": "value", //(value, percentage, etc.)
"total": 14400,
},
},
"items": [
{
"sequencial": "1",
"amounts": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"discount": {
"currency": "BRL",
"normalizer": 100,
"total": 5000,
"shared": 2500
},
"freight": {
"currency": "BRL",
"normalizer": 100,
"total": 10000,
"shared": 0
},
"comission": {
"normalizer": 100,
"type": "percentage",
"total": 1850,
}
},
"info": {
"sku": "livro_01",
"id": "00839163-486f-4557-8173-c454d22edd64",
"name": "Livro XYZ",
"description": "...",
"images": [
{
"url": "https://imagem.do.livro/foto.jpg"
}
],
"attributes": [
{
"name": "color",
"value": "black"
}
],
"extras": {
"categories": "UD"
},
"dimensions": {
"height": {
"value": 120,
"unit": "cm"
},
"width": {
"value": 100,
"unit": "cm"
},
"length": {
"value": 110,
"unit": "cm"
},
"weight": {
"value": 170,
"unit": "g"
}
}
},
"measure_unit": "PC|KG|G",
"unit_price": {
"currency": "BRL",
"normalizer": 100,
"value": 1999
},
"quantity": 1
}
],
"shipping": {
"posting_date": "2021-07-22T13:06:28.000Z",
"recipient": {
"customer_type": "cnpj|cpf",
"document_number": "12312312311",
"email": "user@mail.com",
"name": "Fu***as",
"phones": [
{
"area_code": "11",
"country_code": "55",
"number": "991232233",
"type": "mobile|comercial|residential"
}
],
"address": {
"zipcode": "86380000",
"street": "1 DE MAIO",
"number": "79",
"district": "VILA INDUSTRIAL",
"city": "ANDIRA",
"state": "PR",
"country": "BR",
"complement": "apto 1023",
"reference": ""
}
},
"drop_details": {
"store": {
"name": "loja magalu 001 franca",
"document": "1928491824"
},
"address": {
"zipcode": "86380000",
"street": "1 DE MAIO",
"number": "79",
"district": "VILA INDUSTRIAL",
"city": "ANDIRA",
"state": "PR",
"country": "BR",
"complement": "apto 1023",
"reference": ""
}
},
"handling_time": {
"value": 15,
"precision": "days",
"workday": true,
"limit_date": "2021-07-22T13:06:28.000Z"
},
"deadline": {
"value": 15,
"precision": "days",
"workday": true,
"limit_date": "2021-07-22T13:06:28.000Z"
},
"provider": {
"id": "integra",
"name": "integra",
"description": "Entrega pelo parceiro",
"extras": {
"chave": "valor"
}
}
},
"order": {
"code": "LU-123456789101112",
"id": "c8be6d3d-77e6-4cd9-8d6e-dd556b3e46ee",
"channel": {
"id": "e83ed3c7-7bae-47c4-9dcd-d12f6329fe1a",
"marketplace": {
"document": "18901029000100"
},
"extras": {}
}
}
}
]
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 500 | Internal Server Error |