Safra - Guia de Instalação

ROTEIRO DE INSTALAÇÃO E CONFIGURAÇÃO
MÓDULO SAFRA
CONTEÚDO
1. INTRODUÇÃO ....................................................................................................................................... 3
2. DESCRIÇÃO DO NEGÓCIO ................................................................................................................ 3
3. PRÉ-REQUISITOS ................................................................................................................................. 3
4. INSTALAÇÃO DO MÓDULO SAFRA ................................................................................................ 4
4.1 BACKUP ................................................................................................................................................ 4
4.2 INSTALAÇÃO ........................................................................................................................................ 4
4.3 ROLLBACK ........................................................................................................................................... 4
5. COMPONENTES DO MÓDULO.......................................................................................................... 5
6. CONFIGURAÇÃO DO MÓDULO SAFRA NO SITEF/SITDEMO .................................................. 6
7. CONFIGURAÇÃO MULTIBANDEIRA ............................................................................................ 10
7.1 CONFIGURADOR MULTI-BANDEIRA PADRÃO ............................................................................... 11
7.2 CONFIGURADOR MULTIBANDEIRA COLORIDO ............................................................................ 13
8. CARGA DE TABELAS ........................................................................................................................ 18
9. VISUALIZADOR DE TABELAS SAFRA .......................................................................................... 19
10. RELATÓRIOS....................................................................................................................................... 20
11. SITEFWEB ............................................................................................................................................ 21
12. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA SAFRA .................................... 22
13. REIMPRESSÃO DE CUPOM ............................................................................................................. 23
14. CONFIGURAÇÃO DO PONTO DE VENDA (PDV) ........................................................................ 29
14.1 INTERFACE CLISITEF ........................................................................................................................ 29
14.1.1 VENDA CRÉDITO (MAGNÉTICO E DIGITADO) .............................................................................. 29
14.1.2 CANCELAMENTO VENDA CRÉDITO (MAGNÉTICO E DIGITADO) .......................................... 29
14.1.3 VENDA DÉBITO/ VOUCHER ................................................................................................................ 29
14.1.4 VENDA DÉBITO/ VOUCHER (DIGITADO) ........................................................................................ 30
14.1.5 CANCELAMENTO VENDA DÉBITO/ VOUCHER ............................................................................. 30
14.1.6 PAGAMENTO CARNÊ ............................................................................................................................ 31
14.1.7 PRÉ-AUTORIZAÇÃO .............................................................................................................................. 32
14.1.8 ESTORNO DE PRÉ-AUTORIZAÇÃO ................................................................................................... 32
14.1.9 CAPTURA DE PRÉ-AUTORIZAÇÃO ................................................................................................... 32
14.1.10 ESTORNO DE CAPTURA DE PRÉ-AUTORIZAÇÃO ........................................................................ 33
14.2 INTERFACE PDV CLISITEF OU CLIENT MODULAR ........................................................................ 34
14.2.1 VENDA CRÉDITO (MAGNÉTICO E DIGITADO) .............................................................................. 34
14.2.2 CANCELAMENTO VENDA CRÉDITO (MAGNÉTICO E DIGITADO) .......................................... 34
14.2.3 VENDA DÉBITO/ VOUCHER ................................................................................................................ 34
14.2.4 VENDA DÉBITO/ VOUCHER (DIGITADO) ........................................................................................ 34
14.2.5 CANCELAMENTO VENDA DÉBITO/ VOUCHER ............................................................................. 35
14.2.6 PAGAMENTO CARNÊ ............................................................................................................................ 35
14.2.7 PRÉ-AUTORIZAÇÃO .............................................................................................................................. 35
14.2.8 ESTORNO DE PRÉ-AUTORIZAÇÃO ................................................................................................... 35
14.2.9 CAPTURA DE PRÉ-AUTORIZAÇÃO ................................................................................................... 36
14.2.10 ESTORNO DE CAPTURA DE PRÉ-AUTORIZAÇÃO ........................................................................ 36
15. TABELA DE CÓDIGOS DE RETORNO DA ADMINISTRADORA. ............................................ 37
16. INFORMAÇÕES GERAIS................................................................................................................... 40
17. HISTÓRICO DE VERSÕES ................................................................................................................ 41
Safra_Guia de Instalação 2 de 44
1. INTRODUÇÃO
Este documento destina-se ao usuário que pretende instalar e configurar o módulo Safra no SiTef ou no SitDemo.
2. DESCRIÇÃO DO NEGÓCIO
A adquirente Safra processa cartões de crédito e débito bandeirados incluindo processamento EMV.
3. PRÉ-REQUISITOS
Abaixo apresentamos as versões mínimas das interfaces, conforme a versão do SiTef ou SitDemo utilizada:
Nome Versão mínima para o SiTef Versão mínima para o SitDemo
Client Modular 6.1.2.38P 6.0.0.0
CliSiTef 6.1.114.14.r2 6.0.114.0S
As interfaces dos PDV’s somente são compatíveis com a versões específicas do SiTef/SitDemo informadas acima.
ATENÇÃO: É necessário possuir um pinpad com as chaves do Safra.
Versão mínima para tratamento de DMC
Nome Versão mínima para o SiTef Versão mínima para o SitDemo
Client Modular 7.0.2.142 7.0.2.142
CliSiTef 7.0.117.14.rc1 7.0.117.14.rc1
4. INSTALAÇÃO DO MÓDULO SAFRA
4.1 BACKUP
a) Efetuar uma cópia de backup das pastas \SiTef\CONFIG e \SiTef\APLIC.WIN
4.2 INSTALAÇÃO
a) Descompactar o módulo em uma pasta temporária, por exemplo C:\Instalacao\
b) Acessar o diretório temporário criado (C:\Instalacao), executar o programa SiTef_Safra.msi e seguir os
passos Avançar ► Instalar ► Concluir.
c) Efetuar a configuração conforme item “Configuração do Módulo” abaixo.
Observações:
• Se a instalação estiver sendo realizada em ambiente de Produção, antes de iniciar o procedimento, é

