guia tecnico gerenciador padrao 2.1_31102000

Guia Tcnico da Soluo TEF DiscadoINTERFACE E AMBIENTEVerso 2.1 - 31/10/2000

Guia Tcnico da Soluo TEF Discado - INTERFACE EAMBIENTE - V 2.1

1

OBJETIVOO Guia Tcnico da Soluo TEF Discado foi elaborado para apoiar a integrao de Aplicativos de Automao Comercial ao ambiente de tratamento de venda com cartes de Crdito, Dbito, CDC (Crdito Direto ao Consumidor Venda com Dbito Parcelado) e Consultas de Cheques*, com as Redes Amex, Redecard e Visanet. Este guia trata os dois grandes temas referentes integrao: INTERFACE e AMBIENTE, onde so considerados o funcionamento e o layout de mensagens, e ambiente de hardware e sistema operacional necessrios para utilizao da Soluo TEF Discado. Este Guia visa elucidar os objetivos do Sistema, bem como esclarecer os detalhes tcnicos e as seqncias de passos a serem seguidos para proporcionar uma correta e eficiente implantao. Eventuais dvidas podero ser sanadas com:

SevenPdv e-mail : [email protected] tel./ fax: (0xx11) 253-1722

Software Express e-mail: [email protected] tel./ fax: (0xx11) 3021-5368

Qualquer sugesto ou comentrio que venha contribuir para o enriquecimento deste material ser bem vinda atravs dos seguintes contatos:Redecard Anna Patricia Campos tel.: (0xx11) 3150-0909 Visanet Regina Gouveia tel.: (0xx11) 5696-7638 Wilson Futema e-mail: [email protected] tel: (0xx11) 5696-7624 Amex Marcelo H Martins [email protected] tel: (0xx11) 3741-8372

e-mail: [email protected] e-mail: [email protected] e-mail:

INDICE

INTERFACE E AMBIENTE1. Apresentao........................................................................................................................................................................3

Guia Tcnico da Soluo TEF Discado

2

2.1. Automao Comercial....................................................................................................................................................4 2.2 Gerenciador Padro........................................................................................................................................................5 2.3 Mdulo TEF.....................................................................................................................................................................5 3. Informaes Tcnicas ..........................................................................................................................................................6 3.1Comunicao entre a Soluo TEF Discado e a Automao Comercial ......................................................................6 3.2Procedimentos para a transao TEF: ...........................................................................................................................8 4. Layout de Mensagens de Comunicao..........................................................................................................................10 4.1Campos presentes nas mensagens geradas pelo Aplicativo de Automao Comercial - Solicitaes........................11 (C:\TEF_DIAL\REQ\IntPos.001)..............................................................................................................................11 4.2 Campos presentes nas mensagens geradas pelo Gerenciador Padro - Status..........................................................12 (C:\TEF_DIAL\RESP \IntPos.Sts).............................................................................................................................12 4.3 Campos presentes nas mensagens geradas pelo Gerenciador Padro - Respostas....................................................12 (C:\TEF_DIAL\RESP \IntPos.001)............................................................................................................................12 4.4 Descrio dos campos...................................................................................................................................................13 4.5 Exemplo de uma venda com carto de crdito.............................................................................................................19 5.1 Sistema Operacional.....................................................................................................................................................21 5. Configurao Mnima........................................................................................................................................................21 5.2 Hardware.......................................................................................................................................................................21 6. Instalao Standalone........................................................................................................................................................21 7. Perifricos recomendados..................................................................................................................................................21 7.1 Modem..........................................................................................................................................................................22 7.2 Impressora ....................................................................................................................................................................22 8. Pinpad e Kit TEF.................................................................................................................................................................22 9. Observaes importantes....................................................................................................................................................22 10. Informaes Complementares..........................................................................................................................................22 11. Certificao........................................................................................................................................................................22

INTERFACE E AMBIENTE1. Apresentao

Este material foi preparado para descrever a integrao da soluo de Automao Comercial com as funes requeridas pela Soluo TEF Discado (Transferncia Eletrnica de Fundos). O modelo proposto para esta


3

integrao prev os seguintes componentes: Aplicativo de Automao Comercial Gerenciador Padro: Mdulo que ir selecionar qual o Mdulo TEF a ser utilizado na transao. Mdulo TEF: Componente que interage com o usurio para coleta de dados da transao a ser executada. Cada Rede possui um Mdulo TEF prprio. O Gerenciador Padro contm um mdulo executvel desenvolvido para plataforma Windows. O acionamento deste mdulo ser realizado pela Automao Comercial atravs de troca de pequenos arquivos contendo os parmetros da transao (ver diagrama abaixo):

Aplicativo de Automao Comercial

Mdulo TEF Re de car Gerenciador Padro Mdulo TEF Vis an et Mdulo TEF A me x

