TREINAMENTO SITEF

MÓDULO I
Conceitos Básicos TEF

• TEF

• Adquirente

• Bandeira

• Modos de Leitura

• Código de Estabelecimento

• PDV

• Pinpad
Conceitos Básicos TEF

• TEF

A sigla TEF significa: “Transferência Eletrônica de Fundos”.

É qualquer modalidade de pagamento ou serviços
realizada de forma eletrônica, substituindo a utilização de
dinheiro, cheques ou ordem de pagamento.
Conceitos Básicos TEF

• Adquirente

É a rede de captura da transação, empresa com a qual são fechados

os contratos para aceitar pagamento com TEF.

É a ligação entre o SiTef, a bandeira e o emissor do cartão, o qual é

responsável por autorizar (ou não) uma transação.

Hoje, as principais adquirentes são: Bin, Cielo, Elavon, GetnetLac,

Global Payments, Rede, Stone e Vero.
Conceitos Básicos TEF

• Bandeira

É a Identificação do cartão.
Corresponde à sua marca comercial!

• Visa
• Electron
• MasterCard
• Maestro
• ELO
• AMEX
Conceitos Básicos TEF
Bandeira

 Mastercard  Diners
 Maestro  Vouchers:
 Visa - Alimentação
 Visa Electron - Combustível
 Amex - Refeição
 JCB  Hipercard
 Elo  Outras...

 Bin (Firs Data)  Rede

 Cielo  Stone
 Elavon  Vero (Banrisul)
 Getnet  PBM’s
 Global Payments  Voucher’s

Emissor Adquirente

Proprietário do cartão Shopping

Conceitos Básicos TEF

• Modos de Leitura
• Trilha: os dados de identificação do cartão estão gravados em
uma trilha magnética

• Chip: neste caso os dados estão em um chip. Forma mais

segura de proteger os dados e por consequência o proprietário
do cartão. Este cartão também possui trilha.

• Contact Less – chip sem contato: possui as mesmas

características do cartão com chip com diferença apenas na
tecnologia de leitura destes dados.
Conceitos Básicos TEF

• Código de Estabelecimento
É a informação que identifica de forma única um estabelecimento comercial (ou
loja) para o adquirente;

Configuração de Código Errado – Quando se realiza um cadastro incorreto deste código, todos os créditos das
vendas serão direcionados ao dono do código cadastrado indevidamente.

Configuração de Código em Duplicidade - Caso existam estabelecimentos com códigos iguais, além dos problemas
de crédito indevido, poderão ocorrer transações que não serão consideradas por repetição de NSU. Somente a última
é considerada.

Gateway (Roteador ISO8583) – Como utiliza esta informação como chave primária, esta aplicação irá apenas permitir
o envio das transações referentes a primeira loja que transacionar (código/IP), as demais serão ignoradas e listadas
com código em duplicidade
Conceitos Básicos TEF

• PDV

A sigla PDV significa: “Ponto de Venda”.

Outras terminologias utilizadas: “Check-out”, “Frente de Caixa” e
“Automação Comercial”.
É um sistema composto por um conjunto de hardwares e softwares
voltados para o registro das compras realizadas por um cliente e a
informatização do pagamento da venda via TEF.
Cada PDV deve ter um código (número de terminal) único, não
podendo se repetir na mesma empresa/loja.
Conceitos Básicos TEF

• Pinpad
É um hardware utilizado para leitura das informações registradas nos
cartões, captura das senhas e outros dados necessários aos
processos de registro de vendas e pagamento TEF.
As informações registradas nos cartões são obtidas através da leitura
da trilha magnética ou do chip.
Além dos dados obtidos da leitura de um cartão, outras informações
podem ser capturadas em um pinpad, por exemplo, digitação senha,
digitação dados de confirmação positiva, CPF para nota paulista, etc.
Histórico SiTef

A sigla SiTef significa: “Solução Inteligente para

Transferência Eletrônica de Fundos”.

É um produto desenvolvido para realização de

transações eletrônicas.

SiTef é marca registrada da Software

Express Informática Ltda.
Histórico SiTef

A Software Express está em operação desde 1986.

O sistema está no mercado de TEF desde 1989/1990.

Qual a finalidade do SiTef?

T R A D U T O R !!!!

Vamos fazer um desenho?

Histórico SiTef

ADQUIRENTE A
AUTOMAÇÃO 1 Cada automação terá “fala” Inglês
que “falar” Inglês,
Espanhol, Chinês e
ADQUIRENTE B
AUTOMAÇÃO 2 Russo??? “fala” Espanhol

ADQUIRENTE C
AUTOMAÇÃO 3
“fala” Chinês

Aqui entra o SiTef! ADQUIRENTE D

AUTOMAÇÃO 4
Para permitir que todas as automações “fala” Russo
“falem” apenas “SiTefez”, traduzindo
para a língua correta do adquirente!!
Arquitetura SiTef

• Componentes

Interfaces Clientes SiTef  são os componentes da Software

Express utilizados pelos diferentes tipos de “automação” (ou de
aplicações) para a integração com o SiTef.

Os principais componentes são:

• CliSiTef – componente integrado à automação
• Cliente Modular – automação simples
• LibSiTef – componente integrado a aplicações WEB
Arquitetura SiTef

• Componentes
Servidor SiTef

• Gerpdv – principal módulo SiTef: É responsável por receber todas as transações

