saveCupom - Webservice
Atualizado há mais de uma semana

Método

O nome do método utilizado na consulta é saveCupom.

Descrição

Salva o cupom de desconto.

Dados

Os dados enviados para salvar são organizados em uma tabela contendo o nome, tipo e descrição do campo, os campos obrigatórios possuem um (*) no final do nome demarcando que são obrigatórios. Segue tabela descrevendo os dados de envio:

Nome

Tipo

Descrição

codigo(*)

String(50)

Código de identificação do cupom. Esse código deve ser único.

tipos_pagamento

String(100)

Tipos de pagamentos permitidos para ser usado o cupom.

São eles:

cartao_credito - Cartão de crédito,

transferencia - Transferência,

boleto - Boleto bancário,

sistema_pagamento - Sistema de pagamento,

deposito - Depósito em conta,

cartao_debito - Cartão de débito,

dinheiro - Dinheiro,

multiplos_cartoes_credito - Múltiplos cartões,

multiplos_cartoes_credito_boleto - Múltiplos cartões + Boleto

Caso não seja enviada a tag, ou envie com o valor “all”, irá selecionar todas.

cliente_cpf_cnpj

String(20)

CPF ou CNPJ do cliente.

valor_desconto(*)

Float(9,2)

Valor de desconto que será aplicado, de acordo com o tipo.

tipo_desconto(*)

String(10)

Tipo de desconto que será aplicado - “percentual” ou “valor

frete_normal_gratis

Integer(1)

Permite utilizar o cupom quando houver frete grátis nas modalidades “Normal”

Valores:

1 - Permite;

0 - Não permite.

frete_expresso_gratis

Integer(1)

Permite utilizar o cupom quando houver frete grátis nas modalidades “Expresso”

Valores:

1 - Permite;

0 - Não permite.

frete_economico_gratis

Integer(1)

Permite utilizar o cupom quando houver frete grátis nas modalidades “Economico”

Valores:

1 - Permite;

0 - Não permite.

valor_minimo_compra

Float(9,2)

Valor mínimo para utilizar o cupom.

valor_maximo_compra

Float(9,2)

Valor máximo para utilizar o cupom.

validade_inicio

Datetime

Data de validade inicial do cupom.

Formato: Y-m-d H:i:s

validade_fim

Datetime

Data de validade final do cupom.

tipo_utilizacao(*)

String(20)

Tipo de utilização do cupom.

Valores:

unica_geral, unica_cliente, livre.

permite_produto_com_desconto

Integer(1)

Define se permite se utilizado o cupom com produtos que já possuem desconto.

Valores:

1 - Permite;

0 - Não permite.

descricao

String(150)

Descrição do cupom.

observacao_cliente

String(150)

Mensagem que será exibida para o cliente ao adicionar cupom.

permite_pontos_na_compra

Integer(1)

Permite gerar pontos ao usar o cupom.

Valores:

1 - Permite;

0 - Não permite.

permite_uso_kit

Integer(1)

Permite o uso do cupom em kits.

Valores:

1 - Permite;

0 - Não permite.

permite_uso_produtos_pre_venda

Integer(1)

Permite uso em produtos de pré-venda.

Valores:

1 - Permite;

0 - Não permite.

status(*)

Integer(1)

Status do cupom

Valores:

1 - Ativo;

0 - Inativo.

categorias

String

Categorias em que será permitido o uso do cupom.

Deve ser enviado o nome exato da(s) categoria(s). Caso desejar adicionar mais de uma, enviar separando-as por vírgula.

Caso não seja enviado nada ou “all” na tag, irá selecionar todas.

produtos

String

Produtos em que será permitido o uso do cupom.

Deve ser enviado o SKU (Código que fica na aba 02. Estoque). Caso desejar adicionar mais de um, enviar separando os SKU’s por vírgula.

marcas

String

Marcas em que será permitido o uso do cupom.

Deve ser enviado o nome exato da(s) marca(s). Caso desejar adicionar mais de uma, enviar separando-as por vírgula.