2. Componentes 2.1. Automao ComercialA - CARACTERSTICAS pode ser desenvolvido para ambiente DOS ou Windows (16 ou 32 bits). composto de um ou mais mdulos executveis gerencia perifricos da Automao Comercial (exceto Pinpad) Obs.: Pinpad = Teclado reduzido utilizado para leitura dos cartes de crdito, dbito e CDC, bem como a digitao da senha do carto. J vem preparado para leitura de Smart Card.


4

B - FUNES As funes que podero ser executadas pela Automao Comercial integrada soluo de TEF Discado so os pagamentos das vendas com cartes de crdito e de dbito e as consultas/garantias de cheques, entre outros. Cada Rede possui um conjunto de transaes associadas estas funes que sero tratadas pelo Mdulo TEF de cada uma, mantendo as particularidades de cada Rede. No entanto, devido a utilizao do Gerenciador Padro, estas no interferem no processo de integrao para o software de Automao Comercial.

2.2

Gerenciador Padro

Mdulo responsvel pelo direcionamento da transao para os respectivos Mdulos TEF (Amex, Redecard e Visanet). Efetua o tratamento das atividades TEF, permitindo que a Automao Comercial interaja com as administradoras de carto de crdito e de dbito, de forma simples e eficiente.

2.3

Mdulo TEF

Softwares que efetuam a interface com o usurio para coleta dos dados da transao a ser realizada e comunicao com as administradoras de carto para cumprimento da tarefa solicitada.


5

3. Informaes Tcnicas 3.1 Comunicao entre a Soluo TEF Discado e a Automao ComercialO Aplicativo de Automao Comercial ser responsvel por executar todas as tarefas pertinentes venda e a legislao ECF, incluindo a impresso do cupom fiscal e do cupom TEF. Ao trmino da venda, se a forma de pagamento escolhida utilizar a Soluo TEF Discado, a Automao Comercial acionar o Gerenciador Padro (por meio de gravao de um arquivo) que, por sua vez, acionar o Mdulo TEF correspondente. A troca de informaes entre os sistemas feita por meio de troca de mensagens padres. Esta modalidade foi definida para permitir maior independncia entre os sistemas. Apresentamos a seguir o fluxo simplificado de dados entre os mdulos que compe esta soluo e a descrio detalhada das tarefas a serem executadas pelo Aplicativo de Automao no uso das funes de TEF. (1) Envia solicitao

(2) Confirma recebimento da solicitao (3) Exibe telas para seleo da Rede e Captura de Dados.

Automao Comercial

(4) Envia resposta da solicitao.

Soluo TEF Discado

(5) Imprime cupom TEF Envia status da impresso

(6) Confirma recebimento do status da impresso.

OBS: Para a transao ATV o fluxo ser encerrado na etapa 2, outras transaes que no exijam impresso de cupom TEF, o fluxo encerrado na etapa 4. Caso contrrio, vai at a etapa 6. No h como identificar apenas atravs do tipo de transao, se haver ou no a impresso de cupom TEF. O Aplicativo de Automao Comercial dever sempre verificar todas as informaes existentes no arquivo recebido na ETAPA 4 Conforme tabela do item 4.3. A estrutura de troca de arquivos prev a utilizao de 2 diretrios: C:\TEF_DIAL\REQ e C:\TEF_DIAL\RESP.


6

Diretrio de envio dos dados Utilizado pela Automao Comercial para enviar os dados para o Gerenciador Padro. Automao Comercial gera um arquivo para cada envio de mensagem. Gerenciador Padro utiliza o arquivo recebido e o deleta aps sua utilizao. Nome do diretrio: C:\TEF_DIAL\REQ Nome do arquivo (para as etapas 1 e 5 do grfico anterior): IntPos.001 OBS: Criar o arquivo com o nome IntPos.tmp e em seguida renome-lo para IntPos.001 Diretrio de retorno dos dados Utilizado pela Automao Comercial para receber os dados do Gerenciador Padro. Gerenciador Padro gera um arquivo de resposta conforme fluxo. Automao Comercial utiliza o arquivo de resposta e o deleta aps sua utilizao. O arquivo de resposta contm indicao do aceite ou recusa do pedido efetuado pelo envio. Nome do diretrio: C:\TEF_DIAL\RESP Nome do arquivo (para as etapas 2 e 6 do grfico anterior): IntPos.Sts Nome do arquivo (para as demais etapas do grfico anterior): IntPos.001 Como vimos, os softwares de Automao Comercial e Gerenciador Padro funcionam simultaneamente como tarefas do Windows, sendo que a Automao Comercial aciona o Gerenciador Padro por meio do envio de arquivos de solicitao conforme layout definido adiante. A Soluo TEF Discado integrada a Automao Comercial atua da seguinte forma:

Automao

