SIGAFRT Retirada de tela Escolha das Adm.

Financeiras 1
Retirada da Tela de Escolha das Adm. Financeiras
Produto : Microsiga Protheus + Front Loja + P10 Chamado : SCRXGR
Data da criao 07/10/10 Data da reviso 22/10/10
Pas(es) : Brasil
Banco de
Dados
: Todos
FNC : 00000015507/2010





Implementado recurso para que na finalizao de vendas no Front Loja, com forma de pagamento carto de
crdito ou dbito, no seja solicitado os cdigos das administradoras, sendo recuperado as bandeiras de
cartes retornadas pelo SITEF aps a transao

Abaixo os cdigos de retorno do SITEF que so contemplados pelo Protheus no retorno automtico para
identificao da administradora de cartes:

1. Cartes de Dbito:
00001 TECBAN
00004 VISANET ESPECIFICAO 200001
00005 REDECARD
00006 AMEX
00021 BANRISUL
00031 TICKET COMBUSTIVEL
00082 GETNET
00125 VISANET ESPECIFICAO 4.1

2. Cartes de Crdito:
00001 VISA
00002 MASTERCARD
00003 DINERS
00004 AMERICAN EXPRESS
00005 SOLLO
00006 SIDECARD (REDECARD)
00007 PRIVATE LABEL (REDECARD)
00008 REDESHOP