das aplicações (sejam elas quais forem, PDV, POS, WEB, etc.) e encaminhar aos
respectivos módulos.
• Módulos adquirentes (mais conhecidos como “Sit”): responsáveis por tratar as
características de cada adquirente;
• Driver de comunicação: responsável pelo tratamento da comunicação com os
adquirentes
• Ferramentas de apoio: para manter todos estes módulos integrados em um único
servidor, o SiTef® dispõe de algumas ferramentas de apoio sendo as principais:
configurador geral, visualização de parâmetros recebidos dos adquirentes, relatórios.
Arquitetura SiTef

Configurador Visualizador

Carga Tabelas

G Sit C Adquirente A
AUTOMAÇÃO A
Drvcom O
E M
Sit U Adquirente B
AUTOMAÇÃO B Drvcom
R N
I
Sit
P C Adquirente C
AUTOMAÇÃO C Drvcom
A
D : Ç
: Ã
V O
Servidor SiTef
Arquitetura SiTef

Comunicação via
SiTef Gw Comunicação
via X -25

LOJA 01
Integrador
PDV 01  Comnect/WNB Data Center
 Imediadata Software Express
 GsurfNet
 Lyra

PDV 02
Adquirente
Comunicação  Bin Stone
Firewall via TCP/IP  Elavon  Vero
Servidor SiTef  Cielo  Voucher’s
 Getnet  PBM’s
PDV 03
 Global Payments  Outros
 Rede
Roteador
Aligera (AR1000, AR2000)
Cisco (com protocolo RBP)

Comunicação
via X-25
Arquitetura SiTef

• Fluxo Transacional

LOJA 01

1° Perna Esperando resposta

PDV 01 PDV 02

Status Pendente 2° Perna

PDV 03 POS 01
Transação efetuada
3° Perna
ou desfeita
Servidor SiTef Adquirente
Características do SiTef

Características Gerais

Alta performance (Ambiente multi-tarefa);

Flexibilidade (Inclusão de novos Serviços);
Gerenciamento centralizado (Configuração no próprio servidor TEF por
utilitários do SiTef);
Segurança (Troca de mensagens criptografadas);
Simultaneidade Transacional (Varias transações ao mesmo tempo);
Utilitários de apoio (Relatórios, emuladores, configurações, etc...);
Interface flexível com os PDV’s (TCP/IP);
Logs (Armazenamento das informações por um determinado período).
Características do SiTef

Requisitos mínimos para instalação do SiTef.

Somente Windows 2012, conforme normas PCI somente poderão ser utilizadas versões de
software que tenham suporte de seus fornecedores;
4 Gb de memória RAM;
Disco rígido de 60 GB;
Monitor, Teclado e mouse;
Impressora para os relatórios;
Placa de rede compatível com o protocolo utilizado (TCP/IP);
Todos os equipamentos que envolvem a rede interna (LAN) devem estar devidamente
configurados;
Comunicação

Existem três meios de comunicação com as adquirentes que são:

 X25
 TCP-IP
 SiTef GW
Comunicação

• Comunicação X-25

Hardware de comunicação X-25

 Placa de comunicação X-25: Eicon

 Roteadores Aligera: Linha AR (AR1000, AR2000)
 Roteador Cisco: Contendo protocolo RBP
 Gateway: Software de gerenciamento de conexões (utiliza a placa Eicon)
 Linha contratada (Embratel – Renpac / Telefônica –SPPac ) ou outras concessionárias.

Dados da linha X-25 para Configuração

 Endereço X25 Local. (Nº de Identificação da linha X25 contratada).

 Nº de canais lógicos disponíveis na linha. Deve haver a quantidade de Canais lógicos para cada
Administradora Contratada.
 Velocidade da Linha contratada e tamanho do Pacote.
 Obs: Informações que constam no contrato com a prestadora de serviço –X25)
Comunicação

• Comunicação TCP-IP

Obter IP e Porta de cada adquirente que

será utilizada.

Caso o estabelecimento possua firewall é

necessária a liberação da conexão do IP e
porta da adquirente
Comunicação

• Comunicação SiTef-GW

Contrato com uma Integradora:

 Realizar o contato com uma Integradora para fechar uma VPN.

 IP da VPN para ser configurado no SiTef.
 Obter a porta padrão da bandeira (Fornecida pela Software
Express).

Integradoras Disponíveis:

 Comnect/WNB
 Imediadata
 GsurfNet
 Lyra
Adquirentes e Bandeiras

• Contrato com as Adquirentes

Contrato com as Adquirentes:

 Endereço remoto de conexão com as Adquirentes.

 Ao solicitar esta informação para a Adquirente, informá-la qual a