Comercial, no trmino da operao comercial, gera o arquivo C:\TEF_DIAL\REQ\IntPos.001 nos padres estabelecidos; (ETAPA 1) O Gerenciador Padro avisa a Automao Comercial que recebeu o arquivo e que est processando, gerando o arquivo C:\TEF_DIAL\RESP\IntPos.Sts. Se a Automao Comercial no receber este arquivo em at 7 segundos, significa que o Gerenciador Padro no est ativo; (ETAPA 2) O Gerenciador Padro maximiza uma tela para seleo da Rede desejada; (ETAPA 3) Gerenciador Padro executa a transao solicitada e envia sua resposta para a Automao Comercial: C:\TEF_DIAL\RESP \IntPos.001; (ETAPA 4) Caso haja cupom TEF a ser impresso, a Automao Comercial deve imprimi-lo e em seguida retornar status da impresso para o Gerenciador Padro: C:\TEF_DIAL\REQ\IntPos.001. No caso de uma transao de venda, se o valor da transao no completar o valor total da venda, a Automao Comercial dever imprimir o comprovante de TEF e permitir ao usurio completar o pagamento com outras formas (dinheiro, cheque , etc). (ETAPA 5) Gerenciador Padro confirma recebimento do status da impresso para a Automao Comercial: C:\TEF_DIAL\RESP \IntPos.Sts. (ETAPA 6)


7

3.2 Procedimentos para a transao TEF:Seguir o fluxo a ser obedecido quando da transao TEF:


8

Exibir a Mensagem: Cancelada a Transao: Rede: Doc No: Valor:(Vide Obs.)

Observaes: 1 Caso ocorra queda de energia durante a impresso do cupom, a AC dever automaticamente enviar uma transao NCN apresentando a mensagem:Cancelada a Transao: Rede: Doc No: Valor:

2 Quando apresentar mensagem de no confirmao, apresentar os campos Doc. No (campo 12) e rede (campo 10) obrigatoriamente, o campo valor (campo 3) dever ser apresentado somente se estiver presente ou com valor


9

diferente de zero no arquivo Intpos.001 do diretrio Resp. O campo valor tambm dever ser formatado como moeda. 3 O nmero de vias impressas do cupom poder ser parametrizado. Quando de impresso em 2 ou mais vias a AC poder parar a impresso por 5 segundos , entre as vias, para que seja destacado o cupom. Quando do processo de certificao, os testes sero realizados com a emisso de 2 vias. 4 A verificao da impresso correta do comprovante deve ser feita pela automao, no deixar o usurio informar se o mesmo foi impresso corretamente. 5 No imprimir leitura X entre as vias do comprovante TEF. 6- Mensagem do Campo 30 Esta deve ser apresentada pela Automao Comercial quando seu contedo for diferente de vazio. Se vazio no poder ser apresentado o Message Box . Cuidados: a) Quando existir linhas para serem impressas a mensagem do campo 30 , deve ser exibida paralelamente a impresso. Esta no pode ficar aguardando um Ok do usurio para comear a imprimir.Deixar a mensagem o mnimo por 5 segundos ou durante toda a impresso. b) Quando no houver linhas para serem impressas a mensagem deve ficar aguardando uma confirmao do usurio. 7- Verifique tambm o documento Cuidados para Certificao , para maiores dicas

4.

Layout de Mensagens de Comunicao

As descries aqui apresentadas exibem o formato que devem ter as mensagens geradas pela Automao Comercial e o formato da mensagem de retorno gerada pelo Gerenciador Padro com a confirmao ou no da transao. As mensagens sero transferidas por meio de arquivo tipo texto onde cada linha contm um tipo de informao. As linhas possuem formato padro e tamanho varivel, utilizando conceito de palavra chave. O formato genrico : AAA-BBBC=CDDDDDDD......DDDDDEF Onde: ABCDEFIdentificao do tipo de informao ou campo N de seqncia complementar ao tipo de informao ou campo Posio contendo espao ou branco Informao (sempre alinhada a esquerda, sem preenchimento de zeros ou espaos) Carriage Return (CR) =13 (segundo a tabela ASCII) Line Feed (LF) = 10 (segundo a tabela ASCII)

Os tipos de operaes possveis so: ATV ADM CHQ* Verifica se o Gerenciador Padro est ativo Permite o acionamento da Soluo TEF Discado para execuo das funes administrativas Pedido de autorizao para transao por meio de cheque10


CRT CNC CNF NCN

Pedido de autorizao para transao por meio de carto Cancelamento de venda efetuada por qualquer meio de pagamento Confirmao da venda e impresso de cupom No confirmao da venda e/ou da impresso.

