GET Vouchers
julianSantos09 edited this page Feb 6, 2023
·
2 revisions
GET https://integrador.varejonline.com.br/apps/api/vouchers/:id
- entidades: ids das entidades (long) (opcional)
- documentoCliente: Para filtrar vouchers nominais pelo documento do cliente não formatado (string) (opcional)
- codigoPromocional: Para filtrar vouchers promocionais pelo código (string) (opcional)
- numeroValePresente: Para filtrar voucher de vale presente pelo número/código (string) (opcional)
- somenteAtivos: Para filtrar vouchers ativos, ou seja, não encerrados/excluídos/cancelados e que estão válidos na data atual (boolean) (opcional)
- inicio: Entenda a Coleta Paginada
- quantidade: Entenda a Coleta Paginada
- alteradoApos: Entenda a Coleta de Alterações
Sucesso HTTP 200 OK:
Retorna uma lista JSONs com informações do resultado da operação realizada, contendo:
- id: id do voucher (long)
- entidades: lista de entidades cadastradas para o voucher
-
nominal: informações referentes ao voucher do tipo nominal
- id: id do voucher nominal (long)
- terceiros: lista de terceiros cadastrados para o voucher nominal
-
categoriasCliente: lista de categorias de clientes cadastrados para o voucher nominal
- id: id da categoria (long)
- nome: nome da categoria (string)
- classesTerceiro: lista de classes cadastrados para o voucher nominal.
-
promocional: informações referentes ao voucher do tipo promocional
- id: id do voucher promocional (long)
- codigo: código promocional (string)
- clienteObrigatorio: define se o voucher só pode ser aplicado a um cliente identificado na venda (boolean)
- quantidadeLimitada: define se o voucher possui quantidade limitada para uso (boolean)
- quantidadeUsos: quando o voucher possui quantidade limitada essa informação define a quantidade de uso permitido (integer)
-
valePresente: informações referentes ao voucher do tipo vale presente
- id: id do voucher vale presente (long)
- numero: número referente ao cartão do vale presente (string)
- formaAplicacao: Se o voucher é aplicado como pagamento ou desconto (enum: PAGAMENTO, DESCONTO)
- tipoLancamento: Define a forma em que o voucher foi criado no sistema (enum: MANUAL, CONFIGURACAO, AUTOMATICO, VENDA_ERP_PDV)
- valor: Valor configurado para o voucher (decimal)
- tipoValor: Define a configuração do valor, podendo ser unitário ou percentual (enum: PERCENTUAL, VALOR_UNITARIO)
- valorCompraMinimo: Define o valor de compra mínimo do pedido para poder consumir o voucher (decimal)
- percentualUsoVenda: Define o percentual de uso em venda para o voucher (decimal)
- dataValidadeInicial: Define a data de validade inicial para consumo no formato dd-mm-aaaa (string)
- dataValidadeFinal: Define a data de validade final para consumo no formato dd-mm-aaaa (string)
- usoUnico: Define se o voucher pode ser utilizado apenas uma única vez (boolean)
- excluido: Define se o voucher foi excluído (boolean)
- encerrado: Define se o voucher foi encerrado (boolean)
- cancelado: Referente ao vale presente. Define se o voucher foi cancelado (boolean)
- observacoes: Observações referente ao voucher (string)
- somenteWeb: Define se o voucher só pode ser utilizado em Ecommerce/Marketplace (boolean)
- franquias: lista de terceiros cadastrados para a integração
Requisição inválida:
- HTTP STATUS 400 – BAD REQUEST
- Body: mensagem de erro
[
{
"formaAplicacao": "DESCONTO",
"dataValidadeInicial": "29-07-2022",
"dataValidadeFinal": "31-12-2022",
"valor": 5,
"tipoLancamento": "MANUAL",
"usoUnico": false,
"encerrado": false,
"promocional": {
"clienteObrigatorio": false,
"quantidadeLimitada": false,
"codigo": "654321",
"id": 1002
},
"cancelado": false,
"entidades": [],
"excluido": false,
"franquias": [],
"somenteWeb": false,
"tipoValor": "VALOR_UNITARIO",
"id": 1002
},
{
"formaAplicacao": "PAGAMENTO",
"dataValidadeInicial": "29-07-2022",
"dataValidadeFinal": "31-12-2022",
"valor": 10,
"tipoLancamento": "MANUAL",
"usoUnico": false,
"encerrado": false,
"promocional": {
"clienteObrigatorio": false,
"quantidadeLimitada": false,
"codigo": "123456",
"id": 1001
},
"cancelado": false,
"entidades": [],
"excluido": false,
"franquias": [],
"somenteWeb": false,
"tipoValor": "VALOR_UNITARIO",
"id": 1001
},
{
"formaAplicacao": "PAGAMENTO",
"dataValidadeInicial": "03-08-2022",
"dataValidadeFinal": "31-08-2022",
"valor": 15.9,
"tipoLancamento": "MANUAL",
"usoUnico": true,
"encerrado": false,
"cancelado": false,
"entidades": [
{
"nome": "DÉPOSITO CENTRAL",
"documento": "45.433.924/0001-10",
"id": 3
}
],
"excluido": false,
"franquias": [],
"nominal": {
"categoriasCliente": [
{
"nome": "VIP",
"id": 2
}
],
"classesTerceiro": [
"CLIENTE"
],
"terceiros": [
{
"nome": "Alan Bahnia",
"documento": "057.159.029-30",
"id": 192
}
],
"id": 1021
},
"somenteWeb": false,
"tipoValor": "VALOR_UNITARIO",
"id": 1021
}
]
GET https://integrador.varejonline.com.br/apps/api/vouchers/1001
{
"formaAplicacao": "PAGAMENTO",
"dataValidadeInicial": "29-07-2022",
"dataValidadeFinal": "31-12-2022",
"valor": 10,
"tipoLancamento": "MANUAL",
"usoUnico": false,
"encerrado": false,
"promocional": {
"clienteObrigatorio": false,
"quantidadeLimitada": false,
"codigo": "123456",
"id": 1001
},
"cancelado": false,
"entidades": [],
"excluido": false,
"franquias": [],
"somenteWeb": false,
"tipoValor": "VALOR_UNITARIO",
"id": 1001
}
Administrativo
- GET dados-login
- GET empresas
- GET entidades
- GET Grupo entidades
- GET Campos Custom.
- ENDPOINTS terceiros
- GET classificacoes-clientes
- ENDPOINTS Usuários
- GET permissao-usuario
- GET marcas
Comercial
Compras
Financeiro
- ENDPOINTS adiantamentos
- POST baixas
- POST estorno baixa
- GET boletos
- POST boletos
- GET Impressao boletos
- GET contas-disponibilidade
- GET contas-pagar
- GET contas-receber
- GET lancamentos-padroes
- GET negociacoes-cartao
- GET planos-gerenciais
- GET plano-contabil
- GET planos-financeiro
- GET previsoes
- POST provisoes
- DELETE Provisão
- POST reneg. receber
- POST reneg. pagar
- PUT transacao-cartao
Controle de crédito
Fiscal
- GET classificao-produtos
- GET conhecim. transporte
- GET cupons fiscais
- GET notas-consumo
- GET notas-mercadoria
- GET XML notas-mercadorias
- GET DANFE notas mercadoria
- GET notas-servico
- GET reducoes-z
Contábil
Operacional
- GET balancos-estoque
- POST balancos-estoque
- POST ajuste-estoque
- GET canais-digitais
- ENDPOINTS Categorias
- GET conferencias-caixa
- GET custo-produtos
- GET devolucoes
- GET entradas
- POST entradas
- GET Niveis Categoria
- GET Orcamentos
- PUT Orcamentos
- POST Orcamentos
- DELETE Orcamentos
- GET Reserva estoque
- PUT Cancelar Reserva
- ENDPOINTS Pedidos
- GET planos-pagamento
- ENDPOINTS Produtos
- GET atendimentos
- GET saidas
- POST entrada movimentação própria
- POST saída movimentação própria
- GET saldos-liquidos-mercadorias
- GET saldos-mercadorias
- GET servicos
- POST servicos
- PUT servicos
- GET tabelas-preco
- GET configuracoes-preco
- POST tabelas-preco
- PUT tabelas-preco
- GET preco-produtos
- PUT preco-produtos
- GET preco-servicos
- PUT preco-servicos
- GET unidades
- POST unidades
- PUT unidades
- POST transferencia
- GET atributos de produto
- ENDPOINTS ações promocionais
- GET Status Pedido Venda
- Integração com Ecom
- Coleta de Alterações
- Paginação de Resultados
- Obter Pagamento de Vendas
- Nota de Devolução de Venda
- Filtro de Datas
- Filtro de Entidades
- Filtro de CPF ou CNPJ
- Filtro de Representantes
- Filtro de Terceiro
- Filtro de Integração