Histórico

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


Consulta Boleto ACOM (7C)

Para fazer uma consulta de boleto ACOM, deve-se utilizar o método: ConsultaBoletoAcom7C.

 

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

numeroBoleto

String

19

Número do boleto a ser consultado

  

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

Nome do Cliente

String

25

Nome do cliente

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>054665631</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <Bit62> TRANSAC APROVADABOL.7790000200200200300  N                    000000000001000000000000000000000000000000000000000005000000000000000000000005000000000000000001000000000000500000000000005000000000005000020180301</Bit62>

  <TempoResposta>737</TempoResposta>

  <Validade>20180301</Validade>

  <DataHoraTransacao>0206110943</DataHoraTransacao>

  <NomeCliente>BOL.7790000200200200300  </NomeCliente>

  <ValorTotalTransacao>500</ValorTotalTransacao>

</RespostaSAFE>



Pagamento Boleto ACOM (9C)

Para fazer um pagamento de boleto ACOM, deve-se utilizar o método: PagamentoBoletoAcom9C.

 

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

numeroCupom

String

6

Número do cupom

horaLocal

String

6

Representa a hora local do PDV

Mascara: hhmmss

dataLocal

String

4

Representa a data local do PDV

Mascara: MMDD

numeroBoleto

String

19

Número do boleto a ser pago

valorBoleto

Double

12,2

Valor do boleto

dataVencimentoBoleto

String

8

Data de vencimento do boleto (AAAAMMDD)

codigoDeBarras1

String

21

Código de barras 1

codigoDeBarras2

String

21

Código de barras 2

FormasPagamento

Tipo Complexo

 

Formas de pagamento do boleto

  

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

Texto do Cupom

String

999

Texto to cupom

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

Nome do Cliente

String

25

Nome do cliente

Valor Total Transação

Double

12,2

Valor da transação

 

Exemplo de XML de Resposta

<?xml version="1.0" encoding="utf-16"?>

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

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>054665643</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <TextoCupom>COMPROVANTE DE OUTROS RECEBIMENTOS

 

NUM. DOCUMENTO: 7790000200200200303-12

NUM. PEDIDO: 000200200200303

VENCIMENTO EM: 07/02/2018

 

PAGTO ACOM NO VALOR DE R$ 500,00

PAGO EM:

DINHEIRO: 250.00

DEBITO VISA: 250.00</TextoCupom>

  <TempoResposta>576</TempoResposta>

  <DataHoraTransacao>0131114942</DataHoraTransacao>

  <ValorTotalTransacao>0</ValorTotalTransacao>

</RespostaSAFE>



ConsultaAssociado6B

Para fazer uma consulta de associado: ConsultaAssociado6B.

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

numeroCartao

String

19

Número do cartão do conveniado

codigoEstabelecimento

String

15

Representa o código do estabelecimento.

ESTABELECIMENTO.CODIGO_ESTABELECIMENTO

codigoEmpresa

String

5

Representa o código da empresa.

Ex: 00001

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

  

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

 

 

Saldo disponível do cartão

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

DataCarga

Char

8

Data da primeira Carga.

Máscara: AAAAMMDD

Validade

Char

4

Data de validade.

Máscara: AAMM

DataUltimaRecarga

Char

8

Data da última Carga.

Máscara: AAAAMMDD

TipoResgatePermitido

Char

1

Tipo de resgate.

P – Parcial

T – Total

CartaoPermiteRecarga

Char

1

Permite Resgate.

S – Sim

N – Não

ValorMinimoRecarga

Char

12

Valor mínimo para resgate.

ValorMaximoRecarga

Char

12

Valor máximo para Resgate

NomeResponsavel

Char

25

Nome do Cartao

Cpf

Numeric

14

CPF/CNPJ responsável

Matricula

Char

10

Matricula

TipoConvenio

Char

1

Tipo de Convenio

1 – Pos

2 – Pre

NomeEmpresaConveniada

Char

40

Nome do Convenio

