Histórico da Página

...

Método que disponibiliza informações de Vendas realizadas.

Chamada

GET SMVendasApi/api/v1/vendas?
NumeroCupom=
{NumeroCupom}&CNPJ=
{CNPJ}&NumeroPDV=
{NumeroPDV}&DataInicioVendas=
{DataInicioVendas}&DataFimVendas=
{DataFimVendas}&TipoVenda=
{TipoVenda}&_pageNo=
{_pageNo}&_pageSize=
{_pageSize}

...

Nome (Name)	Descrição (Description)	Tipo (Type)	Informações Adicionais (Adittional Information)
NumeroCupom	Número do cupom	integer	Nenhum.
CNPJ	CNPJ da empresa Formato: 00000000000000 (14 dígitos)	string	Nenhum Obrigatório.
numeroPDV	Número do PDV	integer	Nenhum.
dataInicioVendas	Data início das vendas – Obrigatório – Formato: yyyy-MM-dd	string	Obrigatório Tamanho máximo: 10 Tamanho mínimo: 10
dataFimVendas	Data fim das vendas – Obrigatório – Formato: yyyy-MM-dd	string	Obrigatório Tamanho máximo: 10 Tamanho mínimo: 10
tipoVenda	Tipo da venda (Opções: P – PDV / E – ERP)	string	Nenhum.
_pageNo		integer	Nenhum.
_pageSize		integer	Nenhum.

...

Coleção de VendaRespostaDto

Nome (Name)	Descrição (Description)	Tipo (Type)	Informações Adicionais (Adittional Information)
cpfCliente	CPF do Cliente	string	Nenhum.
numeroNota	Número do cupom	integer	Nenhum.
numeroEmpresa	Número da empresa	integer	Nenhum.
CNPJ	CNPJ da empresa	string	Nenhum.
numeroPDV	Número PDV	integer	Nenhum.
numeroSerieEcf	Número de série do emissor de cupom fiscal	string	Nenhum.
serieNota	Série da nota	string	Nenhum.
CodigoVendedor	Código do Vendedor	integer	Nenhum.
codigoOperador	Código do Operador de PDV	integer	Nenhum.
valorTotal	Valor total da venda	decimal number	Nenhum.
dataVenda	Data da venda	date	Nenhum.

valorDescontoValor de desconto

dataHoraVenda

Data e hora da venda

decimal numberNenhum

datetime	Disponível a partir da versão 22.07
	valorDesconto	Valor de desconto da venda	decimal number	Nenhum.
	valorAcrescimo	Valor de acréscimo da venda	decimal number	Nenhum..
	situacao	Situação do cupom	string

Nenhum.

V=Valido; C=Cancelado
	tipoVenda	Indicador do tipo de venda (Opções: P – PDV / E – ERP)	string	Nenhum.

itensLista de itens da vendaColeção de ItemVendaRespostaDto

chaveAcesso

Chave do cupom

sample string

Nenhum.

finalizadoras

origemPedido

Lista de itens da vendaColeção de FinalizadoraVendaRespostaDtoNenhum.

Indicador da origem do Pedido

string

origemPedidoIndicador da origem do Pedidostring

Opções = P - PDV / E - Ecommerce / T - Televendas

custoLiquidoFiscalCusto líquido fiscal do item string


itens		Lista de itens da venda	Coleção de ItemVendaRespostaDto	Nenhum.
	codigoProduto	Código sequencial do produto no ERP	integer	Nenhum.
	EAN

Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):

Código de barras EAN ou DUN do produto	sample string	Nenhum.
	descricao	Descrição do produto	sample string	Nenhum.
	sequencia	Sequencia do item no cupom	integer	Nenhum.
	quantidade	Quantidade	decimal number	Nenhum.
	valorUnitario	Valor unitário do item	decimal number	Nenhum.
	valorTotalItem	Valor total do item	decimal number	Nenhum.
	valorDescontoItem	Valor do desconto do item	decimal number	Nenhum.
	valorAcrescimoItem	Valor de acréscimo no item	decimal number	Nenhum.
	custoLiquidoFiscal	Custo líquido fiscal do item	decimal number	Custo Líquido Fiscal multiplicado pela quantidade de venda.
	situacaoItem	Situação do item no cupom	sample string	V=Valido; C=Cancelado
	custoLiquidoFiscal	Custo líquido fiscal do item	decimal number	Custo Líquido Fiscal multiplicado pela quantidade de venda.
finalizadoras		Lista de finalizadoras da venda	Coleção de FinalizadoraVendaRespostaDto	Nenhum.
	tipoPagamento	Tipo de pagamento	sample string	Nenhum.
	valorPagamentoRealizado	Valor do págamento realizado	decimal number	Nenhum.
