> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/pedidos/detalhes-do-pedido.md).

# Detalhes do Pedido

Retorna os **dados completos** de um pedido específico, identificado pelo seu **Código**.

```
GET /pedidos/{Codigo}/
```

O `{Codigo}` é o código do pedido, obtido na [listagem de pedidos](/pedidos/listar-pedidos.md).

## 📥 Exemplo de requisição

```bash
curl -X GET "https://api.toplojas.com.br/pedidos/1000/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

## 📤 O que é retornado

Os detalhes de um pedido incluem, entre outros:

| Grupo        | Conteúdo                                                        |
| ------------ | --------------------------------------------------------------- |
| **Cliente**  | Nome/Razão Social, documento, contato e endereço                |
| **Endereço** | Endereço de entrega do pedido                                   |
| **Itens**    | Produtos do pedido (SKU, nome, quantidade e valores)            |
| **Valores**  | Total, produtos, frete e descontos                              |
| **Formas**   | Forma de pagamento e forma de entrega                           |
| **Status**   | Código, nome e indicação do status atual                        |
| **Fretes**   | Formas de entrega **calculadas** no carrinho (opções e valores) |

Exemplo completo de um pedido retornado:

```json
{
  "Codigo": 1000,
  "CodigoReferencial": 1,
  "Data": "2020-12-01 12:00:00",
  "Loja": "cmacetkoteste",
  "Cliente": {
    "Codigo": 1,
    "IsPessoa": "F",
    "Nome_RazaoSocial": "Paloma Macetko",
    "Contato": "",
    "DataNascimento": "1989-11-14",
    "Sexo": "M",
    "CPF_CNPJ": "000.000.000-00",
    "RG_IE": "",
    "Email": "suporte2@web4business.com.br",
    "Telefone01": "(47) 33224477",
    "Telefone02": "(47) 55447788",
    "Telefone03": "(47) 55886699",
    "Empresa": "",
    "End_Estado": "SC",
    "End_Cidade": "Brusque",
    "End_Bairro": "centro",
    "End_Endereco": "Rua Central",
    "End_Numero": "99",
    "End_Complemento": "",
    "End_CEP": "88355-000"
  },
  "Endereco": {
    "End_Estado": "SC",
    "End_Cidade": "Brusque",
    "End_Bairro": "centro",
    "End_Endereco": "Rua Central",
    "End_Numero": "99",
    "End_Complemento": "",
    "End_CEP": "88355-000"
  },
  "ValorTotal": 253.79,
  "ValorProdutos": 220,
  "ValorFrete": 33.79,
  "ValorDescontosCupom": 0,
  "ValorDescontosPagamento": 0,
  "FormaPagamento": {
    "Codigo": 78509,
    "Nome": "PagSeguro"
  },
  "FormaEntrega": {
    "Codigo": 27154,
    "Nome": "PAC"
  },
  "NumeroParcelas": 1,
  "Status": {
    "Codigo": 25,
    "Nome": "Pedido com Pagamento Confirmado, Aguardando Captura",
    "Indicacao": "Pago"
  },
  "PrazoEntrega": {
    "QtdDias": 9,
    "Texto": "Entrega em até <strong>9 dias</strong> úteis após a postagem"
  },
  "FormasEntregaCalculadas": [
    {
      "Codigo": 27150,
      "Nome": "Frete Grátis",
      "Valor": 0,
      "PrazoEntrega": {
        "QtdDias": 12,
        "Texto": "Entrega em até <strong>12 dias</strong> úteis após a postagem"
      }
    },
    {
      "Codigo": 27154,
      "Nome": "PAC",
      "Valor": 33.79,
      "PrazoEntrega": {
        "QtdDias": 9,
        "Texto": "Entrega em até <strong>9 dias</strong> úteis após a postagem"
      }
    },
    {
      "Codigo": 27155,
      "Nome": "SEDEX",
      "Valor": 52.4,
      "PrazoEntrega": {
        "QtdDias": 4,
        "Texto": "Entrega em até <strong>4 dias</strong> úteis após a postagem"
      }
    }
  ],
  "Itens": [
    {
      "Codigo": 1187876,
      "SKU": "3017",
      "Nome": "Teste1",
      "Quantidade": 2,
      "ValorUnitario": 110,
      "ValorTotal": 220
    }
  ]
}
```

## 🚚 Formas de entrega calculadas

O elemento **`FormasEntregaCalculadas`** traz **todas as opções de frete que foram calculadas no carrinho** no momento da compra — e não apenas a que o cliente escolheu.

As opções vêm **ordenadas pelo valor do frete**, do **menor para o maior**.

| Campo                  | Tipo    | Descrição                                        |
| ---------------------- | ------- | ------------------------------------------------ |
| `Codigo`               | inteiro | Código da forma de entrega                       |
| `Nome`                 | texto   | Nome da forma de entrega apresentado no carrinho |
| `Valor`                | decimal | Valor do frete calculado para esta opção         |
| `PrazoEntrega.QtdDias` | inteiro | Prazo de entrega em dias úteis                   |
| `PrazoEntrega.Texto`   | texto   | Prazo em formato de texto (pode conter HTML)     |

{% hint style="info" %}
Não confunda os dois elementos:

* **`FormaEntrega`** → a forma de entrega **escolhida** pelo cliente (e cobrada no pedido, em `ValorFrete`).
* **`FormasEntregaCalculadas`** → **todas** as opções que estavam **disponíveis** no carrinho, com seus respectivos valores e prazos.

Use `FormasEntregaCalculadas` para analisar, por exemplo, quanto o cliente **economizou** ao escolher uma opção mais barata, ou para comparar as cotações de frete dos seus pedidos.
{% endhint %}

{% hint style="success" %}
**Frete grátis também é retornado.** Opções de entrega gratuitas aparecem normalmente na lista, com **`Valor: 0`** — elas não são omitidas. Como a ordenação é pelo valor do frete (do menor para o maior), uma opção de frete grátis costuma ser o **primeiro item** da lista.

Portanto, para identificar frete grátis, verifique se **`Valor` é igual a `0`** — e não a ausência da opção na lista.
{% endhint %}

{% hint style="warning" %}
`FormasEntregaCalculadas` retorna uma **lista vazia** (`[]`) quando o pedido não possui cotações de frete registradas — por exemplo, em pedidos **antigos** (anteriores à implantação do recurso) ou em pedidos vindos de **Marketplace**. **Sempre trate essa possibilidade** na sua integração.
{% endhint %}

{% hint style="info" %}
Consulte a descrição de cada campo retornado na referência:

{% embed url="<https://api.toplojas.com.br/doc/#/Pedidos>" %}
{% endhint %}