Expedir uma entrega
Este endpoint permite que o vendedor (seller) faça a expedição de uma entrega utilizando o id como referência. Somente é aplicável para entregas a combinar.
Escopo requerido
| Valor | Descrição |
|---|---|
| order-delivery:write | Permite a escrita de entregas e dados relacionados. |
Parâmetros da URL
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| id | ObjectId | ID da entrega na plataforma. | Sim |
Parâmetros da requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| tracking_url | String | URL de rastreamento da entrega. | Sim |
| protocol | String | Protocolo da entrega. | Sim |
| label | String | Etiqueta da entrega para rastreio. | Sim |
| dates | Object | Datas da entrega. | Sim |
| carrier | Object | Transportadora da entrega. | Sim |
Objeto dates
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| estimated_delivery | String | Data estimada de entrega. | Sim |
| shipped | String | Data de expedição. | Não |
Objeto carrier
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| name | String | Nome da transportadora. | Sim |
Exemplo de requisição
curl -X 'POST' \
'https://apps.eupreciso.com.br/v1.0/marketplace/deliveries/{id}/shippings' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Access Token>' \
-H 'Content-Type: application/json' \
-d '{
"tracking_url": "http://url.de.acompanhamento.da.entrega/",
"protocol": "000111222",
"label": "000111222",
"dates": {
"estimated_delivery": "2021-07-22T13:06:28.000Z",
"shipped": "2021-07-22T13:06:28.000Z", //[opcional] Se nulo será considerada a data atual
},
"carrier": {
"name": "Nome da transportadora"
}
}'Exemplo de resposta
{
"order_id": "6712a764c37c38e9039093e4",
"delivery_id": "6712a312c37c38e9038fd9b6",
"status": "shipped",
"tracking_url": "http://url.de.acompanhamento.da.entrega/",
"protocol": "000111222",
"label": "000111222",
"dates": {
"estimated_delivery": "2021-07-22T13:06:28.000Z",
"shipped": "2021-07-22T13:06:28.000Z"
},
"carrier": {
"name": "Nome da transportadora"
}
}Códigos de retorno
| Código | Descrição |
|---|---|
| 201 | CREATED |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |