Interface Frente de Loja < > TSCard Gestão de Crédito

de 10 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).

de 10 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.

de 10 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 - 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 Empresa Num 3 4 2 - Código de identificação da empresa administradora do cartão. Filial Num 5 6 2 - 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 - Número do documento (comprovante de venda, recibo, etc.). Parcelas Num 34 36 3 - Se venda parcelada preencher com o número de parcelas da venda. Se venda no rotativo preencher com 1. Valor Num 37 46 10 2 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 - Preencher com a modalidade da venda. Pode ser: 0 = rotativo 1 = parcelado Saldo Num 68 78 11 2 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 Campo não utilizado (preencher com espaços). Plano_Pagto Num 102 106 5 - 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 - Campo não utilizado (preencher com espaços). Nr_Terminal Num 141 146 6 - Número do terminal que enviou a transação Login_Aprovador Alfa 147 160 14 - Campo não utilizado (preencher com espaços). Vr_Juros Num 161 170 10 2 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).

de 10 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. Filial Num 3 4 2 - Código de identificação da filial onde ocorreu a transação. Loja Num 5 9 5 - Código de identificação da loja onde ocorreu a transação. Estabelecimento Num 10 12 3 - Preenchido com a literal 001. 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 - Número do documento (comprovante de venda, recibo, etc.). Cod_Autorizacao Num 32 37 6 - Número da autorização. Cod_Retorno Num 38 39 2 - Código de identificação do status da transação. [Tabela 2]. Data Num 40 47 8 - Data da transação (no formato AAAAMMDD). Hora Num 48 53 6 - Hora da transação (no formato HHMMSS). Nome Alfa 54 83 30 - Nome do cliente (a ser utilizado na impressão do comprovante da operação). Dt_Validade Num 84 87 4 - 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 - Código de identificação do tipo de transação. [Tabela 1]. Msg_Ret Num 114 213 100 - 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).

de 10 Layout 2 Consulta Layout da mensagem de remessa ( Frente de Loja TSCard ) Campo Formato Início Fim Tam Dec Descrição Tipo_Reg Num 1 2 2 - Código de identificação do tipo de transação. Pode ser: 95 = Consulta de limite de crédito disponível Cartao Num 3 12 10 - Número do cartão. Layout da mensagem de retorno ( TSCard Frente de Loja ) Campo Formato Início Fim Tam Dec Descrição Cod_Retorno Num 1 2 2 - Código de identificação do status da transação. [Tabela 2]. Saldo Num 3 11 9 2 Valor do saldo disponível para compra. Nome Alfa 12 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). Vl_Sld_Devedor Num 61 69 9 2 Campo não utilizado (preenchido com zeros). 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).

de 10 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

de 10 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 Falha Interna (Erro na gravação de RECRE) 16 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

de 10 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 83 Cliente com saldo de crediário ou acordo em aberto. verificar o tipo do pagto

de 10 Código Descrição 84 Não é permitido receber pagamento acima do valor em aberto 99 Parâmetro informado inválido, favor reenviar transação

de 10 Anexo 1 Layout da trilha 2 do Cartão Campo Formato Início Fim Tam Dec Descrição T2_Bin Num 1 6 6 - Número do Bin T2_Cartao Num 7 16 10 - Número do cartão T2_Seq Num 17 19 3 - Sequencial do cartão T2_Igual Alfa 20 20 1 - Literal contendo o caracter = (igual) T2_DtVal Num 21 24 4 - Ano e mês de validade (AAMM) T2_Senha Num 25 28 4 - Senha T2_Limite Num 29 30 2 - Código de limite T2_Zero Num 31 31 1 - Literal contendo o caracter 1 (um) T2_Seis Num 32 32 1 - Literal contendo o caracter 6 (seis) T2_IniBin Num 33 36 4 - Primeiros 4 dígitos do número do Bin T2_Um Num 37 37 1 - Literal contendo o caracter 1 (um)