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:

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):

{
  "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": "[e-mail]",
        "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
  }
}

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.

Consulte a descrição de cada campo na referência:

Swagger UIapi.toplojas.com.br

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

Paginação