Histórico


Emissão de Vale-Troca

Para emitir um Vale-Troca, deve-se utilizar o seguinte método: EmissaoValeTroca93V2


 Parâmetros de entrada

Nome

Tipo

Tamanho

Obrigatório

Descrição

estabelecimento

String

15

S

Representa o código do estabelecimento. ESTABELECIMENTO.CODIGO_ESTABELECIMENTO. Completar com espaços a direita até 15 posições.

codigoLoja

String

4

S

Representa o número da loja.Deve-se completar com zeros a esquerda.Ex: Loja 1 deve ser passado 0001

pdv

String

3

S

Representa o número do PDVDeve-se completar com zeros a esquerda.Ex: PDV 22 deve ser passado 022

valorTransacao

Double

12,2

S

Valor da transação / valor do vale troca a ser emitido

horaLocal

String

6

S

Representa a hora local do PDVMascara: hhmmss

dataLocal

String

4

S

Representa a data local do PDVMascara: MMDD

tipoCliente

Char

1

S

Se é Física (F), Jurídica (J), Estrangeiro (E)

nomeCliente

String

50

S

Nome do cliente no vale troca

cpfCnpj

String

15

S

CPF / CNPJ do cliente do vale troca.Deve-se completar com zeros a esquerda.

rg

String

10

S

RG do cliente do vale troca. Se não possuir o dado pode passar 0(zero).

orgaoEmissorRg

String

10

S

Órgão emissor do RG do cliente no vale troca

dataNascimento

String

8

S

Data de nascimento do cliente no vale trocaMascara: AAAAMMDD

numeroTelefone

String

10

S

Telefone do cliente do vale troca

numeroCupomTroca

String

6

S

Número do cupom de troca

numeroCupomVale

String

6

S

Número do cupom do vale

dataVenda

String

8

S

Data da venda do produto a ser trocadoMascara: AAAAMMDD

numeroLojaVenda

String

4

S

Loja que vendeu o produto a ser trocado.Deve-se completar com zeros a esquerda.Ex: Loja 1 deve ser passado 0001

numeroPdvVenda

String

3

S

Número do PDV que vendeu o produto a ser trocado.Deve-se completar com zeros a esquerda.Ex: PDV 22 deve ser passado 022

nsuVenda

String

6

S

NSU do terminal que vendeu o produto a ser trocado.Deve-se completar com zeros a esquerda.

numeroCupomVenda

String

6

S

Número do cupom do produto a ser trocado.Deve-se completar com zeros a esquerda.

numeroOperadorVenda

String

6

S

Número do operador que realizou a venda do produto a ser trocado.Deve-se completar com zeros a esquerda.

numeroOperadorEmissao

String

6

S

Número do operador que está realizando a emissão do vale troca.Deve-se completar com zeros a esquerda.

numeroFiscalEmissao

String

6

S

Número do fiscal que realizou a sensibilização.Deve-se completar com zeros a esquerda.

dataSensibilizacao

String

8

S

Data da sensibilizaçãoMáscara: AAAAMMDD. Data válida que pode ser a data corrente.

lojaSensibilizacao

String

4

S

Número da loja em que a sensibilização foi realizada.Deve-se completar com zeros a esquerda.Ex: Loja 1 deve ser passado 0001

pdvSensibilizacao

String

3

S

Número do PDV em que a sensibilização foi realizada.Deve-se completar com zeros a esquerda.

nsuSensibilizacao

String

6

S

NSU do terminal no qual a sensibilização foi realizada.Deve-se completar com zeros a esquerda. Se não possuir o dado, preencher com zeros.

operadorSensibilizacao

String

6

S

Matrícula do operador que realizou a sensibilização.Deve-se completar com zeros a esquerda. Se não possuir o dado, preencher com zeros.

fiscalSensibilizacao

String

6

S

Matrícula do fiscal que realizou a sensibilizaçãoDeve-se completar com zeros a esquerda. Se não possuir o dado, preencher com zeros.

mac

String

4

S

Message Authentication Code.Código que representa o MAC da transação.Vide item “Cálculo MAC” no documento.

tipoDocumentoEstrangeiro

Char

20

N