pessoasFidelidade		Lista de pessoas fidelizadas	Coleção de pessoasFidelidadeVendaRespostaDto	Nenhum.
	codParceiro	Código Parceiro do programa de fidelidade	integer	Nenhum.
	CNPJCPF	CNPJ ou CPF do parceiro	string	Nenhum.

Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):

[[
  {
    "cpfCliente": "sample string 1",
    "numeroNota": 2,
    "numeroEmpresa": 3,
    "CNPJ": "sample string 4",
    "numeroPDV": 1,
    "codigoOperador": 1,
    "valorTotal": 7.0,
    "dataVenda": "2020-05-13T10:42:46.7840029-03:00",
    "valorDesconto": 1.0,
    "valorAcrescimo": 1.0,
    "situacao": "sample string 9",
    "tipoVenda": "sample string 10",
    "itens": [
      {
        "codigoProduto": 1,
        "EAN": "sample string 2",
        "descricao": "sample string 3",
        "sequencia": 4,
        "quantidade": 5.1,
        "valorUnitario": 6.1,
        "valorTotalItem": 7.0,
        "valorDescontoItem": 1.0,
        "valorAcrescimoItem": 1.0,
        "situacaoItem": "sample string 8"
      },
      {
        "codigoProduto": 1,
        "EAN": "sample string 2",
        "descricao": "sample string 3",
        "sequencia": 4,
        "quantidade": 5.1,
        "valorUnitario": 6.1,
        "valorTotalItem": 7.0,
        "valorDescontoItem": 1.0,
        "valorAcrescimoItem": 1.0,
        "situacaoItem": "sample string 8"
      }
    ],
    "finalizadoras": [
      {
        "tipoPagamento": "sample string 1",
        "valorPagamentoRealizado": 1.0
      },
      {
        "tipoPagamento": "sample string 1",
        "valorPagamentoRealizado": 1.0
      }
    ]
  },
  {
    "cpfCliente": "sample string 1",
    "numeroNota": 2,
    "numeroEmpresa": 3,
    "CNPJ": "sample string 4",
    "numeroPDV": 1,
    "numeroSerieEcf": string optional,
    "serieNota": string optional,

    "numeroPDVcodigoVendedor": 1,

    "codigoOperador": 1,
    "valorTotal": 7.0,
    "dataVenda": "2020-05-13T00:00:00.0000000-00:00",
    "dataHoraVenda": "2020-05-13T10:42:46.7840029-03:00",

     "valorDesconto": 1.0,
    "valorAcrescimo": 1.0,
    "situacao": "sample string 9",
    "tipoVenda": ",
sample string 10",
    "tipoVendaorigemPedido": "sample string 10",
    "itens": [
      {
        "codigoProduto": 1,
        "EAN": "sample string 2",
        "descricao": "sample string 3",
        "sequencia": 4,
        "quantidade": 5.1 2",
        "valorUnitariodescricao": 6.1 "sample string 3",
        "valorTotalItemsequencia": 7.04,
        "valorDescontoItemquantidade": 5.1.0,
        "valorAcrescimoItemvalorUnitario": 6.1.0,
        "situacaoItemvalorTotalItem": "sample string 8"
      },
7.0,
        {"valorDescontoItem": 1.0,
        "codigoProdutovalorAcrescimoItem": 1.0,

        "EANcustoLiquidoFiscal": "sample string 2"1.0,
        "descricaosituacaoItem": "sample string 38",

        "sequencia": 4},
        "quantidade": 5.1, {
        "valorUnitariocodigoProduto": 6.1,
        "valorTotalItemEAN": 7.0 "sample string 2",
        "valorDescontoItemdescricao": 1.0 "sample string 3",
        "valorAcrescimoItemsequencia": 1.04,
        "situacaoItemquantidade": "sample string 8"
      }5.1,
    ],
    "finalizadorasvalorUnitario": [
6.1,
        {"valorTotalItem": 7.0,
        "tipoPagamentovalorDescontoItem": "sample string 1".0,
        "valorPagamentoRealizadovalorAcrescimoItem": 1.0
  ,
    },
      {"custoLiquidoFiscal":1.0,
        "tipoPagamentosituacaoItem": "sample string 1",8"
      }
    ],
    "valorPagamentoRealizadofinalizadoras": 1.0[
      }{
    ]
   }
]

application/xml, text/xml

Exemplo (Sample):

<ArrayOfVendaRespostaDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SMVendasAPI.Entidades.Dto.Entidades.v1.SMVendasAPIEntidadeDto">
  <VendaRespostaDto> "tipoPagamento": "sample string 1",
        "valorPagamentoRealizado": 1.0
    <CNPJ>sample string 4</CNPJ>},
    <CodigoOperador>1</CodigoOperador>
  {
  <CpfCliente>sample string 1</CpfCliente>
    <DataVenda>2020-05-13T10:42:46.7840029-03:00</DataVenda>
    <Finalizadoras>"tipoPagamento": "sample string 1",
      <FinalizadoraVendaRespostaDto>
   "valorPagamentoRealizado": 1.0
    <TipoPagamento>sample string 1</TipoPagamento>}
    ],
    "pessoasFidelidade": [
 <ValorPagamentoRealizado>1</ValorPagamentoRealizado>
     {
 </FinalizadoraVendaRespostaDto>
      <FinalizadoraVendaRespostaDto>
 "codParceiro": "integer",
       <TipoPagamento>sample"CNPJCPF": string 1</TipoPagamento>
"string"
      }
  <ValorPagamentoRealizado>1</ValorPagamentoRealizado>
  ]
  },
  </FinalizadoraVendaRespostaDto>{
    </Finalizadoras>
    <Itens>
"cpfCliente": "sample string 1",
    "numeroNota": 2,
  <ItemVendaRespostaDto>
  "numeroEmpresa": 3,
     <Descricao>sample"CNPJ": "sample string 3</Descricao>
4",
    "numeroPDV": 1,
    <EAN>sample"numeroSerieEcf": string 2</EAN>
optional,
    "serieNota":    <Quantidade>5.1</Quantidade>
string optional,
        <SeqProduto>1</SeqProduto>"codigoVendedor": 1,
        <Sequencia>4</Sequencia>"codigoOperador": 1,
    "valorTotal": 7.0,
    <SituacaoItem>sample string 8</SituacaoItem>
        <ValorAcrescimoItem>1</ValorAcrescimoItem>"dataVenda": "2020-05-13T00:00:00.0000000-00:00",
    "dataHoraVenda": "2020-05-13T10:42:46.7840029-03:00",
    "valorDesconto": 1.0,
        <ValorDescontoItem>1</ValorDescontoItem>"valorAcrescimo": 1.0,
    "situacao": "sample   <ValorTotalItem>7</ValorTotalItem>string 9",
    "tipoVenda": "sample string  <ValorUnitario>6.1</ValorUnitario>
10",
    "origemPedido": "sample  </ItemVendaRespostaDto>string 10",
    "itens": [
 <ItemVendaRespostaDto>
     {
   <Descricao>sample string 3</Descricao>
   "codigoProduto": 1,
    <EAN>sample string 2</EAN>
  "EAN": "sample string 2",
   <Quantidade>5.1</Quantidade>
     "descricao": "sample  <SeqProduto>1</SeqProduto>string 3",
        <Sequencia>4</Sequencia>"sequencia": 4,
        <SituacaoItem>sample string 8</SituacaoItem>"quantidade": 5.1,
        <ValorAcrescimoItem>1</ValorAcrescimoItem>
 "valorUnitario": 6.1,
         <ValorDescontoItem>1</ValorDescontoItem>"valorTotalItem": 7.0,
        <ValorTotalItem>7</ValorTotalItem>"valorDescontoItem": 1.0,
        "valorAcrescimoItem": <ValorUnitario>6.1</ValorUnitario>
  1.0,
    </ItemVendaRespostaDto>
    </Itens>"custoLiquidoFiscal":1.0,
    <NumeroEmpresa>3</NumeroEmpresa>
    <NumeroNota>2</NumeroNota>
    <NumeroPDV>1</NumeroPDV>"situacaoItem": "sample string 8"
    <NumeroSerieEcf>sample string 6</NumeroSerieEcf>},
    <SeqNf>1</SeqNf>
   {
 <Seriedf>sample string 5</Seriedf>
    <Situacao>sample string 9</Situacao>"codigoProduto": 1,
    <TipoVenda>sample  string 10</TipoVenda>
    <ValorAcrescimo>1</ValorAcrescimo> "EAN": "sample string 2",
    <ValorDesconto>1</ValorDesconto>
    <ValorTotal>7</ValorTotal>
  </VendaRespostaDto>
  <VendaRespostaDto>
 "descricao": "sample string 3",
   <CNPJ>sample string 4</CNPJ>
    <CodigoOperador>1</CodigoOperador>
 "sequencia": 4,
   <CpfCliente>sample string 1</CpfCliente>
    <DataVenda>2020-05-13T10:42:46.7840029-03:00</DataVenda>"quantidade": 5.1,
    <Finalizadoras>
      <FinalizadoraVendaRespostaDto>"valorUnitario": 6.1,
        <TipoPagamento>sample string 1</TipoPagamento>
"valorTotalItem": 7.0,
         <ValorPagamentoRealizado>1</ValorPagamentoRealizado>
 "valorDescontoItem": 1.0,
     </FinalizadoraVendaRespostaDto>
      <FinalizadoraVendaRespostaDto>
"valorAcrescimoItem": 1.0,
         <TipoPagamento>sample string 1</TipoPagamento>"custoLiquidoFiscal":1.0,
        <ValorPagamentoRealizado>1</ValorPagamentoRealizado>
      </FinalizadoraVendaRespostaDto>
"situacaoItem": "sample string 8"
      </Finalizadoras>}
    <Itens>],
      <ItemVendaRespostaDto>"finalizadoras": [
        <Descricao>sample{
 string 3</Descricao>
      "tipoPagamento": "sample <EAN>sample string 2</EAN>1",
        "valorPagamentoRealizado": <Quantidade>51.1</Quantidade>0
        <SeqProduto>1</SeqProduto>},
      {
  <Sequencia>4</Sequencia>
        <SituacaoItem>sample"tipoPagamento": "sample string 8</SituacaoItem>1",
        <ValorAcrescimoItem>1</ValorAcrescimoItem>
        <ValorDescontoItem>1</ValorDescontoItem>
"valorPagamentoRealizado": 1.0
     }
    <ValorTotalItem>7</ValorTotalItem>
],
   "pessoasFidelidade": [
     <ValorUnitario>6.1</ValorUnitario>
{
      </ItemVendaRespostaDto>
 "codParceiro": "integer",
     <ItemVendaRespostaDto>
   "CNPJCPF": "string"
     <Descricao>sample}
 string 3</Descricao>
 ]
 }
 { 
    <EAN>sample string 2</EAN>
        <Quantidade>5.1</Quantidade>
        <SeqProduto>1</SeqProduto>
        <Sequencia>4</Sequencia>
        <SituacaoItem>sample string 8</SituacaoItem>
        <ValorAcrescimoItem>1</ValorAcrescimoItem>
        <ValorDescontoItem>1</ValorDescontoItem>
        <ValorTotalItem>7</ValorTotalItem>
        <ValorUnitario>6.1</ValorUnitario>
      </ItemVendaRespostaDto>
    </Itens>
    <NumeroEmpresa>3</NumeroEmpresa>
    <NumeroNota>2</NumeroNota>
    <NumeroPDV>1</NumeroPDV>
    <NumeroSerieEcf>sample string 6</NumeroSerieEcf>
    <SeqNf>1</SeqNf>
    <Seriedf>sample string 5</Seriedf>
    <Situacao>sample string 9</Situacao>
    <TipoVenda>sample string 10</TipoVenda>
    <ValorAcrescimo>1</ValorAcrescimo>
    <ValorDesconto>1</ValorDesconto>
    <ValorTotal>7</ValorTotal>
  </VendaRespostaDto>
</ArrayOfVendaRespostaDto>"cpfCliente": "string",
   "numeroNota": "string"
 }
]

