---
title: "Consultar Pedidos de Venda"
method: GET
path: "/v1/vendas/pedidos"
tags: ["Vendas Pedidos"]
---

# Consultar Pedidos de Venda

`GET /v1/vendas/pedidos`

## Query parameters

- `page` integer, required
- `modifiedSince` string
- `codigoEmpresa` integer, required
- `codigoNota` integer
- `numeroNota` integer
- `serieNota` string
- `dataNegociacaoInicio` string
- `dataNegociacaoFinal` string
- `codigoCliente` integer
- `confirmada` boolean
- `pendente` boolean
- `statusWMS` 1 | 2 | 3 | 4 | 5 | 6
- `situacaoWMS` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22
- `statusConferencia` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11
- `codigoNatureza` integer
- `codigoCentroResultado` integer
- `codigoProjeto` integer
- `codigoContrato` integer
- `codigoOrdemCarga` integer

## Response `200`

Sucesso.

- RespostaPaginadaPedido
  - `metadados` Metadados
    - `paginaAtual` integer
    - `totalPaginas` integer
    - `totalRegistros` integer
    - `possuiMaisPaginas` boolean
  - `registros` RetornoPedido[]
    - `codigoEmpresa` integer
    - `nomeEmpresa` string
    - `cliente` Cliente
      - `atualizar` boolean
      - `tipo` string
      - `cnpjCpf` string
      - `ieRg` string
      - `nome` string
      - `razao` string
      - `email` string
      - `telefoneDdd` string
      - `telefoneNumero` string
      - `endereco` Endereco
        - `entrega` boolean
        - `nomeContato` string
        - `email` string
        - `logradouro` string
        - `numero` string
        - `complemento` string
        - `bairro` string
        - `cidade` string
        - `codigoIbge` integer
        - `uf` string
        - `cep` string
    - `confirmada` boolean
    - `pendente` boolean
    - `statusWMS` integer
    - `situacaoWMS` integer
    - `statusConferencia` integer
    - `dataNegociacao` string
    - `dataHoraAlteracao` string
    - `numeroNota` integer
    - `codigoNota` integer
    - `serieNota` string
    - `codigoTipoNegociacao` integer
    - `nomeTipoNegociacao` string
    - `codigoTipoOperacao` integer
    - `nomeTipoOperacao` string
    - `codigoNatureza` integer
    - `nomeNatureza` string
    - `codigoCentroResultado` integer
    - `nomeCentroResultado` string
    - `codigoProjeto` integer
    - `nomeProjeto` string
    - `codigoContrato` integer
    - `codigoVendedor` integer
    - `nomeVendedor` string
    - `codigoContato` integer
    - `nomeContato` string
    - `codigoMoeda` integer
    - `nomeMoeda` string
    - `valorMoeda` number, double
    - `valorNota` number, double
    - `descontoTotal` number, double
    - `valorSeguro` number, double
    - `valorDestaque` number, double
    - `valorVendor` number, double
    - `valorJuro` number, double
    - `valorOutros` number, double
    - `valorEmbalagem` number, double
    - `valorFrete` number, double
    - `vencimentoFrete` string, date
    - `codigoOrdemCarga` integer
    - `codigoVeiculo` integer
    - `placaVeiculo` string
    - `codigoMotorista` integer
    - `nomeMotorista` string
    - `codigoTransportadora` integer
    - `nomeTransportadora` string
    - `codigoRemetente` integer
    - `nomeRemetente` string
    - `codigoDestinatario` integer
    - `nomeDestinatario` string
    - `quantidadeVolumes` integer
    - `numeracaoVolumes` string
    - `lacres` string
    - `pesoBruto` number, double
    - `cifFob` 1 | 2 | 3 | 4 | 5 | 6
    - `tipoFrete` 1 | 2
    - `baseICMSFrete` number, double
    - `icmsFrete` number, double
    - `reformaTributaria` ReformaTributaria
      - `valorCreditoPresumido` number, double
      - `valorCreditoPresumidoSuspensivaCBS` number, double
      - `valorCreditoPresumidoSuspensivaIBS` number, double
      - `valorTotalImposto` number, double
      - `valorDevolucaoCBS` number, double
      - `valorDevolucaoTributosIBSUF` number, double
      - `valorDevolucaoTributosMunicipio` number, double
      - `valorDiferimento` number, double
      - `valorDiferimentoIBSUF` number, double
      - `valorDiferimentoMunicipioIBS` number, double
      - `valorIBSUF` number, double
      - `valorIBSMunicipio` number, double
      - `valorImpostoSeletivo` number, double
      - `valorBaseCalculo` number, double
      - `valorTotalDocumento` number, double
    - `itens` PedidoDeVendasItemNfe[]
      - `sequencia` integer
      - `codigoProduto` integer
      - `descricaoProduto` string
      - `quantidade` number, double
      - `unidade` string
      - `valorUnitario` number, double
      - `valorTotal` number, double
      - `cfop` string
      - `ncm` string
      - `cst` string
      - `valorDesconto` number, double
      - `valorICMS` number, double
      - `valorIPI` number, double
      - `impostos` PedidoDeVendasImpostos[]
        - `tipo` 'icms' | 'icms-st' | 'ipi' | 'ibs' | 'cbs' | 'is' — Tipo do imposto.
        - `cst` string — Código de Situação Tributária.
        - `tributacaoMunicipio` string — Código de tributação do município. Utilizar como referencia a Tabela de Código de Classificação Tributária do IBS/CBS.
        - `classificacaoTributaria` integer — Código de Classificação Tributária. Utilizar como referencia a Tabela de Código de Classificação Tributária do IBS/CBS.
        - `aliquota` number, double — Aliquota do imposto
        - `aliquotaEfetivaRegular` number, double — Alíquota efetiva regular do CBS ou do IBS
        - `aliquotaUnidadeMedida` number, double — Alíquota específica por unidade de medida apropriada
        - `aliquotaEfetivaBaseCalculo` number, double — Alíquota Efetiva que será aplicada a Base de Cálculo
        - `reducaoAliquota` number, double — Percentual da redução de alíquota
        - `percentualFCP` number, double — Percentual do Fundo de Combate a Pobreza (FCP).
        - `percentualReducaoAliquotaGovernamental` number, double — Percentual da redução de alíquota Governamental
        - `percentualDiferimento` number, double — Percentual do diferimento
        - `valorBase` number, double — Valor da base de cálculo
        - `valorBaseReduzida` number, double — Valor Base Cálc.Reduzida (Já com reduções da Reforma aplicadas)
        - `valorImposto` number, double — Valor do imposto calculado
        - `valorFCP` number, double — Valor do Fundo de Combate a Pobreza (FCP).
        - `valorRegular` number, double — Valor do Regular do IBS ou do Município, de acordo com o tipo do imposto enviado.
        - `valorDiferimento` number, double — Valor do Diferimento
        - `valorTributoDevolvido` number, double — Valor do tributo devolvido
    - `financeiros` FinanceiroNfe[]
      - `sequencia` integer
      - `tipoPagamento` integer
      - `cheque` Cheque
        - `codigoBarras` string
        - `banco` string
        - `agencia` string
        - `conta` string
        - `numero` integer
        - `nome` string
        - `cnpjCpf` string
      - `cartao` Cartao
        - `bandeira` string
        - `autorizacao` integer
      - `dataVencimento` string
      - `dataBaixa` string
      - `valorParcela` number, double
      - `idTransacao` string

## Other responses

- `400` — Erro.
- `401` — Não autorizado.
- `500` — Erro interno.

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)