* A transao CHQ estar presente apenas na prxima verso dos mdulos, mais dever ser desenvolvida para que no haja a necessidade de re-certificao da aplicao com a distribuio dos novos mdulos. Verificao pela Automao Comercial se o Gerenciador Padro est ativo poder ser feita atravs: 1. Funo ATV: A Automao Comercial envia as mensagens ao Gerenciador Padro conforme item 4.1. Se a Automao Comercial receber em at 7 segundos o arquivo C:\TEF_DIAL\RESP\IntPos.Sts conforme item 4.2 significa que o Gerenciador Padro est ativo. 2. Toda vez que o GP entrar no ar ir informar para a AC que est ativo atravs do arquivo Ativo.001 que ser gravado no diretrio \Tef_dial\resp , com os campos: 000-000 = TEF 016-000 = DDMMHHMMSS (Timestamp) 999-999 = 0 Se no existir este arquivo no diretrio significa que o Gerenciador Padro no est ativo. O cancelamento de venda pode ser feito de duas formas: 1. Pela operao ADM, onde o Gerenciador Padro abre uma tela para a captura dos dados da transao a ser cancelada. 2. Pela operao CNC, onde o Aplicativo de Automao Comercial captura os dados da transao a ser cancelada e as transfere para o Gerenciador Padro. A seguir apresentamos os tipos de informaes (ou campos) que devero estar presentes nos arquivos enviados e recebidos pela Automao Comercial. As informaes (ou campos) variam de acordo com o tipo de operao e esto assinalados com M quando mandatrios, O quando opcionais e - quando ausentes. Notar que o aplicativo de automao deve estar preparado para receber e ignorar os tipos de registros que ele desconhea. Essa caracterstica importante para manter compatibilidade com verses futuras. Quando houver discrepncia entre o contedo do campo enviado pelo Aplicativo de Automao Comercial e o recebido pelo Gerenciador Padro valer o do Gerenciador Padro.

4.1

Campos presentes nas mensagens geradas pelo Aplicativo de Automao Comercial Solicitaes (C:\TEF_DIAL\REQ\IntPos.001)Tipo de Informao HEADER IDENTIFICAO DOCUMENTO FISCAL VINCULADO VALOR TOTAL ATV M M ADM M M CHQ M M O M CRT M M O M CNC M M O M CNF M M O 11 NCN M M O -

Cdigo do Campo 000-000 001-000 002-000 003-000


MOEDA CMC-7 TIPO DE PESSOA DOCUMENTO DA PESSOA DATA DO CHEQUE NOME DA REDE NMERO DA TRANSAO - NSU DATA DA TRANSAO - COMPROVANTE HORA DA TRANSAO COMPROVANTE 027-000 FINALIZAO 033-000 BANCO 034-000 AGNCIA 035-000 AGNCIA - DC 036-000 CONTA CORRENTE 037-000 CONTA CORRENTE - DC 038-000 NMERO DO CHEQUE 039-000 NMERO DO CHEQUE - DC 999-999 TRAILER - REGISTRO FINAL M = Mandatrio O = Opcional - = Ausente

004-000 005-000 006-000 007-000 008-000 010-000 012-000 022-000 023-000

M

M

O O O O O O O O O O O M

O M

O(1) O(1) O(1) O(1) M M M M O(1) O(1) O(1) O(1) O(1) O(1) O(1) M

M M M M

M M M M

Obs:

Os campos marcados com: (1)- somente existem para cancelamento de operao com cheques.

4.2

Campos presentes nas mensagens geradas pelo Gerenciador Padro - Status (C:\TEF_DIAL\RESP \IntPos.Sts)Tipo de Informao HEADER IDENTIFICAO TRAILER REGISTRO FINAL O = Opcional - = Ausente ATV M M M ADM M M M CHQ M M M CRT M M M CNC M M M CNF M M M NCN M M M

Cdigo do Campo 000-000 001-000 999-999 M = Mandatrio

4.3

Campos presentes nas mensagens geradas pelo Gerenciador Padro - Respostas (C:\TEF_DIAL\RESP \IntPos.001)Tipo de Informao HEADER IDENTIFICAO DOCUMENTO FISCAL VINCULADO VALOR TOTAL MOEDA CMC-7 TIPO DE PESSOA DOCUMENTO DA PESSOA DATA DO CHEQUE STATUS DA TRANSAO NOME DA REDE ATV ADM M M O O O O M M CHQ M M O(3) M M(3) M M M M M CRT M M O(3) M M(3) M M CNC M M O(3) M M(3) O(2) M M

Cdigo do Campo 000-000 001-000 002-000 003-000 004-000 005-000 006-000 007-000 008-000 009-000 010-000


12

011-000 012-000 013-000 014-000 015-000 016-000 017-000 018-000 019-yyy 020-yyy 021-yyy 022-000 023-000 024-000 025-000 026-000 027-000 028-000 029-yyy 030-000 031-000 032-000 033-000 034-000 035-000 036-000 037-000 038-000 039-000 040-000 999-999 M = Mandatrio