Tipo de documento para Cliente estrangeiro. Deve ser preenchido com RNE ou PASSAPORTE apenas quando tipoCliente for E.

documentoEstrangeiro

Char

20

N

Número do documento para Cliente estrangeiro. Deve ser preenchido quando tipoCliente for E.

 

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

NSUSafe

String

9

NSU SAFE da Transação

MensagemPDV

String

16

Mensagem a ser exibida no terminal

SaldoDisponivel

Double

12,2

-- DEPRECATED --

TextoCupom

String

260

Texto do cupom impresso no PDV.O caracter @ significa quebra de linha.

Cartao

String

19

Número do Vale-Troca gerado

TempoResposta

Numeric

6

Tempo de Resposta da Transação

DataHoraTransacao

String

10

Data/Hora da Transação realizada.Máscara: MMDDHHMMSS

ValorTotalTransacao

Double

12,2

-- DEPRECATED --

 

XML de Retorno

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

    <CodigoResposta>00</CodigoResposta>

    <NSUSafe>000073430</NSUSafe>

    <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

    <SaldoDisponivel>0</SaldoDisponivel>

    <TextoCupom>CUPOM VALE TROCA DATA DA OPERACAO....: 03/03/2016 Prazo de Validade...: 90 dias CAIXA...............: 001 VALOR...............: 15,50 NUM. VALE TROCA.....: 439 MAC VALE TROCA......: 7059 NSU: 000073430 OPER: 444444 AUT: 555555 Thiago Neves 00000439000015507059</TextoCupom>

    <Cartao>0000000000000000439</Cartao>

    <TempoResposta>741</TempoResposta>

    <DataHoraTransacao>0303095615</DataHoraTransacao>

<ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



Resgate de Vale-Troca (Utilização)

Para emitir um Vale-Troca, deve-se utilizar o seguinte método: ResgateValeTroca94

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

estabelecimento

String

15

Representa o código do estabelecimento.

 ESTABELECIMENTO.CODIGO_ESTABELECIMENTO

codigoLoja

String

4

Representa o número da loja.

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Representa o número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 22 deve ser passado 022

valorTransacao

Double

12,2

Valor da transação / valor do vale troca a ser emitido

horaLocal

String

6

Representa a hora local do PDV

Mascara: hhmmss

dataLocal

String

4

Representa a data local do PDV

Mascara: MMDD

tipoCliente

Char

1

Se é Física (F), Jurídica (J), Estrangeiro (E)

cpfCnpj

String

15

CPF / CNPJ do cliente do vale troca.

Deve-se completar com zeros a esquerda.

dataNascimento

String

8

Data de nascimento do cliente no vale troca

Mascara: AAAAMMDD

mac

String

4

Message Authentication Code.

Código que representa o MAC da transação.

Vide item “Cálculo MAC” no documento.

numeroValeTroca

String

8

Número do vale troca a ser resgatado

nsuSensibilizacao

String

6

NSU do terminal no qual a sensibilização foi realizada.

Deve-se completar com zeros a esquerda.

numeroOperador

String

6

Número do operador que está realizando o resgate do vale troca.

Deve-se completar com zeros a esquerda.

numeroFiscal

String

6

Número do fiscal que está realizando o resgate.

Deve-se completar com zeros a esquerda.

numeroCupom

String

6

Número do cupom de troca.

Deve-se completar com zeros a esquerda.

 

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

NSUSafe

String

9

NSU SAFE da Transação

MensagemPDV

String

16

Mensagem a ser exibida no terminal

SaldoDisponivel

Double

12,2

-- DEPRECATED --

TextoCupom

String

260

Texto do cupom impresso no PDV.

O caracter @ significa quebra de linha.

Cartao

String

19

Número do Vale-Troca gerado

TempoResposta

Numeric

6

Tempo de Resposta da Transação

DataHoraTransacao

String

10

Data/Hora da Transação realizada.

Máscara: MMDDHHMMSS

 

XML de Retorno

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

    <CodigoResposta>00</CodigoResposta>

    <NSUSafe>000073432</NSUSafe>

    <MensagemPDV>SAFE001404500000</MensagemPDV>

    <SaldoDisponivel>0</SaldoDisponivel>

    <TextoCupom>SAFE0014045000000123456789705900000000155077777720160303</TextoCupom>

    <Cartao>0000000000000000439</Cartao>

    <TempoResposta>688</TempoResposta>

    <DataHoraTransacao>0303095615</DataHoraTransacao>