FlagValidacaoCartao

Char

1

Tipo de Validação do Cartao.

0 - não pede nada

1 - deve pedir 4 Últ. dígitos

2 - deve pedir CVV2

3 - deve pedir 4 Últ. dígitos e CVV2

4 - deve pedir senha

5 - deve pedir senha e 4 dígitos Últ.

6 - deve pedir senha e CVV2

7 - deve pedir senha, 4 Últ. e CVV2

QuantidadePlanos

Numeric

2

Quantidade de planos disponíveis

CodigoPlanoPagamento

Numeric

5

Código do Plano

NumeroParcelas

Numeric

2

Numero de Parcelas

TaxaJuros

Char

8

Taxa de Juros

FatorEntrada

Char

8

Fator de Entrada

QuantidadeValoresFixos

Char

2

Quantidade de valores fixos

ValoresFixos

Char

40

Valores Fixos

Logradouro

Char

40

Nome do Logradouro

Numero

Numeric

10

Numero

Complemento

Char

40

Complemento

Bairro

Char

40

Bairro

Cidade

Char

40

Cidade

Pais

Char

3

Sigla Pais

Uf

Char

2

Sigla UF

Cep

Numeric

8

CEP

PercentualDescontoEvento

Numeric

10

Percentual de Desconto

QuantidadeConvenios

Numeric

2

Quantidade de Convenios

Convenios

Char

40

Lista Convenios

ValorTotalTransacao

Char

12

Valor Trs

EmailCliente

String

 

Email do cliente

  

Exemplo de XML de resposta:

<?xml version="1.0" encoding="utf-16"?>

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

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>054666069</NSUSafe>

  <MensagemPDV>TRANSAC APROVADA</MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <TempoResposta>1227</TempoResposta>

  <DataCarga>00000000</DataCarga>

  <Validade>0000</Validade>

  <DataUltimaRecarga>00000000000000</DataUltimaRecarga>

  <TipoResgatePermitido>0</TipoResgatePermitido>

  <CartaoPermiteRecarga>0</CartaoPermiteRecarga>

  <ValorMinimoRecarga>000000000000</ValorMinimoRecarga>

  <ValorMaximoRecarga>000000000000</ValorMaximoRecarga>

  <NomeResponsavel>DEISE DE PAULA CORREA                   </NomeResponsavel>

  <Cpf>04209764426</Cpf>

  <Matricula>          </Matricula>

  <TipoConvenio>0</TipoConvenio>

  <NomeEmpresaConveniada>Convenio Associado                      </NomeEmpresaConveniada>

  <FlagValidacaoCartao>0</FlagValidacaoCartao>

  <QuantidadePlanos>01</QuantidadePlanos>

  <CodigoPlanoPagamento>00030</CodigoPlanoPagamento>

  <NumeroParcelas>01</NumeroParcelas>

  <TaxaJuros>00000000</TaxaJuros>

  <FatorEntrada>00000000</FatorEntrada>

  <QuantidadeValoresFixos>05</QuantidadeValoresFixos>

  <ValoresFixos>0000000000000000000000000000000000000000</ValoresFixos>

  <Logradouro>N0000                                             </Logradouro>

  <Numero>        </Numero>

  <Complemento>                    </Complemento>

  <Bairro>                                             </Bairro>

  <Cidade>                                             </Cidade>

  <Pais>   </Pais>

  <Uf>  </Uf>

  <Cep>          </Cep>

  <PercentualDescontoEvento>10,00</PercentualDescontoEvento>

  <QuantidadeConvenios>  </QuantidadeConvenios>

  <Convenios>                                                            </Convenios>

  <ValorTotalTransacao>0</ValorTotalTransacao>

  <EmailCliente>marcos.antonio@linx.com.br</EmailCliente>

</RespostaSAFE>



Compra de Associado (B1)

Para realizar uma compra de um cliente associado, deve-se utilizar o método: CompraAssociadoB1

 

Parâmetros de entrada

Nome

Tipo

