Vínculo entre tipos de documentos e títulos a pagar

Vínculo entre tipos de documentos e títulos a pagar Produto : Microsiga Protheus Financeiro versão 10 Chamado : SDBR39 Data da publicação : 25/03/13 País(es) : Todos Banco(s) de Dados : Todos homologados Esta melhoria depende de execução do update de base nome do U_UPDFIN, conforme Procedimentos para Implementação. Implementada melhoria com o vínculo entre tipos de documentos e títulos a pagar que permite criar um controle de documentos necessários e obrigatórios na liberação do título a pagar para a baixa e suas outras movimentações. Há, também, o envio automático de e-mail, caso um título a pagar seja liberado para baixa ou movimentado sem a apresentação de um documento não obrigatório. Os procedimentos descritos dependem da utilização dos parâmetros MV_CTLIPAG e MV_FINVDOC e, também, dos cadastros realizados no Contas a Pagar (FINA050) e M-Messenger (MATA045), assim como, nas novas rotinas s de documentos (CNTA060) e Amarração entre Documentos e Situações (CNTA062). O objetivo da rotina s de documentos (CNTA060) é efetuar o cadastramento dos tipos de documentos que serão relacionados aos contratos de compra ou de venda existentes na empresa e/ou aos títulos a pagar, como, por exemplo, promissória a pagar, boleto bancário, entre outros. Nestes casos, as informações serão utilizadas pelas rotinas de liberação do título a pagar para a baixa e outras movimentações. Ao cadastrar um tipo de documento é possível informar um código opcional de tipo de documento, já cadastrado, para substituí-lo quando necessário. O objetivo da rotina Amarração entre Documentos e Situações (CNTA062) é efetuar a amarração entre os tipos de documentos, cadastrados através da rotina s de documentos (CNTA060), e as seguintes rotinas do módulo financeiro: liberação de pagamentos (FINA580), baixa a pagar manual (FINA080), baixa a pagar automática (FINA090/FINA091), baixa a pagar em lote (FINA080), cheques a pagar sobre títulos (FINA390), borderô de pagamentos (FINA240/FINA241/FINA590) e compensações - de títulos a pagar (FINA340) e entre carteiras (FINA450). As amarrações funcionam como validação dos títulos manipulados pelas rotinas, verificando se há a necessidade da apresentação de documentos obrigatórios e se os mesmos foram apresentados, além do envio automático de e-mail na liberação para baixa ou outras movimentações do título a pagar. Nas rotinas Faturas a pagar (FINA290) e Liquidação (FINA565), os títulos gerados recebem o vínculo entre os tipos de documentos dos títulos a pagar originais. SIGAFIN Vinculo entre tipos de documentos a pagar 1

