Boletim Técnico: Recepção Bancária Automática via Schedule (CNAB)
Ocorrência
Melhoria
Resumo
Implementada melhoria nas rotinas Retorno a Receber (FINA205) e Retorno a Pagar (FINA435) para a automação dos arquivos a serem recebidos/pagos e processados no Módulo Financeiro (SIGAFIN). Essa funcionalidade é configurada e determinada pelo usuário através de agendamento no Schedule (CFGA010).As caracterísiticas da recepção de arquivos serão mantidas, preservando o funcionamento das rotinas Retorno de Cobrança (FINA200), Retorno de Pagamentos (FINA430) e Relátorio de Retorno CNAB (FINR650). Para o funcionamento da melhoria é necessário alterar os campos criados na tabela de parâmetros de bancos (SEE).
ID do Chamado
SDBYXQ
Produtos
Microsiga 10
Módulos
- SIGAFIN
Portais
- nenhum
Países
- Brasil
Sistema Operacional
todos
Bancos de Dados
- todos
Nome + Fonte
FINA200 – Retorno de Cobrança;FINA205 – Retorno a Receber; FINA430 – Retorno de Pagamento; FINA435 – Retorno a Pagar ; FINR650 - Impressão do Retorno da Comunicação Bancária; CFGA010 – Schedule
Ajustes no Compatibilizador
Sim
Integridade Referencial
Não
Aplicação de Patch
Compatibilizador 1
- U_UPDFIN
Procedimentos para Implementação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) desta FNC.
Antes de executar o compatibilizador U_UPDFIN é imprescindível:
a) Realizar o backup da base de dados do produto que será executado o compatibilizador diretório \PROTHEUS_DATA\DATA e dos dicionários de dados "SXs" diretório PROTHEUS_DATA_SYSTEM.
b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
d) 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.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.
|
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:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A). ii. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções. iii. Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou; iv. Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação). v. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D). vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções. vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.
Contate o Help Desk Framework EM CASO DE DÚVIDAS!
|
Em Microsiga Protheus TOTVS Smart Client, digite U_UPDFIN no campo Programa Inicial.
Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 07/11/2011.
1. Clique em OK para continuar.
2. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
3. Clique em Sim para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
4. É apresentada uma mensagem explicativa na tela.
5. 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.
6. Clique em Gravar para salvar o histórico (log) apresentado.
7. Clique em OK para encerrar o processamento.
Descrição de Ajustes
1. Criação ou Alteração no arquivo SX3 – Campos:
· Tabela SEE - Parâmetros de Bancos:
Todos os campos previamente existentes serão alterados para Cadastrais e os novos campos serão incluídos em Retorno Automático.
| Campo | EE_RETAUT |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Ret. Automat? |
| Descrição | Retorno Automático? |
| Nível | Real |
| Usado | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Inic. Padrão | 0 |
| Box | 0=Não; 1=Recebimento; 2= Pagamento; 3= Ambos |
| Help | Permite configurar o retorno Automático através de Schedule |
| Campo | EE_AGCLTB |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Aglut.Lcto? |
| Descrição | Aglutina Lanc. Contab? |
| Nível | Real |
| Usado | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Inic. Padrão | 0 |
| Box | 0=Não; 1=Recebimento; 2= Pagamento; 3= Ambos |
| Help | Permite configurar a aglutinação de lançamento contábeis |
| Campo | EE_ATUMOE |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Atual. Moeda? |
| Descrição | Atualiza Moeda Por? |
| Nível | Real |
| Usado | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Inic. Padrão | 0 |
| Box | 1=Vencimento;2=Emissão;3=Lançamento |
| Help | Permite configurar a atualização de moedas |
| Campo | EE_DIRPAG |
| Tipo | C - Caracter |
| Tamanho | 50 |
| Decimal | 0 |
| Formato | @! |
| Título | Dir.Imp.Pag. |
| Descrição | Dir. Import. Pagamento |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Help | Deve ser informado o diretório de importação de pagamento |
| Campo | EE_DIRREC |
| Tipo | C - Caracter |
| Tamanho | 50 |
| Decimal | 0 |
| Formato | @! |
| Título | Dir.Imp.Rec. |
| Descrição | Dir. Import. Recebimento |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Help | Deve ser informado o diretório de importação de recebimento |
| Campo | EE_CFGPAG |
| Tipo | C - Caracter |
| Tamanho | 12 |
| Decimal | 0 |
| Formato | @! |
| Título | Arq.Cfg.Pag. |
| Descrição | Arq. Configuração Pagto |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Help | Nome do arquivo de configuração de Pagamento |
| Campo | EE_CFGREC |
| Tipo | C - Caracter |
| Tamanho | 12 |
| Decimal | 0 |
| Formato | @! |
| Título | Arq.Cfg.Rec. |
| Descrição | Arq. Configuração Recto |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Help | Nome do arquivo de configuração de Recebimento |
| Campo | EE_BKPPAG |
| Tipo | C - Caracter |
| Tamanho | 50 |
| Decimal | 0 |
| Formato | @! |
| Título | Dir.Bkp.Pag. |
| Descrição | Dir. Backup Arq. Pagamento |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Help | Diretório de backup dos arquivos de Pagamento |
| Campo | EE_BKPREC |
| Tipo | C - Caracter |
| Tamanho | 50 |
| Decimal | 0 |
| Formato | @! |
| Título | Dir.Bkp.Rec. |
| Descrição | Dir. Backup Arq. Receb. |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Help | Diretório de backup dos arquivos de Recebimento |
| Campo | EE_DESCOM |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Desc.Comis.? |
| Descrição | Abate Desc. Comissão? |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Sim;2=Não |
| Help | Permite configurar se abate desconto da comissão |
| Campo | EE_CNABPG |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | CNAB Pagto? |
| Descrição | Config. Modelo CNAB Pagto |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Modelo 1;2=Modelo 2 |
| Help | Permite selecionar a configuração de CNAB de Pagamento |
| Campo | EE_CNABRC |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | CNAB Receb.? |
| Descrição | Config. Modelo CNAB Recto |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Modelo 1;2=Modelo 2 |
| Help | Permite selecionar a configuração de CNAB de Recebimento |
| Campo | EE_PROCFL |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Proc Filial? |
| Descrição | Proc. Filial logada/todas |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Filial Atual;2=Todas Filiais |
| Help | Permite processar apenas a filial logada ou todas as filiais |
| Campo | EE_MULTNT |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Multip. Nat? |
| Descrição | Considera Multipla Nat? |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Sim;2=Não |
| Help | Define se serão consideradas múltiplas naturezas |
| Campo | EE_CTBTRF |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Ctb.Transf.? |
| Descrição | Contabiliza Transf.Banc.? |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Sim;2=Não |
| Help | Permite selecionar se contabiliza transferência bancária |
| Campo | EE_RETBCO |
| Tipo | C - Caracter |
| Tamanho | 1 |
| Decimal | 0 |
| Formato | @! |
| Título | Ret.Bancar.? |
| Descrição | Considera Ret. Bancaria? |
| Contexto | Real |
| Propriedade | Alterar |
| Obrigatório | Não |
| Browse | Não |
| Usado | Sim |
| Pasta | 2- Retorno Automático |
| Box | 1=Sim;2=Não |
| Help | Configurar se considera a retenção bancária |
2. Criação ou Alteração no arquivo SX6 – Parâmetros:
| Nome da Variável | MV_RETMAIL |
| Tipo | Caracter |
| Descrição | Email dos destinatarios do log de erro do recebimento bancario automático. Separar os destinatarios com ponto-e-virgula |
O parâmetro MV_RETMAIL pode ser configurado com um ou mais endereços de e-mail, separados por ponto e vírgula. Para que o processamento envie um e-mail contendo eventuais inconsistências com o resumo dos títulos como anexo. Caso o parâmetro não estiver corretamente preenchido ou estiver em branco, nenhum e-mail ou resumo será enviado ou gravado.
Procedimentos para Configuração
Procedimentos para Utilização
1. No Financeiro (SIGAFIN) acesse Atualizações/Cadastro/Parâmetros Bancos (FINA130).
2. Selecione o banco desejado e clique em Alterar para configurar a Recepção Automática.
3. Clique em Retorno Automático.
4. Preencha todos os campos conforme desejado e Confirme.
· No campo Ret.Automat se preenchido com Não ou estiver em branco, neste banco não ocorrerá o processamento automático.
· No campo Ret.Automat se preenchido com Recebimento ou Ambos, os campos Aglut. Lcto, Atual. Moeda, Dir. Imp. Rec., Arq. Cfg. Rec., Dir.Bkp.Rec, Desc.Comis, CNAB Receb e Proc.Filial devem ser preenchidos obrigatoriamente.
· No campo Ret.Automat se preenchido com Pagamento ou Ambos, os campos Aglut. Lcto, Dir. Imp. Pag., Arq. Cfg. Pag., Dir. Bkp. Pag, CNAB Pagto, Proc. Filial, Multip. Nat, Ctb. Transf e Ret. Bancar. devem ser preenchidos obrigatoriamente.
· Os campos não incluídos no dicionário como obrigatórios, devem ser preenchidos conforme especificado acima. Caso quaisquer dos campos necessários não esteja devidamente preenchido, não ocorre o processo automático.
· Cada arquivo processado será transferido para o diretório de backup. Os arquivos contidos no diretório informado no campo Dir. Imp. Rec serão transferidos para o diretório contido no campo Dir.Bkp.Rec e os arquivos contidos no diretório informado no campo Dir. Imp. Pag serão transferidos para o diretório contido no campo Dir.Bkp.Pag.
· Os arquivos de configuração devem estar na pasta padrão do CNAB e os arquivos de retorno devem estar nos respectivos diretórios informados nos campos Dir. Imp. Pag. e Dir. Imp. Rec. Serão processados todos os arquivos contidos nestes diretórios que tiverem a extensão definica pelo campo EE_EXTEN.
Para configurar o Schedule
Certifique-se que o Schedule está devidamente configurado no servidor. É recomendado ter um ambiente exclusivo para a execução.
O Schedule deve estar devidamente configurado para que o processo funcione de forma automática. Abaixo um exemplo de configuração de Schedule no arquivo INI do Server:
[ONSTART]
JOBS=NOMEJOB (Nome do Job)
refreshrate=120 (Tempo de reinicialização do Job)
[NOMEJOB] (Nome do Job – deve ser igual ao usado em ONSTART)
Main=SCHEDJOB
Environment=AMBIENTE (Ambiente que será utilizado para a execução do JOB)
nParms=2
Parm1=01
Parm2=01
Certifique-se que o Schedule está devidamente configurado no servidor. É recomendado ter um ambiente exclusivo para a execução.
1. No Configurador (SIGACFG) acesse Ambientes / Schedule (CFGA010)
2. Selecione Processos Especiais na opção Diário e clque em Incluir.
3. Informe os campos Código, Nome e Descrição, para a criação do agendamento de Retorno Bancário Automático em Retorno a Receber (FINA205) e Retorno a Pagar (FINA435).
4. Informe a Frequência, as Datas de Ínicio/Final, o Intervalo entre as execuções.
5. No campo Ação informe a Rotina e a empresa/filial que o processo deve ser executado.
6. Informe o Ambiente que deve ser executado.
7. Confira os dados e Confirme.
8. É apresentado o browse com as opções dos agendamentos.
9. Clique duas vezes sobre cada agendamento para ativá-los.
É possível enviar um e-mail contendo as eventuais inconsistência e resumos dos processamentos, para isto o parâmetro MV_RETMAIL deve ser configurado com um ou mais e-mails válidos.
Para isto os parâmetros de configuração de e-mail padrão do Protheus MV_RELACNT, MV_RELAPSW, MV_RELAUSR, MV_RELAUTH, MV_RELFROM, MV_RELPSW, MV_RELSERV, MV_RELSSL e MV_RELT devem estar devidamente configurados para que o envio de e-mail funcione adequadamente.
Informações Técnicas
| Tabelas Utilizadas | SEE – Parâmetros de Bancos |
Observações
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas