Presence API - VENDAS_HEADER

Presence API - VENDAS_HEADER

Cabeçalho das Vendas

Este módulo é responsável por listar o cabeçalho das vendas da base da dados.

Parâmetros

Nome
 Obrigatório
 Tipo
 Descrição
data_at
 SIM quando não informada data_ini
 Data (AAAA-MM-DDT00:00:00)
 Data de atualização dos dados. Padrão ISO8601.
data_ini
 SIM quando não informada data_at
 Data (AAAA-MM-DDT00:00:00)
 Data inicial que as vendas foram realizadas. Padrão ISO8601.
data_fim
 SIM quando informada data_ini
 Data (AAAA-MM-DDT00:00:00)
 Data final que as vendas foram realizadas. Padrão ISO8601.
loja
Não
String
Código da Loja
tipo_nota
Não
String
"S" (Operações de Saída) ou "E" (Operações de Entrada). Padrão: Todas;
situacao
Não
String
"E" (Emitidas) ou "C" (Canceladas) ou "I" (Inutilizadas) ou "R" (Retificada) ou "T" (Todas). Padrão: "E" (Emitidas).

BODY
  1. {
  2.   "data_at" : (Date, AAAA-MM-DD) ou (Date, AAAA-MM-DDT00:00:00)
  3. }
OU
  1. {
  2.   "data_ini" : (Date, AAAA-MM-DD) ou (Date, AAAA-MM-DDT00:00:00),
  3.   "data_fim" : (Date, AAAA-MM-DD) ou (Date, AAAA-MM-DDT00:00:00)
  4. }

JSON de Retorno
  1. {
  2.     "status": (String),
  3.     "method": (String),
  4.     "nextOffset": Integer,         
  5.     "data": [
  6.         {
  7.             "situacaoVenda": (Emitida/Cancelada/Inutilizada/Retificada/Denegada);
  8.             "clienteCodigo": (String),
  9.             "clienteNome": (String),
  10.             "clienteFantasia": (String),
  11.             "clienteEmail": (String),
  12.             "cpfCnpj": (String),
  13.             "clientePessoa": (String),
  14.             "clienteSexo": (String),
  15.             "clienteNascimento": (Date, AAAA-MM-DD)
  16.             "clienteTelefone": (String),
  17.             "clienteEndereco": (String),
  18.             "clienteNumero": (String),
  19.             "clienteComplemento": (String),
  20.             "clienteBairro": (String),
  21.             "clienteCidade": (String),
  22.             "clienteEstado": (String),
  23.             "clienteCep": (String),
  24.             "idLoja": (String),
  25.             "dataCompra": (Date, AAAA-MM-DD)
  26.             "controle": Integer,
  27.             "terminal": Integer,
  28.             "idCompra": (String),
  29.             "nomeLoja": (String),
  30.             "nomeFantasiaLoja": (String),  
  31.             "codigoVendedor": Integer,
  32.             "nomeVendedor": (String),
  33.             "subtotal": Double,
  34.             "totalDesconto": Double,
  35.             "totalFrete": Double,
  36.             "totalSeguro": Double,
  37.             "totalOutrasDespesas": Double,
  38.             "totalIcmsValorSt": Double,
  39.             "totalFcpValorSt": Double,
  40.             "totalIpi": Double,   
  41.             "total": Double,
  42.             "fidelidadePontos": Double,
  43.             "fidelidadeValor": Double,
  44.             "dataAt": (Datetime, AAAA-MM-DD 00:00:00.000),
  45.             "integracaoNoPedido": (String),
  46.             "tipoLoja": (String),
  47.             "operacaoProduto": (String),
  48.             "tipoNota": ("S" (Saída) ou "E" (Entrada)),
  49.             "modelo": (65 (NFC-e) ou 55 (NF-e) ou 51 (NFS-e) ou 59 (CF-e)),
  50.             "modeloDescricao": (String),
  51.             "quantidadeTotalProduto": Double,
  52.             "numero": Integer
  53.         }
  54.     ]
  55. }

Info Para diferenciar uma venda e uma devolução/troca, depois critérios podem ser observados:
  1. em VENDAS_ITENS, a propriedade "total" terá um valor negativo em devoluções/trocas;
  2. em VENDAS_PAGAMENTOS, a propriedade "metodoPagamento" terá valor "DEVOLUCAO".


    • Related Articles

    • Presence API - Página Inicial

      Essa API permite o consumo de informações disponíveis nos sistemas Presence através de chamadas de serviço, bem como a inserção de dados nos sistemas. Para ter acesso aos métodos já existentes, ou solicitação da criação de novos métodos, consulte as ...

    • Releases Notes Presence API

      Versão Presence WebAPI 1.0.75.0 (29/08/2025) #644962 Criação de método para entrada de estoque e EPC via API - Implementado novo método INCLUIR_EPC_SKU para incluir códigos EPC via API. - Poderão ser incluídos até 1000 EPC's por requisição. - ...

    • Presence API - VENDAS_ITENS

      Itens das Vendas Este módulo é responsável por listar os itens relativos as vendas da base da dados. Parâmetros Nome Obrigatório Tipo Descrição data_at (1) ** Data (AAAA-MM-DDT00:00:00) Data de atualização dos dados. Retorna maiores ou iguais. Padrão ...

    • Presence API - VENDAS_PAGAMENTOS

      Pagamentos das Vendas Este módulo é responsável por listar os tipos de pagamentos das vendas da base da dados. Parâmetros Nome Obrigatório Tipo Descrição loja Não Texto(2) Código da Loja dt_mov Não Texto Data de movimento da venda. Padrão ISO8601. ...

    • Presence API - VENDAS_PAGAMENTOS2

      Pagamentos das Vendas Este módulo é responsável por listar os tipos de pagamentos das vendas da base da dados. Parâmetros Nome Obrigatório Tipo Descrição loja Não Texto(2) Código da Loja dt_mov Não Texto Data de movimento da venda. Padrão ISO8601. ...