Presence API - VENDAS

Presence API - VENDAS

Vendas

Este módulo é responsável por listar movimentações de vendas com faturamento.

Parâmetros
NomeObrigatório
Tipo
Descrição
dataInicio
SIM
Data (AAAA-MM-DDT00:00:00)
Data de atualização dos dados. Padrão ISO8601
dataFinal
SIM
Data (AAAA-MM-DDT00:00:00)
Data de atualização dos dados. Padrão ISO8601
loja
NÃO
Texto (2)
Código da loja onde a venda foi realizada
data
SIM
Data (AAAA-MM-DD)
Data de venda/movimentação no sistema. 
controle
SIM
Integer
Número do controle da venda gerado pelo sistema.
terminal
SIM
String
Número do terminal que foi realizado a movimentação.
modelo
NÃO quando informado o número do documento fiscal.
String
Modelo do documento fiscal (Nota emitida). Ex: 
55 - NF-e
serie
NÃO quando informado o número do documento fiscal.
String
Série utilizada na emissão do documento fiscal.
subserie
NÃO quando informado o número do documento fiscal.
String
Subsérie utilizada na emissão do documento fiscal.
numero
SIM
Integer
Número do documento fiscal emitido.
chaveAcesso
SIM
Integer
Chave de acesso gerada na emissão do documento fiscal.
seriePedido
SIM
String
Série do pedido referenciado na Presence.
numeroPedido
 SIM
Integer
Número do pedido referenciado na Presence.


Body
Consulta por data de atualização iniciar e final
  1. {
  2. "dataInicio": (Date, AAAA-MM-DDT00:00:00),
  3.         "dataFinal": (Date, AAAA-MM-DDT00:00:00)
  4. }
OU
  1. {
  2. "dataInicio": (Date, AAAA-MM-DDT00:00:00),
  3.         "dataFinal": (Date, AAAA-MM-DDT00:00:00),
  4.         "loja": (String)
  5. }

Consulta por data de venda
  1. {
  2.     "data": (Date, AAAA-MM-DD)
  3. }
OU
  1. {
  2.     "data": (Date, AAAA-MM-DD),
  3.     "loja": (String)
  4. }

Consulta por controle
  1. {
  2.     "controle": (Integer)
  3. }
OU
  1. {
  2.     "controle": (Integer),
  3.     "terminal": (Integer)
  4. }

Consulta por dados da NF-e
  1. {
  2.     "modelo": (String),
  3.     "serie": (String),
  4.     "subserie": (String),
  5.     "numero":  (Integer),
  6. }

Consulta por chave de acesso
  1. {
  2.     "chaveAcesso": (Integer)
  3. }

Consulta pelo número do pedido
  1. {
  2.     "seriePedido": (String),
  3.     "numeroPedido": (Integer)
  4. }