necessário parar o serviço do SiTef - Solução Inteligente através dos serviços do Windows, e após concluída
a configuração, ativar novamente.
• Se a instalação estiver sendo realizada em ambiente Simulado, antes de iniciar o procedimento, é necessário
fechar o Console do Controle Geral, e após concluída a configuração, iniciar novamente o SitDemo.
4.3 ROLLBACK
a) Renomear a pasta \SiTef\Config\ para \Config_SAFRA
b) Renomear a pasta \SiTef\Aplic.win para \Aplic.win_SAFRA
c) Voltar as pastas que foram feitas backup no item 4.1 Backup ► \SiTef\CONFIG e \SiTef\APLIC.WIN para o
mesmo diretório \SiTef\
5. COMPONENTES DO MÓDULO
Componentes do módulo para instalação no SiTef
Nome Descrição Versão Mínima
DrvCom-p.exe Driver de Comunicação 8.0.0.3
Gerpdv-p.exe Gerenciador de PDV’s 7.0.9.24
SitSafra-p.exe Módulo Safra 8.0.0.1
Componentes do módulo para instalação no SitDemo
Gerpdv-s.exe Gerenciador de PDV’s 7.0.9.24
SitSafra-s.exe Módulo Safra 8.0.0.1
simcomu-s.exe Simulador de Comunicação 8.0.0.10/RC2
6. CONFIGURAÇÃO DO MÓDULO SAFRA NO SITEF/SITDEMO
ATENÇÃO: Está versão contempla as novas características de configuração do SiTef descritas no

documento “Características de Segurança.pdf”.
Acessar o menu Iniciar ► Programas ►
SiTef Produção: ►
SiTef Simulado: ►
Em seguida selecione a guia SAFRA, serão apresentadas as opções abaixo:
Na guia Estabelecimento, configurar:
IMPORTANTE:
A partir da versão x.x.4.4 o modulo permite que o mesmo código de estabelecimento seja
usado em empresas diferentes, desde que o terminal lógico seja diferente.
Empresa: Selecione a empresa no qual deseja configurar. Caso o SiTef esteja configurado como monoempresa a
empresa utilizada é a 00000000, não permitindo selecionar outra empresa.
Código de Estabelecimento:
• SiTef Produção: Informar o código da loja fornecido pela Safra, completando com zeros a esquerda.
• SiTef Simulado: Informar um código de estabelecimento fictício. Por Exemplo: 11111111111111.
➢ Selecionar está opção se for trabalhar com canal de comunicação

exclusivo para carga de tabelas.
Número Lógico Terminal TEF:

• SiTef Produção: Informar o número lógico fornecido pela Safra.
• SiTef Simulado: Informar um número lógico fictício. Por Exemplo: 11111111.
•
Depois de configurado, pressione o botão , em seguida .
Na guia Comunicação, configurar a interface utilizada para comunicação com o autorizador.
SiTef Produção:
Caso a interface utilizada seja roteador (Cylades, Aligera ou Cisco RBP) deve-se configurar o IP e Porta do roteador
onde foram configurados os dados de conexão fornecidos pela Safra.
Caso a interface utilizada seja placa (Eicon ou NetOpen) deve-se configurar os dados de conexão fornecidos pela
Safra (DTE e UserData) e em qual canal a placa está conectada.
Caso a interface utilizada seja TCPIP/Direto, realizar a configuração conforme informado abaixo:
Sub-Rede 01 – Para fluxo das transações financeiras

Endereço IP Primário: Informar o endereço IP de destino
Porta TCP: Informar a porta TCP de destino
Sub-Rede 02 – Para fluxo das transações de carga de tabelas

Endereço IP Primário: Informar o endereço IP de destino
Porta TCP: Informar a porta TCP de destino
Formato do Tamanho:
• Se a comunicação for TCP/IP direto com a autorizadora SAFRA, configurar Binário (Low High).
• Se a comunicação for com o Gateway, configurar Binário (Low High).
Configuração Geral: Selecionar as opções SiTef-GW e S.E (essas opções devem ser marcadas quando a
comunicação está sendo apontada para a Software Express).
Caso tenha duas conexões IP, sendo uma primária e a outra secundária, efetuar a mesma configuração com os
dados da conexão secundária.
SiTef Simulado:
• Por se tratar de um ambiente Simulado, os dados de comunicação são dados fictícios, não havendo a
comunicação real com o Host/Autorizador, quem responde a comunicação é um simulador interno.
Dessa forma pode ser utilizada qualquer interface, informando dados fictícios, por exemplo:
Endereço IP Primário: Informar um endereço IP fictício, exemplo 1.2.3.4

