Recepção Bancária Automática via Schedule CNAB -- 116839

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

TDGQU8

Aplicabilidade

Recepção Bancária Automática via Schedule (CNAB)

Produtos

Microsiga 11

Módulos

SIGAFIN

Países

Brasil

Traduções

Espanhol
Inglês

Sistema Operacional

todos

Bancos de Dados

todos

Nome + Fonte

Retorno a Receber (FINA205) e Retorno a Pagar (FINA435)

Ajustes no Compatibilizador

Sim

Integridade Referencial

Não

Aplicação de Patch

Não

Compatibilizador 1

- 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 \PROTHEUS11_DATA\DATA e dos dicionários de dados "SXs" diretório PROTHEUS11_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 17/01/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 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

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
Rotinas Envolvidas	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
Sistemas Operacionais	Windows/Linux

Árvore de páginas

Recepção Bancária Automática via Schedule CNAB -- 116839