Treinamento SiTef Modulo I

TREINAMENTO SITEF MÓDULO I

Conceitos Básicos TEF •

TEF

•

Adquirente

•

Bandeira

•

Modos de Leitura

•

Código de Estabelecimento

•

PDV

•

Pinpad


TEF

A sigla TEF significa: “Transferência Eletrônica de Fundos” Fundos”. É qualquer modalidade de pagamento ou serviços realizada de forma eletrônica, substituindo a utilização de dinheiro, cheques ou ordem de pagamento.


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 - Combustível - Refeição  Hipercard  Outras...

 Visa Electron  Amex  JCB  Elo

Emissor

Proprietário do cartão

Adquirente

Shopping

 Bin (Firs Data)

 Rede

 Cielo

 Stone

 Elavon

 Vero (Banrisul)

 Getnet

 PBM’s

 Global Payments

 Voucher’s

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 I nteligente para T ransferência E letrônica de F undos”.

É 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

AUTOMAÇÃO 1

Cada automação terá

ADQUIRENTE A “fala” Inglês

que “falar” Inglês, AUTOMAÇÃO 2

Espanhol, Chinês e Russo???

“fala” Espanhol

ADQUIRENTE C

AUTOMAÇÃO 3

AUTOMAÇÃO 4

ADQUIRENTE B

“fala” Chinês

Aqui entra o SiTef! Para permitir que todas as automações “falem” apenas “SiTefez ”, traduzindo para a língua correta do adquirente!!

ADQUIRENTE D “fala” Russo

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 AUTOMAÇÃO A

E AUTOMAÇÃO B

R P

AUTOMAÇÃO C

D V

Sit Drvcom Sit Drvcom Sit Drvcom : : Servidor SiTef

C O M U N I C A Ç Ã O

Adquirente A

Adquirente B

Adquirente C

Arquitetura SiTef Comunicação via SiTef Gw

Comunicação via X -25

LOJA 01 Integrador

PDV 01

 Comnect/WNB  Imediadata

Data Center Software Express

 GsurfNet  Lyra

PDV 02 Adquirente Comunicação Firewall Servidor SiTef

via TCP/IP

PDV 03

 Bin

Stone

 Elavon

 Vero

 Cielo

 Voucher’s

 Getnet

 PBM’s

 Global Payments  Rede

Roteador Aligera (AR1000, AR2000) Cisco (com protocolo RBP)

Comunicação via X-25

 Outros

Arquitetura SiTef • Fluxo Transacional

LOJA 01 PDV 01

PDV 03

PDV 02

1° Perna

Esperando resposta

Status Pendente

2° Perna

POS 01

Transação efetuada

3° Perna

ou desfeita

Servidor SiTef

Adquirente

Características do SiTef

Características Gerais A lta 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); S eg urança (Troca de mensagens criptografadas); S imultaneidade 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:  Linha

Software de gerenciamento de conexões (utiliza a placa Eicon)

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  Obs:

da Linha contratada e ta manho do Pacote.

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  IP 

o contato com uma Integradora para fechar uma VPN.

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 P ara que tenha efeito é preci s o após a ins talação fazer logoff e logi n.

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 botão e será necessário o apontamento do arquivo .lic através do explorer.

Após o arquivo de licença ser validado, serão carregadas as informações abaixo e habilita-se o botão Ins tala Li cenç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 Pr og ramas >S iTef – Menu Pr inci pal > C onfig urador Geral do S iTef

Configurador SiTef Configurar comunicação entre PDV

S iTef > Interface PD V/S iTef

e SiTef.

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

S iTef > Interface S iTef/Hos t

Configurador SiTef Configurar Interface

S iTef > Loja

SiTef/Loja

Configurador SiTef Configurar nova empresa e

dados operacionais para o PDV.

S iTef > 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.

S iTef > Vi s ualiza C omunicação.

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

Débito.

S iTef > Dados Operacionais > Trans ações H abilitadas

Configurador SiTef Configurar mensagem para o

cabeçalho do Tiquete.

S iTef > Dados Operacionais > C abeçalho do Tic ket

Configurador SiTef Configurar Captura Parâmetros.

S iTef > Dados Operacionais > C aptura Parâmetros

Configurador SiTef Configurar

data de Lançamento.

S iTef > Dados Operacionais > Data de Lançamento

Configurador SiTef Configurar Parcelamentos.

S iTef > Dados Operacionais > Parcelamento

Configurador SiTef Configurar Limites.

S iTef > Dados Operacionais > Limi tes

Configurador SiTef Configurar Código de Estabelecimento

para Amex.

A mex Emv > E s tabelecimento 

P ara cada nova E mpres a config urada um novo códig o de E s tabelecimento.

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

A mex E mv > Trans ações H abilitadas


a comunicação para o módulo da Amex, IP do Router e Porta.. A mex Emv > C omunicação


Terminal Lógico da Cielo.

C ielo4 > E s tabelecimento 

P ara cada nova E mpres a config urada um novo códig o de E s tabelecimento

Configurador SiTef Configuração Local Cielo

C ielo4 > C onfig urador Local


Produtos por empresas ou todas empresas.

Ci elo4 > Config urador P rodutos


a comunicação para o módulo da Cielo, IP do Router e Porta.. C ielo4 > Comunicação