</RespostaSAFE>



Consulta de Vale-Troca

Para consultar um Vale-Troca, deve-se utilizar o seguinte método: ConsultaReimpressaoValeTroca95V2

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

estabelecimento

String

15

Representa o código do estabelecimento.

 

ESTABELECIMENTO.CODIGO_ESTABELECIMENTO

codigoLoja

String

4

Representa o número da loja.

Deve-se completar com zeros a esquerda.

Ex: Loja 1 deve ser passado 0001

pdv

String

3

Representa o número do PDV

Deve-se completar com zeros a esquerda.

Ex: PDV 22 deve ser passado 022

valorTransacao

Double

12,2

Valor da transação / valor do vale troca a ser emitido

horaLocal

String

6

Representa a hora local do PDV

Mascara: hhmmss

dataLocal

String

4

Representa a data local do PDV

Mascara: MMDD

dataMovimentoPDV

String

10

Reservado para uso futuro. Passar branco.

tipoCliente

Char

1

Se é Física (F), Jurídica (J), Estrangeiro (E)

Se for passado o valor V, a pesquisa será realizada pelo número do VT (informado no parâmetro cpfCnpj)

cpfCnpj

String

15

CPF / CNPJ do cliente do vale troca.

Deve-se completar com zeros a esquerda.

É possível informar o número do VT nesse parâmetro, desde que tipoCliente seja V.

tipoDocumentoEstrangeiro

Char

20

Tipo de documento para Cliente estrangeiro. Deve ser preenchido com RNE ou PASSAPORTE apenas quando tipoCliente for E.

documentoEstrangeiro

Char

20

Número do documento para Cliente estrangeiro. Deve ser preenchido quando tipoCliente for E.

 

Parâmetros de saída (Quando tipoCliente = V)

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSUSafe

String

9

NSU SAFE da Transação

SaldoDisponivel

Double

12,2

Valor do VT

Cartao

String

19

Número do Vale-Troca gerado

TempoResposta

Numeric

6

Tempo de Resposta da Transação

DataHoraTransacao

String

10

Data/Hora da Transação realizada.

Máscara: MMDDHHMMSS

Cpf

Numeric

15

CPF do Cliente emissor do VT

DataVencimentoPrimeiraParcela

String

10

Data de Validade do VT.

Máscara: AAAAMMDD

NomeCliente

String

50

Nome do Cliente

NumeroVale

Numeric

8

Numero do VT

Mac

String

4

MAC da transação de Emissão do VT

ValorValeTroca

String

12

Valor do VT.

Ex: 000000001550

Representa R$ 15,50

OperadorSensibilizacao

String

6

Matrícula do operador que realizou a sensibilização.

DataEmissaoVale

String

10

Data de Emissão do VT.

Máscara: AAAAMMDD

CodigoMensagemOriginal

String

4

Código da Mensagem da transação de emissão

DataHoraTransacaoOriginal

String

10

Data/Hora da Transação realizada.

Máscara: MMDDHHMMSS

NsuTef

String

6

NSU do TEF

TipoPesoa

Char

1

Tipo do Cliente.

F – Fisico

J – Juridico

E – Estrangeiro

TipoDocumento

String

20

Tipo do documento utilizado na Emissao do VT (Apenas para tipoPessoa = E).

RNE ou PASSAPORTE.

NumeroDocumento

String

20

Número do documento utilizado na emissão do VT (Apenas para tipoPessoa = E).

 

