Presence API - VENDAS

Presence API - VENDAS

Vendas

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


Info
Observação: Para usar consultar este endpoint é necessário a usar a URL abaixo: 


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 quando tag informada e usada como filtroString
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.
CPF_CNPJ
NÃO
INTEGER
Documento de identificação do destinatário da documento fiscal emitido. Informar apenas números.
Pessoa Física - CPF
Pessoa Jurídica - CNPJ
seriePedido
SIM
String
Série do pedido referenciado na Presence.
numeroPedido
 SIM
Integer
Número do pedido referenciado na Presence.
codigoExterno
NÃO
String
Código externo do pedido.


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),
            "CPF_CNPJ": (Integer)
  4. }
OU
  1. {
  2. "dataInicio": (Date, AAAA-MM-DDT00:00:00),
  3.         "dataFinal": (Date, AAAA-MM-DDT00:00:00),
  4.         "loja": (String)
  5. }
OU
  1. {
  2. "dataInicio": (Date, AAAA-MM-DDT00:00:00),
  3.         "dataFinal": (Date, AAAA-MM-DDT00:00:00),
            "codigoExterno": (String)
  4. }

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 por CPF ou CNPJ
  1. {
  2.     "CPF_CNPJ": (Integer)
  3. }

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

Consulta por código externo do pedido
  1. {
  2.     "codigoExterno": (String)
  3. }


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.             "pedidosVinculados": [
  430.                 {
  431.                     "serie": "Integer",
  432.                     "numero": "Integer",
  433.                     "codigoExterno": "String"
  434.                 }
  435.             ]
  436.         }
  437.     ]
  438. }