API FIDELIDADE - FIDELIDADE_GERAR_VOUCHER

API FIDELIDADE - FIDELIDADE_GERAR_VOUCHER

FIDELIDADE_GERAR_VOUCHER


Este método permite incluir e atualizar o voucher, podendo optar por informar o próprio código de voucher ou manter o código que é gerado automaticamente.

Campo
Obrigatório
Tipo
Descrição
loja
Sim
String
Código de loja para inclusão do vouche
clienteLoja
Sim
String
Código de loja do cadastro de cliente
codigoCliente
Sim
Integer
Código do cadastro de cliente
cpf
Não
Double
CPF do cadastro de cliente, necessário informar quando não usar a loja e código do cadastro de cliente
pontos
Sim
Double
Valor em pontos para geração do voucher (cálculo de conversão em R$ feito automaticamente ao gravar)
valor
Sim
Double
Valor em reais para geração do voucher (cálculo de conversão em pontos feito automaticamente ao gravar)
terminal
Sim
Integer
Terminal da loja
voucher
Não
String
Se vazio hash de voucher gerado automaticamente, se preenchido gravará com o código de voucher do cliente
utilizado
Não
String
Por padrão o voucher grava como N, sendo possível atualizar para S quando for consumido
lojaMovimento
Não
String
Código da loja em que o voucher for consumido
dataMovimento
Não
Data
Data em que o voucher for consumido (AAAA-MM-DD)
controleMovimento
Não
Integer
Número da venda ou documento que o voucher for consumido
terminalMovimento
Não
Integer
Terminal da loja em que o voucher for consumido

BODY

  1. {
  2.    "loja": "99", //Loja informada deve ser própria e não estar desativada
  3.    "clienteLoja": "99",
  4.    "pontos": 60, //Informar pontos ou valor
  5.    "valor" : 0, //Informar valor ou pontos
  6.    "terminal" : 0,
  7.    "voucher" : "2207202401", //Se nao informado ele gera automaticamente
  8.    "utilizado" : "N", //Padrão sempre N e pode ser atualizado
  9.    "lojaMovimento" : " ",  //Dados para atualizar o voucher
  10.    "dataMovimento" : " ",  //Dados para atualizar o voucher
  11.    "controleMovimento" : 0, //Dados para atualizar o voucher
  12.    "terminalMovimento" : 0 //Dados para atualizar o voucher
  13. }

OU

  1. {
  2.    "loja": "99", //Loja informada deve ser própria e não estar desativada
  3.    "cpf" : "23323650875", //Obrigatório apenas quando não tiver código e loja do cliente
  4.    "pontos": 0, //Informar pontos ou valor
  5.    "valor" : 20, //Informar valor ou pontos
  6.    "terminal" : 1,
  7.    "voucher" : " ", //Se nao informado ele gera automaticamente
  8.    "utilizado" : "N", //Padrão sempre N e pode ser atualizado
  9.    "lojaMovimento" : " ",  //Dados para atualizar o voucher
  10.    "dataMovimento" : " ",  //Dados para atualizar o voucher
  11.    "controleMovimento" : 0, //Dados para atualizar o voucher
  12.    "terminalMovimento" : 0 //Dados para atualizar o voucher
  13. }

JSON de Retorno

  1. {
  2.     "status": "sucesso",
  3.     "msg": {
  4.         "Sucesso": "Voucher(99991408284000009) incluído com sucesso!"
  5.     }
  6. }

    • Related Articles

    • Releases Notes DLL Fidelidade

      Versão 1.0.17.0 (03/06/2024) #542742 API de Fidelidade - Gerar Token - Implementação do método GerarVoucher no serviço de DLL PresenceFidelidade. Necessário atualizar o serviço para à versão 1.0.17.0 Observação: Em versões anteriores o método não ...

    • Integração Giver 4.0 com Fidelidade

      INTRODUÇÃO Esse documento tem por objetivo explicar a configuração e o funcionamento da integração entre o sistema Presence e o sistema Giver, com envio de informações via arquivo e consumo de pontuação de fidelidade. A solução Giver realiza a gestão ...

    • Interface de Fidelidade - APIs de integração

      Sobre o produto - APIs de Fidelidade A Presence possui um conjunto de API's que disponibilizam o acesso externo ao Módulo de Fidelidade com o intuito de transmitir/receber dados dos processos específicos. O token de acesso à outras APIs não permite o ...

    • Releases Notes Presence API

      Versão Presence WebAPI 1.0.75.0 (29/08/2025) #644962 Criação de método para entrada de estoque e EPC via API - Implementado novo método INCLUIR_EPC_SKU para incluir códigos EPC via API. - Poderão ser incluídos até 1000 EPC's por requisição. - ...

    • Presence API - Página Inicial

      Essa API permite o consumo de informações disponíveis nos sistemas Presence através de chamadas de serviço, bem como a inserção de dados nos sistemas. Para ter acesso aos métodos já existentes, ou solicitação da criação de novos métodos, consulte as ...