Pedidos

Buscar pedidos

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

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

Query parameters

tipoData'criacao' | 'atualizacao'

criacao (padrão) filtra pelos pedidos criados. atualizacao filtra pela data da última modificação.

dataInicialstring

Data e hora inicial no formato DD/MM/YYYY HH:MM:SS.

dataFinalstring

Data e hora final no formato DD/MM/YYYY HH:MM:SS.

datastring

Data única (alternativa ao intervalo) no formato DD/MM/YYYY.

canceladosboolean

Indica se devem ou não ser retornados pedidos cancelados.

somenteNovosboolean

Retorna apenas pedidos novos (ainda não importados por ERP). Atenção: o comportamento do WS com o parâmetro AUSENTE equivale a true (filtra importados) — por isso o MCP injeta false quando o modelo omite (x-mcp-inject-default), garantindo que a listagem sempre retorne os pedidos. A consulta por intervalo marca os pedidos retornados como importados quando autenticada por X-Auth-Id/X-Auth-Secret; autenticada por X-Api-Token (connector MCP), não marca.

consultarVendedoresboolean

Indica se devem ou não ser retornados pedidos das contas de vendedores vinculados.

skipinteger

Quantidade de registros a serem ignorados (paginação).

limitinteger

Quantidade máxima de pedidos retornados (paginação, use com skip). Valores acima de 200 são reduzidos para 200.

Response

Pedidos encontrados.

idstring
datastring
entregaboolean
retiradaOutroLocalboolean

Indica retirada em local diferente da loja. Junto com entrega, define se a etapa enviado se aplica ao pedido.

dataHoraRetiradastring nullable
observacaostring
qrcodestring nullable
valorPedidonumber
valorAproximadoboolean
numerointeger
importacaoErpinteger

Example response

[
  {
    "notas": [
      {
        "tipo": "nfe",
        "numero": "000980",
        "serie": "001",
        "protocolo": "135260000012345",
        "chave": "35260912345678901234550010000019801234567890",
        "situacao": "autorizada",
        "dataEmissao": "2026-09-03 10:06:15",
        "valor": 199.9,
        "linkPdf": "https://exemplo.com/danfe.pdf",
        "linkXml": "https://exemplo.com/nfe.xml",
        "atualizadaEm": "2026-09-03 16:51:43"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.