Boletim Técnico

Adicionar códigos de Bandeira para a transação TEF

Produto : Microsiga Protheus® Controle de Lojas versão 10

Chamado : TFALW5 Data da public ação : 27/08/12

País(es) : Brasil Banco(s) de Dados : Todos

Implementada melhoria na rotina Venda Assistida (LOJA701), que permite a inclusão das bandeiras de cartões de créditos e
débitos que não estão cadastradas no sistema padrão (vide tabela abaixo).
Com base nesses retornos é gravado o campo de administradora financeira (L4_ADMINIS) no arquivo de formas de pagamentos
(SL4) . Os campos no cabeçalho do orçamento como por exemplo Instituição(L1_INSTITU) apenas são utilizados no TEF Discado.
Essas são as bandeiras já incluídas no sistema padrão fornecida pela empresa Software Express:
 Para cartões de crédito
Código Sitef Nome da Bandeira

00001 VISA

00002 MASTERCARD

00003 DINERS

00004 AMEX

00005 SOLLO

00006 SIDECARD

00007 PRIVATE_LABEL

00008 REDESHOP

00009 PAO_ ACUCAR

00010 FININVEST

00011 JCB

00012 HIPERCARD

00013 AURA

00014 LOSANGO

00015 SOROCRED

10014 DISCOVERY
 Para cartões de débito
Código Sitef Nome da Bandeira

00001 VOUCHER

00003 GIFT_PREPAGO

20001 MAESTRO

20002 ELECTRON

SIGALOJA – Adicionar códigos de Bandeiras pra transação TEF. 1

 Boletim Técnico

20003 CABALDEBIT

10001 TICKET

10002 VISAVALE

10003 SODEXHO

10004 NUTRICASH

10005 GREENCARD

10006 PLANVALE

10007 BANQUET

10008 VEROCHEQUE

10009 SAPORE

10010 BNBCLUBE

10011 VALECARD

10012 CABAL

10013 ELO

10015 GOOD_CARD

10016 POLICARD

10017 CARD_SYSTEM

10018 BONUS_CBA

Para inclusão de novas bandeiras verifique o tópico Procedimentos para Configuração.

PROCEDIMENTOS PARA IMPLEMENTAÇÃO

Para viabilizar essa melhoria, é necessário aplicar o pacote de atualizações (Patch) deste chamado.

PROCEDIMENTOS PARA CONFIGURAÇÃO

Qualquer bandeira de cartão de crédito ou de débito que não estiver dentro da tabela padrão, precisa ser informada no arquivo
SIGALOJA.INI conforme configuração abaixo:

Dentro do arquivo SIGALOJA.INI que está localizado na posta SmartClient do Microsiga Protheus® deve ser criada a seção :

- Para cartões de crédito :

[BANDEIRASCC]

2 SIGALOJA – Adicionar códigos de Bandeiras pra transação TEF.

 Boletim Técnico

- Para cartões de débito :

[BANDEIRASCD]

Dentro dessas seções informe o código de retorno da bandeira do cartão da Software Express para a aplicação e o nome da
bandeira. Exemplo para cartões de crédito :

[BANDEIRASCC]
00080 = HIPERMASTER
00097= SUPERVISTA

Onde a chave [BANDEIRASCC] indica que é referente a cartão de crédito , o nome HIPERMASTER é o nome da bandeira do cartão
e 00080 é o código de retorno do Servidor TEF para o Microsiga Protheus®, para descobrir esse código basta habilitar o log do
TEF, conforme instruções abaixo :

Trace para a comunicação com TEF CLISITEF

Para habilitar este recurso, é necessário que o arquivo TOTVSAPI.INI, que deve estar na pasta do SmartClient, tenha a seguinte
seção configurada:

[Log]
LogTEF=1
TamanhoLog=1000 //(1 MB)

Resultado:
É criado o arquivo LjTEF+<estação>.log na pasta
<RootPath>\log\tef+<empresa>+ <filial>.

Após realizar uma transação(uma venda) com o cartão que deseja descobrir o código Sitef será gerado o arquivo log na pasta
citada, verifique a linha que do TipoCampo seja 132, conforme o exemplo abaixo :

01/01/2012 14:06:29 - ContinuaFuncaoSiTefInterativo -> Retorno:10000 (ProximoComando: 0, TipoCampo: 132, TamanhoMin: 0,

TamanhoMax: 0, Buffer: 00001, TamMaxBuffer: 5, Continua: 0)

No exemplo acima pelo buffer do comando 132 pode-se afirmar que o cartão onde foi efetuado a venda é 00001 que
corresponde a bandeira VISA na tabela de cartões de crédito e VOUCHER caso seja débito.

1 - Os códigos de retornos do exemplo acima são da própria Software Express empresa que é resposavel pela aplicação
TEF denominada Sitef.
2- Sempre efetue o cadastro das Administradoras Financeiras (SAE) com o campo descrição (AE_DESC) contendo o
mesmo nome da tabela da Software Express, mostrada no inicio do docuemento , não é necessário que seja a mesma
descrição porém deve conter o mesmo trecho , exemplo : SODEXHO, para o registro da Adminstradora Financeira
referente a esse cartão devemos podemos cadastrar REFEICAO SODEXHO A VISTA . O importante é ter a palavra contida
na descrição para que o sistema encontre a respectiva.

PROCEDIMENTOS PARA UTILIZAÇÃO

1. Em Controle de Lojas (SIGALOJA), acesse Atualições/ Ponto de Venda / Estação(LOJA121)

SIGALOJA – Adicionar códigos de Bandeiras pra transação TEF. 3

 Boletim Técnico

2. Configure a pasta TEF para o tef dedicado Clisitef.

3. Acesse Atualizações / Atendimento / Venda Assistida (LOJA701).
4. Efetue uma venda selecionando a forma de pagamento cartão de crédito.
5. Pressione [F5] para finalizar a venda e efetue o pagamento com uma das bandeiras do quadro no inicio do boletim,
exemplo: VISA.
Verifique que caso possua uma administradora financeira com o mesmo nome da bandeira (VISA) a bandeira é gravada
no arquivo de formas de pagamentos (SL4).

INFORMAÇÕES TÉCNICAS

SL1 - Orçamento
Tabelas Utilizadas SL2 - Itens do Orçamento
SL4 – Formas de Pagamento

Funções Envolvidas LOJA701 - Venda Assistida

Sistemas Operacionais Windows®

4 SIGALOJA – Adicionar códigos de Bandeiras pra transação TEF.