PROCEDIMENTOS PARA IMPLEMENTAÇÃO Para viabilizar essa melhoria, é necessário aplicar o pacote de atualizações (Patch) deste chamado. Antes de executar o update/compatibilizador U_UPDFIN é imprescindível: a) izar o backup da base de dados do produto que será executado o U_UPDFIN diretório \PROTHEUS_DATA\DATA e dos dicionários de dados SXs diretório \PROTHEUS_DATA\SYSTEM Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa. b) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema. c) 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. d) 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 estará(rã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 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 2 SIGAFIN Vinculo entre tipos de documentos a pagar

ativação. Contate o Desk Framework EM CASO DE DÚVIDAS! 1. 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 21/03/2013. 2. Clique em Ok para continuar. 3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado. 4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo. 5. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos, conforme mensagem explicativa apresentada na tela. 6. 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 update/compatibilizador cria os campos que ainda não existem no dicionário de dados. 7. Clique em Gravar para salvar o histórico (log) apresentado. 8. Clique em Ok para encerrar o processamento. PROCEDIMENTOS PARA UTILIZAÇÃO M-messenger 1. No Financeiro (SIGAFIN) acesse Atualizações / Cadastros / M-messenger (MATA045). O sistema apresenta a janela de usuários M-Messenger. 2. Clique em Incluir. 3. Selecione o usuário que deve receber os e-mails das rotinas de liberação para baixa e outras movimentações do título a pagar. Clique em Ok. 4. Preencha os dados conforme orientações do help de campo e, considere, principalmente: Cod.Evento (AN_EVENTO): código do evento para o envio de e-mail. Informe o código 048. 5. Confira os dados e confirme. SIGAFIN Vinculo entre tipos de documentos a pagar 3

s de documentos 1. No Financeiro (SIGAFIN) acesse Atualizações / Cadastros / s de documento (CNTA060). O sistema apresenta a janela s de Documentos. 2. Clique em Incluir. 3. Preencha os dados conforme orientações do help de campo e considere principalmente: Descr. (_DESCRI): descrição do tipo de documento.impede FIN (_IMPFIN): impede eventos do módulo financeiro? Seu preenchimento apresenta as seguintes condições: MV_CTLIPAG preenchido com T (verdadeiro) e MV_FINVDOC com 1 () A apresentação do tipo de documento é obrigatória para a rotina Liberação para Baixa (FINA580) e nas demais cadastradas em Amarrações entre documentos e Situações (CNTA062). A apresentação do tipo de documento não é obrigatória para a rotina de Liberação para Baixa (FINA580) e nas demais cadastradas em Amarrações entre documentos e Situações (CNTA062), entretanto, uma mensagem é exibida. MV_CTLIPAG preenchido com F (falso) e MV_FINVDOC com 1 () A apresentação do tipo de documento é obrigatória para as rotinas cadastradas em Amarrações entre documentos e Situações (CNTA062), exceto para a Liberação para baixa (FINA580). A apresentação do tipo de documento não é obrigatória para as rotinas cadastradas em Amarrações entre documentos e Situações (CNTA062), exceto para a Liberação para Baixa (FINA580), entretanto, uma mensagem é exibida. Pertence ao (_MODULO): módulo em que o tipo de documento pertence. Envia Email (_EMAIL): envia e-mail? Ao informar e o campo Impede FIN (_IMPFIN) seja, o usuário cadastrado em M-messenger (MATA045) com o código de evento 048 recebe um e-mail a cada execução da rotina cadastrada em Amarrações entre documentos e Situações (CNTA062) e para cada título a pagar em questão, desde que o tipo de documento não tenha sido apresentado. A mensagem e conteúdo do e-mail podem ser alterados através do ponto de entrada MMENS048. Cod.Opcional (_CODOPC): código do tipo de documento opcional, que substitui o principal, caso ele não tenha sido vinculado e/ou apresentado para o título a pagar. 4. Confira os dados e confirme. Amarrações entre documentos e Situações 1. No Financeiro (SIGAFIN) acesse Atualizações / Cadastros / Amarr.docs X Situa (CNTA062). O sistema apresenta a janela Amarrações entre documentos e Situações. 2. Clique em Incluir. 3. Preencha os dados conforme orientações do help de campo e, considere, principalmente: 4 SIGAFIN Vinculo entre tipos de documentos a pagar

Cod.Evento (FR9_EVENTO): evento/rotina que faz o controle dos documentos apresentados (obrigatórios ou não) de acordo com o cadastro s de documentos (CNTA060). Cod.Document (FR9_DOCUM): código do tipo de documento que é verificado conforme o cadastro s de Documentos (CNTA060). 4. Confira os dados e confirme. Contas a pagar 1. No Financeiro (SIGAFIN) acesse Atualizações / Cadastros / Contas a pagar (FINA050). O sistema apresenta a janela de títulos a pagar. 2. Clique em Incluir. 3. Informe os dados conforme orientação do help de campo e, considere, principalmente: Possui Docs (E2_TEMDOCS): possui tipos de documentos vinculados? Se este campo apresentar a opção SIM, é exibida a janela para a marcação dos tipos de documentos vinculados ao título a pagar. 4. Confira os dados e confirme. Apresentação de documentos 1. Na janela principal do Contas a pagar (FINA050), posicione o cursor no título desejado e clique em Documentos. 2. É exibida a janela de documentos vinculados ao título a pagar. 3. No campo Recebido (FRD_RECEB) altere o conteúdo de 2= para 1= a fim de realizar a apresentação do documento. 4. Confira os dados e confirme. Localização vínculo e visualização de arquivos 1. Na janela principal do Contas a pagar (FINA050), posicione o cursor no título desejado e clique em Conhecimento. 2. É exibida a janela de documentos anexados ao título a pagar. 3. Clique em Wizard. 4. É exibido o assistente de localização, vinculo e visualização de arquivos. 5. ize os procedimentos necessários para anexar o arquivo desejado. 6. Confira os dados e confirme. ATUALIZAÇÕES DO UPDATE/COMPATIBILIZADOR 1. Criação ou Alteração no arquivo SX3 - s: SIGAFIN Vinculo entre tipos de documentos a pagar 5

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso. Tabela de documento: _IMPGCT Tamanho 1 Lista Opções Inic, Padrão Impede GCT Impede eventos contratos 1=;2= '2' Pertence("1 2 ") Impede eventos de gestao de contratos _IMPFIN Tamanho 1 Impede FIN Impede eventos financeiro Lista Opções 1=;2= Inic. Padrão '2' Pertence("1 2 ") Impede eventos do financeiro 6 SIGAFIN Vinculo entre tipos de documentos a pagar

_MODULO Tamanho 3 Pertence ao Pertence ao Modulo Lista Opções GCT=Gestao Contratos;FIN=Financeiro;AMB=Ambos Inic. Padrão "GCT" Pertence("GCT FIN AMB ") Informe o modulo que este pertence. _EMAIL Tamanho 1 Lista Opções Inic. Padrão Envia Email Envia Email ao Gestor 1=;2=Nao '2' Pertence("12") Envia email ao usuario cadastrado na rotina M-messenger com o código do evento 048 (apenas modulo Financeiro) _SEQ SIGAFIN Vinculo entre tipos de documentos a pagar 7

Tamanho 2 Visualizar Sequencia Sequencia Docto. Sequência de Cadastro do Documento _CODOPC Tamanho 3 Cod.Opcional Codigo Doc. Opcional Cons. Padrão ExistCpo("") Código do Documento Opcional _DESOPC Tamanho 30 Virtual Visualizar Desc.Opciona Doc.opcional Inic. Padrão IF(EMPTY(M->_CODOPC), "", POSICIONE("", 1, XFILIAL("") + M->_CODOPC + 8 SIGAFIN Vinculo entre tipos de documentos a pagar

"00","_DESCRI")) do documento opcional Tabela FR9 Regras de documento por evento: FR9_FILIAL Tamanho 2 Visualizar Filial Filial do Sistema Informe a filial FR9_EVENTO Tamanho 2 Cod.Evento Código do Evento Lista Opções 01=Liberacao p/baixa;02=baixa Manual;03=Baixa Automatica;04=Baixa Lote;05=Cheq.s/Tit;06=Bordero;07=Compensacao Modo Edição Inclui Pertence("01 02 03 04 05 06 07 ").AND. ExistChav("FR9", M->FR9_EVENTO + M->FR9_DOCUM) Indique o evento para o documento SIGAFIN Vinculo entre tipos de documentos a pagar 9

FR9_DOCUM Tamanho 3 Cod.Document Código do Documento Cons. Padrão ExistCpo("").AND. ExistChav("FR9", M->FR9_EVENTO + M->FR9_DOCUM) Informe o codigo do documento FR9_DESCRI Tamanho 30 Virtual Visualizar do Documento Inic. POSICIONE("",1,XFILIAL("")+FR9->FR9_DOCUM+"00","_DESCRI") IF(INCLUI,"",POSICIONE("",1,XFILIAL("")+M->FR9_DOCUM+"00","_DESCRI")) do documento Tabela FRD Checklist de doc.financeiro: FRD_FILIAL 10 SIGAFIN Vinculo entre tipos de documentos a pagar

Tamanho 2 Visualizar Filial Filial do Sistema Filial do Sistema FRD_PREFIX Tamanho 3 Prefixo Prefixo do Informe o prefixo do titulo FRD_NUM Tamanho 9 No. Número do Informe o número do titulo no financeiro SIGAFIN Vinculo entre tipos de documentos a pagar 11

FRD_PARCEL Tamanho 1 Parcela Parcela do Titulo Parcela do titulo no financeiro FRD_TIPO Tamanho 3 do Informe o tipo do titulo no financeiro FRD_FORNEC Tamanho 6 Fornecedor Código do Fornecedor 12 SIGAFIN Vinculo entre tipos de documentos a pagar

Código do fornecedor do titulo FRD_LOJA Tamanho 2 Loja Loja do Fornecedor Informe a loja do fornecedor utilizado no título FRD_DOCUM Tamanho 3 Cod.Document Código do Document Cons. Padrão ExistCpo("") Selecione o documento a ser associado. FRD_DESCRI Tamanho 30 SIGAFIN Vinculo entre tipos de documentos a pagar 13

Inic. Padrão Inic. Virtual Visualizar do Documento IF(INCLUI,"",POSICIONE("",1,XFILIAL("")+FRD->FRD_DOCUM+"00","_DESCRI")) POSICIONE("",1,XFILIAL("")+FRD->FRD_DOCUM+"00","_DESCRI") do documento. FRD_RECEB Tamanho 1 Recebido Recebido Lista Opções 1=;2= Inic. Padrão '2' Pertence("1 2 ") Indica se o documento foi recebido ou não Tabela SE2 Contas a pagar: E2_TEMDOCS Tamanho 1 14 SIGAFIN Vinculo entre tipos de documentos a pagar

Possui Docs Possui documentos Lista Opções 1=;2=Nao Inic. Padrão "2" Pertence("1 2 ") Informe se o título possui documentos vinculados. Tabela SF4 s de Entradas e Saídas F4_TEMDOCS Tamanho 1 Lista Opções Inic. Padrão Modo Edição Possui Docs Possui documentos 1=;2=Nao '2' M->F4_DUPLIC == "S" Pertence("1/2") Informe 1- caso títulos financeiros gerados a partir de nota que possua esta TES, necessitem atrelar documentos 2. Criação de tabela no arquivo SX2 Tabelas: SIGAFIN Vinculo entre tipos de documentos a pagar 15

O compartilhamento das tabelas abaixo seguirão o padrão da tabela de Contas a Pagar (SE2), podendo variar de acordo com o configurado no ambiente do cliente. Chave Nome Modo Empresa Modo Unidade Modo Filial Pyme FR9 REGRAS DE DOCUMENTO POR EVENTO E E E Chave Nome Modo Empresa Modo Unidade Modo Filial Pyme FRD CHECKLIST DE DOC.FINANCEIRO E E E 3. Criação de Consulta Padrão no arquivo SXB Consulta Padrão: Pesquisa : Alias 1- Consulta Sequência 01 Coluna DB de Documento Contêm Alias 2- Ordens Sequência 01 Coluna 01 Código Alias 3- Cad. Novo Sequência 01 Coluna 01 Cadastra Novo Contêm 01 Alias Sequência 01 4- Colunas 16 SIGAFIN Vinculo entre tipos de documentos a pagar

Coluna 01 Contêm Código _CODIGO Alias 4- Colunas Sequência 01 Coluna 02 Contêm _DESCRI Alias 5- Retorno Sequência 01 Contêm ->_CODIGO Alias 6- Filtro Sequência 01 Contêm ->_SEQ== 00 4. Criação ou Alteração de Índices no arquivo SIX Índices: Tabela : Índice Ordem 3 Chave _FILIAL + _CODOPC Cod.Opcional Índice Ordem 4 Chave _FILIAL + _CODIGO + _SEQ Código + Sequencia Tabela FR9: Índice FR9 Ordem 1 SIGAFIN Vinculo entre tipos de documentos a pagar 17

Chave FR9_FILIAL + FR9_EVENTO + FR9_DOCUM Cod.Evento + Cod.Document Índice FR9 Ordem 2 Chave FR9_FILIAL + FR9_DOCUM + FR9_EVENTO Cod.Document + Cod.Evento Tabela FRD: Índice FRD Ordem 1 Chave FRD_FILIAL + FRD_PREFIX + FRD_NUM + FRD_PARCEL + FRD_TIPO + FRD_FORNEC + FRD_LOJA + FRD_DOCUM Prefixo + No. Titulo + Parcela + + Fornecedor + Loja + Cod.docume Índice FRD Ordem 2 Chave FRD_FILIAL + FRD_DOCUM Cod.document 5. Criação de Gatilhos no arquivo SX7 Gatilhos: Tabela de documento: _CODOPC Sequência 001 Cnt. Domínio _DESOPC Primário Regra ->_DESCRI Posiciona Alias Ordem 4 Chave XFILIAL("")+M->_CODOPC+"00" Tabela FR9 Regras de documento por evento FR9_DOCUM Sequência 001 Cnt. Domínio FR9_DESCRI 18 SIGAFIN Vinculo entre tipos de documentos a pagar

Primário Regra ->_DESCRI Posiciona Alias Ordem 4 Chave XFILIAL("")+M->FR9_DOCUM+"00" Tabela FRD Checklist de doc.financeiro: FRD_DOCUM Sequência 001 Cnt. Domínio FRD_DESCRI Primário Regra ->_DESCRI Posiciona Alias Ordem 4 Chave XFILIAL("")+M->FRD_DOCUM+"00" 6. Criação no arquivo SX6 Parâmetros: Nome Var. MV_FINVDOC e Ativa o controle de documentos obrigatórios nas Cont.Descric. rotinas de liberação para baixa / movimentação Cont.Descric. dos títulos a pagar? (1 = / 2 = ) Valor padrão 2 PROCEDIMENTOS PARA CONFIGURAÇÃO 1. No Configurador (SIGACFG) acesse Ambientes / Cadastro / Menu (CFGX013). Informe a nova opção de menu do Financeiro, conforme instruções a seguir: Menu Submenu Nome da rotina Programa Módulo Atualizações Cadastros s de documento CNTA060 Financeiro Função Protheus SIGAFIN Vinculo entre tipos de documentos a pagar 19

Tabelas de Documento FR9 Regras de documento por evento FRD Checklist de doc.financeiro Menu Submenu Nome da rotina Programa Módulo Tabelas Atualizações Cadastros Amarr.docs X Situa CNTA062 Financeiro Função Protheus de Documento FR9 Regras de documento por evento FRD Checklist de doc.financeiro INFORMAÇÕES TÉCNICAS Tabelas Utilizadas Funções Envolvidas Sistemas Operacionais de Documento FR9 Regras de documento por evento FRD Checklist de doc.financeiro SE2 Contas a pagar CNTA060 - Manutenção de s de Documentos; CNTA62 - Manutenção de Amarração Documentos x Situação; CNTA100 - Manutenção de Contratos; FINA050 - Contas a Pagar; FINA080 - Baixa de s a Pagar; FINA090 - Baixa Automática de s a Pagar; FINA091 - Baixa Automática de s a Pagar; FINA240 - Borderô de Pagamentos; FINA241 - Borderô de Pagamentos; FINA290 - Seleção de s para Fatura; FINA340 - Compensação entre títulos e adiantamentos; FINA390 - Cheques S/s; FINA450 Compensação entre Carteiras; FINA565 Liquidação CP; FINA580 - Liberação dos s a Pagar; FINA590 - Manutenção de Borderô Windows /Linux 20 SIGAFIN Vinculo entre tipos de documentos a pagar