Tamanho

Descrição

numeroCartao

String

19

Número do cartão do conveniado

codigoEstabelecimento

String

15

Representa o código do estabelecimento.

 

ESTABELECIMENTO.CODIGO_ESTABELECIMENTO

codigoEmpresa

String

5

Representa o código da empresa.

Ex: 00001

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

Valor Total Transação

Double

12,2

Valor da transação

Número do Cupom

Int

6

Número do cupom

Senha

String

16

String criptografada pelo PDV

  

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

Numeric

 

Saldo disponível do cartão

TextoCupom

String

250

Texto do Cupom

Tempo de Resposta

Numeric

6

Tempo de resposta da transação

NomeResponsavel

String

40

Nome do Cliente

TipoConvenio

Char

1

Tipo do Convênio.

1 – Pós

2 – Pré (Cartao Presente/RT)

3 – Pat

NumeroParcelas

Char

2

Numero de Parcelas da Transacao

DescricaoFormaPagamento

Char

20

Descricao da forma de pagamento

ValorVenda

Char

12

Valor da Transacao

ValorEncargo

Char

12

Valor dos Encargos

ValorParcelas

Char

12

Valor de cada parcela

DataVencimentoPrimeiraParcela

Char

8

Data de Vencimento da primeira parcela.

Máscara: AAAMMDD

Utilizado na modalidade pós-pago

CodigoCritica

Char

2

Código de Retorno da Crítica.

CodigoEmpresaConveniada

Char

6

Código do Convênio

EmpresaConveniada

String

40

Nome do Convênio

NumeroCartao

Numeric

19

Numero do cartão

ValorTotalTransacao

Numeric

12

-- DEPRECATED --

EmailCliente

String

 

Email do cliente

  

XML de Retorno

<?xml version="1.0" encoding="utf-16"?>

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

  <CodigoResposta>00</CodigoResposta>

  <NSUSafe>054666636</NSUSafe>

  <MensagemPDV>TRANSAC APROV   </MensagemPDV>

  <SaldoDisponivel>0</SaldoDisponivel>

  <TextoCupom> COMPRA CARTAO DE CONVENIO

 

 SAFE

 

 DATA  : 26/03/2018   HORA: 15:09:53

 CUPOM : 00000000000000123456

 CONVEN: 000008 Convenio Associado                     

 CARTAO: 888800*********9997

 ESTAB : 987654321000000

 NSU   : 054666636    APROV: 107632

 VENDA EM 01 PARCELAS

 VALOR VENDA  :         0,00

 VALOR ENTRADA:         0,00

 VALOR FINAL  :         0,01

 

 ASS.:...............................

     DEISE DE PAULA CORREA                  

 

 TEL.:

 LOJA: 0001 PDV: 001

</TextoCupom>

  <TempoResposta>566</TempoResposta>

  <NomeResponsavel>DEISE DE PAULA CORREA                   </NomeResponsavel>

  <Debug>Depois do receive do header da MSG ISO. 361</Debug>

  <TipoConvenio>0</TipoConvenio>

  <NumeroParcelas>01</NumeroParcelas>

  <DescricaoFormaPagamento>PLANO CONVENIO      </DescricaoFormaPagamento>

  <ValorVenda>000000000001</ValorVenda>

  <ValorEncargo>000000000000</ValorEncargo>

  <ValorParcelas>000000000000</ValorParcelas>

  <DataVencimentoPrimeiraParcela>00000000</DataVencimentoPrimeiraParcela>

  <CodigoCritica>OK </CodigoCritica>

  <CodigoEmpresaConveniada>000008</CodigoEmpresaConveniada>

  <EmpresaConveniada>Convenio Associado                      </EmpresaConveniada>

  <NumeroCartao>0000000000000009997</NumeroCartao>

  <ValorTotalTransacao>0</ValorTotalTransacao>

  <EmailCliente>marcoss.antonio@linx.com.br</EmailCliente>

</RespostaSAFE>


  • Sem rótulos