--- title: "Consultar Pedido de Venda por Código" method: GET path: "/v1/vendas/pedidos/{codigoPedido}" tags: ["Vendas Pedidos"] --- # Consultar Pedido de Venda por Código `GET /v1/vendas/pedidos/{codigoPedido}` ## Request - Base URL: `https://api.sankhya.com.br` - URL: `https://api.sankhya.com.br/v1/vendas/pedidos/{codigoPedido}` - Auth: API key in header `Authorization` Consulta um pedido de venda específico retornando todos os dados do pedido confirmado. ## Path parameters - `codigoPedido` integer, required ## Response `200` Operação bem sucedida - 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` PedidoDeVendasFinanceiroNfe[] - `sequencia` integer - `tipoPagamento` integer - `cheque` Cheque - `codigoBarras` string - `banco` string - `agencia` string - `conta` string - `numero` integer - `nome` string - `cnpjCpf` string - `cartao` Cartao - `bandeira` '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '99' - `autorizacao` integer - `dataVencimento` string - `dataBaixa` string - `valorParcela` number, double - `idTransacao` string ## Other responses - `400`: Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `401`: Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `403`: Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `404`: Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `409`: Conflito. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `500`: Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `501`: Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `502`: Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `503`: Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. - `504`: Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes. ## Changes - **2026-11-03** `b3c833e7aab1`: 1 info - endpoint added [Operation history](https://skmtc.dev/sankhya/apis/api-sankhya/changes/v1/vendas/pedidos/:codigoPedido/get.md) --- [API](https://skmtc.dev/sankhya/apis/api-sankhya.md) - [All operations](https://skmtc.dev/sankhya/apis/api-sankhya/llms.txt) - [OpenAPI document](https://skmtc.dev/sankhya/apis/api-sankhya/revisions/b3c833e7aab1?raw)