Porta TCP: Informar uma porta “socket” fictícia, por exemplo 7001.
Ao retornar para a tela do configurador, selecionar a opção Arquivo – Sair.
Configuração Safra realizada com sucesso.
7. CONFIGURAÇÃO MULTIBANDEIRA
Atualmente é possível realizar a configuração utilizando dois configuradores, sendo eles Conf. Multi Bandeira e
conf. (padrão) e Multi bandeira 2 – Colorido (neste é possível realizar a configuração em grupo). Abaixo
apresentamos as configurações de cada.
Para configurar as bandeiras que serão roteadas pela Safra, acessar o menu Iniciar ► Programas ►
SiTef Simulado: ►
Em seguida selecione a guia Sitef -> Multibandeira, serão apresentadas as opções abaixo:
7.1 CONFIGURADOR MULTI-BANDEIRA PADRÃO
Na guia SiTef ► Multibandeiras ► Multiband. Padrão ► Configurador:
Selecione a empresa a ser configurada, ou opte por uma configuração padrão para todas as empresas/lojas do
servidor selecionando a opção TODAS, segue:
Na sequência, escolher a Bandeira do cartão e na coluna Autorizador, marcar a opção Safra. Conforme abaixo:
Para salvar as configurações clique em .
Configuração MultiBandeira Safra realizada com sucesso.
7.2 CONFIGURADOR MULTIBANDEIRA COLORIDO
Na guia SiTef ► Multibandeiras ► Multiband. Colorido ► Configurador:
• Funcionalidades
• Botões
Copia uma linha selecionada da Grid Principal para a Grid de

Edição. Apenas uma linha deve estar selecionada para a cópia ser
bem-sucedida.
Copia a linha da Grid de Edição para todas as linhas selecionadas

no Grid Principal. Essa operação depende de alguns fatores para
ser completamente bem-sucedida.
Seleciona todas as linhas (também feito com Ctrl+A).
Desmarca todas as linhas
Exclui todas as linhas que estão selecionadas.
Regrava todas as configurações
Abre o exportador
Busca a linha de alguma empresa. É necessário preencher com 8

caracteres. Se a linha não é encontrada, nada é feito.
• Linha
Cada linha da Grid Principal faz referência a uma empresa.
Linha não selecionada
Linha selecionada (clique na linha para selecioná-la)
• Coluna
Cada coluna faz referência a um produto de uma bandeira.
Coluna não selecionada.
Coluna selecionada (clique na coluna para selecioná-la).
• Realizando a Configuração das Bandeiras
As empresas estão listadas na coluna à esquerda e a primeira linha lista os produtos. O primeiro passo é
criar uma linha com a configuração desejada, isso é feito na Grid de Edição, localizada na parte superior do
configurador.
Clique nas células da Grid de Edição para listar os módulos existentes
*Os módulos listados são apenas os configurados.
Monte a linha da Grid de Edição da forma que achar necessário, selecionando para cada bandeira o respectivo
módulo. Após selecione as empresas onde é desejável copiar a configuração montada na Grid de Edição e clique
em .
Para consolidar as alterações feitas na Grid Principal, clique em .
Observação: Quando a configuração é gravada, ela não será ativada no SiTef imediatamente, a não ser que o
configurador esteja configurado para fazer isso* ou que o serviço do SiTef seja reiniciado manualmente. Se não
é esse o caso, a configuração é ativada no SiTef em até, no máximo, um dia após a gravação.
* Ativar a 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.
Para ativar essa opção, na guia SiTef ► Multibandeiras ► Multiband. Colorido ► Opções:
Habilite a opção “Ativar configuração sempre que salvar”.
A opção de “Não abrir o log em caso de sucesso” pode ser habilitada ou não. Se habilitada, quando a ativação
foi completada com sucesso, o log não é aberto. Se houver uma falha em alguma mensagem, a log será sempre
aberta automaticamente.
A opção “Pedir confirmação quando aplicar uma linha da Grid de Edição para a Grid Prinipal” habilita a tela
de confirmação após qualquer alteração nas grids, conforme abaixo:
Configuração MultiBandeira Safra realizada com sucesso.
8. CARGA DE TABELAS
SiTef Simulado: ►
Este aplicativo realiza uma baixa das configurações habilitadas para o estabelecimento. Em ambiente de
produção, é realizada uma conexão com o Safra, a qual envia essas configurações ao SiTef.
Selecionar a opção Safra ► Carga, clicar na empresa SiTef que deseja efetuar a carga de tabelas e clicar no Botão
‘Enviar’.
9. VISUALIZADOR DE TABELAS SAFRA
SiTef Simulado: ►
Este aplicativo permite apenas visualizar os dados que desceram na tabela da Safra. Qualquer alteração em ambiente
de produção, deve ser solicitada para a Safra, e após, realizar uma nova carga de tabelas.
Selecione a opção Safra:
10. RELATÓRIOS
Para listar as transações utilizar o Relatório do SiTef, através do menu Iniciar ► Programas ►
SiTef Simulado: ►
Tipo de Log: log_mmdd.dat
11. SITEFWEB
Abaixo apresentamos as versões mínimas das aplicações para usuários do SiTefWeb:
SiTefWeb Aplicativo SiTefWeb 12036 – 27/09/2016
ExpCli Exportador Cliente 1.16.4 – 09/01/2017
ExpServ Exportador Servidor 1.16.5 – 26/09/2016
Para as transações do Elo Débito Virtual (Corona Voucher) é necessário configuração especifica, favor
entrar em contato com o suporte da Software Express para orientação.
12. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA SAFRA
Transação
Compra Débito
Débito para pagamento de Carnê
Compra Voucher
Compra Crédito a Vista Magnético
Compra Crédito a Vista Digitado
Compra Crédito Parcelado sem Juros Magnético
Compra Crédito Parcelado sem Juros Digitado
Compra Crédito Parcelado sem Juros Mag Tx Embarque
Compra Crédito Parcelado sem Juros Dig Tx Embarque
Compra Crédito Parcelado com Juros Magnético
Compra Crédito Parcelado com Juros Digitado
Pré Autorização Crédito a Vista Magnético
Pré Autorização Crédito Parcelado sem Juros Magnético
Pré Autorização Crédito a Vista Digitado
Pré Autorização Crédito Parcelado sem Juros Digitado
Confirmação Pré Autorização Crédito a Vista (Captura)
Confirmação Pré Autorização Crédito Parcelado sem Juros
Cancelamento Compra Crédito Magnético
Cancelamento Compra Crédito Digitado
Cancelamento Pré Autorização
Cancelamento de Captura de Pré Autorização
Cancelamento Compra Débito
13. REIMPRESSÃO DE CUPOM
Conforme solicitação do Safra a partir da versão 5.0.2.0, foi implementado no SiTef a reimpressão de cupons por ‘n’
dias.
A reimpressão de cupom trabalha em conjunto com o módulo NServices, ou seja, o cliente precisará ter o NServices
instalado e configurado, pois este é responsável pela consulta no banco de dados de cupons e retorna o cupom para a
reimpressão.
Efetuar o download do módulo NSERVICES no link:

