---
title: "Buscar pedidos"
method: GET
path: "/pedidos"
tags: ["Pedidos"]
---

# Buscar pedidos

`GET /pedidos`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/pedidos`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Consulta pedidos por intervalo de datas ou por uma data específica.
Utilize `dataInicial`/`dataFinal` para um intervalo, ou `data` para
uma única data.

## Query parameters

- `tipoData` 'criacao' | 'atualizacao'
- `dataInicial` string
- `dataFinal` string
- `data` string
- `cancelados` boolean
- `somenteNovos` boolean
- `consultarVendedores` boolean
- `skip` integer
- `limit` integer

## Response `200`

Pedidos encontrados.

- Pedido[]
  - `id` string
  - `data` string
  - `itens` PedidoItem[]
    - `id_produto` string
    - `descricao` string
    - `detalhes` string
    - `preco` number
    - `controle_estoque` boolean
    - `unidadeVenda` string
    - `unidadePreco` string
    - `categorias` union[]: Categorias do produto no momento do pedido. Pedidos criados a partir de 17/03/2026 trazem objetos `{id, nome}` (o `id` como string simples, igual aos demais ids); pedidos anteriores trazem apenas o nome da categoria como string (podendo conter itens null).
      - union
        - object
          - `id` string: Id da categoria.
          - `nome` string
        - string, nullable
    - `precoPromocional` number, nullable
    - `quantidade` number
    - `observacaoProduto` string, nullable
    - `relacaoVariacao` PedidoItemVariacao[], nullable
      - `nome` string
      - `variaveis` PedidoItemVariavel[]
        - `nome` string
        - `quantidade` integer
        - `valorAdicional` number
        - `codigo` string
        - `id` string, nullable
      - `multipla_selecao` boolean
      - `obrigatoria` boolean
      - `adicional` boolean
      - `qtdeMinima` integer, nullable
      - `qtdeMaxima` integer, nullable
      - `quantidadeSelecionada` integer
      - `valorAdicionais` number
      - `codigo` string
      - `id` string
    - `codigo` string, nullable
    - `dimensoes` object, nullable
    - `embalagemTransporte` 1 | 2 | 3 | null, nullable: Código do tipo de embalagem para cálculo de frete, copiado do produto: 1 = Pacote/Caixa, 2 = Cilindro/Rolo, 3 = Envelope. Null ou ausente quando o produto não tem embalagem definida.
  - `entrega` boolean
  - `retiradaOutroLocal` boolean: Indica retirada em local diferente da loja. Junto com `entrega`, define se a etapa `enviado` se aplica ao pedido.
  - `dataHoraRetirada` string, nullable
  - `observacao` string
  - `pagamento` PedidoPagamento
    - `descricao` string
    - `utilizaTroco` boolean
    - `utilizaBandeira` boolean
    - `bandeiraSelecionada` string, nullable
    - `parcelas` integer, nullable
    - `id` string, nullable
    - `dt_alteracao` string, nullable
  - `taxaEntrega` union: Valor do frete do pedido. Number quando há valor calculado; string vazia ("") quando não há entrega/frete; "Grátis" quando o frete foi isentado; null quando o frete é "a combinar" (pendente de definição). O campo pode estar ausente em pedidos antigos.
    - number
    - string
  - `qrcode` string, nullable
  - `valorPedido` number
  - `valorAproximado` boolean
  - `numero` integer
  - `importacaoErp` integer
  - `vendedor` PedidoVendedor, nullable
    - `id` string
    - `nome` string
  - `cliente` PedidoCliente
    - `nome` string, nullable
    - `documento` string, nullable
    - `telefone` string, nullable
    - `endereco` PedidoEndereco
      - `cep` string
      - `logradouro` string
      - `numero` string
      - `bairro` string
      - `pais` string
      - `estado` string
      - `cidade` string
      - `complemento` string
  - `status` PedidoStatus: Etapas de andamento do pedido.
    - `preparacao` boolean: Legado: etapa "preparacao" descontinuada. Só aparece em pedidos antigos que já tinham o campo gravado; não é mais aceita em `PATCH /pedidos/{pedidoId}/status`.
    - `separacao` boolean: Separado.
    - `enviado` boolean: Enviado.
    - `entregue` boolean: Entregue.
    - `pagamento` boolean: Pagamento confirmado.
  - `notas` NotaFiscalPedido[]: Notas fiscais/documentos fiscais vinculados ao pedido (NF-e, NFC-e, NFS-e, CT-e, SAT), registrados via `PATCH /pedidos/{pedidoId}/nota`. Campo ausente (não aparece como `[]` nem `null`) quando o pedido ainda não tem nenhuma nota registrada — e também quando todas as notas já registradas foram excluídas (`excluir: true`).
    - `tipo` 'nfe' | 'nfce' | 'nfse' | 'cte' | 'sat': Tipo do documento: NF-e, NFC-e, NFS-e, CT-e ou SAT.
    - `chave` string: Chave de acesso (só dígitos).
    - `numero` string
    - `serie` string
    - `protocolo` string
    - `codigoVerificacao` string: Código de verificação (usado por NFS-e municipais sem chave).
    - `situacao` 'autorizada' | 'cancelada' | 'denegada' | 'inutilizada'
    - `dataEmissao` string: Data e hora de emissão no formato `AAAA-MM-DD HH:MM:SS` (fuso America/Sao_Paulo), igual ao campo `data` do pedido.
    - `valor` number
    - `linkPdf` string, uri: URL do PDF (DANFE/DACTE/espelho).
    - `linkXml` string, uri: URL do XML autorizado.
    - `atualizadaEm` string: Data e hora da última gravação desta nota, mesmo formato de `dataEmissao`.

## Other responses

- `401`: Credenciais informadas inválidas.

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)