application/xml, text/xml

Exemplo (Sample):

<Inline Model>
  <cpfCliente>string</cpfCliente>
  <numeroNota>1</numeroNota>
  <numeroEmpresa>1</numeroEmpresa>
  <CNPJ>string</CNPJ>
  <numeroPDV>1</numeroPDV>
  <numeroSerieEcf>string</numeroSerieEcf>
  <serieNota>string</serieNota>
  <codigoVendedor>1</codigoVendedor>
  <codigoOperador>1</codigoOperador>
  <valorTotal>1.1</valorTotal>
  <dataVenda>1970-01-01T00:00:00.001Z</dataVenda>
  <dataHoraVenda>1970-01-01T00:00:00.001Z</dataHoraVenda>
  <valorDesconto>1.1</valorDesconto>
  <valorAcrescimo>1.1</valorAcrescimo>
  <situacao>string</situacao>
  <tipoVenda>string</tipoVenda>
  <origemPedido>string</origemPedido>
  <itens>
    <codigoProduto>1</codigoProduto>
    <EAN>string</EAN>
    <descricao>string</descricao>
    <sequencia>1</sequencia>
    <quantidade>1.1</quantidade>
    <valorUnitario>1.1</valorUnitario>
    <valorTotalItem>1.1</valorTotalItem>
    <valorDescontoItem>1.1</valorDescontoItem>
    <valorAcrescimoItem>1.1</valorAcrescimoItem>
    <custoLiquidoFiscal>1.1</custoLiquidoFiscal>
    <situacaoItem>string</situacaoItem>
  </itens>
  <finalizadoras>
    <tipoPagamento>string</tipoPagamento>
    <valorPagamentoRealizado>1.1</valorPagamentoRealizado>
  </finalizadoras>
  <pessoasFidelidade>
    <codParceiro>integer</codParceiro>
    <CNPJCPF>string</CNPJCPF>
  </pessoasFidelidade>
</Inline Model>

Árvore de páginas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

Chamada

Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):

Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):

application/xml, text/xml

Exemplo (Sample):

application/xml, text/xml

Exemplo (Sample):