https://www.softwareexpress.com.br/distri/aplicativos/nservices.zip
Para ativar essa funcionalidade é necessária a configuração do módulo NServices:
Após instalado o módulo NServices, acessar o menu Iniciar ► Programas ► ►
Na aba Habilita Reimpressão, configurar:
Clicar no botão
Depois de configurado, pressione o botão .
Na aba Configuração Geral, configurar:
Endereço IP Servidor: IP do Servidor de E-mail.

Porta Servidor: Porta (default 25).
Número máximo de tentativas: Opcional.
Intervalo Envio: Opcional.
Dados do E-mail: Opcional.
A configuração pode ser feita também, através da criação do Arquivo: /SiTef/CONFIG/NServices.ini
[email]
ipservidor=121.0.0.1
portaservidor=25
Nummaxtentativas=3
intervaloenvio=0
arq0=Selecione o arquivo
Na aba Cadastro de E-mail, configurar:
Na aba E-mail/SMS, configurar:
Empresa: Selecione a empresa no qual deseja configurar. Caso o SiTef esteja configurado como monoempresa a
empresa utilizada é a 00000000, não permitindo selecionar outra empresa.
ID Host: Inserir o identificador do Host
Intervalo de Envio: Inserir o intervalo (em segundos)
Número máximo de tentativas: Por Transação
Host do Proxy: IP de acesso ao host
Porta: Porta de acesso ao Host
URL E-mail: URL da aplicação de e-mail
URL SMS: URL da aplicação de SMS
Pré-requisitos para Reimpressão de cupom
• CliSiTef versão igual ou superior a 4.0.112.25
• Cliente Modular versão igual ou superior a 4.0.6.7
• NServices versão igual ou superior a 6.1.0.10
• Safra versão igual ou superior a 5.0.2.0
Configuração NSERVICES realizada com sucesso!
14. CONFIGURAÇÃO DO PONTO DE VENDA (PDV)
14.1 INTERFACE CLISITEF

Importante: Verificar se a CliSiTef utilizada é compatível com o SiTef/SitDemo que será utilizado, conforme
descrito no item 4.Pré-Requisitos.
14.1.1 VENDA CRÉDITO (MAGNÉTICO E DIGITADO)

Não há parâmetros adicionais para serem configurados.
Essa transação está disponível no menu de Pagamentos (função 0).
Selecionar a opção Cartão de Crédito, e seguir com o fluxo da venda.
14.1.2 CANCELAMENTO VENDA CRÉDITO (MAGNÉTICO E DIGITADO)

Não há parâmetros adicionais para serem configurados.
Pode ser realizado através do menu Administrativo (função 110).
Selecionar a opção Cancelamento de Transação, e seguir com o fluxo do cancelamento.
Ou através do menu de Cancelamento (função 200).
14.1.3 VENDA DÉBITO/ VOUCHER

Não há parâmetros para serem configurados.
Selecionar a opção Cartão de Débito, e seguir com o fluxo da venda.
14.1.4 VENDA DÉBITO/ VOUCHER (DIGITADO)
Incluir no arquivo Clisitef.ini os parâmetros abaixo:
[Geral]
TransacoesAdicionaisHabilitadas=42

Selecionar a opção Cartão de Débito
Selecionar Digitado, e seguir com o fluxo da venda.
14.1.5 CANCELAMENTO VENDA DÉBITO/ VOUCHER

Selecionar a opção Cancelamento de Transação, e seguir com o fluxo do cancelamento.
Ou através do menu de Cancelamento (função 200).
14.1.6 PAGAMENTO CARNÊ
Essa transação está disponível no menu de pagamentos (função 16).
Selecionar a opção Cartão de Débito.
Em seguida selecionar Pagamento de Fatura e seguir com o fluxo.
Pagamento de Fatura com Roteamento Forçado:

