-
Notifications
You must be signed in to change notification settings - Fork 3
POST Voucher
julianSantos09 edited this page Oct 3, 2023
·
1 revision
POST https://integrador.varejonline.com.br/apps/api/vouchers
Envie um JSON no corpo da requisição, contendo:
- entidades: lista de entidades cadastradas para o voucher
-
nominal: informações referentes ao voucher do tipo nominal (obrigatório se não informado promocional, não podem ser informados ambos no mesmo post)
- 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 strings de classes cadastrados para o voucher nominal.
-
promocional: informações referentes ao voucher do tipo promocional (obrigatório se não informado nominal, não podem ser informados ambos no mesmo post)
- codigo: código promocional (string) (obrigatório)
- 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) (obrigatório se quantidadeLimitada for true e não permitido se quantidadeLimitada for false)
- formaAplicacao: Se o voucher é aplicado como pagamento ou desconto (PAGAMENTO, DESCONTO) (obrigatório)
- tipoLancamento: Define a forma em que o voucher foi criado no sistema (MANUAL, CONFIGURACAO, AUTOMATICO, VENDA_ERP_PDV)
- valor: Valor configurado para o voucher (decimal) (obrigatório)
- tipoValor: Define a configuração do valor, podendo ser unitário ou percentual (PERCENTUAL, VALOR_UNITARIO) (obrigatório)
- 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) (obrigatório)
- dataValidadeFinal: Define a data de validade final para consumo no formato dd-mm-aaaa (string) (obrigatório)
- 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)
Sucesso HTTP 201 CREATED:
Retorna um JSON com informações do resultado da operação realizada, contendo:
- idRecurso: ID do voucher gerado.
- codigoMensagem: Código de identificação da operação realizada. veja a lista de Códigos
- mensagem: Mensagem da operação realizada
Requisição inválida:
- HTTP STATUS 400 – BAD REQUEST
- Body: mensagem de erro
POST https://integrador.varejonline.com.br/apps/api/vouchers
'Content-Type'='application/json'
{
"valor": 29.90,
"promocional": {
"codigo": "SUMMER-X5665ZY"
},
"formaAplicacao": "PAGAMENTO",
"dataValidadeInicial": "01-09-2023",
"dataValidadeFinal": "30-09-2023",
"tipoValor": "VALOR_UNITARIO"
}
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