Pular para o conteúdo principal
Versão: 2.2.3

updatePoints

Este método possibilita:

Fazer a adição e remoção de pontos de um usuário.

Classe Java
Requisiçãoweb\wwwroot\ws\java\gmf\gamification\UpdatePointsRequestType.java
Retornoweb\wwwroot\ws\java\gmf\gamification\UpdatePointsRequestType.java

Requisição:

IdentificadorRequeridoDescrição
IDUSERXMatricula do usuário.
VLPOINTSXQuantidade de pontos.
FGPOINTEVENTXTipo de ação. 1 = soma, 2 = subtração.
ONLYBALANCEXTipo de alteração. 1 = Altera apenas o saldo de pontos, 2 = Altera o saldo de pontos e o total de pontos.
DSJUSTIFYXJustificativa.
QTDEADLINEDias para expiração dos pontos.

Estrutura da requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:gamification">
<soapenv:Header/>
<soapenv:Body>
<urn:updatePoints>
<!--You may enter the following 6 items in any order-->
<urn:IDUSER>?</urn:IDUSER>
<urn:VLPOINTS>?</urn:VLPOINTS>
<urn:FGPOINTEVENT>?</urn:FGPOINTEVENT>
<urn:ONLYBALANCE>?</urn:ONLYBALANCE>
<urn:DSJUSTIFY>?</urn:DSJUSTIFY>
<urn:QTDEADLINE>?</urn:QTDEADLINE>
</urn:updatePoints>
</soapenv:Body>
</soapenv:Envelope>

Retorno:

IdentificadorDescrição
StatusSUCESSO: SUCCESS
FALHA: FAILURE
DetailSUCESSO: Registro inserido
FALHA: Mensagem referente ao erro ocorrido.
CodeSUCESSO: 1
FALHA: Código referente ao erro ocorrido.
CódigoDescrição
2Identificador do usuário nulo.
3Evento de pontos deve ser um número entre 1 e 3.
4O Campo ONLYBALANCE aceita apenas os valores 1 e 2.
5Valor inválido para quantidade de pontos.
6O campo DSJUSTIFY deve ser preenchido.
7Usuário inexistente.
8Valor inválido para Dias para expiração dos pontos.