concessionária contratada.
 Código de Estabelecimento (Identificação da empresa/loja (CNPJ) e sua
respectiva conta crédito perante as adquirentes.
 Código de Acesso e Login (Identificação da Empresa perante as Adquirentes
– Transações de consulta a Cheque).
Software Express
Instalação e Configuração
do SiTef
 Instalação do SiTef

Com os arquivos de Instalação do SiTef, copie o [razãosocial].lic

no diretório de instalação e execute o programa instala.exe
Selecionar o driver destino

Nessa nova versão do SiTef após a instalação

foram criados grupos de usuários SiTef-Adm e
SiTef-Rel no Windows

Para que tenha efeito é preciso após a

instalação fazer logoff e login.
 Instalação do SiTef

clique em Next para seguir com a instalação e após a conclusão da mesma clique em Finish.
 Instalação do SiTef
Após a conclusão do processo de instalação, será necessário realizar o licenciamento do SiTef. Acessando o
aplicativo Licenciamento SiTef em: iniciar/Todos os Programas/SiTef Menu Principal.

Caso o CNPJ digitado esteja correto, habilita-se o Após o arquivo de licença ser validado, serão
botão e será necessário o apontamento do carregadas as informações abaixo e habilita-se o
arquivo .lic através do explorer. botão Instala Licença.
 Instalação do SiTef

Caso não esteja com o arquivo de licença no momento da instalação, o SiTef permite
que seja instalada uma licença temporária de 14 dias.

Acionando o botão encerra novamente é

exibida a mensagem de sucesso:
Configurador SiTef
Acessar o Configurador Geral do SiTef .

Iniciar > Todos os Programas >SiTef – Menu Principal > Configurador Geral do SiTef
Configurador SiTef
Configurar comunicação entre PDV e SiTef.

SiTef > Interface PDV/SiTef

Configurador SiTef
Configurar comunicação entre SiTef e Adquirente.

SiTef > Interface SiTef/Host

Configurador SiTef
Configurar Interface SiTef/Loja

SiTef > Loja

 Configurador SiTef
Configurar nova empresa e dados operacionais para o PDV.

SiTef > Dados Operacionais > Operacional PDV


Cálculo sobre o timeout configurado no SiTef é de 30%. Se timeout do SiTef = 30 S, o da CliSiTef será 39
 Isso vale para o Client Modular Também
Configurador SiTef
Visualizar comunicação configurada.

SiTef > Visualiza Comunicação.

Configurador SiTef
Configurar Transações Habilitadas para Crédito e Débito.

SiTef > Dados Operacionais > Transações Habilitadas

Configurador SiTef
Configurar mensagem para o cabeçalho do Tiquete.

SiTef > Dados Operacionais > Cabeçalho do Ticket

Configurador SiTef
Configurar Captura Parâmetros.

SiTef > Dados Operacionais > Captura Parâmetros

Configurador SiTef
Configurar data de Lançamento.

SiTef > Dados Operacionais > Data de Lançamento

Configurador SiTef
Configurar Parcelamentos.

SiTef > Dados Operacionais > Parcelamento

Configurador SiTef
Configurar Limites.

SiTef > Dados Operacionais > Limites

Configurador SiTef
Configurar Código de Estabelecimento para Amex.

Amex Emv > Estabelecimento

 Para cada nova Empresa configurada um novo código de Estabelecimento.

Configurador SiTef
Configurar Transações Habilitadas para Crédito

Amex Emv > Transações Habilitadas

Configurador SiTef
Configurar a comunicação para o módulo da Amex, IP do Router e Porta..
Amex Emv > Comunicação
Configurador SiTef
Configurar Terminal Lógico da Cielo.

Cielo4 > Estabelecimento

 Para cada nova Empresa configurada um novo código de Estabelecimento

Configurador SiTef
Configuração Local Cielo

Cielo4 > Configurador Local

Configurador SiTef
Configurar Produtos por empresas ou todas empresas.

Cielo4 > Configurador Produtos

Configurador SiTef
Configurar a comunicação para o módulo da Cielo, IP do Router e Porta..
Cielo4 > Comunicação
Configurador SiTef
Configurar Código de Estabelecimento da Rede

RedeCard > Estabelecimento

 Para cada nova Empresa configurada um novo código de Estabelecimento

Configurador SiTef
Configurar a comunicação para o módulo da Rede , IP do Router e Porta..
RedeCard > Comunicação
 Configurador SiTef
Acessar a Carga de Tabelas.

Iniciar > Todos os Programas >SiTef – Menu Principal > Carga de Tabelas

Através da carga de tabelas, conseguimos validar a comunicação junto as adquirentes. Nela também, descem todas as
informações que o estabelecimento tem cadastrado junto a esta adquirente.
Carga de Tabelas

Para a execução deste aplicativo o serviço do SiTef precisa estar ativo, pois o mesmo é utilizado
para consulta e exibição dos dados. Por esta razão, devemos ter uma certa cautela para não onerar o
processamento da máquina.

Mensagens de Sucesso:

Processando Tabela 90

Transação OK

Inicialização Ok
Visualizador de Tabelas
Acessar o Visualizador de Tabelas.

Iniciar > Todos os Programas >SiTef – Menu Principal > Visualizador de tabelas.
Visualizador de Tabelas
Visualizar Produtos Cielo

Cielo4 > Produtos

Visualizador de Tabelas
Visualizar Produtos do Bin

Cielo4 > Bins

Visualizador de Tabelas
Visualizador de Limites de Crédito

RedeCardL0502 > Terminal > Limites Créditos

Visualizador de Tabelas
Visualizador de Ranger

RedeCardL0502 > Range

Configurador Multi Bandeiras

As mudanças aqui realizadas,

entram em vigor apenas após o restart do
SiTef.

Ao selecionar a opção da
loja/empresa, é exibida a tela das bandeiras
ao lado.

Selecionar a rede adquirente

para qual a bandeira será direcionada e ao
final salvar a configuração.

Os nomes aparecem em
vermelho quando a bandeira não possui
configuração.

As cofigurações, podem ser

feitas empresa por empresa ou todas de
uma única vez.
Configurador Multi Bandeiras

Para excluir a configuração de

uma loja/empresa específica, acessar a
mesma e selecionar a opção de excluir e
em seguida salvar a configuração.
 Novo Multi Bandeiras

Caso o estabelecimento utilize a opção de

multi Bandeiras, acessar o configurador pelo
menu principal do SiTef.

Para utilizar este novo aplicativo é

necessário que SiTef e clients estejam
atualizados:
Rede - L0501
Cielo – CF03SOFMU41C.29
Client Modular – 4.0.2.36
CliSiTef DLL - 4.0.106.12.r5

O Novo Multi Bandeiras, tem o objetivo de

realizar a alteração de roteamento sem
reiniciar o serviço do SiTef

Outra novidade é obter maior facilidade ao

configurar as redes adquirentes, usando
perfis ou configurando em lote as empresas.
 Novo Multi Bandeiras

Para realizar a configuração é

bem simples, o primeiro passo é
criar uma linha com a
configuração desejada, isso é
feito na Grid de Edição,
localizada na parte superior do
configurador.
 Novo Multi Bandeiras

Monte a linha da Grid de Edição da

forma que achar necessário.
Selecione, clicando na primeira
coluna onde está localizado o
código da empresa, as empresas
onde é desejável copiar a
configuração montada na Grid de
Edição e em seguida clique no
ícone Repita o
processo na Grid principal para
continuar configurando as outras
empresas.
Novo Multi Bandeiras

LEMBRETE:

Ativar configuração sempre que salvar: Se esta

opção está ativa, sempre que a configuração
feita na Grid Principal é salva, o configurador irá
imediatamente tentar ativar as mudanças feitas.
Uma log irá abrir toda vez que isso ocorrer.

O SiTef precisa estar aberto para a ativação

funcionar.

Se está opção não está habilitada, a

configuração salva irá ser ativa no SiTef em até
um dia depois de salvar.
Carga de Tabelas Pinpad

Após concluir a configuração multi bandeiras utilizar Selecionar se a carga será em todas as empresas
o aplicativo Carga de Tabelas Pinpad para aplicar ou em uma empresa específica.
as alterações no pinpad. A mensagem abaixo será exibida.

Após optar por sim, aparecerá a

mensagem abaixo, informando que a
configuração foi concluída.
 Ativação do Serviço SiTef

SiTef: Ativação através dos

Serviços do sistema operacional
 Ativação do Console
Controle Geral

Após ativar o serviço do SiTef,

acessaremos o SiTef Console Controle Geral,
nele, mensagens importantes são exibidas,
por exemplo:

Os aplicativos iniciados;

Transações Pendentes;
Empresas que estão tratando
multibandeira;
Mensagens de alertas (Controle de
validade, limite de lojas cadastradas,
versões dos módulos, etc.)

Notar sempre se as redes subiram com o status de “Ativo”. Caso alguma delas esteja sem comunicação estará com o
status de “Inativo” e não será possível estabelecer comunicação com a Adquirente.
 Ativação do Console
Controle Geral

Através do controle geral é possível realizar a reativação

de um aplicativo sem precisar reiniciar todo o serviço do
SiTef, ou seja, ocorrendo problema em uma rede especifica
é possível reiniciar apenas a mesma.

Atenção: A ativação do Console Controle Geral é realizada em separado ao serviço do SiTef, logo, o SiTef pode estar ativo
sem o controle geral aberto, ou o serviço pode estar inativo com o controle geral aberto, como vemos na imagem a cima.
 Ativação do Console
Controle Geral

Atenção:
A ativação do Console Controle Geral é realizada em separado ao serviço do SiTef, logo, o SiTef pode
estar ativo sem o controle geral aberto, ou o serviço pode estar inativo com o controle geral aberto, como
vemos na imagem a cima.
 Event Viewer - Windows

O Event Viewer, irá auxiliar com as ocorrências sobre o SiTef . Toda alteração, erro, mensagens informativas
serão “logadas” nele, facilitando a resolução de possíveis problemas.
 Backup do servidor

Backup do servidor SiTef

Uma vez que o servidor SiTef encontra-se devidamente Instalado, configurado e operando corretamente,
é ideal que se crie um backup do mesmo, antecipando-se a situações de parada total do servidor

Arquivos que devem ser copiados para

criação de um servidor backup

Servidor 01 – Servidor 02 –
Operando em Backup
produção
Software Express
Visualização do Relatório
 Relatório de transações
Acessar o Relatório do SiTef.

Iniciar > Todos os Programas >SiTef – Menu Principal > Relatórios

 Relatório de transações

No relatório, é possível realizar a pesquisa das transações por filtros, de acordo com seu tipo.

Todas as transações - Lista todas as transações financeiras que foram efetuadas no dia selecionado.
Compras (Débito e Crédito) - Lista todas as transações efetuadas modalidade Débito e Crédito.
Compras Débito - Lista somente as transações de Débito.
Compra Crédito - Lista somente as transações de Crédito.
Cancelamento - Lista todas as transações que foram canceladas junto as administradoras.
Compras não validadas - Lista todas as transações não validas pelo SiTef ou PDV/Terminal de Venda.
Negadas - Lista todas as transações que foram negadas pelas Administradoras.
Garantias e Consulta Cheque - Lista todas as transações de consulta Cheque efetuadas junto a Tecban.
Consulta Avs - Lista todas as transações de Consulta Avs.
Pagamentos - Lista todas as transações de pagamento de Contas.
Pré-autorização - Lista todas as transações de pré-autorização.
Estorno de Pré-autorização - Lista todas as transações de estorno de pré-autorização.
 Relatório de transações

O que é uma Transação Pendente:

São transações aprovadas pelas Administradoras, mas que não tiveram suas
confirmações/desfazimentos enviadas pelo terminal de vendas, ficando assim, em estado de
pendente. Estas transações, ficam pendentes tanto no SiTef quanto na Administradora.

Procedido o tratamento “Efetuando” ou “Desfazendo”, o SiTef enviará o novo estado à

administradora após o recebimento da sonda.

Observações:

A transação de Sonda (0600) é enviada por um período determinado pelas

administradoras, ou seja, cada administradora possui o seu período.

A administradora Cielo aguardará o tratamento num período de 3 dias.

A verificação e o tratamento das pendências deve ser diário.

 Relatório de transações

Manutenção de Pendências

Lista todas as transações que estão com o estado de pendência permitindo realizar o
tratamento das mesmas, efetuando ou cancelando localmente.
 Relatório de transações

Transações tratadas pela Administradora

Os status CANC.ADM e
EFET.ADM , sinalizam que a
transação já foi tratada pela
Administradora, portanto, a
partir deste momento, a
manutenção pelo SiTef não
será mais válida.
 Relatório de transações

Opção Resumo de Movimento:

Lista as transações de
forma resumida, exibindo
quantidades e totais de
compras com os cartões
de débito e crédito,
classificados por Redes .
 Relatório de transações

Opção Pesquisar:

Permite pesquisar as transações por NSU Host, valor ou horário.

Após a pesquisa, é possível realizar a

impressão do resultado da mesma ou
gerar um arquivo.

Para impressora ou Impressora Matricial

Solicita a impressão dos dados via impressora.

Para arquivo
Gera arquivo extensão *.prn no caminho \SiTef\sit
podendo ser aberto com leitor de texto.
 Relatório de transações

Opção Configurar Campos:

Permite alteração de visualização e reposicionamento dos campos apresentados no

Relatório do SiTef.
 Relatório de transações

Estados e códigos das transações

Cada transação exibida no relatório possui suas respectivas informações. Para facilitar a
localização e ponto em que a mesma se encontra, existem diversos campos. Abaixo
detalhamos dois.

Estado da
Descrição
transação Código da
Descrição
EFETUADA Transação Efetuada Transação
ESP.RESP Esperando resposta da Administradora CMPCTDEB Compra com cartão de débito
Transação pendente de
PENDENTE CMPPRECD Compra pré-datada com cartão de débito
confirmação/desfazimento
Excedeu tempo de aguardo de resposta da Compra parcelada com entrada a vista com
CANC.TIM PARCVIST
Administradora cartão de débito
Sistema de Venda não confirmou ou abandonou CMPCTCRM Compra com cartão de crédito magnético
CANC.PDV
a Transação
CMPCTCRN Compra com cartão de crédito digitado
CANC.LOC Transação cancelada local (Pendência)
Compra parcelada com cartão de crédito
EFET.LOC Transações efetuada local (Pendência) CMPCRMJU
magnético com juros
NEGADA Transação não autorizada pela Administrador
CANCDEBI Cancelamento de cartão de débito
Transação que havia sido efetivada, cancelada
CANC.TRN
normalmente
Software Express
Informações Gerais SiTef
 Ambiente TEF - SiTef

Performance X Canc. PDV

Alguns casos os estabelecimentos recebem muitos status de CANCPDV, este status,

além de estar relacionado a problemas com a ECF e/ou queda de energia, pode também ter
relação com a performance do servidor SiTef.

Uma máquina com uma performance ruim, pode resultar em perda de transações,
pois o servidor não processa a transação a tempo de se enviar para a rede e quando este
retorno acontece a transação já está cancelada Timeout.

Isso ocorre porque a quantidade de gravação de mensagem em disco é muito baixa.

Por exemplo:

O cliente realiza 10 transações por segundo, mas a máquina consegue gravar

apenas 3 mensagens por segundo (que chega a ser apenas uma transação por segundo) .

Ao realizar a instalação do SiTef, é interessante executar o aplicativo Perfdisk e enviar

os resultado ao Suporte Software Express para análise.
 Mensagens SiTef - Bandeiras

Mensagens retornadas

Durante as transações, mensagens de recusa podem ser retornadas. Algumas retornadas pelo
SiTef e outras pela Adquirente

Mensagens retornadas pelo SiTef.

Mensagens retornas (do SiTef ao PDV).

Serviço Indisp., Transação já Efetuada, Cartão Inválido, etc.

Mensagens de ativação ou de aviso (exibidas no Console Controle Geral).

Rede Tecban Inativa (ou Ativa):<PORTA>
Existe transação <Bandeira> Pendente  (Aviso de Sonda)

Mensagens das Administradoras.

Mensagens retornas pelo Administradora ao Sistema de Venda.

15 – Probl. Cartão, 57 – Refaça Transação,...etc .
 Label do Audit

Identificação e coleta dos Audits

É importante saber identificar o label do Audit do SiTef para quando o mesmo for solicitado
pela Software Express.

Os Audits encontram-se no caminho: \SiTef\AUDIT e estará nomeado da seguinte forma:

03131155.000
0313 -> Mês/Dia
1155 -> Hora/Minuto que o sit foi iniciado
.000 -> extensão com o código do respectivo adquirente Ex: .000 PDV, .125 Cielo, .005 Redecard,
.021 Banrisul, .207 Elavon, entre outros.

O log do Audit fica gravado em um mesmo arquivo até que o SiTef seja reiniciado, o Sit caia
por algum motivo ou na virada do dia, nestas situações, será gerado um novo arquivo.
Atualização e Chargeback

Chargeback

Pelo fato do SiTef trabalhar com muitas redes, é necessário que se realize
diversas atualizações. Os informativos destas, vem através de emails (circulares), por isso é muito
importante manter o cadastro atualizado com a Software Express,

Muitas vezes estas atualizações não são realizadas e o estabelecimento corre risco
de não realizar Chargeback.

Mas o que significa o Chargeback?

Chargeback não ocorre quando um cliente esta desatualizado em relação ao que a

Adquirente exige como configuração mínima, como consequência, em um determinado momento,
esta Adquirente pode não mais localizar transações efetuadas pelo estabelecimento, e portanto,
não pagaria pela transação (chargeback).

Importante: Caso ocorra algum problema no estabelecimento e ele não esteja atualizado de acordo
com o que foi alertado nos informes enviados pela Software Express a mesma não se responsabiliza.
 Atualização e Chargeback

Client
Modular
SiTef Gateway
Aplicativo Aplicativos Aplicativos

Configuração Configuração Configuração

Client Modular SitRedecard

4.0.6.7 L0502/5.0.0.8 TrataNIIP=S

Deve-se sempre consultar a Software Express com relação aos impactos de uma
atualização

Toda migração deve seguir o procedimento básico, para se necessário, executar o

“rollback” ou testes que comprovem que a Atualização foi realizada com sucesso.

Acima temos um exemplo da migração da versão do aplicativo da Redecard.

Atualização do SiTef

Todo ano a licença do SiTef precisa ser atualizada, caso a atualização não seja efetuada,
o serviço não irá mais rodar na máquina.

A licença tem validade até o março de (anualmente), perto deste período, o cliente deve
estar atento para mexer no servidor e realizar as atualizações (licença, módulos e etc).

Mensagem retornada no controle geral do SiTef

Software Express
Interfaces SiTef
 Interfaces do SiTef

Principais Interfaces do SiTef.

CliSiTefdll
Biblioteca interativa de funções que facilita a conversação entre PDV e SiTef

Client Modular
Automação simples, utilizada por estabelecimentos que não desejam grandes
investimentos ou desenvolvedores que preferem a interface via arquivos e/ou não
necessitam de interface visual própria.
Interface CliSiTef Dll

Objetivos e características da biblioteca CliSiTef

Propiciar um meio rápido e simples de disponibilizar as funcionalidades do SiTef para

aplicativos em geral.

A própria automação é quem gerencia suas telas, portanto não ocorre sobreposição.

Permite que a automação restrinja as transações disponíveis para determinado pagamento.

Permite total liberdade na inclusão de novos produtos e meios de pagamento,

acompanhando a evolução do SiTef.

A biblioteca é implementada através de duas DLLs para Windows 32 bits ou duas Libs
para Linux (CliSiTefI e CliSiTef32). Estes arquivos pode ser solicitados ao suporte da Software
Express para uso em etapas de desenvolvimento ou de atualização.
Interface CliSiTef Dll

Exemplo da rotina de
uma transação usando a
CliSiTef
Interface CliSiTef Dll

Arquivo CliSiTef.ini

Habilitação de trace

[PinPadCompartilhado]
Porta=01
MensagemPadrao=<Nome da empresa>

[CliSiTefI]
HabilitaTrace=1

[CliSiTef]
HabilitaTrace=1

Transações Habilitadas (Parâmetro de RESTRIÇÃO por arquivo)

[Geral]
TransacoesHabilitadas=<Tipo do meio de pagamento>;<Tipo do meio de pagamento>;...
Interface CliSiTef Dll

Arquivo CliSiTef.ini

inclusão de transações não default

[Geral]
TransacoesAdicionaisHabilitadas=<Tipo do meio de pagamento>;<Tipo do meio de
pagamento>;...
Interface CliSiTef Dll

Arquivo CliSiTef.ini

Habilitando Traces durante desenvolvimento

[Geral]
DataEmAmbienteDeDesenvolvimento=AAAAMMDD

AAAAMMDD refere-se ao dia do teste em questão (NÃO utilizar em produção).

Habilitando parâmetros de recarga: (configurações avançadas)

[Geral]
;Recarga Celular:
TransacoesAdicionaisHabilitadas=60;61;62;63

[RecargaCelular]
HabilitaRecargaMultiConcessionaria=1
IncluiMenuAdministrativo=1
HabilitaTratamentoTrocoPgtoDinheiro=1
TipoConfirmacaoNumeroCelular=0
Interface CliSiTef Dll

Arquivo CliSiTef.ini

 Habilitando parâmetros de Corresp. Bancário: (configurações avançadas)

[PagamentoContas]
HabilitaPagamentoContasFininvest=1

[CorrespondenteBancario]
HabilitaFuncoesAdministrativas=0
PermiteValorTotalDiferente=1  função especifica para CB Bradesco
IncluiMenuAdministrativo=0
HabilitaTransacaoRepasseCB=807  função especifica para CB Banespa
PermiteApenasConferirValorTotal=1
Interface Client Modular

Objetivos e características do Client Modular.

Propiciar um meio rápido e simples de disponibilizar as funcionalidades do SiTef para

aplicativos em geral.

O Cliente SiTef é responsável pela coleta de dados adicionais à transação, pela leitura de
cartões magnéticos caso a transação exija isto e pela formatação das mensagens.

Foi desenvolvido de forma que a quantidade de informações exigidas dos terminais

solicitadores fosse a menor possível, visando simplificar a operação e o desenvolvimento do
mesmo.

O Cliente SiTef, contém um módulo executável desenvolvido para plataforma Windows.

O acionamento deste software será realizado pela Terminal solicitador de TEF através de troca
de pequenos arquivos.

É responsabilidade do Terminal solicitador de TEF coletar alguns dados das transações,

exibir a resposta e imprimir o cupom TEF.
 Funcionamento Interno
Funcionamento do Client Modular.
Na tabela abaixo, podemos observar quais informações são Mandatórias (M) ou opcionais
(O), para cada tipo de transação (HEADER)

Ao efetuar a instalação do Client Modular, os

diretórios ao lado serão criados.

Estes diretórios, são usados para interação

com o client, depositando-se arquivos esperados pelo mesmo,
conforme exemplo abaixo (IntPos.001):

Os arquivos depositados no diretório Req

tem a responsabilidade de informar ao client que tipo de
transação/operação deseja-se realizar.

Arquivo criado em client\Req\IntPos.001

 Instalação Client Modular

Após a execução do arquivo “instala.exe”, e durante o processo de instalação serão

solicitados alguns dados para uma configuração inicial do aplicativo.
Instalação Client Modular

Informações importantes de configuração

e comunicação entre PDV e SiTef serão
solicitadas.
Instalação Client Modular

Após concluir a configuração, será necessário

reiniciar o Client Modular.
Configurações Avançadas

No arquivo clientetrn.ini, podem ser habilitadas transações que não estão

no Client Modular por default .

[BOTOES_HABILITADOS]
btCredito=1
btDebito=1
btFininvest=1
btChequeGarantia=1
btCorrespBancario=0
btCartao=1
btConfigura=1
btUsuario=1
btReimpressao=0

[CONSULTA CHQ SPCBR]

SPC=0
Sintetico=0
Analitica=0
Mix=0
Top_Fisica=0
Master_Fisica=0
Juridica=0
Master_Juridica=0
So_Cheque=0
Software Express
Módulo SiTef Recarga
Sit_GWCel
Módulo de Recarga no SiTef

Para realização de transações de recarga via GWCel, é necessário a instalação

deste módulo no SiTef.

LOJA 01

PDV 01 PDV 02

PDV 03 POS 01

Servidor SiTef Adquirente

SitGWCel
 Configurações Sit- GWCel

A instalação e configuração do módulo deve ser realizada juntamente com o manual

que o acompanha. Algumas informações serão fornecidas pela Software Express.

Tela inicial de configuração do GWCel

As informações de
código de grupo e código de
origem para carga de tabelas
são fornecidas pelo comercial da SE.
 Configurações Sit- GWCel

Alguns exemplos de concessionárias

Na aba Filiais, após clicar no botão Adicionar de E em Filiais, Informar o código da respectiva Filial (área) que o
Concessionárias será aberto um campo para inclusão estabelecimento deseja trabalhar, conforme documento fornecido
do código da respectiva concessionária. pelo comercial “ListaConcessionariasFiliais.pdf”
 Configurações Sit- GWCel

Na aba Estabelecimento, após clicar no

botão Adicionar, será exibida a tela abaixo

Código da Empresa: incluir o código da empresa SiTef

cadastrado no Configurador SiTef.

Código de Origem: Selecionar o código cadastrado

anteriormente e preencher o campo com o código de
estabelecimento para o integrador. Deve seguir o formato:
GGGG+000+NNNNNNNN.

Onde:

GGGG = Código do grupo junto ao GWCEL (cadastrado

anteriormente na guia Geral + 000

NNNNNNNN = código de empresa SiTef

CEP: Do estabelecimento que está sendo cadastrado.

CPF/CNPJ: Do estabelecimento que está sendo

cadastrado.
Configurações Sit- GWCel

Ainda na aba Estabelecimento,

entrando na guia Concessionárias e

Filiais,

Habilita-se o combo Repete o código da

Empresa em todas as transações TEF.

E clica-se no boão + para adicionar todas

as Concessionárias e Filiais ou no
Adicionar para inserir alguma específica
Configurações Sit- GWCel

Se o estabelecimento for trabalhar com PIN de

Recarga, selecionar a empresa desejada ou optar
por TODOS e marcar a opção Habilita
Concessionárias de PIN.

Clique em Incluir e informe os dados abaixo:

Concessionária: Código da Concessionária que

o estabelecimento irá trabalhar no GwCel.

Chave: Esta chave deve ser fornecida por quem

oferece os serviços (transações) de Pin.11
Relatório de Recarga

O Módulo de GWCel, possui um relatório específico para visualização das transações de Recarga.
Software Express
Módulo SiTef
Correspondente Bancário
 Correspondente Bancário

Para realizar transações de correspondente bancário, é necessário a instalação

do módulo no SiTef.

LOJA 01

PDV 01 PDV 02

PDV 03 POS 01

Servidor SiTef Adquirente

SitCB XXX
Software Express
SiTef WEB
SiTef Web

1ª P Achei o BIN
Aguardando Resposta do Host

Estado pendente
2ª P

3ª P
Efetuada ou desfeita
Software Express
Solução Mobile
SOLUÇÃO MOBILE

Dispositivo Móvel

A Biblioteca CliSiTef, possui versões

para os sistemas Android, iOS e Windows
Phone.

O dispositivo móvel disponibilizará

ao usuário a interface para venda
comunicando-se com pinpad e servidor
SiTef.

Configurações como IP, Porta do SiTef,

código Empresa e IdTerminal deverão ser
realizadas na aplicação.
SOLUÇÃO MOBILE

Pinpads

Aos modelos que possuem a opção de funcionamento via USB e Bluetooth, é

necessário o chaveamento para a opção desejada através de suas configurações.

para Android com versão a partir da 4.0 é possível utilizar pinpads USB com
cabo USB OTG em dispositivos compatíveis

Atualmente, os pinpads disponíveis para a solução Mobile e homologados

juntos as redes são:

 Ingenico ISMP  Datecs Bluepad

 Ingenico ICMP  Pax D200
 Gertec MOBI PIN 10  Pax D180
SOLUÇÃO MOBILE

Topologia
É comum que a comunicação entre solução móvel e SiTef ocorra via
Wireless ou Redes de celular.

Tablet

Roteador Wireless TCP/IP

Redes de Celular X25

Adquirente

Pinpad
SOLUÇÃO MOBILE

Particularidades da Solução
Confirmação da transação

Na versão mobile, o processo de confirmação da transação é realizado de

modo diferente, usa-se a função FinalizaTransacaoSiTefInterativoEx,
se o retorno for 10000, chama-se a função ContinuaFuncaoSiTefInterativo e
enquanto o retorno para esta função for 10000 a chamada deve ser repetida
até que o retorno seja 0, indicando que ocorreu tudo bem, ou diferente de 0
ou 10000 indicando alguma interrupção anormal.
SOLUÇÃO MOBILE

Particularidades da Solução
Arquivo de configuração: CLSIT

No documento “SiTef - Interface Simplificada com a aplicação”, consta que o

arquivo de configuração da CliSiTef é o “CliSiTef.ini”, comumente utilizado em
automações para PDVs, mas para a plataforma mobile, deve-se utilizar o arquivo
denominado ‘CLSIT’ (sem extensão e em caixa alta).

Neste arquivo, será acrescentada toda configuração que o programador julgar

necessário para o funcionamento da aplicação, como transações habilitadas ou
desabilitadas, habilitação de trace da CliSiTef e do pinpad e outras funções que
podem ser observadas no documento citado acima.
SOLUÇÃO MOBILE

Particularidades da Solução
Habilitação do trace

Por padrão a gravação de informações de trace na plataforma mobile é

desabilitada.
Para habilitar esta gravação de traces para diagnóstico de problemas pela
equipe da Software Express, deve-se adicionar as seguintes configurações no
arquivo CLSIT:

[CliSiTef]
HabilitaTrace=1

[CliSiTefI]
HabilitaTrace=1
Software Express
Perguntas Frequentes
(FAQ)
 O que fazer ?

1. Usuário informa que o SiTef não funciona > PINPAD - Não Funciona
 Perguntas:

- O que não funciona? Apenas não passa transação no PDV especifico?

- Existe alguma mensagem de erro no display do PDV?
- Os arquivos da data em questão para análise, foram coletados? Horário do problema?
- Todos os PDV’s pararam ou o erro ocorreu em apenas 1 caixa?
- A infra de rede da Loja está OK?
- O Pinpad não funciona por que está desligado? Existe alguma mensagem de erro?
- Porta serial ok? (geralmente erro PinPad 30 ou 31 em caso de porta/comunicação serial)

 O que coletar neste caso (sem qualquer informação):

- Mensagem de erro no PDV / PinPad;

- Horário e informações de Rede/Bandeira do cartão;
- Bin do cartão
- Audits do SiTef;
- Audits do Client;
- (Event Viewer da maquina SiTef )
- Caso necessário a Software Express, vai solicitar o \Config do SiTef e/ou Log do GW.
 Perguntas Frequentes (FAQ)

1. 1) Há alguma limitação por numero de PDVs em uma loja?

Não, você pode utilizar quantos PDVs quiser em uma loja, porém o numero do terminal entre
900 e 999 não podem ser utilizados pois eles são utilizados pelo SiTef.

1. 2) Há alguma forma de exportar o Log (Relatório) em um documento Texto ou