O pagamento de fatura respeita o roteamento de bins de débito.
Porém, para clientes que queriam rotear as transações de débito e pagamento fatura para
autorizadoras diferentes.
Deve ser criado o arquivo “abertura.ini” com os seguintes parâmetros:
\SiTef\Config\abertura.ini
Todas as empresas e única empresa:

[Geral]
Encaminha_Pagamento=xxx
Ou
[XXXXXXXX]
Encaminha_Pagamento=xxx
Onde xxx corresponde ao código da Adquirente
14.1.7 PRÉ-AUTORIZAÇÃO
Essa transação está disponível no menu Administrativo (função 110).
Selecionar a opção Pré-Autorização, e seguir com o fluxo do pagamento.
14.1.8 ESTORNO DE PRÉ-AUTORIZAÇÃO

Selecionar a opção Cancelamento de Transação, em seguida selecionar a opção de Cancelamento de
Pré-autorização e seguir com o fluxo.
Ou através do menu direto de Cancelamento (função 200).
14.1.9 CAPTURA DE PRÉ-AUTORIZAÇÃO

Selecione a forma de pagamento Confirmação de Pré-autorização e siga com o fluxo.
14.1.10 ESTORNO DE CAPTURA DE PRÉ-AUTORIZAÇÃO
Selecionar a opção Cancelamento de Transação, em seguida selecionar a opção de Cancelamento de
Confirmação de Pré-autorização e seguir com o fluxo.
Ou através do menu direto de Cancelamento (função 200).
14.2 INTERFACE PDV CLISITEF OU CLIENT MODULAR
Para mais informações sobre essa transação, é necessária a leitura do documento:

Diferenças operacionais Modular Atual x Modular Novo (PDVCliSiTef).pdf
Importante: Verificar se o Client Modular utilizado é compatível com o SiTef/SitDemo que será utilizado,
conforme descrito no item 4.Pré-Requisitos.
14.2.1 VENDA CRÉDITO (MAGNÉTICO E DIGITADO)

Essa transação está disponível no menu de Pagamentos (função CRT).
Selecionar
Em seguida, seguir com o fluxo da venda.
14.2.2 CANCELAMENTO VENDA CRÉDITO (MAGNÉTICO E DIGITADO)

Pode ser realizado através do menu Administrativo (função ADM), ou através do menu de Cancelamento
(função CNC).
5 - Cancelamento
Selecionar a opção
1 - Crédito
Em seguida, escolher
Em seguida, seguir com o fluxo do cancelamento.
14.2.3 VENDA DÉBITO/ VOUCHER

2 - Débito
Selecionar
14.2.4 VENDA DÉBITO/ VOUCHER (DIGITADO)

No arquivo Cliente.ini Incluir o parâmetro conforme abaixo:
[TODOS]
PermiteDebitoDigitado=1
2 - Débito
Selecionar
14.2.5 CANCELAMENTO VENDA DÉBITO/ VOUCHER

Pode ser realizado através do menu Administrativo (função ADM), ou através do menu de Cancelamento
(função CNC).
5 - Cancelamento
Selecionar a opção
2 - Débito
Em seguida, seguir com o fluxo do cancelamento.
14.2.6 PAGAMENTO CARNÊ

2 - Débito
Selecionar a opção .
8 - Pagamento Carnê
Em seguida, seguir com o fluxo.
14.2.7 PRÉ-AUTORIZAÇÃO
Não há configurações adicionais.
Essa transação está disponível no menu de Pré-Autorização de Cartão de Crédito (função PRE).
1 - Pré-Autorização
Selecionar a opção e siga com o fluxo
14.2.8 ESTORNO DE PRÉ-AUTORIZAÇÃO

Essa transação está disponível no menu de funções administrativas (função ADM).
5 - Cancelamento
Clicar no botão .
1 - Pré-Autorização
Após selecione e siga com o fluxo.
14.2.9 CAPTURA DE PRÉ-AUTORIZAÇÃO

Essa transação está disponível no menu de Pré-Autorização de Cartão de Crédito (função PRE).
2 - Captura à Vista 3 - Captura Parcelada Adm

Selecionar a opção , ou
4 - Captura Parcelada Loja

e siga com o fluxo.
14.2.10 ESTORNO DE CAPTURA DE PRÉ-AUTORIZAÇÃO