TIPO DA TRANSAO NMERO DA TRANSAO - NSU CDIGO DE AUTORIZAO DA TRANSAO NMERO DO LOTE DA TRANSAO TIMESTAMP DA TRANSAO - HOST TIMESTAMP DA TRANSAO - LOCAL TIPO PARCELAMENTO QUANTIDADE DE PARCELAS DATA VENCIMENTO DA PARCELA VALOR DA PARCELA NMERO DA TRANSAO NSU DA PARCELA DATA DA TRANSAO - COMPROVANTE HORA DA TRANSAO - COMPROVANTE DATA PR-DATADO NMERO DA TRANSAO CANCELADA - NSU TIMESTAMP DA TRANSAO CANCELADA FINALIZAO QUANTIDADE DE LINHAS DO COMPROVANTE (*) IMAGEM DE CADA LINHA DO COMPROVANTE TEXTO ESPECIAL OPERADOR TEXTO ESPECIAL CLIENTE AUTENTICAO BANCO AGNCIA AGNCIA - DC CONTA CORRENTE CONTA CORRENTE - DC NMERO DO CHEQUE NMERO DO CHEQUE - DC NOME DA ADMINISTRADORA TRAILER - REGISTRO FINAL O = Opcional - = Ausente

-

M O O O O O O O O O O M O O O O O O O O O O O M

M M(1) O M(1) O O O M(1) M O O O O M(4) M(4) O M(4) O O(4) O O M

M M(1) O O M(1) O O O O O O M(1) M(1) O M(1) M O O O O M

M M(1) O O M(1) O M(1) M(1) M M M(1) M O O O O O O O O O O O M

Obs:

Os campos marcados com: (1)- somente existem se a transao foi aprovada. (2)- devolve, opcionalmente, qual o cheque foi cancelado, desde que o Mdulo TEF permita cancelamentos. (3)- Somente estaro preenchidos se a informao for preenchida no arquivo de envio correspondente. (4)- Somente estaro preenchidos quando o campo CMC7 ausente.

(*) O campo 028-000 QUANTIDADE DE LINHAS DO COMPROVANTE est como obrigatrio para todas as operaes por uma medida de segurana para o Aplicativo de Automao Comercial. O Gerenciador Padro preencher com zero 0 este campo quando no houver comprovante.

4.4

Descrio dos camposContedo / Descrio HEADER Finalidade: Indica o incio do arquivo e o tipo de operao relacionada ao arquivo. Formato: Alfanumrico de 3 bytes.13

Campo 000-000


001-000

002-000

Contedos vlidos: ATV- Verifica se o Gerenciador Padro est ativo ADM- Administrativa CHQ- Cheque CRT- Carto CNC- Cancelamento CNF- Confirmao de finalizao da venda e impresso do cupom NCN- No confirmao de finalizao da venda por desistncia do cliente ou erro na impresso do cupom. IDENTIFICAO Finalidade: Indica o nmero de controle da solicitao que est sendo feita. Este nmero gerado pelo aplicativo de automao comercial, o qual dever colocar um contedo diferente a cada nova solicitao. Este mesmo contedo devolvido nos arquivos de resposta. Formato: Numrico de at 10 bytes. DOCUMENTO FISCAL VINCULADO Finalidade: Nmero do documento fiscal vinculado forma de pagamento ou finalizao.Nota relativa a legislao ECF A emisso do comprovante de pagamento de operao ou prestao efetuado com carto de crdito ou dbito automtico em conta corrente somente poder ser feita por meio de ECF, devendo o comprovante estar vinculado ao documento fiscal emitido na operao ou prestao respectiva, conforme disposto na legislao pertinente..

003-000

004-000

005-000

006-000

007-000

Formato: Numrico de at 12 bytes. VALOR TOTAL Finalidade: Valor total desta forma de pagamento. Formato: Numrico de at 12 bytes, sendo duas casas decimais sem a virgula separadora MOEDA Finalidade: Indica a moeda utilizada na operao Formato: Numrico de 1 byte Contedos Vlidos: 0 para Real 1 para Dolar CMC-7 Finalidade: Contm os dados do cheque no mesmo formato obtido por uma leitura do CMC-7 Formato: Alfanumrico de at 70 bytes. TIPO DE PESSOA Finalidade: Indica o tipo de pessoa que esta sendo atendida na operao. Formato: Alfanumrico de 1 byte Contedos Vlidos: F para pessoa fsica CPF J para pessoa jurdica - CNPJ DOCUMENTO DA PESSOA Finalidade: Indica a pessoa que esta sendo atendida na operao por meio do CNPJ ou CPF.14


008-000

009-000

010-000

011-000

