Presence API - VENDAS_ITENS

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 ISO8601.
data_ini (2)
**
Data (AAAA-MM-DDT00:00:00)
Data de movimento da venda.
Retorna maiores ou iguais.
Padrão ISO8601.
data_fim (2)
**
Data (AAAA-MM-DDT00:00:00)
Data de movimento da venda.
Retorna menores ou iguais.
Padrão ISO8601.
loja (3) (4)
**Texto(2)Código da Loja
dt_mov (4)
**
Data (AAAA-MM-DD)
Data de movimento da venda. Padrão ISO8601.
controle (4)
**
Inteiro
Controle da venda.
terminal (4)
**
Inteiro
Terminal da venda.

** Orientação:
  1. Os números entre parênteses representam o conjunto de parâmetros que podem ser usados juntos ou isoladamente.
  2. O grupo (1) pode ser nulo.
  3. O grupo (2) pode ser nulo, mas se uma data for informada, a outra também deve ser.
  4. O grupo (3) pode ser nulo.
  5. O grupo (4) pode ser nulo, mas se um dos campos for informados, todos também devem ser.

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. }
OU

  1. {
  2.   "loja" : (String, 2),
  3.   "dt_mov" : (Date, AAAA-MM-DD),
  4.   "controle" : (Integer),
  5.   "terminal" : (Integer)
  6. }
​
JSON de Retorno

  1. {
  2.     "status": "ok",
  3.     "serverTime": (Date, AAAA-MM-DDT00:00:00),
  4.     "versionCode": Integer,
  5.     "method": "VENDAS_ITENS",
  6.     "data": [
  7.         {
  8.             "situacaoVenda": (Emitida/Cancelada/Inutilizada/Retificada/Denegada);,
  9.             "idCompra": String,
  10.             "seriePedido": Integer,
  11.             "numeroPedido": Integer,
  12.             "controleItem": Integer,
  13.             "idProduto": String,
  14.             "nomeProduto": String,
  15.             "quantidadeProduto": Double,
  16.             "precoUnitario": Double,
  17.             "desconto": Double,
  18.             "acrescimo": Double,
  19.             "frete": Double,
  20.             "seguro": Double,
  21.             "outrasDespesas": Double,
  22.             "icmsVlrSt": Double,
  23.             "fcpValorSt": Double,
  24.             "ipiValor": Double,
  25.             "precoCusto": Double,
  26.             "precoLiquido": Double,**
  27.             "transacao": ("V" (Venda) ou "D" (Devolução)),  
  28.             "codigoCategoria": String,
  29.             "categoriaProduto": String,
  30.             "codigoSubcategoria": String,
  31.             "subcategoriaProduto": String,
  32.             "corProduto": String,
  33.             "tamanhoProduto": String,
  34.             "idLoja": String,
  35.             "lojaNome": String,
  36.             "lojaFantasia": String,
  37.             "dataCompra": (Date, AAAA-MM-DDT00:00:00),
  38.             "controle": Integer,
  39.             "terminal": Integer,
  40.             "vendedorControle": Integer,
  41.             "vendedorNome": String,
  42.             "codigo": String,
  43.             "codigoLinha": String,
  44.             "linhaProduto": String,
  45.             "codigoColecao": String,
  46.             "colecaoProduto": String,
  47.             "codigoMarca": Integer,
  48.             "marca": String,
  49.             "referenciaFornecedor": String,
  50.             "fidelidadePontos": Double,
  51.             "fidelidadeValor": Double,
  52.             "dataAtualizacao": (Date, AAAA-MM-DDT00:00:00),
  53.             "participaFidelidade": String,
  54.             "numero": Integer
  55.         }
  56.     ]
  57. }
**Composição do campo precoLiquido:
Venda: precoUnitario * quantidadeProduto - desconto + acrescimo + frete + ipiValor
Devolução: precoUnitario * quantidadeProduto + desconto + acrescimo + frete + ipiValor

Validação no Presence Domain

  1. Totalizado:
    1. Relatório de Lucratividade
  1. Detalhado:
    1. Relatório de Faturamento (considerar somente vendas)



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

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

    • Presence API - RESUMO-DOCUMENTO-ELETRONICO

      Resumo documento eletrônico Este módulo é responsável por listar o cabeçalho e itens de vendas que foram emitidas por documento fiscal eletrônico que possuem chave de acesso. Parâmetros Nome Obrigatório Tipo Descrição chave_acesso Sim String (44) ...

    • Presence API - VENDAS

      Vendas Este módulo é responsável por listar movimentações de vendas com faturamento. Parâmetros Nome Obrigatório Tipo Descrição dataInicio SIM Data (AAAA-MM-DDT00:00:00) Data de atualização dos dados. Padrão ISO8601 dataFinal SIM Data ...

    • Releases Notes Presence API

      Versão Presence WebAPI 1.0.82.0 (05/12/2025) #658748 - Presence API - Criar Produto - "API Napp" - Implementação para liberação de métodos por usuário e por pacotes (grupo com métodos e usuários). Ao gerar o token, passará a validar se o usuário tem ...