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  "P" (Pre-Nota) 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.             "codigoTransportadora": (String),
  27.             "fantasiaTransportadora":  (String),  
  28.             "controle": Integer,
  29.             "terminal": Integer,
  30.             "idCompra": (String),
  31.             "nomeLoja": (String),
  32.             "nomeFantasiaLoja": (String),  
  33.             "codigoVendedor": Integer,
  34.             "nomeVendedor": (String),
  35.             "subtotal": Double,
  36.             "totalDesconto": Double,
  37.             "totalFrete": Double,
  38.             "totalSeguro": Double,
  39.             "totalOutrasDespesas": Double,
  40.             "totalIcmsValorSt": Double,
  41.             "totalFcpValorSt": Double,
  42.             "totalIpi": Double,   
  43.             "total": Double,
  44.             "fidelidadePontos": Double,
  45.             "fidelidadeValor": Double,
  46.             "dataAt": (Datetime, AAAA-MM-DD 00:00:00.000),
  47.             "integracaoNoPedido": (String),
  48.             "tipoLoja": (String),
  49.             "operacaoProduto": (String),
  50.             "tipoNota": ("S" (Saída) ou "E" (Entrada)),
  51.             "modelo": (65 (NFC-e) ou 55 (NF-e) ou 51 (NFS-e) ou 59 (CF-e)),
  52.             "modeloDescricao": (String),
  53.             "serieNf": (String),
  54.            "subserieNf": (String),
  55.             "quantidadeTotalProduto": Double,
  56.             "numero": Integer
  57.         }
  58.     ]
  59. }

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".