Formato: Numrico 16 bytes. DATA DO CHEQUE Finalidade: Data de vencimento do Cheque Formato: Numrico DDMMAAAA STATUS DA TRANSAO Finalidade: Indica se a transao foi aprovada ou recusada e qual o motivo da recusa. Formato: Alfanumrico de at 3 bytes. Contedos Vlidos: 0 para transao aprovada Outro valor transao negada NOME DA REDE Finalidade: Nome da rede que tratou a transao Formato: Alfanumrico de at 8 bytes Contedos Vlidos: AMEX REDECARD VISANET TIPO DA TRANSAO Finalidade: Cdigo identificando o tipo da transao executada Formato: Numrico de at 2 bytes. Contedos Vlidos: 0- Administrativas Outras (Reimpresso, Iniciao de Terminal etc.) 1- Administrativa Fechamento/Transmisso de Lote 10- Carto de Crdito Vista 11- Carto de Crdito Parcelado pelo Estabelecimento 12- Carto de Crdito Parcelado pela Administradora 13- Pr-Autorizao com Carto de Crdito 20- Carto de Dbito Vista 21- Carto de Dbito Pr-Datado 22- Carto de Dbito Parcelada 23- Carto de Dbito Vista Forada 24- Carto de Dbito Pr-Datado Forada 25- Carto de Dbito Pr-Datado sem Garantia 30- Outros Cartes 40- CDC 41- Consulta CDC 50- Convnio 60- Voucher 70- Consulta Cheque 71- Garantia de Cheque 99-Outras Obs.: No cancelamento de venda feito atravs da operao ADM (Administrativa) este campo conter o tipo da transao de venda que foi cancelada.


15

Exemplo-1: Exemplo-2: Exemplo-3:

000-000 = ADM 011-000 = 00 000-000 = ADM 011-000 = 01 000-000 = ADM 011-000 = 10 000-000 = ADM 011-000 = 20

(Administrativas: Reimpresso, Iniciao de Terminal etc.) (Administrativa: Fechamento/Transmisso de Lote) (Cancelamento de Carto de Crdito, qualquer que tenha sido a modalidade: Vista, Parcelado pelo Estabelecimento ou pela Administradora) (Cancelamento de Carto de Dbito, qualquer que tenha sido a modalidade: Vista, Pr-Datado, Parcelado etc.)

Exemplo-4:

Exemplo-5: 012-000

000-000 = ADM 011-000 = 71 (Cancelamento de Garantia de Cheque) NMERO DA TRANSAO - NSU Finalidade: Indica o nmero de seqncia (NSU Nmero Sequencial nico) da transao atribudo pelo Host (Sistema das Redes de Carto que recebe e trata as solicitaes das transaes TEF). Quando este campo enviado do Gerenciador Padro para o Aplicativo de Automao Comercial, ele representa o NSU do Host estabelecido para a transao. Quando este campo enviado do Aplicativo de Automao Comercial para o Gerenciador Padro, ele representa o NSU da transao a ser tratada (cancelada, confirmada etc.) Formato: Numrico de at 12 bytes. CDIGO DE AUTORIZAO DA TRANSAO Finalidade: Indica o nmero de autorizao da transao atribuda pelo Host. Cada transao TEF possui um nmero de autorizao. Formato: Numrico de at 6 bytes. NMERO DO LOTE DA TRANSAO Finalidade: Indica o nmero de lote da transao Formato: Numrico de at 10 bytes. TIMESTAMP DA TRANSAO HOST Finalidade: Indica a data e hora da transao no Host Formato: Numrico DDMMHHMMSS TIMESTAMP DA TRANSAO LOCAL Finalidade: Indica a data e hora da transao no ponto de venda. Formato: Numrico DDMMHHMMSS TIPO PARCELAMENTO Finalidade: Indica o tipo de parcelamento aplicado operao16

013-000

014-000

015-000

016-000

017-000


018-000

019-yyy

020-yyy

021-yyy

022-000

023-000

024-000

025-000

026-000

Formato: Numrico de 1 byte Contedos Vlidos: 0 parcelado estabelecimento 1 parcelado administradora QUANTIDADE DE PARCELAS Finalidade: Indica o nmero de parcelas no caso de transaes Parceladas (Crdito ou Dbito). Formato: Numrico de at 2 bytes. DATA VENCIMENTO DA PARCELA Finalidade: Indica a data em que foi agendada a parcela (yyy). A parcela indicada pelos trs caracteres (yyy) do campo correspondente, onde yyy ser igual a 001, 002, respectivamente para cada uma das parcelas definidas no campo QUANTIDADE DE PARCELAS. Formato: Numrico - DDMMAAAA VALOR DA PARCELA Finalidade: Indica o valor da parcela (yyy). A parcela indicada pelos trs caracteres (yyy) do campo correspondente, onde yyy ser igual a 001, 002, respectivamente para cada uma das parcelas definidas no campo QUANTIDADE DE PARCELAS. Formato: Numrico de at 12 bytes, sendo duas casas decimais sem a vrgula separadora. NMERO DA TRANSAO NSU DA PARCELA Finalidade: Indica o NSU da parcela (yyy). A parcela indicada pelos trs caracteres (yyy) do campo correspondente, onde yyy ser igual a 001, 002, respectivamente para cada uma das parcelas definidas no campo QUANTIDADE DE PARCELAS. Formato: Numrico de at 12 bytes. DATA DA TRANSAO - COMPROVANTE Finalidade: Indica a data da transao Formato: Numrico DDMMAAAA HORA DA TRANSAO - COMPROVANTE Finalidade: Indica a hora da transao Formato: Numrico HHMMSS DATA PR-DATADO Finalidade: Contm data de agendamento para pr-datado. Formato: Numrico DDMMAAAA NMERO DA TRANSAO CANCELADA - NSU Finalidade: Nmero de sequncia (NSU) da transao cancelada. Formato: Numrico de at 12 bytes. TIMESTAMP DA TRANSAO CANCELADA - Host Finalidade:17


