---
title: "Atualizar status de entrega"
description: "PATCH /v1/orders/{orderId}/delivery-status — altera o status de entrega de um pedido na API BeeFood."
method: "PATCH"
path: "/v1/orders/{orderId}/delivery-status"
url: "https://developer.beefood.com.br/docs/pedidos/status-entrega"
group: "Pedidos"
scope: "orders:write"
lang: "pt"
---
# Atualizar status de entrega

`PATCH /v1/orders/{orderId}/delivery-status`

- Produção: `https://api.beefood.app/v1/orders/{orderId}/delivery-status`
- Sandbox: `https://api-sandbox.beefood.app/v1/orders/{orderId}/delivery-status`

Movimenta o status de entrega de um pedido DELIVERY.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `orders:write`. Limite: 300 requisições a cada 3 minutos.


## Parâmetros de path

- `orderId` *integer* **obrigatório** — ID do pedido, maior ou igual a 1. Exemplo: `58449271`.



## Parâmetros do body

- `deliveryStatus` *string* **obrigatório** — Novo status de entrega. Exemplo: `"DISPATCHED"`.
  - *Valores:* `WAITING`, `ACCEPTED`, `PREPARING`, `READY`, `DISPATCHED`, `DELIVERED`



## Exemplos de requisição

### cURL

```bash
curl -X PATCH "https://api.beefood.app/v1/orders/{orderId}/delivery-status" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "deliveryStatus": "DISPATCHED"
}'
```


## Exemplos de resposta

### 200 OK

```json

```




## Erros

| Status | Mensagem |
| --- | --- |
| 400 | 'id' must be a positive integer |
| 400 | 'deliveryStatus' must be one of WAITING, ACCEPTED, PREPARING, READY, DISPATCHED, DELIVERED |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the orders:write scope |
| 404 | Order ID 123 not found |
| 422 | Order ID 123 is not a delivery order |
| 422 | Order ID 123 is cancelled |
| 429 | Too Many Requests |
| 500 | Database error when trying to … |
| 502 | Delivery status service unavailable |
| 502 | Delivery status service failed to update the order |


## Vocabulários usados neste endpoint

## Pedidos · deliveryStatus

Situação operacional do pedido. Aparece na lista e no detalhe e é espelhada nos webhooks de status.

| Valor | Significado | Uso |
| --- | --- | --- |
| `WAITING` | Aguardando | Pedidos e webhooks |
| `ACCEPTED` | Aceito | Pedidos e webhooks |
| `PREPARING` | Em preparo | Pedidos e webhooks |
| `READY` | Pronto | Pedidos e webhooks |
| `DISPATCHED` | Despachado | Pedidos e webhooks |
| `DELIVERED` | Entregue | Pedidos e webhooks |