Página 1 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Interface Frente de Loja <–> TSCard – Gestão de Crédito
Esse documento descreve os passos necessários para a integração entre sistemas de frente
de loja e o sistema TSCard.
Integração
Será necessária a implementação de rotinas, no sistema de Frente de Loja, para capturar as
transações ocorridas com a utilização do cartão TSCard (vendas, consultas, estornos, etc.).
A integração com o sistema TSCard será feita através da Web, estabelecendo uma conexão
via socket.
Há duas modalidades de operação entre o Frente de Loja e o TSCard:
1) Movimentação do Cartão – Operações básicas do cartão, como venda e
cancelamentos. Esta modalidade deve ser, obrigatoriamente, implementada pelo
sistema de Frente de Loja. (Ver Layout 1 - Operação de Venda).
2) Consulta – Operações de consulta do limite de crédito disponível. (Ver Layout 2 Consulta).
A operação de comunicação proceder-se-á em quatro etapas:
a) O cliente (frente de loja) deverá estabelecer uma conexão, via socket em uma
determinada porta (configurável via parâmetros), com o servidor de transação;
b) Solicitar uma autorização (Enviando os parâmetros da transação conforme layout da
modalidade de operação);
c) Capturar a resposta enviada pelo servidor de transação;
d) Imprimir o Comprovante do Cliente (se for o caso).
Obs: Se ultrapassar o TIME OUT, ou ocorrer alguma queda de comunicação entre o sistema
de Frente de Loja e o TSCard durante uma operação do tipo 1 (Movimentação do Cartão),
o frente de loja deverá reenviar a transação, precedida por uma operação de desfazimento
correspondente à transação original.
Ex.: Se numa operação de Venda Rotativa (Tipo_Reg = 10) ocorrer algum problema de
comunicação e o Frente de Loja não conseguir concluir as etapas descritas acima, deverá
proceder, então, do seguinte modo:
Enviar uma transação de Desfazimento Venda Rotativa (Tipo_Reg = 51) com
todos os demais dados da transação original (o TSCard irá desfazer qualquer
atualização porventura já processada para esta transação).
Enviar novamente a transação original de Venda Rotativa (Tipo_Reg = 10).
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 2 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Alinhamento de Campos
• Campos Numéricos (Num) = Sempre à direita e preenchidos com zeros à esquerda.
• Campos Alfanuméricos (Alfa) = Sempre à esquerda e preenchidos com brancos à direita.
Recuperando dados da tarja magnética do cartão
Efetuar a leitura da trilha 2 do cartão e recuperar os campos referente ao número e o
seqüencial do cartão, utilizando o layout do anexo 1.
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 3 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Layout 1 - Operação de Venda
Layout da mensagem de remessa ( Frente de Loja TSCard )
Campo
Formato Início
Fim Tam
Dec
Descrição
Tipo_Reg
Num
1
2
2
-
Empresa
Num
3
4
2
-
Filial
Num
5
6
2
-
Código de identificação do tipo de transação. [Tabela 1].
10 - Venda Rotativa
20 - Venda Parcelada
40 - Cancelamento
51 - Desfazimento Venda Rotativa
52 - Desfazimento Venda Parcelada
54 - Desfazimento Cancelamento
Código de identificação da empresa administradora do
cartão.
Código de identificação da filial onde ocorreu a transação.
Loja
Num
7
11
5
-
Código de identificação da loja onde ocorreu a transação.
Estabelecimento
Num
12
14
3
-
Preencher com a literal 001.
Cartao
Num
15
24
10
-
Número do cartão.
Seq_Cartao
Num
25
27
3
-
Seqüencial do cartão.
Num_Documento
Num
28
33
6
-
Parcelas
Num
34
36
3
-
Valor
Num
37
46
10
2
Número do documento (comprovante de venda, recibo,
etc.).
Se venda parcelada preencher com o número de parcelas
da venda.
Se venda no rotativo preencher com 1.
Valor da operação (EX: 10,00 -> 0000001000)
Data
Num
47
54
8
-
Data da transação (no formato AAAAMMDD).
Hora
Num
55
60
6
-
Hora da transação (no formato HHMMSS).
Quantidade
Num
61
65
5
-
Campo não utilizado (preencher com zeros).
Digitado
Alfa
66
66
1
-
Indicador da forma de leitura do cartão (S ou N).
Preencher com S se o número do cartão foi digitado.
Preencher com N se foi feita a leitura da tarja magnética.
Modalidade
Num
67
67
1
-
Saldo
Num
68
78
11
2
Preencher com a modalidade da venda. Pode ser:
0 = rotativo
1 = parcelado
Campo não utilizado (preencher com zeros).
Aprovador
Num
79
84
6
-
Campo não utilizado (preencher com zeros).
Taxa
Num
85
87
3
-
Campo não utilizado (preencher com zeros).
Contrato_Empresa
Alfa
88
89
2
-
Campo não utilizado (preencher com espaços).
Contrato_Filial
Alfa
90
91
2
Campo não utilizado (preencher com espaços).
Contrato_Loja
Alfa
92
96
5
Campo não utilizado (preencher com espaços).
Filler_1
Alfa
97
101
5
Plano_Pagto
Num
102
106
5
-
Campo não utilizado (preencher com espaços).
Campo não utilizado (preencher com zeros).
Login_Operador
Alfa
107
120
14
-
Campo não utilizado (preencher com espaços).
Senha_Operador
Alfa
121
140
20
-
Nr_Terminal
Num
141
146
6
-
Campo não utilizado (preencher com espaços).
Número do terminal que enviou a transação
Login_Aprovador
Alfa
147
160
14
-
Vr_Juros
Num
161
170
10
2
Campo não utilizado (preencher com espaços).
Campo não utilizado (preencher com zeros).
Vr_Encargos
Num
171
180
10
2
Campo não utilizado (preencher com zeros).
Vr_Multa
Num
181
190
10
2
Campo não utilizado (preencher com zeros).
Vr_Pago
Num
191
200
10
2
Campo não utilizado (preencher com zeros).
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 4 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Layout da mensagem de retorno ( TSCard Frente de Loja )
Campo
Formato Início Fim Tam Dec Descrição
Empresa
Num
1
2
2
-
Código de identificação da empresa administradora
do cartão.
Código de identificação da filial onde ocorreu a
transação.
Código de identificação da loja onde ocorreu a
transação.
Preenchido com a literal 001.
Filial
Num
3
4
2
-
Loja
Num
5
9
5
-
Estabelecimento
Num
10
12
3
-
Cartao
Num
13
22
10
-
Número do cartão.
Seq_Cartao
Num
23
25
3
-
Seqüencial do cartão.
Num_Documento
Num
26
31
6
-
Cod_Autorizacao
Num
32
37
6
-
Número do documento (comprovante de venda,
recibo, etc.).
Número da autorização.
Cod_Retorno
Num
38
39
2
-
Data
Num
40
47
8
-
Código de identificação do status da transação.
[Tabela 2].
Data da transação (no formato AAAAMMDD).
Hora
Num
48
53
6
-
Hora da transação (no formato HHMMSS).
Nome
Alfa
54
83
30
-
Dt_Validade
Num
84
87
4
-
Nome do cliente (a ser utilizado na impressão do
comprovante da operação).
Validade do cartão (no formato AAMM)
CPF
Alfa
88
101
14
-
CPF do cliente
Valor
Num
102
111
10
2
Valor da operação (EX: 10,00 -> 0000001000)
Tipo_Reg
Num
112
113
2
-
Msg_Ret
Num
114
213
100
-
Código de identificação do tipo de transação.
[Tabela 1].
Mensagem de retorno
Qtd_Vnd_Rot_Parc
Num
214
219
6
0
Campo não utilizado (preenchido com zeros).
Total_Vnd_Rot_Parc
Num
220
230
11
2
Campo não utilizado (preenchido com zeros).
Qtd_Vnd_Crediario
Num
231
236
6
0
Campo não utilizado (preenchido com zeros).
Total_Vnd_Crediario
Num
237
247
11
2
Campo não utilizado (preenchido com zeros).
Qtd_Vnd_Giftcard
Num
248
253
6
0
Campo não utilizado (preenchido com zeros).
Total_Vnd_Giftcard
Num
254
264
11
2
Campo não utilizado (preenchido com zeros).
Qtd_Pgt_Fatura
Num
265
270
6
0
Campo não utilizado (preenchido com zeros).
Total_Pgt_Fatura
Num
271
281
11
2
Campo não utilizado (preenchido com zeros).
Qtd_Pgt_Acordo
Num
282
287
6
0
Campo não utilizado (preenchido com zeros).
Total_Pgt_Acordo
Num
288
298
11
2
Campo não utilizado (preenchido com zeros).
Total_Est_Vnd_Rot_Parc
Num
299
315
17
0
Campo não utilizado (preenchido com zeros).
Total_Est_Vnd_Crediario
Num
316
332
17
0
Campo não utilizado (preenchido com zeros).
Total_Est_Pgt_Fatura
Num
333
349
17
0
Campo não utilizado (preenchido com zeros).
Total_Est_Pgt_Acordo
Num
350
366
17
0
Campo não utilizado (preenchido com zeros).
Total_Est_Vnd_Giftcard
Num
367
383
17
0
Campo não utilizado (preenchido com zeros).
Dt_Abertura_Caixa
Num
384
391
8
-
Campo não utilizado (preenchido com zeros).
Hr_Abertura_Caixa
Num
392
397
6
-
Campo não utilizado (preenchido com zeros).
Qtd_Vnd_Entr_Cred
Num
398
403
6
0
Campo não utilizado (preenchido com zeros).
Total_Vnd_Entr_Cred
Num
404
414
11
2
Campo não utilizado (preenchido com zeros).
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 5 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Layout 2 – Consulta
Layout da mensagem de remessa ( Frente de Loja TSCard )
Campo
Formato Início
Fim Tam
Tipo_Reg
Num
1
2
Cartao
Num
3
12
Dec
Descrição
2
-
Código de identificação do tipo de transação. Pode ser:
10
-
95 = Consulta de limite de crédito disponível
Número do cartão.
Layout da mensagem de retorno ( TSCard Frente de Loja )
Campo
Formato
Cod_Retorno
Num
Saldo
Nome
Início
Fim Tam
1
2
Num
3
Alfa
12
Dec
Descrição
2
-
11
9
2
Código de identificação do status da transação.
[Tabela 2].
Valor do saldo disponível para compra.
41
30
-
Nome do cliente .
Atraso
Alfa
42
42
1
-
Indica se o cliente está em atraso (S ou N)
Situacao
Alfa
43
43
1
-
Código da situação do cliente. Preenchido com 1, 2,
3, 4 ou I, apenas se o cliente estiver em atraso.
Caso contrário, será preenchido com espaço.
Dt_Venc
Num
44
51
8
-
Campo não utilizado (preenchido com zeros).
Vl_Amortizacao
Num
52
60
9
2
Campo não utilizado (preenchido com zeros).
Campo não utilizado (preenchido com zeros).
Vl_Sld_Devedor
Num
61
69
9
2
Limite_Credito
Num
70
78
9
2
Limite de crédito do cliente.
Tipo_Limite
Alfa
79
79
1
-
Tipo do limite de crédito. Pode ser:
1 = global
2 = parcelado
Vl_Juros
Num
80
88
9
2
Campo não utilizado (preenchido com zeros).
Vl_Multa
Num
89
97
9
2
Campo não utilizado (preenchido com zeros).
Foto_Cliente
Alfa
98
297
200
-
Campo não utilizado (preenchido com espaços).
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 6 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Tabela 1 – Tipos de Transação
Código Descrição
10
Venda Rotativa
20
Venda Parcelada
40
Cancelamento
51
Desfazimento Venda Rotativa
52
Desfazimento Venda Parcelada
54
Desfazimento Cancelamento
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 7 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Tabela 2 - Códigos de Retorno
Código
Descrição
00
Transação aprovada
01
Data do documento inválida
02
Loja não cadastrada
03
Cliente não cadastrado em CLIEN
04
Cartão do dependente bloqueado
05
Venda Rotativo - Parcelas maior que 1
06
Transação já existente
07
Falha Interna (Erro na gravação de EVENT)
08
Venda Parcelado - Parcelas menor ou igual a 1
09
Falha Interna (Erro na gravação de CONTR)
10
Tipo de desfazimento inválido
11
Desfazimento aprovado
12
Tipo de transação inválida
13
Falha Interna (Empresa sem PRFAT)
14
Falha Interna (Empresa sem PRMOV)
15
16
Falha Interna (Erro na gravação de RECRE)
Parâmetro de venda não cadastrado
17
Cartão não é válido para esta loja
18
Convênio não autorizado
21
Usuário não existe
22
Senha não confere
23
Nº do terminal inexistente
24
Caixa anterior pendente de fechamento pelo usuário [nome_usuario]
31
Faixa de crédito não cadastrada
32
Registro não encontrado para estorno
33
Valor do estorno maior que crédito do cartão
35
Cartão não é giftcard
36
Operação inválida para tipo do cartão
40
Erro na gravação de HTRANS
41
Transação não encontrada
42
Transação já cancelada
43
Transação original com erro
44
Transação já confirmada
45
Confirmação inválida
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 8 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Código
Descrição
46
Transação original não confirmada
47
Parcelas do cancelamento diferente das parcelas da transação
48
Valor da parcela abaixo do valor mínimo
51
Cartão inexistente
52
Saldo insuficiente
53
Cartão vencido
54
Cartão com situação irregular
55
Cliente com situação irregular
56
Dependente com situação irregular
57
Data do cancelamento difere de hoje
58
Documento já cancelado
59
Cancelamento de venda inexistente
60
Valor do cancelamento diferente do valor da transação
61
Cancelamento sem faturamento
62
Plano não cadastrado para esta loja
63
Compra abaixo do valor mínimo
64
Compra acima do valor máximo
65
Cartão não cadastrado no sistema
66
Cartão cancelado
67
Cartão bloqueado
68
CPF do cliente difere do cartão da venda
69
Aprovador não cadastrado
70
Taxa maior que 100%
71
Valor pago diferente do valor da parcela mais juros, encargos e multa
72
Recebimento já processado
73
Convênio inexistente
74
Recebimento já cancelado
75
Cancelamento de recebimento convênio inexistente
76
Contrato inexistente
77
Valor da parcela menor que a do contrato
78
Cartão sem convênio
79
Parcela fora de seqüência
80
Parcela maior que a do contrato
81
Parcela paga em dia anterior
82
Cartão não pertence à empresa informada
Cliente com saldo de crediário ou acordo em aberto. verificar o tipo do pagto
83
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 9 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Código
84
Descrição
Não é permitido receber pagamento acima do valor em aberto
99
Parâmetro informado inválido, favor reenviar transação
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]
Página 10 de 10
TSCard – Gestão de Crédito
Especificações da Interface (versão operações básicas)
Anexo 1 – Layout da trilha 2 do Cartão
Campo
T2_Bin
T2_Cartao
T2_Seq
T2_Igual
T2_DtVal
T2_Senha
T2_Limite
T2_Zero
T2_Seis
T2_IniBin
T2_Um
Formato Início Fim Tam Dec Descrição
Num
1
6
Número do Bin
6
Num
7 16
10
Número do cartão
Num
17
19
3
Sequencial do cartão
Alfa
20
20
1
Literal contendo o caracter = (igual)
Num
21
24
4
Ano e mês de validade (AAMM)
Num
25
28
4
Senha
Num
29
30
2
Código de limite
Num
31
31
1
Literal contendo o caracter 1 (um)
Num
32
32
1
Literal contendo o caracter 6 (seis)
Num
33
36
4
Primeiros 4 dígitos do número do Bin
Num
37
37
1
Literal contendo o caracter 1 (um)
TSCard Tecnologia em Informática Ltda.
Av. Barbosa Lima, 149 – Sala 303 – Bairro do Recife - Recife PE - CEP 50030-917 – Fone: (081) 3227.6771 E-mail: [email protected]