2 SIGAFRT Retirada de tela de Escolha das Adm. Financeiras
00010 FININVEST (VISANET)
00011 JCB
00012 HIPERCARD
00013 AURA
00014 LOSANGO
00015 SOROCRED
Procedimentos para Implementao
O sistema atualizado logo aps a aplicao do pacote de atualizaes (Patch) desta FNC.
Importante:
Antes de executar o compatibilizador U_UPDLOJ68 imprescindvel:
a) Realizar o backup da base de dados do produto que ser executado o compatibilizador (diretrio
\PROTHEUS_DATA\DATA) e dos dicionrios de dados "SXs" (diretrio \PROTHEUS_DATA\
SYSTEM).
b) Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser
alterados conforme o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o
sistema.
d) Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar
o compatibilizador, certifique-se de que esto identificados pelo nickname. Caso o compatibilizador
necessite criar ndices, ir adicion-los a partir da ordem original instalada pelo Protheus, o que poder
sobrescrever ndices personalizados, caso no estejam identificados pelo nickname.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.
ATENO: O procedimento a seguir deve ser realizado por um profissional
qualificado como Administrador de Banco de Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o
relacionamento entre tabelas no banco de dados. Portanto, antes de utiliz-la, observe
atentamente os procedimentos a seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial,
selecionando a opo Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as
empresas e filiais cadastradas para o sistema e nenhuma delas estar selecionada. Neste
caso, E SOMENTE NESTE, no necessrio qualquer outro procedimento de ativao
ou desativao de integridade, basta finalizar a verificao e aplicar normalmente o
compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma
SIGAFRT Retirada da tela de Escolha das Adm. Financeiras 3
mensagem na janela Verificao de relacionamento entre tabelas. Confirme a
mensagem para que a verificao seja concluda, ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua
totalidade, so relacionadas em uma nova janela todas as empresas e filiais cadastradas
para o sistema e, somente, a(s) que possui(em) integridade est(aro) selecionada(s).
Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta
anotao para posterior consulta na reativao (ou ainda, contate nosso Help Desk
Framework para informaes quanto a um arquivo que contm essa informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio
desativar tal integridade, selecionando a opo Integridade/ Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme
instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E
SOMENTE SE tiver sido desativada, atravs da opo Integridade/Ativar (APCFG60).
Para isso, tenha em mos as informaes da(s) empresa(s) e/ou filial(is) que possua(m)
ativao da integridade, selecione-a(s) novamente e confirme a ativao.
CONTATE O HELP DESK FRAMEWORK EM CASO DE DVIDAS!

1. Em TotvsSmartClient digite U_UPDLOJ68 no campo Programa Inicial.
2. Clique em OK para continuar.
3. Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser
modificado ou apresentada a janela para seleo do compatibilizador.
4. Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo
em modo exclusivo.
5. Clique em Sim para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos.
apresentada uma mensagem explicativa na tela.
6. Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes
processadas. Nesse log de atualizao, so apresentados somente os campos atualizados pelo programa.
O compatibilizador cria os campos que ainda no existem no dicionrio de dados.
7. Clique em Gravar para salvar o histrico (log) apresentado.
8. Clique em OK para encerrar o processamento.

Ajustes Efetuados pelo Compatibilizador
1. Criao no arquivo SX3 Campos:
Tabela SAE - Adm. Financeiras:
Campo
AE_PARCDE
Tipo Numrico

4 SIGAFRT Retirada de tela de Escolha das Adm. Financeiras
Tamanho 3
Decimal 0
Formato 999
Ttulo Parcela De
Descrio
Parcela Minima
Nvel 1
Usado Sim
Help Nmero mnimo de parcelas permitidas por esse cdigo de adm. Financeira.

Campo
AE_PARCATE
Tipo Numrico
Tamanho 3
Decimal 0
Formato 999
Ttulo Parcela Ate
Descrio
Parcela Mxima
Nvel 1
Usado Sim
Obrigatrio No
Browse No
Help Nmero mximo de parcelas permitidas por esse cdigo de adm. Financeira

Campo
AE_ADMCART
Tipo Caracter
Tamanho 3
Decimal 0
Formato @!
Ttulo Cod. SITEF
Descrio
Cod. Administradora SITEF
Nvel 1
SIGAFRT Retirada da tela de Escolha das Adm. Financeiras 5
Usado Sim
Obrigatrio No
Browse No
F3 MDE
Help
Cdigo correspondente ao retorno do SITEF para essa administradora de
cartes
Tabela MDE - Adm. Cartes SITEF.
Campo
MDE_FILIAL
Tipo Caracter
Tamanho 2
Decimal 0
Formato @!
Ttulo Filial
Descrio
Filial do Sistema
Nvel 1
Usado Sim
Obrigatrio No
Browse No

Campo
MDE_CODIGO
Tipo Caracter
Tamanho 3
Decimal 0
Formato @!
Ttulo Codigo
Descrio
Codigo Interno no Protheus
Nvel 1
Usado Sim
Obrigatrio Sim
Browse Sim
Relao
IIF(INCLUI,GETSXENUM("MDE","MDE_CODIGO"),MDE->MDE_CODIGO)

6 SIGAFRT Retirada de tela de Escolha das Adm. Financeiras
Help
Codigo Interno Protheus (sequencial)

Campo
MDE_DESC
Tipo Caracter
Tamanho 50
Decimal 0
Formato @!
Ttulo Desc. SITEF
Descrio
Descrito Retorno SITEF
Nvel 1
Usado Sim
Obrigatrio Sim
Browse Sim
Help
Descrio exatamente como o retorno do SITEF.

Campo
MDE_TIPO
Tipo Caracter
Tamanho 2
Decimal 0
Formato @!
Ttulo Tipo
Descrio
Tipo do carto
Nvel 1
Usado Sim
Obrigatrio Sim
Browse Sim
Lista Opes
CC=Credito;CD=Debito
Help
Tipo de carto utilizado por essa bandeira (crdito ou dbito).
2. Criao de tabela no arquivo SX2 Tabelas:
Chave Nome Modo PYME
SIGAFRT Retirada da tela de Escolha das Adm. Financeiras 7
MDE Adm. Cartoes SITEF C N
3. Criao no arquivo SX6 Parmetros:
Nome da Varivel MV_LJADMFI
Tipo Lgico
Descrio Inibe a tela de escolha da finalizacao de pagtos. no Front Loja
Valor Padro .F.

4. Criao de Consulta Padro no arquivo SXB Consulta Padro:
MDE:
Alias MDE
Tipo 1
Sequncia 01
Coluna DB
Descrio Administ. Sitef
Contm MDE

Alias MDE
Tipo 2
Sequncia 01
Coluna 01
Descrio Codigo

Alias MDE
Tipo 4
Sequncia 01
Coluna 01
Descrio Codigo
Contm MDE_CODIGO

8 SIGAFRT Retirada de tela de Escolha das Adm. Financeiras

Alias MDE
Tipo 4
Sequncia 01
Coluna 02
Descrio Desc. SITEF
Contm MDE_DESC

Alias MDE
Tipo 5
Sequncia 01
Contm MDE->MDE_CODIGO
5. Criao de ndices no arquivo SIX ndices:
ndice MDE
Ordem 1
Chave MDE_FILIAL + MDE_COD
Descrio Cdigo
Proprietrio S

ndice MDE
Ordem 2
Chave MDE_FILIAL + MDE_DESC
Descrio Desc. SITEF
Proprietrio S
Procedimentos para Configurao
PARA PARMETROS
1. No Configurador (SIGACFG) acesse Ambientes / Cadastros / Parmetros (CFGX017). Crie o parmetro
a seguir:
SIGAFRT Retirada da tela de Escolha das Adm. Financeiras 9
Itens/Pastas Descrio
Informaes
Nome MV_LJADMFI
Tipo Lgico
Cont. Por. .T.

PARA MENUS
2. No Configurador (SIGACFG) acesse Ambientes / Cadastro / Menu (CFGX013). Informe a nova opo de
menu do LOJA075, conforme instrues a seguir:
Menu Sigaloja + Atualizaes
Submenu Cadastros
Nome da rotina Cod. SITEF
Programa LOJA075
Mdulo Controle de Lojas
Tipo Funo Protheus
Tabelas MDE

Procedimentos para Utilizao

1. Aps processar o update, deve-se acessar o mdulo CONTROLE DE LOJAS no cadastro de
ADMINISTRADORAS FINANCEIRAS (tabela SAE). Nesse cadastro, foram criados 3 novos campos:
- Parcela De: numero de parcelamento mnimo permitido para esse cdigo;
- Parcela At: numero de parcelamento mximo permitido para esse cdigo;
- Cod. Sitef: cdigo do SITEF correspondente a administradora cadastrada. Dever ser associado o
cdigo correspondente de retorno do SITEF da bandeira do carto.

2. Acessar o mdulo CONFIGURADOR, e configure o parmetro MV_LJADMFI com .T., para que no seja
exibida a tela de escolha da administradora do carto antes da finalizao a venda.

3. Acessar o mdulo FRONT LOJA, com um usurio CAIXA e com um terminal configurado com o SITEF.
Fazendo uma venda finalizada com condio de pagamento associada ao tipo
CARTO DE CRDITO ou DBITO:
a) Escolher produtos e quantidades;
b) Finalizando a venda, pressionando a tecla F9 e depois pressionando F5 para consultar as
CONDIES DE PAGAMENTO, selecionar a condio associada a carto (podendo ser carto
de crdito CC ou carto de dbito CD).