Código de Estabelecimento da Rede

RedeCard > Estabelecimento 

P ara cada nova Empresa config urada um novo códig o de Es tabelecimento


a comunicação para o módulo da Rede , IP do Router e Porta.. R edeC ard > Comunicação

Configurador SiTef  Acessar

a Carga de Tabelas.

Iniciar > Todos os Pr og ramas >S iTef – Menu Princ ipal > Carg a 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.

Mens ag ens de S uces s o: Processando Tabela 90 Transação OK Inicialização Ok

Visualizador de Tabelas  Acessar

o Visualizador de Tabelas.

Iniciar > Todos os Pr og ramas >S iTef – Menu Princ ipal > Vis ualizador de tabelas .

Visualizador de Tabelas Visualizar Produtos Cielo

C ielo4 > P rodutos

Visualizador de Tabelas Visualizar Produtos do Bin

C ielo4 > B ins

Visualizador de Tabelas Visualizador de Limites de Crédito

R edeCardL0502 > Terminal > Li mites C réditos

Visualizador de Tabelas Visualizador de Ranger

R edeCardL0502 > R ang e

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.


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.


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 o aplicativo Carga de Tabelas Pinpad para aplicar as alterações no pinpad.

Após optar por sim, aparecerá a mensagem abaixo, informando que a configuração foi concluída.

Selecionar se a carga será em todas as empresas ou em uma empresa específica. A mensagem abaixo será exibida.

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.

A tenção: A ativação do Cons ole 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 c ontrole geral aberto, como vemos na imagem a cima.

Ativação do Console Controle Geral

A tençã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 – Operando em produção

Servidor 02 – Backup

Software Express Visualização do Relatório

Relatório de transações  Acessar

o Relatório do SiTef.

Iniciar > Todos os Pr og ramas >S iTef – Menu Pri ncipal > 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 transação EFETUADA ESP.RESP PENDENTE CANC.TIM CANC.PDV CANC.LOC EFET.LOC NEGADA CANC.TRN

Descrição Transação Efetuada Esperando resposta da Administradora Transação pendente de confirmação/desfazimento Excedeu tempo de aguardo de resposta da Administradora Sistema de Venda não confirmou ou abandonou a Transação Transação cancelada local (Pendência) Transações efetuada local (Pendência) Transação não autorizada pela Administrador Transação que havia sido efetivada, cancelada normalmente

Código da Transação

Descrição

CMPCTDEB

Compra com cartão de débito

CMPPRECD

Compra pré-datada com cartão de débito

PARCVIST

Compra parcelada com entrada a vista com cartão de débito

CMPCTCRM

Compra com cartão de crédito magnético

CMPCTCRN

Compra com cartão de crédito digitado

CMPCRMJU CANCDEBI

Compra parcelada com cartão de crédito magnético com juros Cancelamento de cartão de débito

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 trans ações por s egundo, mas a máquina cons egue g ravar apenas 3 mens ag ens por s eg undo (que chega a s er apenas uma trans ação por s egundo) .

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): Existe transação 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 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 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, mínima, como como consequência, em um determinado determinado momento, esta Adquirente Adquirente pode não mais localizar transações efetuadas pelo estabelecimento, 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 L0502/5.0.0.8

TrataNIIP=S

4.0.6.7

Deve-se sempre consultar a Software Express com relação aos impactos de uma atualização Toda migração deve seguir s eguir o procedimento básico, para se necessário, executar o “rollback” ou testes que comprovem que a Atualização foi realizada com suc esso.

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

Atualização do SiTef SiTef

Todo ano a licença do SiT SiTef ef 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= [CliSiTefI] HabilitaTrace=1 [CliSiTef] HabilitaTrace=1 Transações

Habilitadas (Parâmetro de RESTRIÇÃO por arquivo)

[Geral] TransacoesHabilitadas=;;...

Interface CliSiTef Dll Arquivo CliSiTef.ini inclusão

de transações não default

[Geral] TransacoesAdicionaisHabilitadas=;;...

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ódig o de g rupo e códig o de ori g em para carg a de tabe tabela lass são fornecidas pelo comercial da SE.

Configurações Sit- GWCel

Alguns exemplos de concessionárias concessionárias

Filiais, após clicar no botão Adicionar de Na aba Filiais, de Concessionárias será Concessionárias será aberto um campo para inclusão do código da código da respectiva concessionária. concessionária.

Filiais, Informar o código da código da respectiva Filial (área) que o E em Filiais, estabelecimento estabelecimento deseja trabalhar, conforme documento fornecido pelo comercial “ListaConcessionariasFiliais.pdf ”


Estabelecimento, após clicar no Na aba Estabelecimento, 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 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: CEP: Do estabelecimento estabelecimento que está sendo cadastrado. CPF/CNPJ: CPF/CNPJ: Do estabelecimento que está sendo cadastrado.


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


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

3ª P

2ª 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

 Ingenico

ICMP

 Pax

D200

 Pax

D180

 Gertec

MOBI PIN 10

Bluepad

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 Redes de Celular

TCP/IP 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 S iTef não funciona > PINPA D - 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 cas o (s em 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 s etor 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.

Treinamento SiTef Modulo I

Recommend Documents