> ## 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.

# Valide o código de entrega

> Valide o código de entrega informado pelo cliente.

Valide o código informado pelo cliente antes de chamar o endpoint [Marcar como entregue](/api-reference/orders/delivered).

## Parâmetros de rota

<ParamField path="orderId" type="string (uuid)" required>
  Identificador único do pedido cujo código de entrega você quer validar. Gerado pela Onbeef e retornado no evento do pedido.
</ParamField>

## Corpo da requisição

<ParamField body="deliveryCode" type="string" required>
  Código de confirmação de entrega informado pelo cliente no momento da entrega.
</ParamField>

## Resposta

### 200: Sucesso

O código é válido. A entrega está confirmada como sendo feita ao cliente correto.

<ResponseField name="orderId" type="string (uuid)">
  Identificador único do pedido validado.
</ResponseField>

<ResponseField name="deliveryCode" type="string">
  Código de confirmação de entrega que foi validado.
</ResponseField>

### 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.

### 400: Requisição inválida

O código de entrega informado é inválido ou não corresponde ao código registrado para este pedido. Corpo: `{ "title": "Invalid code provided", "status": 400 }`.

## 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/validateCode" \
    --header "Authorization: Bearer <token>" \
    --header "Content-Type: application/json" \
    --data '{
      "deliveryCode": "4829"
    }'
  ```

  ```bash Produção theme={null}
  curl --request POST \
    --url "https://api.connect.onbeefapp.com.br/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479/validateCode" \
    --header "Authorization: Bearer <token>" \
    --header "Content-Type: application/json" \
    --data '{
      "deliveryCode": "4829"
    }'
  ```
</CodeGroup>

## Exemplo de corpo da requisição

```json theme={null}
{
  "deliveryCode": "4829"
}
```

## Exemplo de resposta (200)

```json theme={null}
{
  "orderId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "deliveryCode": "4829"
}
```

<Warning>
  Uma resposta `400` significa que o código está incorreto. **Não** entregue o pedido se a validação falhar: entre em contato com o cliente pelo canal apropriado para resolver a divergência antes de concluir a entrega.
</Warning>

<Tip>
  Este é o endpoint do lado do merchant (autenticado por Bearer token). O provedor de logística usa o endpoint equivalente [`POST /v1/logistics/confirmationCode`](/api-reference/logistics/delivery-confirmation-code), autenticado por headers `X-App-*`.
</Tip>