Histórico da Página
CONCILIAÇÃO DE CARTÕES
Características do RequisitoProjeto Conciliação de Cartões
Linha de Produto: | RMS |
Segmento: | VAREJO |
Módulo: | TESOURARIA |
Rotina: |
|
| ||||||||||
Cadastros Iniciais: | Cadastros de Redes, Bandeiras, Produtos e Tipos de capturas. | |||||||||
Parâmetro(s): | Redes: Tabela 45-SR<RRRRRRRR> Bandeiras: Tabela 45-SITBAN<BBBB> Produtos: Tabela 45- |
SITPR<PPPPP> Tipos de capturas: Tabela 45-SITCAPTUR<C> | |
País(es): | Brasil. |
Banco(s) de Dados: | Oracle |
Tabelas Utilizadas: | AG2VTFVD, AG2VTFVF, AG2VTFMV, AG2VTFCR, AG2VTFTA, AG2VTFPR, AG2VTFLJ, AG2VTFAJ, AG2VTFRJ e AG2VTFMO. |
Sistema(s) Operacional(is): | Windows. |
Versões/Release: | 5681.1 / V12Rx |
Descrição
O projeto Conciliação de cartões consiste no desenvolvimento de funcionalidades necessárias para importar os dados de vendas das administradoras de cartão, assim como os créditos recebidos referentes às antecipações dos depósitos, ajustes ou simplesmente os créditos referentes às vendas em cartão de crédito, débito, etc. Os dados de venda importados são utilizados para efetuar as saídas do cofre para os documentos referentes às vendas Sitef e os créditos e antecipações são utilizados para baixar os títulos no módulo de contas a receber, oriundos de dobra das saídas do cofre da tesouraria das saídas Sitef. O processo de saídas sitef Sitef é substituído pelo processo de saída através da conciliação de cartões, essa mudança é feita a partir da parametrização através do painel de controle, no cofre permanece a mesma função para o usuário. Os ajustes com agenda de entrada geram títulos a pagar, conforme as parametrizações informadas no painel de controle. As transações podem ser consultadas em detalhes através da seleção do título no contas receber, registro fiscal ou no movimento do cofre da tesouraria, assim como os dados brutos importados. O título a receber não pode ser baixado manualmente assim como agrupado, abatido automaticamente ou enviado para baixa em banco.
Tabela | AG2VTFVD |
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão 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 não estejam identificados pelo nickname.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente! A ativação 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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:
Nome da Variável: | Informe o Nome da Variável |
Tipo: | Informe o Tipo |
Descrição: | Informe a Descrição |
Valor Padrão: | Informe o Valor Padrão |
Atualizações do Compatibilizador
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
- Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:
Pergunte | (X1_PERGUNT) |
Nome |
|
Grupo | (X1_GRUPO) |
Ordem | (X1_ORDEM) |
Tipo | (X1_TIPO) |
Tamanho | (X1_TAMANHO) |
2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
B04 (X2_CHAVE) | Dente/Região (X2_NOME) | C (X2_MODO) | N (X2_PYME) |
3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:
Chave | Ex.: AR |
Descrição | Ex.: Tabela de IR de Aplicações Financeiras |
4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:
- Tabela BGD - Prod x Cob x Proc x Co-Part:
Campo | (X3_CAMPO) |
Tipo | (X3_TIPO) |
Tamanho | (X3_TAMANHO) |
Decimal | (X3_DECIMAL) |
Formato | (X3_PICTURE) |
Título | (X3_TITULO) |
Descrição | (X3_DESCRIC) |
Nível | (X3_NÍVEL) |
Usado | (X3_USADO) Informe Sim ou Não |
Obrigatório | (X3_OBRIGAT) Informe Sim ou Não |
Browse | (X3_BROWSE) Informe Sim ou Não |
Opções | (X3_CBOX) |
When | (X3_WHEN) |
Relação | (X3_RELACAO) |
Val. Sistema | (X3_VALID) |
Help | Descreva o conteúdo informado para Help de Campo no ATUSX |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLS:
Alias | (XB_ALIAS) |
Tipo | (XB_TIPO) |
Sequência | (XB_SEQ) |
Coluna | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
6. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice | AA1 |
Ordem | 6 |
Chave | AA1_FILIAL+AA1_CODVEN |
Descrição | Cod. Vendedor |
Proprietário | S |
7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | (X6_VAR) |
Tipo | (X6_TIPO) |
Descrição | (X6_DESCRIC + X6_DESC1 + X6_DESC2) |
Valor Padrão | (X6_CONTEUD) |
8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:
- Tabela BD5 – Contas Médicas:
Campo | Informe o conteúdo do (X7_CAMPO) |
Sequência | Informe o conteúdo do (X7_SEQUENC) |
Campo Domínio | Informe o conteúdo do (X7_CDOMIN) |
Tipo | Informe o conteúdo do (X7_TIPO) |
Regra | Informe o conteúdo do (X7_REGRA) |
Posiciona? | Informe o conteúdo do (X7_SEEK) |
Chave | Informe o conteúdo do (X7_CHAVE) |
Condição | Informe o conteúdo do (X7_CONDIC) |
Proprietário | Informe o conteúdo do (X7_PROPRI) |
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas | Descrição |
Nome: |
|
Tipo: | Informe o Tipo do parâmetro |
Cont. Por.: | Informe o Conteúdo padrão |
Descrição: |
|
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
Procedimento para Utilização
- Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
- Localização da rotina no menu;
- Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
- Caso seja necessário ter algum cadastro feito previamente, faça uma observação.
Exemplo:
1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).
O sistema apresenta a janela de produtos cadastrados.
2. Posicione o cursor em um produto e clique em Alterar.
3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.
4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).
O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.
5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:
Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.
6. Confira os dados e confirme.
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
Descrição | Vendas importadas não associadas para saída do cofre |
Tabela | AG2VTFVF |
Descrição | Vendas associadas |
Tabela | AG2VTFMV |
Descrição | Movimentações de vendas com informações parametrizadas |
Tabela | AG2VTFMO |
Descrição | Motivos de ajustes |
Tabela | AG2VTFCR |
Descrição | Créditos importados |
Tabela | AG2VTFTA |
Descrição | Transações antecipadas |
Tabela | AG2VTFRJ |
Descrição | Detalhes rejeitados |
Tabela | AG2VTFAJ |
Descrição | Ajustes importados |
Tabela | AG2VTFPR |
Descrição | Parametrizações do painel de controle |
Tabela | AG2VTFLJ |
Descrição | Associações de lojas RMS com códigos de estabelecimentos |
Campos chaves
Campo | Descrição |
---|---|
TMV_TPA | Total de parcelas |
TMV_PAR | Número da parcela |
TMV_CAP | Tipo de captura |
TMV_RED | Código da rede |
TMV_BAN | Código da bandeira |
TMV_PRO | Tipo do Produto |
TMV_EST | Código do estabelecimento |
TMV_DTA | Data da venda |
TMV_SEQ | Sequência da saída do cofre |
Procedimento para Configuração
CONFIGURAÇÃO DE PARÂMETROS
- Cadastrar as tabelas de redes, bandeiras e produtos.
1.1. No programa VABUTABE, incluir as redes na tabela com código 45, acesso ‘SR’<rrrrrrrr>, onde r=Código da rede, conforme layout disponibilizado pela administradora de cartões.
1.2 No programa VABUTABE, incluir as bandeiras na tabela com código 45, acesso ‘SITBAN<bbbb>, onde b=Código da bandeira, conforme layout disponibilizado pela administradora de cartões.
1.3 No programa VABUTABE, incluir os produtos na tabela com código 45, acesso ‘SITPR’<ppppp>, onde p=Código do produto, conforme layout disponibilizado pela administradora de cartões.
1.4 No programa VABUTABE, incluir as capturas na tabela com código 45, acesso ‘SITCAPTUR’<c>, onde c=Código da captura, conforme layout disponibilizado pela administradora de cartões.
Painel de controle
1 - Foi incluída a opção de checkbox ‘Conciliação de Cartões’. Necessário informar que está usando conciliação de cartões no rodapé da tela do painel de controle:
2 - Foi incluída nova aba ‘Conc. Cartões’ que é habilitada conforme o checkbox anterior. Informar os dados de associação da administradora de cartões para gerar as saídas do cofre:
3 - Foi incluída nova aba ‘Param Cartões’ que é habilitada conforme o checkbox ‘Conciliação de Cartões’. Informe os dados para gerar os ajustes e a associação entre o código da filial(estabelecimento) Sitef e filial RMS. O código do motivo do ajuste é definido no layout da adm. de cartões e os demais dados são os utilizados para gerar o título no financeiro.
Consulta de importações
1 – O programa VGTINTEF foi alterado para mostrar as importações da conciliação de cartões, conforme a opção ‘Conciliação de Cartões’ do painel de controle da tesouraria. Após importar os dados pelo webservices, é possível consultar as importações que mostram a quantidade de registros importados. Também é utilizado para verificar os erros de parametrizações para as saídas do cofre não realizadas, pois mostra as vendas não associadas ao painel de controle, para isso usar a opção ‘Imprimir’ e informar ‘vendas não associadas’.
2 - Desenvolvido relatório emitido através do programa VGTINTEF, para imprimir as transações importadas na filial no período.
3 - O relatório mostra todas as transações importadas na filial no período:
Saídas do cofre
1 - A função ‘Saídas Sitef’ foi alterada para fazer as saídas utilizando os dados da conciliação de cartões, conforme o checkbox ‘Conciliação de Cartões’ do painel de controle da tesouraria. Necessário efetuar as saídas do cofre, através da função ShF3-Saídas Sitef. Deve ter entradas no cofre que são feitas através da atualização das coletas ou fechamento do turno, se usar tesouraria on line.
2 - Após efetuar as saídas é possível consultar os detalhes que foram gerados. Foi criada nova função ‘Exibir Trans.’ para mostrar os detalhes das transações referentes à conciliação de cartões.
3 – Foi desenvolvida esta consulta que é apresentada através de seleção do cofre da tesouraria, ou seja, é possível consultar os detalhes das transações usadas para gerar as saídas.
Atualização do movimento da tesouraria
1 – A atualização do movimento da tesouraria gera os dados no registro fiscal que integram o contas a receber se as parametrizações, principalmente de agenda, estiverem corretas.
Consulta transações no registro fiscal
1 – Foi criada uma nova função no registro fiscal para mostrar os detalhes das transações. Os dados são integrados no registro fiscal, para integrar o contas a receber é necessário executar a integração, veja os dados gerados no registro fiscal e a nova função para consultar os detalhes das transações.
2- Foi desenvolvida esta consulta para mostrar as transações através de seleção no registro fiscal.Veja as transações consultadas através do registro fiscal:
Consulta título no contas a receber
1 - Foi criada nova função Conc. Cartões, para consultar as transações Sitef através do Contas a Receber.
2 - Foi desenvolvida esta consulta, para mostrar os detalhes das transações consultas através do Contas a Receber.
3 - Mais detalhes das transações associadas ao título selecionado.
Conciliação dos títulos com os créditos importados
1 - Desenvolvido novo programa VARMSTEF para consultar e baixar os títulos a receber. Os ajustes a pagar geram títulos a pagar, através da função F5-Ajustes a Pagar do programa VARMSTEF. As cores indicam crédito recebido abaixo ou acima do esperado, essas cores são parametrizadas através do botão abaixo.
2 - Os ajustes a pagar são processados nesta tela e devem ser feitos antes de baixar os créditos.
3 - O processamento de ajustes a pagar gera títulos no contas a pagar.
4 - Os títulos a receber baixados, através da conciliação de cartões, recebe a descrição do documento 'Conc. Cartões'.
Relatórios
1 - Relatório de títulos baixados via conciliação de cartões:
2 - Relatório para mostrar os créditos não conciliados:
3 - Relatório para mostrar as vendas importadas e não conciliadas
CONFIGURAÇÃO DE MENUS
Menu | Administrativo e Financeiro |
Submenu | Contas a Receber |
Nome da Rotina | Conciliação de cartões |
Programa | VARMSTEF |
Menu | Administrativo e Financeiro |
Submenu | Tesouraria |
Nome da Rotina | Importações Conciliação de cartões |
Programa | VGTINTEF |
Menu | Administrativo e Financeiro |
Submenu | Tesouraria |
Nome da Rotina | Painel de controle |
Programa | VGTUPAIN |
Menu | Administrativo e Financeiro |
Submenu | Tesouraria |
Nome da Rotina | Saída do cofre |
Programa | VGTUMCOF |
Menu | Administrativo e Financeiro |
Submenu | Contas a Receber |
Nome da Rotina | Manutenção de títulos |
Programa | VARMONLI |
Layout base utilizado, layout 3.6 detalhado:
Instalação do Webservices para importação dos arquivos
Para instalar o sistema de integração de arquivos para a Conciliação, é necessário configurar o webservice no IIS, configurar o sistema de importação dos arquivos (console), bem como agendar diariamente para executar o console.
Procedimentos para Configuração
1- Após receber o pacote de atualização do webservice, adicioná-lo à pasta C:\inetpub\wwwroot.
2 - No arquivo C:\inetpub\wwwroot\ConciliacaoCartoes\Web.config, alterar os parâmetros em destaque com as informações do banco (nome do banco, usuário e senha).
3 - Entrar no IIS Manager (executar “inetmgr”).
4 - Clicar com o botão direito em “Pools de Aplicativos” e clicar na opção
5 - Preencher o campo “Nome” com PoolConciliacao, marcar a versão do .NET framework para a 4.0 e clicar OK.
6 - Clicar com o botão direito na pasta “ConciliacaoCartoes” e clicar na opção “Converter para Aplicativo”.
7 - Clicar no botão “Selecionar...”
8 - Selecionar o Pool “PoolConciliacao” e apertar OK e, na tela abaixo, apertar OK.
9 - Se o servidor onde está instalado o webservice for 64-bits, em “Configurações Avançadas”, marcar a opção de habilitar a integração com aplicações 32-bits.
10- Informar os layouts utilizados e demais configurações:
A tela abaixo disponibiliza as configurações e permite fazer a importação manual, neste caso a importação automática deverá estar desativa no gerenciador de serviços do windows
Desativando a importação automática, caso este não esteja instalado deverá executar o Setup.exe:
Importação automática desativada:
Definição dos layouts utilizados, ativação de log e intervalo de tempo para execução:
O processo grava as seguintes informações no arquivo de configuração:
Compilar a package PC_RMS_CTB_CONCILIACAO no banco de dados do RMS-Retail.
Requisitos mínimos para importação de arquivos para a Conciliação de Cartões:
- Sistema Operacional Windows Server 2008, Windows 7 Profissional ou superior;
- Usuário logado para instalação deve ser administrador da máquina;
- .NET Framework 4.5
- ODAC 12c Release 4 and Oracle Developer Tools for Visual Studio (12.1.0.2.4) instalado (INF001_Guia_Instalação_Oracle_ODAC_ASP_NET) e configurado para acessar o banco de dados do cliente;
- Webservice da Conciliação de Cartões;
- SOAPUI Opensource instalado (para efeitos de testes de importação de dados).
Atenção:
A máquina não deve conter o sistema RMS instalado na mesma, assim como não deve conter outras instâncias do oracle client instalado, caso exista, favor efetuar a desinstalação antes de prosseguir.
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Return aCab