Caso não seja enviado nada ou “all” na tag, irá selecionar todas.

limpar_marcas

Integer(1)

Define se deve remover as marcas que estão salvas no cupom.

Valores:

1 - Limpar;

0 - Não limpar.

limpar_produtos

Integer(1)

Define se deve remover os produtos que estão salvos no cupom.

Valores:

1 - Limpar;

0 - Não limpar.

limpar_categorias

Integer(1)

Define se deve remover as categorias que estão salvas no cupom.

Valores:

1 - Limpar;

0 - Não limpar.

Observações

  • Nas tags de “limpar”, caso seja enviado 0 e também seja enviado mais algum valor que ainda não esteja cadastrado na respectiva tag do “limpar” (Ex: limpar_produtos -> produtos), irá apenas adicionar mais um item. Caso envie a tag “limpar” como 1, irá remover o que está salvo no momento e adicionar o que foi enviado na respectiva tag. Caso não seja enviado nada, ao limpar, irá selecionar todos.

Exemplos de Requisição:

XML:

<data>
<codigo>Teste12345</codigo>
<tipos_pagamento>cartao_credito,boleto</tipos_pagamento>
<cliente_cpf_cnpj>25731394334</cliente_cpf_cnpj>
<valor_desconto>10</valor_desconto>
<tipo_desconto>percentual</tipo_desconto>
<frete_normal_gratis>0</frete_normal_gratis>
<frete_expresso_gratis>0</frete_expresso_gratis>
<frete_economico_gratis>1</frete_economico_gratis>
<valor_minimo_compra>100</valor_minimo_compra>
<valor_maximo_compra>1000</valor_maximo_compra>
<validade_inicio>2018-05-20 00:00:00</validade_inicio>
<validade_fim>2018-05-30 00:00:00</validade_fim>
<tipo_utilizacao>livre</tipo_utilizacao>
<permite_produto_com_desconto>1</permite_produto_com_desconto>
<descricao>Teste Teste</descricao>
<observacao_cliente>olá</observacao_cliente>
<permite_pontos_na_compra>0</permite_pontos_na_compra>
<permite_uso_kit>0</permite_uso_kit>
<permite_uso_produtos_pre_venda>0</permite_uso_produtos_pre_venda>
<status>1</status>
<produtos>1223,123</produtos>
<marcas>Adidas</marcas>
<categorias>Tênis,Sapatênis</categorias>
<limpar_produtos>1</limpar_produtos>
<limpar_marcas>1</limpar_marcas>
<limpar_categorias>1</limpar_categorias>
</data>

JSON:

{
"codigo": "Teste12345",
"tipos_pagamento": "cartao_credito,boleto",
"cliente_cpf_cnpj": "25731394334",
"valor_desconto": 10,
"tipo_desconto": "percentual",
"frete_normal_gratis": 0,
"frete_expresso_gratis": 0,
"frete_economico_gratis": 1,
"valor_minimo_compra": 100,
"valor_maximo_compra": 1000,
"validade_inicio": "2018-05-20 00:00:00",
"validade_fim": "2018-05-30 00:00:00",
"tipo_utilizacao": "livre",
"permite_produto_com_desconto": 1,
"descricao": "Teste Teste",
"observacao_cliente": "Teste",
"permite_pontos_na_compra": 0,
"permite_uso_kit": 0,
"permite_uso_produtos_pre_venda": 0,
"status": 1,
"produtos": "1223,123",
"marcas": "Adidas",
"categorias": "Tênis,Sapatênis",
"limpar_produtos": 1,
"limpar_marcas": 1,
"limpar_categorias": 1
}

Mais sobre Webservice

Consulte nossa tabela de retorno aqui.

Não conhece todos os métodos webservice da Moovin? Veja nossa lista completa aqui.

Caso tenha dúvidas em como realizar o envio ou formatos de envio, veja nesta nossa documentação aqui.

Respondeu à sua pergunta?