027-000

028-000

029-yyy

030-000

031-000

032-000

033-000

034-000

035-000

Contm a data e hora da transao cancelada no Host. Formato: Numrico - DDMMHHMMSS FINALIZAO Finalidade: Dados recebidos do Mdulo TEF que executou a transao e que devem ser devolvidos no comando de finalizao de uma venda Formato: Alfanumrico de at 30 bytes QUANTIDADE DE LINHAS DO COMPROVANTE Finalidade: Indica a quantidade de linhas do comprovante. Quando no h comprovante o campo deve conter zero. Formato: Numrico de at 3 bytes IMAGEM DE CADA LINHA DO COMPROVANTE Finalidade: Apresenta a imagem a ser impressa de cada uma das linhas do comprovante. A linha de impresso indicada pelos trs caracteres (yyy) do campo correspondente, onde yyy ser igual a 001, 002, ... respectivamente para cada uma das linhas definidas no campo QUANTIDADE DE LINHAS DO COMPROVANTE. Formato: Alfanumrico de at 40 bytes TEXTO ESPECIAL OPERADOR Finalidade: Texto que, quando presente, deve ser apresentado pelo aplicativo de Automao Comercial ao operador. Formato: Alfanumrico de at 40 bytes. TEXTO ESPECIAL CLIENTE Finalidade: Texto que, quando presente, deve ser apresentado pelo aplicativo de Automao Comercial ao cliente. Formato: Alfanumrico de at 40 bytes. AUTENTICAO Finalidade: Mensagem de autenticao a ser impressa no cheque Formato: Alfanumrico de at 20 bytes. BANCO Finalidade: Cdigo do Banco no padro do Banco Central Formato: Alfanumrico de at 4 bytes. AGNCIA Finalidade: Cdigo da agncia do cheque Formato: Alfanumrico de at 20 bytes. AGNCIA - DC Finalidade: Dgito de controle da agncia do cheque18


036-000

037-000

038-000

039-000

040-000

999-999

Formato: Alfanumrico de at 2 bytes. CONTA CORRENTE Finalidade: Cdigo da conta corrente do cheque Formato: Alfanumrico de at 20 bytes. CONTA CORRENTE - DC Finalidade: Dgito de controle da conta corrente do cheque Formato: Alfanumrico de at 2 bytes. NMERO DO CHEQUE Finalidade: Nmero do cheque Formato: Alfanumrico de at 20 bytes. NMERO DO CHEQUE - DC Finalidade: Dgito de controle do Nmero do cheque Formato: Alfanumrico de at 2 bytes. NOME DA ADMINISTRADORA Finalidade: Identifica a Administradora do Carto utilizado. Formato: Alfanumrico de at 12 bytes. Contedos Vlidos: VISA AMEX MASTERCARD etc. TRAILER - REGISTRO FINAL Finalidade: Indica fim do arquivo. Formato: Numrico de 1 byte Constante zero

4.5

Exemplo de uma venda com carto de crditoArquivo de solicitao da compra (C:\TEF_DIAL\REQ\IntPos.001) Imagem do arquivo Comentrios Header p/venda p/carto Identificao da solicitao Nmero do documento fiscal vinculado Valor total da transao (R$1.500,00) Registro final do arquivo

000-000 = CRT 001-000 = 1 002-000 = 123456 003-000 = 150000 999-999 = 0


19

Arquivo de informao que a funo est sendo executada (C:\TEF_DIAL\RESP \IntPos.Sts) Imagem do arquivo 000-000 = CRT 001-000 = 1 999-999 = 0 Header p/venda p/carto Identificao da solicitao Registro final do arquivo Comentrios

