Para emitir um Vale-Troca, deve-se utilizar o seguinte método: EmissaoValeTroca93V2
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. |
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 -- |
<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>
Para emitir um Vale-Troca, deve-se utilizar o seguinte método: ResgateValeTroca94
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. |
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 |
<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>
Para consultar um Vale-Troca, deve-se utilizar o seguinte método: ConsultaReimpressaoValeTroca95V2
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. |
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). |
<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>
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 -- |
<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>
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 |