v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB
Vendas Pedidos

Consultar Pedidos de Venda

get/v1/vendas/pedidos

Query parameters

pageinteger required
Example:1

Informe neste atributo a "página" desejada

modifiedSincestring
Example:2025-01-28T16:24:00

Data hora da ultima modificação. Quando este parametro é enviado, o serviço retorana apenas registros que tiveram modificação deste da data/hora enviada. Vale ressaltar que este recurso é condicionada a utilização do Log de Alterações no SankhyaOm no ambiente do cliente. O formato deve ser o seguinte: AAAA-MM-DDTHH:MM:SS

codigoEmpresainteger required
Example:1

Código da Empresa (Escopo Obrigatório)

codigoNotainteger
Example:12540

Código Interno da Nota (NUNOTA).

numeroNotainteger
Example:254100

Número da Nota Fiscal (NUMNOTA).

serieNotastring
Example:1

Série da Nota

dataNegociacaoIniciostring
Example:10/02/2025

Data inicial (dd/mm/aaaa)

dataNegociacaoFinalstring
Example:20/02/2025

Data final (dd/mm/aaaa)

codigoClienteinteger

Código do Cliente (Parceiro)

confirmadaboolean
Example:true

Nota Confirmada?

pendenteboolean

Nota Pendente?

statusWMS1 | 2 | 3 | 4 | 5 | 6
Example:2

Status WMS

situacaoWMS1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22
Example:17

Situação WMS

statusConferencia1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11
Example:6

Status Conferência

codigoNaturezainteger
Example:30100

Código da Natureza (CODNAT)

codigoCentroResultadointeger
Example:202

Código do CR

codigoProjetointeger

Código do Projeto

codigoContratointeger
Example:159

Código do Contrato

codigoOrdemCargainteger
Example:55412

Código da Ordem de Carga

Response

Sucesso.

Example response

{
  "metadados": {
    "paginaAtual": 1,
    "totalPaginas": 12,
    "totalRegistros": 580,
    "possuiMaisPaginas": true
  },
  "registros": [
    {
      "codigoEmpresa": 1,
      "nomeEmpresa": "Sankhya Gestão de Negócios Matriz",
      "cliente": {
        "tipo": "PF",
        "cnpjCpf": "12315914799",
        "ieRg": "12315914799",
        "nome": "José da Silva",
        "razao": "José da Silva ME",
        "email": "contato@provedor.com.br",
        "telefoneDdd": "34",
        "telefoneNumero": "912349966",
        "endereco": {
          "entrega": true,
          "nomeContato": "Maria Roberta",
          "email": "maria.roberta@provedor.com.br",
          "logradouro": "Rua Maria Roberta",
          "numero": "10",
          "complemento": "Apto 104",
          "bairro": "Centro",
          "cidade": "Uberlândia",
          "codigoIbge": 11155566,
          "uf": "MG",
          "cep": "38400000"
        }
      },
      "confirmada": true,
      "statusWMS": 2,
      "situacaoWMS": 17,
      "statusConferencia": 6,
      "dataNegociacao": "15/06/2024",
      "dataHoraAlteracao": "15/06/2024 14:45:30",
      "numeroNota": 254100,
      "codigoNota": 12540,
      "serieNota": "1",
      "codigoTipoNegociacao": 110,
      "nomeTipoNegociacao": "Venda de Mercadoria Nacional",
      "codigoTipoOperacao": 1200,
      "nomeTipoOperacao": "Venda Estadual de Produção Própria",
      "codigoNatureza": 30100,
      "nomeNatureza": "Venda de Produção do Estabelecimento",
      "codigoCentroResultado": 10100,
      "nomeCentroResultado": "Departamento Comercial SP",
      "codigoProjeto": 202401,
      "nomeProjeto": "Expansão Sudeste 2024",
      "codigoContrato": 4502,
      "codigoVendedor": 55,
      "nomeVendedor": "Carlos Eduardo Silva",
      "codigoContato": 302,
      "nomeContato": "Maria Paula",
      "nomeMoeda": "Real",
      "valorNota": 5450,
      "descontoTotal": 250,
      "valorSeguro": 45,
      "valorOutros": 85,
      "valorEmbalagem": 20,
      "valorFrete": 180,
      "vencimentoFrete": "2024-07-15",
      "codigoOrdemCarga": 995512,
      "codigoVeiculo": 45,
      "placaVeiculo": "ABC-1234",
      "codigoMotorista": 102,
      "nomeMotorista": "Roberto Mendes",
      "codigoTransportadora": 800,
      "nomeTransportadora": "Expresso Logística Rápida",
      "codigoRemetente": 1,
      "nomeRemetente": "Sankhya Gestão de Negócios Matriz",
      "codigoDestinatario": 20500,
      "nomeDestinatario": "Tech Solutions Comercio e Servicos LTDA",
      "quantidadeVolumes": 12,
      "numeracaoVolumes": "1/12 a 12/12",
      "lacres": "LACRE-001254",
      "pesoBruto": 245.5,
      "cifFob": 1,
      "tipoFrete": 2,
      "baseICMSFrete": 180,
      "icmsFrete": 21.6,
      "reformaTributaria": {
        "valorTotalImposto": 1325,
        "valorIBSUF": 662.5,
        "valorIBSMunicipio": 150,
        "valorBaseCalculo": 5000,
        "valorTotalDocumento": 6325
      },
      "itens": [
        {
          "sequencia": 1,
          "codigoProduto": 1050,
          "descricaoProduto": "Notebook Gamer i7 16GB",
          "quantidade": 2,
          "unidade": "UN",
          "valorUnitario": 2500,
          "valorTotal": 5000,
          "cfop": "5101",
          "ncm": "84714100",
          "cst": "000",
          "valorDesconto": 100,
          "valorICMS": 900,
          "valorIPI": 250,
          "impostos": [
            {
              "tipo": "ibs",
              "cst": "00",
              "tributacaoMunicipio": "140801",
              "classificacaoTributaria": 200,
              "aliquota": 26.5,
              "aliquotaEfetivaRegular": 26.5,
              "aliquotaEfetivaBaseCalculo": 26.5,
              "percentualReducaoAliquotaGovernamental": 60,
              "percentualDiferimento": 10,
              "valorBase": 1000,
              "valorBaseReduzida": 400,
              "valorImposto": 106,
              "valorRegular": 106,
              "valorDiferimento": 10.6
            }
          ]
        }
      ],
      "financeiros": [
        {
          "sequencia": 1,
          "tipoPagamento": 19,
          "cheque": {
            "codigoBarras": "341067330330018805201725766099",
            "banco": "341",
            "agencia": "0673",
            "conta": "576609",
            "numero": 1880,
            "nome": "José da Silva Souza",
            "cnpjCpf": "14532515955"
          },
          "cartao": {
            "bandeira": "02",
            "autorizacao": 4581596
          },
          "dataVencimento": "30/05/2024",
          "dataBaixa": "30/05/2024",
          "valorParcela": 3.38,
          "idTransacao": "dadotiuiwnlkeuhcnhlahdiwlaoaokd48ge55x"
        }
      ]
    }
  ]
}