10 SIGAFRT Retirada de tela de Escolha das Adm. Financeiras
c) Finalizando a escolha da forma de pagamento pressionando a tecla F9, ser exibida a tela
inicial do SITEF para transao dos cartes de crdito/dbito. Seguir os procedimentos de
preenchimento conforme orientao do WIZARD do TEF.
d) Aps a transao ser feita pelo SITEF, e caso a bandeira do carto utilizada no tenha uma
administradora financeira (tabela SAE) associada ao cdigo do SITEF (conforme campo COD.
SITEF, detalhado no item 2 desse documento), o sistema ir exibir uma tela com todas as
administradoras cadastradas do tipo da transao (dbito ou crdito) para que o operador
selecione uma das opes. Essa tela de preenchimento obrigatrio para a finalizao da
venda.
Fazendo uma venda finalizada com TECLAS de atalho de cartes (CTRL + C e
CTRL + D):

Aps acessar a tela de escolha das formas de pagamento (tecla F9), pode-se utilizar os recursos de teclas de
atalho ao invs de condio de pagamento.
a) Pressione CTRL + C ou CTRL + D, que ser exibida a tela para que seja informado o tipo de carto
(dbito ou crdito), nmero de parcelas, valor e ID.
b) Escolha a opo entre DBITO ou CRDITO.
c) Confirme no boto OK. Ser carregado para a tela de FORMAS DE PAGAMENTO, no quadro superior
esquerdo, as informaes, que sero repassadas ao SITEF para processar a transao do carto.

Aps escolher as opes (dbito ou crdito), pressionando a tecla F9, ser carregada a tela do
SITEF para processar a transao do carto. Aps a transao ser feita pelo SITEF, e caso a
bandeira do carto utilizada no tenha uma administradora financeira (tabela SAE) associada ao
cdigo do SITEF (conforme campo COD. SITEF, detalhado no item 2 desse documento), o sistema
ir exibir uma tela com todas as administradoras cadastradas do tipo da transao (dbito ou
crdito) para que o operador selecione uma das opes. Essa tela de preenchimento obrigatrio
para a finalizao da venda.

4. Acessando o mdulo CONTROLE DE LOJAS, na rotina ADM. FINANCEIRAS, relacione as
administradoras com seus respectivos cdigos do SITEF, atravs do campo COD. SITEF e consulta
padro na tabela MBE.

5. Repetindo os processos do item 4, aps o retorno do SITEF aprovando a transao do carto, com o
relacionamento correto entre CARTO UTILIZADO x COD. SITEF NO CADASTRO DE
ADMINISTRADORAS FINANCEIRAS, o sistema apresenta a tela de escolha das administradoras,
finalizando a venda automaticamente.
a) Escolha produtos e quantidades;
b) Escolha a forma de pagamento, pressionando F9 ser carregada a tela do SITEF.
c) Siga as orientaes do WIZARD do TEF.
Com o retorno do SITEF, a venda ser automaticamente finalizada sem informar a administradora
financeira.
6. Em ambos os casos (venda via condio de pagamento ou teclas de atalho), os registros na tabela SL4
CONDIO NEGOCIADA, sero gravadas conforme retorno do SITEF, ou seja, com o cdigo da
administradora financeira relacionada automaticamente pelo campo COD. SITEF ou seleo manual do
usurio aps retorno do SITEF
7. Adicionalmente, com o advento de novas bandeiras de cartes, essas podero ser cadastradas atravs
da rotina COD. SITEF (LOJA075), seguindo a regra repassada no manual da Software Express SITEF.
SIGAFRT Retirada da tela de Escolha das Adm. Financeiras 11
Informaes Tcnicas
Tabelas Utilizadas
SAE Adm. Financeiras
MDE- Cdigos SITEF
Rotinas Envolvidas
FRTA271 Front Loja
FRTA040 Carga de Estaes
Sistemas
Operacionais
Windows/Linux
Nmero do Plano 00000015460/2010