Essa transação está disponível no menu de funções administrativas (função ADM).
5 - Cancelamento
Clicar no botão .
1 - Crédito
3 - Confirmação de Pré
Após selecione e siga com o fluxo.
15. TABELA DE CÓDIGOS DE RETORNO DA ADMINISTRADORA.
Retorno Bandeira Mensagem POS / TEF Significado
000 Approved 2-000 AUTORIZADA 00 Successful
107 Refer To Card Issuer 2-107 REFERIDA 01 Refer To Card Issuer
108 Refer To Card Issuer Special 2-108 REFERIDA 02 Refer To Card Issuer Special
109 Invalid Merchant 2-109 ESTABEL INVALIDO 03 Invalid Merchant
200 Do Not Honour Pick Up 2-200 NAO AUTORIZADA 04 Pick Up
100 Do Not Honour 2-100 NAO AUTORIZADA 05 Do Not Honour
913 Duplicate Transmission 2-913 TRANS. DUPLICADA 06 Error
207 Special Conditions Pick Up 2-207 NAO AUTORIZADA 07 Pick Up Special
001 Honour With ID 2-001 APROVADA 08 Honour With ID
923 Request In Progress 2-923 TRANS. DUPLICADA 09 Request In Progress
002 Approved Partial 2-002 APROVADA 10 Approved Partial
003 Approved VIP 2-003 APROVADA 11 Approved VIP
902 Invalid Transaction 2-902 TRANS. INVALIDA 12 Invalid Tran
110 Invalid Amount 2-110 VALOR INVALIDO 13 Invalid Amount
111 Invalid Card Number 2-111 CARTAO COM ERRO 14 Invalid Card Number
908 Routing Error 2-908 ERRO DE ROTA 15 No Such Issuer
004 Approved Update Track 3 2-004 APROVADA 16 Approved Update Track 3
100 Do Not Honour 2-100 NAO AUTORIZADA 17 Customer Cancellation
100 Do Not Honour 2-100 NAO AUTORIZADA 18 Customer Dispute
903 Re-enter Transaction 2-903 TENTE NOVAMENTE 19 Re-enter Transaction
100 Do Not Honour 2-100 NAO AUTORIZADA 20 Invalid Response
921 Security Error No Action 2-921 EMISSOR FORA 21 No Action Taken
909 System Malfunction 2-909 ERRO SISTEMA 22 Suspected Malfunction
113 Unacceptable Fee 2-113 NAO AUTORIZADA 23 Unacceptable Tran Fee
301 File Action Not Supported 2-301 TRANS. COM ERRO 24 File Update Not Supported
302 File Record Not Found 2-302 TRANS. COM ERRO 25 Unable To Locate Record
308 File Duplicate Record Rejected 2-308 TRANS. REJEITADA 26 Duplicate Record
304 File Field Edit Error 2-304 TRANS. COM ERRO 27 File Update Edit Error
305 File Locked Out 2-305 TRANS. COM ERRO 28 File Update File Locked
306 File Action Not Successful 2-306 TRANS. COM ERRO 29 File Update Failed
904 Format Error 2-904 ERRO 30 Format Error
905 Acquirer Not Supported 2-905 ERRO 31 Bank Not Supported
100 Do Not Honour 2-100 NAO AUTORIZADA 32 Completed Partially
201 Expired Card Pick Up 2-201 CARTAO EXPIRADO 33 Expired Card Pick Up
202 Suspected Fraud Pick Up 2-202 CARTAO COM ERRO 34 Suspected Fraud Pick Up
203 Contact Acquirer Pick Up 2-203 CONTATE SAFRA 35 Contact Acquirer Pick Up
204 Restricted Card Pick Up 2-204 CARTAO COM ERRO 36 Restricted Card Pick Up
205 Call Acquirer Security Pick Up 2-205 CONTATE SAFRA 37 Call Acquirer Security Pick Up
206 PIN Tries Exceeded Pick Up 2-206 SENHA BLOQUEADA 38 PIN Tries Exceeded Pick Up
114 No Account Of Requested Type 2-114 NAO AUTORIZADA 39 No Credit Account
115 Function Not Supported 2-115 NAO SUPORTADA 40 Function Not Supported
208 Lost Card Pick Up 2-208 CARTAO COM ERRO 41 Lost Card
114 No Account Of Requested Type 2-114 NAO AUTORIZADA 42 No Universal Account
209 Stolen Card Pick Up 2-209 CARTAO COM ERRO 43 Stolen Card
114 No Account Of Requested Type 2-114 NAO AUTORIZADA 44 No Investment Account
100 Do Not Honour 2-100 NAO AUTORIZADA 45 –50
116 Not Sufficient Funds 2-100 NAO AUTORIZADA 51 Not Sufficient Funds
114 No Account Of Requested Type 2-100 NAO AUTORIZADA 52 No Check/Cheque Account
114 No Account Of Requested Type 2-116 LIMITE EXCEDIDO 53 No Savings Account
101 Expired Card 2-114 NAO AUTORIZADA 54 Expired Card
117 Incorrect PIN 2-117 SENHA INVALIDA 55 Incorrect PIN
118 No Card Record 2-118 CARTAO COM ERRO 56 No Card Record
119 Tran Not Permitted Cardholder 2-119 NAO PERMITIDA 57 Tran Not Permitted Cardholder
120 Tran Not Permitted Terminal 2-120 NAO PERMITIDA 58 Tran Not Permitted Terminal
102 Suspected Fraud 2-102 CARTAO COM ERRO 59 Suspected Fraud Declined
103 Contact Acquirer 2-103 CONTATE SAFRA 60 Contact Acquirer
121 Exceeds Withdrawal Amount

Limit 2-121 LIMITE EXCEDIDO 61 Exceeds Withdrawal Limit
104 Restricted Card 2-104 CARTAO COM ERRO 62 Restricted Card
122 Security Violation 2-122 CONTATE SAFRA 63 Security Violation
110 Invalid Amount 2-110 VALOR INVALIDO 64 Original Amount Incorrect
123 Exceeds Withdrawal Frequency

Limit 2-123 NEG. INSIRA CHIP 65 Exceeds Withdrawal Frequency
105 Call Acquirer Security 2-105 CONTATE SAFRA 66 Call Acquirer Security
200 Do Not Honour Pick Up 2-200 NAO AUTORIZADA 67 Hard Capture
911 Card Issuer Timed Out 2-911 TENTE NOVAMENTE 68 Response Received Too Late
106 PIN Tries Exceeded 2-106 SENHA BLOQUEADA 75 PIN Tries Exceeded
100 Do Not Honour 2-100 NAO AUTORIZADA 76
77 Intervene Bank Approval

