> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onbeef.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirme um pedido

> Aceite um pedido e inicie o preparo.

Chame este endpoint depois de revisar um evento `CREATED`. A requisição aceita o pedido e inicia o preparo.

## Parâmetros de rota

<ParamField path="orderId" type="string (uuid)" required>
  Identificador único do pedido a ser confirmado. Gerado pela Onbeef e retornado no evento do pedido.
</ParamField>

## Corpo da requisição

<ParamField body="createdAt" type="string (date-time)" required>
  Data e hora em que o pedido foi criado, no formato ISO 8601 (por exemplo, `2019-08-24T14:15:22Z`).
</ParamField>

<ParamField body="orderExternalCode" type="string" required>
  Código de referência interno do seu PDV para este pedido. Usado para correlacionar o pedido Onbeef com seus registros.
</ParamField>

<ParamField body="reason" type="string">
  Campo opcional em texto livre com contexto adicional sobre a confirmação: por exemplo, o nome do funcionário que aceitou o pedido.
</ParamField>

<ParamField body="preparationTime" type="integer">
  Tempo estimado de preparo em minutos. A Onbeef usa este valor para informar o cliente e o entregador sobre o tempo previsto até ficar pronto.
</ParamField>

## Resposta

### 202: Aceito

A confirmação foi aceita para processamento. A Onbeef atualizará o status do pedido e notificará o cliente.

### 401: Não autorizado

Retornado quando a requisição não inclui credenciais de autenticação válidas.

### 404: Não encontrado

Nenhum pedido foi encontrado com o `orderId` informado.

## Exemplo de requisição

<CodeGroup>
  ```bash Sandbox theme={null}
  curl --request POST \
    --url "https://api.dev.connect.onbeefapp.com.br/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479/confirm" \
    --header "Authorization: Bearer <token>" \
    --header "Content-Type: application/json" \
    --data '{
      "reason": "Aceito por Maria",
      "createdAt": "2019-08-24T14:15:22Z",
      "orderExternalCode": "POS-00123",
      "preparationTime": 25
    }'
  ```

  ```bash Produção theme={null}
  curl --request POST \
    --url "https://api.connect.onbeefapp.com.br/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479/confirm" \
    --header "Authorization: Bearer <token>" \
    --header "Content-Type: application/json" \
    --data '{
      "reason": "Aceito por Maria",
      "createdAt": "2019-08-24T14:15:22Z",
      "orderExternalCode": "POS-00123",
      "preparationTime": 25
    }'
  ```
</CodeGroup>

## Exemplo de corpo da requisição

```json theme={null}
{
  "reason": "Aceito por Maria",
  "createdAt": "2019-08-24T14:15:22Z",
  "orderExternalCode": "POS-00123",
  "preparationTime": 25
}
```

<Warning>
  Se você não consegue cumprir um pedido, **não** chame este endpoint. Em vez disso, use o endpoint [Solicitar cancelamento](/api-reference/orders/request-cancellation) para cancelar o pedido e informar o motivo.
</Warning>

<Tip>
  Informe sempre um `preparationTime` realista. Superestimar prejudica a experiência do cliente; subestimar pode fazer o entregador chegar antes de o pedido estar pronto.
</Tip>