XML de Retorno:

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

    <CodigoResposta>00</CodigoResposta>

    <NSUSafe>000073430</NSUSafe>

    <SaldoDisponivel>15.5</SaldoDisponivel>

    <TempoResposta>130</TempoResposta>

    <DataHoraTransacao>0303160705</DataHoraTransacao>

    <Cpf>123456789</Cpf>

    <DataVencimentoPrimeiraParcela>20160601</DataVencimentoPrimeiraParcela>

    <NomeCliente>THIAGO NEVES</NomeCliente>

    <NumeroVale>00000439</NumeroVale>

    <Mac>7059</Mac>

    <ValorValeTroca>000000001550</ValorValeTroca>

    <OperadorSensibilizacao>777777</OperadorSensibilizacao>

    <DataEmissaoVale>20160303</DataEmissaoVale>

    <CodigoMensagemOriginal>0200</CodigoMensagemOriginal>

    <DataHoraTransacaoOriginal>0303095615</DataHoraTransacaoOriginal>

    <TipoPessoa>F</TipoPessoa>

    <TipoDocumento/>

    <NumeroDocumento/>

</RespostaSAFE>

 

Parâmetros de saída (Quando tipoCliente <> V)

Nome

Tipo

Tamanho

Descrição

CodigoResposta

String

2

Código de Resposta da Transação.

Vide item “Códigos de Resposta” no documento

NSUSafe

String

9

NSU SAFE da Transação

SaldoDisponivel

Double

12,2

-- DEPRECATED --

MensagemPDV

String

16

-- DEPRECATED --

TempoResposta

Numeric

6

Tempo de Resposta da Transação

DataHoraTransacao

String

10

Data/Hora da Transação realizada.

Máscara: MMDDHHMMSS

Bit62

String

80

Bit 62 do retorno

Vide detalhamento abaixo.

NomeCliente

String

50

Nome do Cliente

NumeroVale

Numeric

8

-- DEPRECATED --

Mac

String

4

-- DEPRECATED --

ValorValeTroca

String

12

-- DEPRECATED --

OperadorSensibilizacao

String

6

-- DEPRECATED --

DataEmissaoVale

String

10

-- DEPRECATED --

QuantidadeValesUsaveis

String

2

Quantidade de VTs emitidos e não utilizados

ValorTotalTransacao

Numeric

12

-- DEPRECATED --

 

XML de Retorno:

<RespostaSAFE>

<CodigoResposta>00</CodigoResposta>

<NSUSafe>000078585</NSUSafe>

<MensagemPDV>ELA </MensagemPDV>

<SaldoDisponivel>0</SaldoDisponivel>

<Bit62> ELA 13SAFE001203800001480650300000000000000023820160629SAFE001203800001482610700000000000000360020160629SAFE001203800001492994500000000000000699620160629SAFE001203800001502202800000000000000400020160704SAFE001203800001493238100000000000000630020160701SAFE001203800001530652800000000000000440020160713SAFE001203800001481001100000000000000360020160629SAFE001203800001483494200000000000001000020160629SAFE001203800001486800000000000000001500020160629SAFE001203800001491654000000000000001290020160629SAFE001203800001476553900000000000000400020160629SAFE001203800001494238100000000000000630020160701SAFE001203800001529675900000000000000260020160707TRANSAC APROVADA</Bit62>

<TempoResposta>265</TempoResposta>

<DataHoraTransacao>0714115622</DataHoraTransacao>

<NomeCliente>ELA</NomeCliente>

<NumeroVale>00001480</NumeroVale>

<Mac>6503</Mac>

<ValorValeTroca>000000000238</ValorValeTroca>

<OperadorSensibilizacao>000000</OperadorSensibilizacao>

<DataEmissaoVale>20160629</DataEmissaoVale>

<QuantidadeValesUsaveis>13</QuantidadeValesUsaveis>

<ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>

 

Detalhamento do Bit62

Nome

Tipo

Tamanho

Descrição

Filler

Char

1

‘ ‘ (Espaço)

Nome do Cliente

String

50

Nome do Cliente

Qtd. de Vales Utilizáveis

Numeric

2

Qtd. de VTs emitidos e não utilizados (inclusive vencidos)

Nome do subcampo

Char

8

SAFE0012 – Dados de Vale para Reimpressão (repete-se tantas vezes quanto for a quantidade acima)

Tamanho do subcampo

Numeric

3

038 (Fixo)

Número do Vale

Char

8

Número de Vale Troca

MAC do Vale

Char

4

Message Authentication Code

Operador da Sensibilização

Char

6

Matrícula do Operador

Valor do Vale

Char

12

Valor do Vale Troca

Data de emissão

Char

8

Máscara: AAAAMMDD