103 Contact Acquirer 2-103 CONTATE SAFRA Required
103 Contact Acquirer 2-103 CONTATE SAFRA 78 Intervene Partial Amount
906 Cutover In Progress 2-906 REFACA TRANSACAO 90 Cut-off In Progress
907 Issuer Or Switch Inoperative 2-907 EMISSOR FORA 91 Issuer Or Switch Inoperative
908 Routing Error 2-908 ERRO DE ROTA 92 Routing Error
124 Violation Of Law 2-124 NAO AUTORIZADA 93 Violation Of Law
913 Duplicate Transmission 2-913 TRANS. DUPLICADA 94 Duplicate Transmission
915 Cutover Or Checkpoint Error 2-915 ERRO 95 Reconcile Error
909 System Malfunction 2-909 ERRO SISTEMA 96 System Malfunction
100 Do Not Honour 2-100 NAO AUTORIZADA 97
121 Exceeds Withdrawal Amount

Limit 2-121 LIMITE EXCEDIDO 98 Exceeds Cash Limit
16. INFORMAÇÕES GERAIS
Extensão da Audit: 296

Extensão da Log: .dat
Cupom Reduzido: Sim
Para habilitar a funcionalidade do cupom reduzido é necessário realizar uma configuração no arquivo sitefcfg.ini
localizado no servidor SiTef \CONFIG\ sitefcfg.ini, e inserir o parâmetro abaixo:
[CONFIG]
HabilitaTicketReduzido=1
Após realizar a configuração é necessário reiniciar o serviço do SiTef para habilitar a nova funcionalidade.
Porta Gateway (Produção): 22313
17. HISTÓRICO DE VERSÕES
Versão Alteração
5.0.0.1 Versão Inicial
Versão homologada pelo Safra

x.x.0.8
Versão liberada para piloto
x.x.0.9 Melhorias no comprovante do módulo solicitadas pelo Safra.
x.x.0.10 Ajuste no relatório de transações para melhor visualização das informações.
x.x.0.11 Ajustes nas transações de cancelamentos do módulo
Ajustes no Código de Bandeiras Padrão quando habilitado.

x.x.0.12
Ajustes na validação de número máximo de parcelas.
x.x.0.13 Melhorias na compatibilidade com o módulo SAT NFC-e.
x.x.0.14 Adequação para que a transação não seja negada com o código 904.
x.x.0.15 Melhorias na troca de mensagens entre o PDV e SiTef
x.x.0.16 Ajustes na carga de tabela
x.x.0.17 Melhorias nas trocas de mensagens entre o PDV e SiTef
x.x.0.18 Adequação nas tabelas de produtos recebidas do autorizador, para não prejudicar o
arquivo de saída do converte log.
x.x.0.19 Melhorias no configurador do modulo, para que não ocorra problemas na leitura do
arquivo de configuração.
x.x.0.20 Melhorias na carga de tabelas de empresas recém-criadas, para que seja disponibilizado o
diretório de gravação dos arquivos referente as tabelas, evitando possíveis problemas nas
transações.
x.x.0.21 Adequação na transação de desfazimento evitando possíveis problemas no tratamento da

mesma.
x.x.0.22 Melhoria nas transações de desfazimento.
Adequação na transação de pré-autorização evitando possíveis problemas no tratamento
x.x.0.23
da mesma.
x.x.0.24 Aumento do limite da tabela de timeout.
x.x.0.25 Adequação na transação de desfazimento evitando possível queda do modulo.
Melhoria no modulo para não gravar a mensagem “falha lê cartão cripto” no controle geral
x.x.0.26
do SiTef.
Adequação no fluxo de carga de tabelas, evitando que em transações de carga de tabelas
x.x.0.27 negadas pelo autorizador, sejam geradas mensagens automáticas impactando no correto
funcionamento do módulo.
x.x.0.28 Melhoria nas transações que são negadas.
x.x.0.29 Melhorias na troca de mensagens
x.x.0.30 Ajustes no tratamento de pendências de log
x.x.0.30a Melhorias na carga de tabelas
x.x.0.30b Melhorias no aplicativo Visualizador de Tabelas.
Habilitação das bandeiras Cabal, ELO, Hipercard e Sorocred.
Permite a reimpressão de comprovante de cancelamento com o mesmo NSU Host da

x.x.2.1
venda (versão mínima NServices).
Permite Pagamento Carnê.
x.x.2.2 Alterações no módulo
x.x.2.3 Melhorias na gravação de log
x.x.2.7 Ajustes no comprovante de transação.
x.x.2.8 Inclusão da transação compra Voucher
x.x.2.8a Ajustes na configuração para desabilitar o pagamento carnê no fluxo de débito
x.x.4.0 Inclusão das transações contactless EMV
Inclusão do canal de comunicação exclusivo para carga de tabelas.
Adequação nos dados referente a coluna nome produto do relatório SiTef para melhor
x.x.4.1
identificação das transações de pagamento carne.
Adequação nas informações do cupom fiscal para sua melhor visualização.

x.x.4.2
Inclusão da versão do GerPdv para validação dos clients.
x.x.4.3 Adequação no fluxo de mensagens referente as transações para um melhor desempenho.
Adequação para permitir que o mesmo código de estabelecimento seja usado em