PDF?

Sim, você deve abrir o relatório do SiTef, na aba de opções temos , “Imprimir -> Para o
arquivo”
Será criado um arquivo “.PRN” dentro do diretório “*\SiTef\Lst\”.
A melhor forma de abrir este arquivo seria com o Notepad++.

3) Há alguma forma de renomear uma loja ?

Não, não temos como renomear uma loja facilmente. Há uma amarração criada quando você
tem uma loja já em operação, são criados arquivos em diversos lugares e há um grau de dificuldade
alta para esta mudança. Caso queira realmente que este número de empresa não exista você deve
excluí-la, criar uma nova com o nome desejado e configura-la novamente.
 Perguntas Frequentes (FAQ)

4) A licença do SiTef é gerada por loja/empresas ou por PDV?

A licença do SiTef é gerada sempre por loja, quem gera esta licença é a Software Express e
o cliente precisa dizer quantas lojas/empresas ele vai utilizar e assim será gerada uma licença de
acordo com o pedido.

5) Eu posso aumentar o numero de lojas/empresas depois da licença já gerada?

Sim, caso o cliente queira aumentar o número de lojas/empresas basta entrar em contato
com a área comercial da Software Express e eles irão solicitar uma nova licença ao setor
responsável para encaminhar esta licença.

6) Como posso ter acesso a algum módulo novo para ser instalado?

