Histórico

Versão Publicado Alterado Por Comentar
ATUAL (v. 1) jun 01, 2021 10:37
Mario Jorge Azevedo Santos


Carga Cuponagem (D1)

Para fazer uma carga de cuponagem, deve-se utilizar o método: CargaCuponagemD1.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

cpf

String

14

CPF do cliente que efetuou a carga

numeroCampanha

String

7

Número da campanha

dataInicioCampanha

String

6

Data inicial da vigência da campanha (AAMMDD)

dataFimCampanha

String

6

Data final da vigência da campanha (AAMMDD)

operador

String

6

Código do operador

cupom

String

6

Número do cupom

confirmacaoAutomatica

String

1

Flag confirmação automática (S = SIM / N = NÃO)

  

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

TextoCupom

String

999

Texto do cupom a ser impresso

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação


Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>000060004</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>7.8</SaldoDisponivel>

  <TextoCupom>         CARTAO PRE-PAGO         @                RECARGA@ DATA: 05/02/2018        HORA: 17:12:44@ ESTAB: 0189           @ CARTAO:0077400039947181049@ NSU_SAFE:000060004 APROV: 778012@ VALOR DA RECARGA:       7,80@ SALDO ATUAL:            7,80@ @  LOJA: 0189 PDV: 646@</TextoCupom>

  <Cartao>77400039947181049</Cartao>

  <Bit62> TRANSAC APROVADA000000000000#28310         CARTAO PRE-PAGO         @                RECARGA@ DATA: 05/02/2018        HORA: 17:12:44@ ESTAB: 0189           @ CARTAO:0077400039947181049@ NSU_SAFE:000060004 APROV: 778012@ VALOR DA RECARGA:       7,80@ SALDO ATUAL:            7,80@ @ NSU_CTF: 000000 LOJA: 0189 PDV: 646@000005</Bit62>

  <TempoResposta>6077</TempoResposta>

  <DataHoraTransacao>0205171244</DataHoraTransacao>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Carga Cuponagem V2 (D1)

Para fazer uma carga de cuponagem passando o valor da campanha, deve-se utilizar o método: CargaCuponagemD1V2.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

cpf

String

14

CPF do cliente que efetuou a carga

numeroCampanha

String

7

Número da campanha

dataInicioCampanha

String

6

Data inicial da vigência da campanha (AAMMDD)

dataFimCampanha

String

6

Data final da vigência da campanha (AAMMDD)

operador

String

6

Código do operador

cupom

String

6

Número do cupom

confirmacaoAutomatica

String

1

Flag confirmação automática (S = SIM / N = NÃO)

valorTransacao

Double

12,2

Valor da transação

  

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

TextoCupom

String

999

Texto do cupom a ser impresso

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>000060004</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>7.8</SaldoDisponivel>

  <TextoCupom>         CARTAO PRE-PAGO         @                RECARGA@ DATA: 05/02/2018        HORA: 17:12:44@ ESTAB: 0189           @ CARTAO:0077400039947181049@ NSU_SAFE:000060004 APROV: 778012@ VALOR DA RECARGA:       7,80@ SALDO ATUAL:            7,80@ @  LOJA: 0189 PDV: 646@</TextoCupom>

  <Cartao>77400039947181049</Cartao>

  <Bit62> TRANSAC APROVADA000000000000#28310         CARTAO PRE-PAGO         @                RECARGA@ DATA: 05/02/2018        HORA: 17:12:44@ ESTAB: 0189           @ CARTAO:0077400039947181049@ NSU_SAFE:000060004 APROV: 778012@ VALOR DA RECARGA:       7,80@ SALDO ATUAL:            7,80@ @ NSU_CTF: 000000 LOJA: 0189 PDV: 646@000005</Bit62>

  <TempoResposta>6077</TempoResposta>

  <DataHoraTransacao>0205171244</DataHoraTransacao>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Resgate de Cuponagem (D3)

Para fazer um resgate de cuponagem, deve-se utilizar o método: ResgataCuponagemD3.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