JSON de Retorno
  1. {
  2.     "status": "String",
  3.     "serverTime": "Date",
  4.     "versionCode": "Imteger",
  5.     "method": "String",
  6.     "data": [
  7.         {
  8.             "loja": "String"
  9.             "dataVenda": "Date",
  10.             "controle": "Integer",
  11.             "terminal": "Integer",
  12.             "situacao": "String",
  13.             "tipoNota": "String",
  14.             "tipoDocumento": "String",
  15.             "operacao": "String",
  16.             "coo": "Integer",
  17.             "ccf": "Integer",
  18.             "horaVenda": "Date",
  19.             "dataSaida": "Date",
  20.             "horaSaida": "Date",
  21.             "dataAtualizacao": "Date",
  22.             "notaTroca": "String",
  23.             "produtoServico": "String",
  24.             "observacaoContribuinte": "String",
  25.             "template": "String",
  26.             "finalidade": "String",
  27.             "integracaoPedido": "String",
  28.             "funcionarios": {
  29.                 "controleCaixa": "String",
  30.                 "nomeCaixa": "String"
  31.                 "controleVendedor": "String",
  32.                 "nomeVendedor": "String"
  33.                 "controleGerente": "String",
  34.                 "nomeGerente": "String",
  35.                 "controleRepresentante": "String",
  36.                 "nomeRepresentante": "String",
  37.                 "controleVendedorCancelamento": "String"
  38.             },
  39.             "valores": {
  40.                 "prcDesconto": "Double",
  41.                 "descontoPercentual": "Double",
  42.                 "descontoCortesia": "Double",
  43.                 "descontoCortesiaDesvio": "Double",
  44.                 "descontoCondicionalVenda": "Double",
  45.                 "descontoCondicionalItem": "Double",
  46.                 "descontoItem": "Double",
  47.                 "descontoProgressivo": "Double",
  48.                 "valorDescontoVenda": "Double",
  49.                 "percentualDescontoVenda": "Double",
  50.                 "descontoAniversariante": "Double",
  51.                 "descontoDevolucao": "Double",
  52.                 "descontoVoucher": "Double",
  53.                 "encargos": "Double",
  54.                 "acrescimos": "Double",
  55.                 "frete": "Double",
  56.                 "seguro": "Double",
  57.                 "tac": "Double",
  58.                 "devolucoes": "Double",
  59.                 "outrasDepesas": "Double",
  60.                 "valorCreditoEfetivado": "Double",
  61.                 "valorLiquido": "Double",
  62.                 "valorBruto": "Double",
  63.                 "valorTotalProdutos": "Double",
  64.                 "valorTotalServicos": "Double",
  65.                 "valorTotalNotaFiscal": "Double"
  66.                 "valorTotalVenda": "Double",
  67.                 "valorTotalFaturado": "Double"
  68.             },
  69.             "dadosNF": {
  70.                 "modelo": "String",
  71.                 "serie": "String",
  72.                 "numero": "Integer",
  73.                 "dataTransmissao": "Date",
  74.                 "chaveAcesso": "Integer",
  75.                 "reciboLote": "Integer",
  76.                 "numeroProtocolo": "Integer",
  77.                 "layout": "Double",
  78.                 "ambiente": "Integer",
  79.                 "verAplicacao": "String",
  80.                 "dataRecibo": "Date",
  81.                 "digVal": "String",
  82.                 "codigoStatus": "Integer",
  83.                 "motivo": "String",
  84.                 "modoEmissao": "String",
  85.                 "indicadaoIntermediador": "String",
  86.                 "indicadorPresenca": "String",
  87.                 "consumidorFinal": true/false,
  88.                 "identificarCliente": true/false
  89.             },
  90.             "contigencia": {},
  91.             "destinatario": {
  92.                 "tipo": "String",
  93.                 "lojaCliente": "String",
  94.                 "codigo": "Integer",
  95.                 "endereco": "String",
  96.                 "numero": "String",
  97.                 "complemento": "String",
  98.                 "bairro": "String",
  99.                 "cidade": "String",
  100.                 "cep": "Integer",
  101.                 "uf": "String",
  102.                 "pais": "String",
  103.                 "dddCelular": "Integer",
  104.                 "celular": "Integer"
  105.             },
  106.             "impostos": {
  107.                 "aliquotaSimples": "Double",
  108.                 "icms": {
  109.                     "base": "Double",
  110.                     "valor": "Double",
  111.                     "baseST": "Double",
  112.                     "valorST": "Double",
  113.                     "destinoValorFcp": "Double",
  114.                     "destinoValorInterestadual": "Double",
  115.                     "remetenteValorInterestadual": "Double",
  116.                     "baseCreditoSimples": "Double",
  117.                     "valorCreditoSimples": "Double",
  118.                     "valorDesnonerado": "Double",
  119.                     "impostoAcumulado": "Double"
  120.                 },
  121.                 "ipi": {
  122.                     "valor": "Double"
  123.                 },
  124.                 "pis": {
  125.                     "aliquota": "Double",
  126.                     "valor": "Double",
  127.                     "valorST": "Double",
  128.                     "valorRetido": "Double",
  129.                     "calculo": true/false
  130.                 },
  131.                 "cofins": {
  132.                     "aliquota": "Double",
  133.                     "valor": "Double",
  134.                     "valorST": "Double",
  135.                     "valorRetido": "Double"
  136.                 },
  137.                 "ii": {
  138.                     "base": "Double",
  139.                     "valor": "Double"
  140.                 },
  141.                 "iss": {
  142.                     "aliquota": "Double",
  143.                     "base": "Double",
  144.                     "valor": "Double"
  145.                 },
  146.                 "csl": {
  147.                     "aliquota": "Double",
  148.                     "valor": "Double"
  149.                 },
  150.                 "irrf": {
  151.                     "aliquota": "Double",
  152.                     "valor": "Double"
  153.                 },
  154.                 "fcp": {
  155.                     "valor": "Double",
  156.                     "valorST": "Double",
  157.                     "valorStRetido": "Double"
  158.                 },
  159.                 "inss": {
  160.                     "aliquota": "Double",
  161.                     "valor": "Double"
  162.                 },
  163.                 "csrf": {
  164.                     "aliquota": "Double",
  165.                     "valor": "Double"
  166.                 },
  167.                 "das": {
  168.                     "aliquota": "Double",
  169.                     "valor": "Double"
  170.                 }
  171.             },
  172.             "entrega": {
  173.                 "nome": "String"
  174.                 "endereco": "String",
  175.                 "numero": "String",
  176.                 "complemento": "String",
  177.                 "bairro": "String",
  178.                 "cidade": "String",
  179.                 "cep": "Integer",
  180.                 "uf": "String",
  181.                 "pais": "String",
  182.                 "dddCelular": "Integer",
  183.                 "celular": "Integer",
  184.                 "transporte": {
  185.                     "tipoFrete": "String",
  186.                     "freteCalculado": true/false,
  187.                     "quantidadeVolume": "Double",
  188.                     "pesoBrutoVolume": "Double",
  189.                     "pesoLiquidoVolume": "Double"
  190.                 }
  191.             },
  192.             "devolucao": {
  193.                 "notaFiscalDevolucao": "Double",
  194.                 "controleVendaOriginal": "Double",
  195.                 "terminalVendaOriginal": "Double"
  196.             },
  197.             "deOlhoNoImposto": {
  198.                 "valorMunicipal": "Double",
  199.                 "valorEstadual": "Double",
  200.                 "valorFederal": "Double"
  201.             },
  202.             "fidelidade": {
  203.                 "pontos": "Double",
  204.                 "valor": "Double",
  205.                 "codigoIntegracao": "Double",
  206.                 "campanha": "Double",
  207.                 "pin": true/false
  208.             },
  209.             "financeiro": {},
  210.             "importacoes": {
  211.                 "volumeMercadoria": "Integer",
  212.                 "controleNotaRecebimento": "Integer"
  213.             },
  214.             "gnre": {
  215.                 "agrupado": true/false,
  216.                 "controleTituloST": "Integer",
  217.                 "controleTituloDifal": "Integer",
  218.                 "controleTituloFcp": "Integer"
  219.             },
  220.             "usuario": {
  221.                 "codigo": "Double"
  222.             },
  223.             "ecommerce": {},
  224.             "lavanderia": {
  225.                 "controleEntregador": "Double",
  226.                 "plano": "String"
  227.             },
  228.             "itens": [
  229.                 {
  230.                     "controleItem": "String",
  231.                     "sequencia": "Integer",
  232.                     "transacao": "String",
  233.                     "dataAtualizacao": "String",
  234.                     "situacao": "S/N",
  235.                     "codigoSituacao": "String",
  236.                     "devolucaoResolvido": true/false,
  237.                     "controleFuncionario": "String",
  238.                     "produto": {
  239.                         "codigo": "String",
  240.                         "descricao": "String",
  241.                         "tamanho": "String",
  242.                         "cor": "String",
  243.                         "quantidade": "Double",
  244.                         "precoUnitario": "Double",
  245.                         "codigoItemKit": "Double",
  246.                         "precoMedio": "Double",
  247.                         "precoMedioInd": "Double",
  248.                         "margem": "Double",
  249.                         "margemInd": "Double",
  250.                         "precoTabela": "Double"
  251.                     },
  252.                     "valores": {
  253.                         "descontoItem": "Double",
  254.                         "descontoPercentual": "Double",
  255.                         "desconto": "Double",
  256.                         "descontoProgressivo": "Double",
  257.                         "descontoCondicionalVenda": "Double",
  258.                         "descontoCondicionalItem": "Double",
  259.                         "descontoDoItem": "Double",
  260.                         "acrescimo": "Double",
  261.                         "frete": "Double",
  262.                         "seguro": "Double",
  263.                         "outrasDespesas": "Double",
  264.                         "tac": "Double",
  265.                         "precoLiquido": "Double",
  266.                         "totalLiquido": "Double",
  267.                         "valorVenda": "Double"
  268.                     },
  269.                     "impostos": {
  270.                         "ncm": "Integer",
  271.                         "cfop": "Integer",
  272.                         "valorINSS": "Double",
  273.                         "valorDAS": "Double",
  274.                         "icms": {
  275.                             "tributacao": "String",
  276.                             "codigoSituacaoTributaria": "Integer",
  277.                             "aliquota": "Double",
  278.                             "baseCalculo": "Double",
  279.                             "valor": "Double",
  280.                             "fatorBase": "Double",
  281.                             "percentualST": "Double",
  282.                             "mvaST": "Double",
  283.                             "percentualReducaoBaseST": "Double",
  284.                             "baseST": "Double",
  285.                             "aliquotaST": "Double",
  286.                             "valorST": "Double",
  287.                             "baseSTRet": "Double",
  288.                             "valorRetST": "Double",
  289.                             "stRet": "Double",
  290.                             "csosn": "Integer",
  291.                             "destBase": "Double",
  292.                             "destAliquotaFCP": "Double",
  293.                             "destAliquotaInterna": "Double",
  294.                             "destAliquotaInterestadual": "Double",
  295.                             "destPercentualPartilha": "Double",
  296.                             "destValorFCP": "Double",
  297.                             "destValorInterestadual": "Double",
  298.                             "remetValorInterestadual": "Double",
  299.                             "valorDesonerado": "Double",
  300.                             "substituto": "Double",
  301.                             "baseCreditoSimples": "Double",
  302.                             "valorCreditoSimples": "Double",
  303.                             "aliquotaImpostoAcumulado": "Double",
  304.                             "valorImpostoAcumulado": "Double",
  305.                             "estimativaSimplicado": true/false,
  306.                             "indiceTotalizador": "Integer"
  307.                         },
  308.                         "ipi": {
  309.                             "tributacao": "String",
  310.                             "ipi": "Double",
  311.                             "situacaoTributaria": "String",
  312.                             "baseCalculo": "Double",
  313.                             "aliquota": "Double",
  314.                             "valor": "Double",
  315.                             "enquadramento": "Double"
  316.                         },
  317.                         "pis": {
  318.                             "tributacao": "String",
  319.                             "situacaoTributaria": "Double",
  320.                             "baseCalculo": "Double",
  321.                             "aliquota": "Double",
  322.                             "valor": "Double",
  323.                             "aliquotaValor": "Double",
  324.                             "baseCalculoST": "Double",
  325.                             "aliquotaST": "Double",
  326.                             "valorST": "Double",
  327.                             "aliquotaValorST": "Double"
  328.                         },
  329.                         "cofins": {
  330.                             "tributacao": "String",
  331.                             "situacaoTributaria": "Integer",
  332.                             "baseCalculo": "Double",
  333.                             "aliquota": "Double",
  334.                             "valor": "Double",
  335.                             "aliquotaValor": "Double",
  336.                             "baseCalculoST": "Double",
  337.                             "aliquotaST": "Double",
  338.                             "valorST": "Double",
  339.                             "aliquotaValorST": "Double"
  340.                         },
  341.                         "iss": {
  342.                             "tributacao": "String",
  343.                             "iss": "Double",
  344.                             "situacaoTributaria": "Integer",
  345.                             "baseCalculo": "Double",
  346.                             "aliquota": "Double",
  347.                             "valor": "Double",
  348.                             "retido": true/false
  349.                         },
  350.                         "ii": {
  351.                             "aliquota": "Double",
  352.                             "valor": "Double",
  353.                             "baseCalculo": "Double"
  354.                         },
  355.                         "fcp": {
  356.                             "baseCalculo": "Double",
  357.                             "aliquota": "Double",
  358.                             "valor": "Double",
  359.                             "baseCalculoST": "Double",
  360.                             "aliquotaST": "Double",
  361.                             "valorST": "Double",
  362.                             "baseCalculoRET": "Double",
  363.                             "aliquotaRET": "Double",
  364.                             "valorRET": "Double"
  365.                         }
  366.                     },
  367.                     "deOlhoNoImposto": {
  368.                         "aliquotaMunicipal": "Double",
  369.                         "aliquotaEstadual": "Double",
  370.                         "aliquotaFederal": "Double",
  371.                         "valorMunicipal": "Double",
  372.                         "valorEstadual": "Double",
  373.                         "valorFederal": "Double"
  374.                     },
  375.                     "devolucao": {
  376.                         "numeroOriginal": "Integer",
  377.                         "ordemEcfOriginal": "Integer"
  378.                     },
  379.                     "fidelidade": {
  380.                         "ponto": "Double",
  381.                         "valor": "Double"
  382.                     },
  383.                     "vinculos": {
  384.                         "volumeMercadoria": "Integer",
  385.                         "ordemCompraItem": "Integer",
  386.                         "varianteOrdemProducao": "Double",
  387.                         "seriePedido": "String",
  388.                         "numeroPedido": "Integer",
  389.                         "itemPedido": "Integer",
  390.                         "controleVendaVinculada": "Double",
  391.                         "terminalVendaVinculada": "Double"
  392.                     }
  393.                 }
  394.             ],
  395.             "parcelas": [
  396.                 {
  397.                     "parcela": Integer,
  398.                     "codigoCondicaoPagamento": "String",
  399.                     "condicaoPagamento": "String",
  400.                     "moeda": "String",
  401.                     "transacao": "Integer",
  402.                     "transacaoParcela": "Integer",
  403.                     "dataVencimentoOriginal": "Date",
  404.                     "dataVencimento": "Date",
  405.                     "valor": "Double",
  406.                     "encargos": "Double",
  407.                     "banco": "Double",
  408.                     "controleTitulo": "Integer",
  409.                     "controleTituloTaxa": "Integer",
  410.                     "liquidado": true/false,
  411.                     "valorTroco": "Double",
  412.                     "estadoCobranca": "Double",
  413.                     "codigoAdminstradora": "Double",
  414.                     "vendaTef": "String",
  415.                     "integracaoPedido": true/false,
  416.                     "sinal": true/false,
  417.                     "dataTransmissaoVFPE": "Date",
  418.                     "percentualTaxaCartao": "Double",
  419.                     "controleVendaVinculada": "Double",
  420.                     "terminalVendaVinculada": "Double",
  421.                     "parcelaVendaVinculada": "Double",
  422.                     "controleVendedorPagamento": "Double",
  423.                     "terminalPagamento": "Integer",
  424.                     "lojaPagamentoC": "String",
  425.                     "dataPagamentoC": "Date",
  426.                     "terminalPagamentoC": "Integer"
  427.                 }
  428.             ]
  429.         }
  430.     ]
  431. }
Observação:  Endpoint para uso /integracao

    • Related Articles

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

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