Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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)
NumeroCupomNúmero do cupomintegerNenhum.
CNPJCNPJ da empresa Formato: 00000000000000 (14 dígitos)stringNenhum

Obrigatório.

numeroPDVNúmero do PDVintegerNenhum.
dataInicioVendasData início das vendas – Obrigatório – Formato: yyyy-MM-ddstringObrigatório


Tamanho máximo: 10

Tamanho mínimo: 10

dataFimVendasData fim das vendas – Obrigatório – Formato: yyyy-MM-ddstringObrigatório


Tamanho máximo: 10

Tamanho mínimo: 10

tipoVendaTipo da venda (Opções: P – PDV / E – ERP)stringNenhum.
_pageNo
integerNenhum.
_pageSize
integerNenhum.

...

Coleção de VendaRespostaDto


Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)

cpfClienteCPF do ClientestringNenhum.

numeroNotaNúmero do cupomintegerNenhum.

numeroEmpresaNúmero da empresaintegerNenhum.

CNPJCNPJ da empresastringNenhum.

numeroPDVNúmero PDVintegerNenhum.

numeroSerieEcf

Número de série do emissor de cupom fiscal

stringNenhum.

serieNota

Série da nota

stringNenhum.

CodigoVendedorCódigo do VendedorintegerNenhum.

codigoOperadorCódigo do Operador de PDVintegerNenhum.

valorTotalValor total da vendadecimal numberNenhum.

dataVendaData da vendadateNenhum.
valorDescontoValor de desconto

dataHoraVendaData e hora da venda
decimal numberNenhum
datetimeDisponível a partir da versão 22.07

valorDescontoValor de desconto da vendadecimal numberNenhum.

valorAcrescimoValor de acréscimo da vendadecimal numberNenhum..

situacaoSituação do cupomstring
Nenhum.
V=Valido; C=Cancelado

tipoVendaIndicador do tipo de venda (Opções: P – PDV / E – ERP)stringNenhum.
itensLista de itens da vendaColeção de ItemVendaRespostaDto

chaveAcessoChave do cupomsample stringNenhum.
finalizadorasorigemPedidoIndicador da origem do Pedidostring

origemPedido
Lista de finalizadoras da vendaColeção de FinalizadoraVendaRespostaDtoNenhum.
Indicador da origem do Pedidostring
Opções = P - PDV / E - Ecommerce / T - Televendas
custoLiquidoFiscalCusto líquido fiscal do item stringCusto Líquido Fiscal multiplicado pela quantidade de venda.pessoasLista de pessoas da vendaDoctoPessoaDto
itens
Lista de itens da vendaColeção de ItemVendaRespostaDtoNenhum.

codigoProdutoCódigo sequencial do produto no ERPintegerNenhum.

Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):


EANCódigo de barras EAN ou DUN do produtosample stringNenhum.

descricaoDescrição do produto sample stringNenhum.

sequenciaSequencia do item no cupomintegerNenhum.

quantidadeQuantidade decimal numberNenhum.

valorUnitarioValor unitário do item decimal numberNenhum.

valorTotalItem

Valor total do item 

decimal numberNenhum.

valorDescontoItemValor do desconto do itemdecimal numberNenhum.

valorAcrescimoItemValor de acréscimo no itemdecimal numberNenhum.

custoLiquidoFiscalCusto líquido fiscal do itemdecimal numberCusto Líquido Fiscal multiplicado pela quantidade de venda.

situacaoItemSituação do item no cupomsample stringV=Valido; C=Cancelado

custoLiquidoFiscalCusto líquido fiscal do item decimal numberCusto Líquido Fiscal multiplicado pela quantidade de venda.
finalizadoras
Lista de finalizadoras da vendaColeção de FinalizadoraVendaRespostaDtoNenhum.

tipoPagamentoTipo de pagamentosample stringNenhum.

valorPagamentoRealizadoValor do págamento realizado decimal numberNenhum.
pessoasFidelidade
Lista de pessoas fidelizadasColeção de pessoasFidelidadeVendaRespostaDtoNenhum.

codParceiroCódigo Parceiro do programa de fidelidadeintegerNenhum.

CNPJCPFCNPJ ou CPF do parceirostringNenhum.

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>