cpf

String

14

CPF do cliente que efetuou a carga

numeroCampanha

String

7

Número da campanha

operador

String

6

Código do operador

cupom

String

6

Número do cupom

 

 Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

TextoCupom

String

999

Texto do cupom a ser impresso

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>000060006</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <Cartao>77400039947181049</Cartao>

  <Bit62> TRANSAC APROVADA                                             #28510         CARTAO PRE-PAGO         @             COMPRA/RESGATE@ DATA: 05/02/2018        HORA: 17:15:21@ ESTAB: 0189           @ CARTAO:0077400039947181049@ NSU_SAFE:000060006 APROV: 178492@ VALOR DA COMPRA:       7,80@ SALDO ATUAL:               @ @ NSU_CTF: 000000 LOJA: 0189 PDV: 646@</Bit62>

  <TempoResposta>5563</TempoResposta>

  <DataHoraTransacao>0205171521</DataHoraTransacao>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Resgate de Cuponagem V2 (D3)

Para fazer um resgate de cuponagem passando o valor da campanha, deve-se utilizar o método: ResgataCuponagemD3V2.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

cpf

String

14

CPF do cliente que efetuou a carga

numeroCampanha

String

7

Número da campanha

operador

String

6

Código do operador

cupom

String

6

Número do cupom

Valor Total Transação

Double

12,2

Valor da transação

 

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

TextoCupom

String

999

Texto do cupom a ser impresso

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>000060006</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <Cartao>77400039947181049</Cartao>

  <Bit62> TRANSAC APROVADA                                             #28510         CARTAO PRE-PAGO         @             COMPRA/RESGATE@ DATA: 05/02/2018        HORA: 17:15:21@ ESTAB: 0189           @ CARTAO:0077400039947181049@ NSU_SAFE:000060006 APROV: 178492@ VALOR DA COMPRA:       7,80@ SALDO ATUAL:               @ @ NSU_CTF: 000000 LOJA: 0189 PDV: 646@</Bit62>

  <TempoResposta>5563</TempoResposta>

  <DataHoraTransacao>0205171521</DataHoraTransacao>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Consulta de Cuponagem (D5)

Para fazer uma consulta de cuponagem, deve-se utilizar o método: ResgataCuponagemD3.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

cpf

String

14

CPF do cliente que efetuou a carga

numeroCampanha

String

7

Número da campanha

operador

String

6

Código do operador

cupom

String

6

Número do cupom

 

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

Cartão

String

19

Número do cartão

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>000060005</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <Cartao>77400039947181049</Cartao>

  <Bit62> TRANSAC APROVADA000399471810490000040171226181226007</Bit62>

  <TempoResposta>2734</TempoResposta>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Consulta de Cuponagem V2 (D5)

Para fazer uma consulta de cuponagem passando o valor da campanha, deve-se utilizar o método: ResgataCuponagemD3V2.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

codigoLoja

String

4

Código da loja

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 1 deve ser passado 001

estabelecimento

String

15

Representa o código do estabelecimento

cpf

String

14

CPF do cliente que efetuou a carga

numeroCampanha

String

7

Número da campanha

operador

String

6

Código do operador

cupom

String

6

Número do cupom

Valor Total Transação

Double

12,2

Valor da transação

  

Parâmetros de Saída

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSU Safe

String

9

NSU do SAFE

Mensagem PDV

String

12

Mensagem a ser exibida no PDV

Saldo Disponível

Double

12,2

Saldo disponível da lista

Cartão

String

19

Número do cartão

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

Data / Hora da transação

String

10

Data / Hora da transação

Máscara: MMDDHHMMSS

Valor Total Transação

Double

12,2

Valor da transação

  

Exemplo de XML de Resposta

<RespostaSAFE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>000060005</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <Cartao>77400039947181049</Cartao>

  <Bit62> TRANSAC APROVADA000399471810490000040171226181226007</Bit62>

  <TempoResposta>2734</TempoResposta>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>

 

  • Sem rótulos