Arquivo de resposta (C:\TEF_DIAL\RESP \IntPos.001) Imagem do arquivo 000-000 = CRT 001-000 = 1 002-000 = 123456 003-000 = 150000 004-000 = 1 009-000 = 0 010-000 = Nome da Rede 011-000 = 10 012-000 = 123456789000 013-000 = 123456 014-000 = 1234567890 015-000 = DDMMHHMMSS 016-000 = DDMMHHMMSS 022-000 = DDMMAAAA 023-000 = HHMMSS 027-000 = 123XXYTZAAABC 028-000 = 20 029-001 = Rede X 029-002 = Loja X 029-003 = Rua X 029-004 = TERM.666666 029-005 = ADM. X . . . 029-017 = 029-018 = 029-019 = ASSINATURA 029-020 = CLIENTE X 040-000 = ADM. X 999-999 = 0 Comentrios Header p/de venda p/carto Identificao da solicitao Nmero do documento fiscal vinculado Valor total da transao (R$1.500,00) Moeda = real Status da transao = OK Nome da Rede Tipo da Transao = Carto de Crdito Vista Nmero da NSU Cdigo de Autorizao da Transao Nmero do Lote da Transao Data e a Hora da Transao (Host) Data e Hora da Transao local (ponto de venda) Data da Transao - Comprovante Hora da Transao - Comprovante Finalizao Quant. de linhas do comprovante = 20 Imagem do comprovante linha 01 Imagem do comprovante linha 02 Imagem do comprovante linha 03 Imagem do comprovante linha 04 Imagem do comprovante linha 05 Imagem do comprovante linha .. Imagem do comprovante linha .. Imagem do comprovante linha .. Imagem do comprovante linha 17 Imagem do comprovante linha 18 Imagem do comprovante linha 19 Imagem do comprovante linha 20 Administradora do Carto Registro final do arquivo

Nota: Somente ser disponibilizada uma cpia do comprovante, ficando a cargo da Aplicao de Automao Comercial a emisso da quantidade de vias necessrias., em funo do tipo de impressora disponvel. Devero haver ao menos duas "vias", uma para o cliente e outra para o estabelecimento.


20

Arquivo de confirmao (C:\TEF_DIAL\REQ\IntPos.001) Imagem do arquivo 000-000 = CNF 001-000 = 1 002-000 = 123456 010-000 = Rede X 012-000 = 123456789000 027-000 = 123XXYTZAAABC 999-999 = 01.

Comentrios Header p/ confirmao de finalizao da venda e impresso do cupom Identificao da solicitao Nmero do documento fiscal vinculado Rede responsvel pela autorizao Nmero da Transao NSU Finalizao Registro final do arquivo

5.1 5.

Sistema Operacional Configurao Mnima

Windows 95/ 98 Windows NT 4.0

5.2

Hardware

Microcomputador Padro PC Processador Pentium ou similar 16 MB de memria; 540 MB de disco rgido Teclado padro PC 1 Fax/Modem padro Hayes V22 Bis 1 porta serial DB9 livre ou DB25, para conexo do Pinpad Seguro Impressora de no mnimo 40 colunas OBS.: Neste requisitos mnimos no foram consideradas outras aplicaes instaladas ou integradas no micro do cliente...

6.

Instalao Standalone

A Soluo TEF Discado foi desenhada para funcionar no modelo standalone, ou seja, onde todos os componentes requeridos devem estar instalados no mesmo device (disco C:\). As funes TEF somente podem ser executadas atravs de um equipamento que possua o PinPad Seguro, um modem prprio, linha telefnica disponvel e a Soluo TEF Discado completa instalada no disco rgido.

7.

Perifricos recomendados


21

7.1

ModemMarca US Robotics US Robotics Tipo Internal External Modelo Sportster 28800 Sportster 33600

7.2

Impressora

Poder ser utilizada qualquer impressora homologada pelo Aplicativo de Automao Comercial, visto que o gerenciamento da impresso realizada pela mesma.

8. Pinpad e Kit TEFA instalao da Soluo TEF Discado nos clientes somente poder ser feita com a utilizao do kit TEF fornecido por integradores autorizados. O kit TEF conter, entre outros, o Pinpad Inteligente (Seguro). A lista de equipamentos homologados poder ser obtida com a SevenPdv ou com a Software Express.

9. Observaes importantes proibido o armazenamento da imagem de qualquer cupom TEF em qualquer parte do sistema aps a impresso do mesmo.

10. Informaes ComplementaresNo caso de problemas ocorridos em qualquer procedimento citado neste documento, solicitamos que sejam revistas todas as configuraes executadas e comparadas com os parmetros descritos neste manual; execute novamente as atividades ou troque os discos utilizados na instalao, caso necessrio. Caso permanea alguma dvida, entre em contato com a SevenPdv ou com a Software Express.

11. CertificaoPara que sua Aplicao Comercial possa ser comercializada utilizando a Soluo TEF Discado, dever ocorrer um processo denominado certificao no qual sua soluo ser avaliada quanto ao uso das funes descritas neste manual. Para isto, aps ter terminado todo o processo de ajuste de seu aplicativo, entre em contato com a Certificadora (SevenPdv/Software Express). Verificar documento Regras para Certificao.


22

guia tecnico gerenciador padrao 2.1_31102000

Documents