> 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-abandonados/listar-pedidos-abandonados.md).

# Listar e Filtrar Pedidos Abandonados

Retorna a **listagem de carrinhos abandonados** da loja, com suporte a filtros e paginação.

```
GET /pedidos-abandonados/
```

Os registros vêm ordenados do **mais recente para o mais antigo**, que é a ordem mais útil para ações de recuperação.

## 🔎 Filtros disponíveis

Os filtros são enviados na **Query** da requisição. Todos são opcionais e podem ser combinados.

| Parâmetro           | Tipo    | Descrição                                                    |
| ------------------- | ------- | ------------------------------------------------------------ |
| `DataDe`            | data    | Retorna carrinhos a partir desta data (`Ano-Mês-Dia`)        |
| `DataAte`           | data    | Retorna carrinhos até esta data (`Ano-Mês-Dia`)              |
| `Codigo`            | inteiro | Filtra pelo código interno do pedido                         |
| `CodigoCliente`     | inteiro | Retorna apenas os carrinhos de um cliente                    |
| `CodigoLojaGerador` | inteiro | Filtra pela loja que gerou o pedido (para lojas com filiais) |
| `Pagina`            | inteiro | Página desejada (paginação)                                  |
| `QtdPorPagina`      | inteiro | Registros por página (máx. **100**)                          |

## 📥 Exemplo de requisição

Buscando os carrinhos abandonados de janeiro, 50 por página:

```bash
curl -X GET "https://api.toplojas.com.br/pedidos-abandonados/?DataDe=2026-01-01&DataAte=2026-01-31&QtdPorPagina=50" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

## 📤 Exemplo de resposta

A resposta segue o padrão de paginação (`Dados` + `Paginacao`):

```json
{
  "Dados": [
    {
      "Codigo": 1234,
      "CodigoReferencial": 0,
      "Data": "2026-01-15 14:32: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": "",
        "Telefone03": "",
        "Empresa": "",
        "End_Estado": "SC",
        "End_Cidade": "Brusque",
        "End_Bairro": "centro",
        "End_Endereco": "Rua Central",
        "End_Numero": "99",
        "End_Complemento": "",
        "End_CEP": "88355-000"
      },
      "EnderecoEntrega": {
        "End_Estado": "SC",
        "End_Cidade": "Brusque",
        "End_Bairro": "centro",
        "End_Endereco": "Rua Central",
        "End_Numero": "99",
        "End_Complemento": "",
        "End_CEP": "88355-000"
      },
      "Itens": [
        {
          "Produto": {
            "Codigo": 1187876,
            "SKU": "3017",
            "Nome": "Teste1"
          },
          "Quantidade": 2,
          "ValorUnitario": 110,
          "ValorTotal": 220
        }
      ],
      "Valores": {
        "Produtos": 220
      }
    }
  ],
  "Paginacao": {
    "PaginaAtual": 1,
    "QtdPaginas": 1,
    "QtdRegistros": 1
  }
}
```

{% hint style="warning" %}
`Valores.Produtos` é um valor **estimado** — a soma de `Quantidade × ValorUnitario` dos itens. **Não inclui frete**, pois o cliente não chegou a escolher a forma de entrega.
{% endhint %}

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

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

Para entender o funcionamento da paginação, veja:

{% content-ref url="/pages/-MObwaEfNJbBvr8ZSK0U" %}
[Paginação](/funcionamento/paginacao.md)
{% endcontent-ref %}