Caso o cliente queira instalar um novo módulo ele deve entrar em contato com o suporte da
Software Express para solicitar o instalador do mesmo. Ainda não existe um portal que seja possível
realizar o download, ele é enviado por um técnico responsável da Software Express.
 Perguntas Frequentes (FAQ)

7) Como é gerada a licença? Por integrador ou por estabelecimento?

Esta licença é gerada por estabelecimento,para solicitação:

Caso o cliente trabalhe com um integrador, o mesmo deve entrar em contato com a Software
Express para mandar a licença para o seu cliente.
- Caso o cliente não trabalhe o mesmo deve entrar em contato com a Software Express e solicitar a
licença.

8) Quem realiza a instalação do SiTef?

A instalação do SiTef pode ser feita por qualquer um que tenha domínio sobre o
ambiente. A Software Express disponibiliza alguns recursos que podem realizar a instalação em
lócus, deve ser consultada a área comercial para saber como funciona. Caso tenha duvidas
durante a instalação pode ser utilizado o suporte para obter ajuda.
FT – SoftwareExpress

Para facilitar o envio de arquivos

para análise do suporte a Software
Express disponibiliza um link FTP.

https://ft.softwareexpress.com.br/

Obs.: Limite máximo de 40 MB por

envio.
Obrigado!