x.x.4.4
empresas diferentes, desde que o terminal lógico seja diferente.
x.x.4.5 Melhorias na configuração por empresa do módulo
x.x.4.6 Melhorias na troca de mensagens
x.x.4.7 Melhorias na configuração multibandeira.
Adequação na troca de mensagens com o autorizador Safra para melhor desempenho nas
x.x.4.8
transações de crédito e débito.
x.x.4.10 Aprimoramento na segurança do módulo
x.x.4.11 Melhorias de desempenho do módulo.
x.x.4.13 Melhorias no desempenho do módulo e nas transações feitas com o LoteWin.
Melhorias nas transações de pré-autorização.

x.x.4.14
Alteração na identificação dos produtos Alelo Refeição e Alimentação.
x.x.8.3 Primeira versão liberada para o Sitef 7
x.x.8.3 Ajustes na versão do GerPDV para melhor desempenho das transações de Crédito.
x.x.8.4 Adequações no tratamento de pendências.
Inclusão de transações de débito digitadas para o produto Elo Débito Virtual (Corona
x.x.8.6
voucher).
Adequação na troca de mensagens com o autorizador Safra para melhor desempenho nas
x.x.8.6a
transações de débito digitadas para o produto Elo Débito Virtual (Corona voucher).
x.x.8.8 Adequação para melhor desempenho do módulo.
x.x.8.9 Ajustes para melhoria de desempenho.
Adequação na troca de mensagens entre o SiTef e o Autorizador Safra, para melhor

x.x.8.10
desempenho nas transações de crédito e débito.
x.x.10.3 Inclusão do tratamento DMC(Debit Mastercard) e ABECS 2.12.
8.0.0.0 Melhoria na segurança e adequações para aprimoramento no modulo
8.0.0.1 Melhorias no desempenho do módulo.

Safra - Guia de Instalação

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Safra - Guia de Instalação

Enviado por

Direitos autorais:

Formatos disponíveis

ROTEIRO DE INSTALAÇÃO E CONFIGURAÇÃO

Nome Versão mínima para o SiTef Versão mínima para o SitDemo

Client Modular 6.1.2.38P 6.0.0.0

CliSiTef 6.1.114.14.r2 6.0.114.0S

ATENÇÃO: É necessário possuir um pinpad com as chaves do Safra.

Versão mínima para tratamento de DMC

Nome Versão mínima para o SiTef Versão mínima para o SitDemo

Client Modular 7.0.2.142 7.0.2.142

CliSiTef 7.0.117.14.rc1 7.0.117.14.rc1

• Se a instalação estiver sendo realizada em ambiente de Produção, antes de iniciar o procedimento, é

Componentes do módulo para instalação no SiTef

Nome Descrição Versão Mínima

DrvCom-p.exe Driver de Comunicação 8.0.0.3

Gerpdv-p.exe Gerenciador de PDV’s 7.0.9.24

SitSafra-p.exe Módulo Safra 8.0.0.1

Componentes do módulo para instalação no SitDemo

Nome Descrição Versão Mínima

Gerpdv-s.exe Gerenciador de PDV’s 7.0.9.24

SitSafra-s.exe Módulo Safra 8.0.0.1

simcomu-s.exe Simulador de Comunicação 8.0.0.10/RC2

ATENÇÃO: Está versão contempla as novas características de configuração do SiTef descritas no

Acessar o menu Iniciar ► Programas ►

Em seguida selecione a guia SAFRA, serão apresentadas as opções abaixo:

Na guia Estabelecimento, configurar:

➢ Selecionar está opção se for trabalhar com canal de comunicação

Número Lógico Terminal TEF:

Depois de configurado, pressione o botão , em seguida .

Sub-Rede 01 – Para fluxo das transações financeiras

Sub-Rede 02 – Para fluxo das transações de carga de tabelas

Endereço IP Primário: Informar um endereço IP fictício, exemplo 1.2.3.4

Depois de configurado, pressione o botão , em seguida .

Ao retornar para a tela do configurador, selecionar a opção Arquivo – Sair.

Configuração Safra realizada com sucesso.

Configuração MultiBandeira Safra realizada com sucesso.

Copia uma linha selecionada da Grid Principal para a Grid de

Copia a linha da Grid de Edição para todas as linhas selecionadas

Seleciona todas as linhas (também feito com Ctrl+A).

Desmarca todas as linhas

Exclui todas as linhas que estão selecionadas.

Regrava todas as configurações

Busca a linha de alguma empresa. É necessário preencher com 8

Linha não selecionada

Linha selecionada (clique na linha para selecioná-la)

Coluna não selecionada.

Coluna selecionada (clique na coluna para selecioná-la).

Clique nas células da Grid de Edição para listar os módulos existentes

*Os módulos listados são apenas os configurados.

Habilite a opção “Ativar configuração sempre que salvar”.

Configuração MultiBandeira Safra realizada com sucesso.

Acessar o menu Iniciar ► Programas ►

Acessar o menu Iniciar ► Programas ►

Selecione a opção Safra:

Tipo de Log: log_mmdd.dat

Abaixo apresentamos as versões mínimas das aplicações para usuários do SiTefWeb:

Nome Descrição Versão Mínima

SiTefWeb Aplicativo SiTefWeb 12036 – 27/09/2016

ExpCli Exportador Cliente 1.16.4 – 09/01/2017

ExpServ Exportador Servidor 1.16.5 – 26/09/2016

Débito para pagamento de Carnê

Compra Crédito a Vista Magnético

Compra Crédito a Vista Digitado

Compra Crédito Parcelado sem Juros Magnético

Compra Crédito Parcelado sem Juros Digitado