Método

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

Exemplo http://sualoja.integration.moovin.com.br/webservice/updateBonus.

Descrição

Este método realiza o acréscimo ou decréscimo de bônus no cadastro dos clientes.

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
email(*)	string	e-mail do cliente que irá receber o bônus
cpg_cnpj(*)	string	CPF/CNPJ do cliente que irá receber o bônus
descricao(*)	string(200)	Caso seja informado, retornará apenas as informações de estoque daquele produto.
valor(*)	float	Define o valor de bônus a ser somado ou subtraído.
tipo(*)	int	1 - para adição do valor, 2 - para subtração do valor.
origem	int	Código da origem do bônus localizado no menu cadastro > desconto > bônus > origem

Exemplos de Requisição:

XML:

<?xml version="1.0" encoding="UTF-8" ?>
<root>
  <email>teste@moovin.com.br</email>
  <cpf_cnpj>03124825071</cpf_cnpj>
  <valor>3.99</valor>
  <descricao>a</descricao>
  <tipo>1</tipo>
  <origem>1</origem>
</root>

JSON:

{
    "email": "teste@moovin.com.br",
    "cpf_cnpj":"03124825071",
    "valor":"3.99",
    "descricao":"teste",
    "tipo": "1", 
    "origem": "1"
 }

Exemplo de Retorno:

O retorno deste método irá consistir no total de bônus no cadastro do cliente, juntamente com os dados enviados na requisição.

XML:

<?xml version="1.0" encoding="UTF-8" ?>
<bonus>
    <total_bonus>
        <total_bonus>20.99</total_bonus>
    </total_bonus>
    <bonus>
        <data>2021-12-07 15:53:23</data>
        <valor>3.99</valor>
        <descricao>a</descricao>
        <tipo>1</tipo>
        <status>1</status>
        <id>391</id>
    </bonus>
</bonus>

JSON:

{
    "bonus": [
        {
            "total_bonus": "20.99"
        },
        {
            "data": "2021-12-07 15:51:26",
            "valor": "3.99",
            "descricao": "teste",
            "tipo": "1",
            "status": "1",
            "id": "390"
        }
    ]
}

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.