Integração Financeiro CMNET x SIGAGPE
Linha de Produto: |
Microsiga Protheus® |
||||||||
Segmento: |
Recursos Humanos |
||||||||
Módulo: |
SIGAGPE |
||||||||
Rotina: |
|
||||||||
Cadastros Iniciais: |
GPEA010 - Cadastro de Funcionários GPEA040 - Cadastro de Verbas GPEA320 - Manutenção de Tabelas GPEM640 - Definições de Títulos GPEM650 - Geração de Títulos GPEM660 - Manutenção de Títulos GPEM670 - Integração com o Financeiro |
||||||||
Parâmetro(s): |
MV_ERPCM |
||||||||
Requisito/Story/Issue (informe o requisito relacionado): |
|||||||||
Tabelas Utilizadas: |
SRA - Cadastro de Funcionários SRC - Movimento Mensal SRV - Cadastro de Verbas RC0 - Definições de Títulos RC1 - Movimentação de Títulos RCC - Parâmetros |
||||||||
Pacote: | 12.1.16: https://suporte.totvs.com/portal/p/10098/download?e=569394 |
Gerar arquivo CSV (separado por vírgulas) com lançamentos de títulos financeiros do GPE a fim de serem importados pela rotina de Importação de Lançamentos do Contas a Pagar CMNET.
Após realizar a geração de Títulos da Folha de Pagamento no SIGAGPE, possuindo as configurações de integração CMNET ativas, é possível gerar os arquivos dos títulos financeiros para serem importados pelo sistema CMNET.
CONFIGURAÇÃO DE PARÂMETROS
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie o parâmetro a seguir:
Itens/Pastas
Descrição
Nome:
MV_ERPCM
Tipo:
Lógico
Cont. Por.:
.T.
Descrição:
Indica se existe integração com BackOffice CMNET (.T.) ou (.F.) se não existe.
S128 - TIPO DE DOCUMENTO INTEG. CMNET
A tabela S128 foi desenvolvida para gerenciar o cadastro de Tipos de Documento utilizado pelo CMNET para importação dos lançamentos de títulos financeiros.
A tabela possui a seguinte estrutura de campos:
Campo | Características |
---|---|
CODIGO |
|
DESCRICAO |
|
Onde, o campo CÓDIGO deve possuir o mesmo valor do campo CADTIPDOC da tabela TipoDocRecPag presente no CMNET.
A tabela será mantida manualmente, conforme necessidade para integrações financeiras.
Para realizar a geração de títulos financeiros da Folha no Protheus e exportação dos lançamentos em arquivo texto, siga os seguintes passos:
Cadastrar os Tipos de Documentos
- Acesse a rotina Manutenção Tabelas através do menu SigaGPE > Atualizações > Definições de Cálculos > Manutenção Tabelas (GPEA320)
- Posicione na tabela Auxiliar S128 - TIPO DE DOCUMENTO INTEG. CMNET
- Faça o cadastro dos Tipos de documento considerando o Código com 8 dígitos e a respectiva descrição.
- Confira os dados e clique em salvar
Realizar a Integração com o Financeiro
Acesse a rotina através do menu SigaGPE > Miscelânea > Títulos > Integração Financeiro (GPEM670)
Se o parâmetro MV_ERPCM estiver habilitado (.T.) o sistema apresentará a tela: "Integração de Títulos - Protheus GPE x Sistemas Externos"
Nessa tela é possível definir quais títulos poderão ser integrados fornecendo os dados para pesquisa e filtro dos dos títulos existentes. Principais campos:
* Tipo de Documento: Para qual tipo de documento o arquivo será gerado. É obrigatório selecionar um código previamente cadastrado na tabela S128 - Tipo de Documento Integ. CMNET* Naturezas: Quais naturezas devem ser consideradas. É obrigatório selecionar ao menos uma natureza.
* Consolidar por Fornecedor ou Agrupar por Filial
* Consolidar por Fornecedor: Se selecionado, serão gerados em um único documento os títulos que possuem a mesma FILIAL + FORNECEDOR. Ou seja, serão lançamentos de rateio.
* Agrupar por Filial: Se selecionado, serão gerados em um único documento os títulos que possuem a mesma FILIAL+ FORNECEDOR + NATUREZA. Ou seja, serão lançamentos de rateio.
Observação: Se nenhuma opção for selecionada, serão gerados em um único documento os títulos que possuem a mesma FILIAL + FORNECEDOR + NATUREZA + CENTRO DE CUSTOS.
* Destino: Deve ser selecionado o diretório onde o arquivo será gravado. É sempre sugerida a opção C:\
* Data de Pagamento: Corresponde aos campos Data de Vencimento e Data Programada, caso informada. Não é obrigatório informar esse dado, e caso ele esteja em branco, o sistema irá utilizar a informação presente nos campos Data Vencimento e Vencimento Real, respectivamente.
* Competência: Deve ser informado nos parâmetros a competência (Ano e Mês) com o formato AAAAMM. É obrigatório informar esse dado.
Competência: Deve ser informado nos parâmetros a competência (Ano e Mês) com o formato AAAAMM. É obrigatório informar esse dado.
Ao clicar em Executar, o sistema inicia o processamento pesquisando os títulos existentes conforme os parâmetros definidos, e que ainda não foram Integrados com o Financeiro, ou seja, somente títulos com o campo 'Integ Finan" (RC1_INTEGR) com valor 0 (Não liberado).
- Os títulos processados terão os campos Integ Finan" e "Nro.Tit.Ext" atualizados na tabela RC1 com o valor 1 (Liberado), e o com o correspondente número do documento, respectivamente.
- Ao final do processamento o sistema apresentará um LOG com todos os títulos que foram processados.
Configuração para gerar arquivos:
- Exemplo 1:
- Utilizando a opção Agrupar por Filial
- Quando utilizada esta opção, será utilizada a chave FILIAL + FORNECEDOR + NATUREZA.
- Agrupando em um mesmo documento os títulos gerados por Centro de Custo.
- Exemplo 2:
- Utilizando a opção Consolidar por Fornecedor
- Quando utilizada esta opção, será utilizada a chave FILIAL + FORNECEDOR
- Possibilitando o agrupamento , em um mesmo documento, de títulos de Naturezas diferentes porém com mesmo Fornecedor.
- Títulos gerados por Centro de Custo também serão agrupados no mesmo documento junto à Natureza.
- Exemplo 3:
- Utilizando opção padrão (sem selecionar as opções acima)
- Quando utilizada a opção padrão a chave utilizada será FILIAL + FORNECEDOR + NATUREZA + CC.
- Assim, cada título gerado por Centro de Custo será colocado em um documento diferente.
Arquivo de Títulos Financeiros
Para cada filial processada é gerado 1 arquivo de títulos que serão integrados ao Financeiro
O nome do arquivo segue a seguinte estrutura: CAPFOL_D MG 01_2017_05_12_1217.csv
- CAPFOL - indica que o arquivo é de integração dos títulos
- D MG 01 - indica a Filial dos títulos.
- 2017_05_12_1217 - indica a data e a hora que o arquivo foi criado.
- CSV - indica a extenção do arquivo
O arquivo segue o leiaute definido para integração CMNET.
Arquivo de Log de Processamento
Para cada processamento, o sistema questiona se o usuário deseja gerar um LOG com os registros que foram processados.
O arquivo é gerado na pasta SPOOL com o nome: "LOG_INTEG_Titulos_CMNET"
Conteúdo do arquivo:
- Filial
- Código do Fornecedor
- Nome do Fornecedor
- Centro de Custos
- Natureza
- Número do documento
- Valor do Lançamento
- Valor do Rateio
Campo |
Nulo |
Tipo |
Tamanho |
Posição |
Observação |
CMNET x PROTHEUS |
Campo Protheus (enviado no arquivo) |
Contas Caixa x Tipo de Pagamento |
Não |
Numérico |
8 |
1-8 |
Código da tabela PortadorForma, campo CODPORTFORMA, que indica o banco (ou caixa) e a forma de pagamento (dinheiro, cheque, pagto eletrônico, etc.) |
Para a integração Títulos da Folha x CAP, não é utilizado. Pode deixar o campo em branco. |
Espaços |
ID do Fornecedor |
Não |
Numérico |
8 |
9-16 |
Código do Fornecedor, originário da tabela Pessoa da CMNET, campo IDPESSOA. Campo chave para criação do documento no sistema da CMNET, para um mesmo número de documento + complemento do documento + ID do Fornecedor. Os próximos registros serão considerados alteradores, rateio ou parcelas de um mesmo documento. |
Número identificador do registro dentro do CM. Esse código é gerado automaticamente pelo sistema e não pode ser alterado. O código de Fornecedores (A2_COD) no Protheus é do tipo Caractere, tamanho 6. Pode ser alterado para tamanho 8. É necessário alterar a máscara do campo para aceitar apenas algarismos. O cadastro será mantido/atualizado de forma manual. |
RC1_FORNEC |
Sistema de Destino do Lançamento |
Não |
Numérico |
1 |
17-17 |
3 - CAP (Contas a Pagar) |
Para a Folha, sempre será enviado 3 (CAP). |
3 |
Código do Tipo de Documento |
Não |
Numérico |
8 |
18-25 |
Originário da tabela CMNET TipoDocRecPag, campo CADTIPDOC. |
Informação definida no momento da Importação. Opções listadas são provenientes de uma tabela definida pelo usuário no CAP. Exemplos de opções: PESSOAL (FOLHA, RESCISÕES, FÉRIAS); PENSAO ALIMENTICIA; etc. Tabela Auxiliar – S128 – Tipo de Documento Integ. CMNET - campo Código |
Campo Código da Tabela S128 |
Indicação de Pagamento |
Não |
Caractere |
1 |
26-26 |
P - CAP (Contas a Pagar) R - CAR (Contas a Receber) |
Sempre enviado P (CAP). |
P |
Número do Documento |
Não |
Numérico |
15 |
27-41 |
Campo chave para criação do documento no sistema da CMNET, para um mesmo número de documento + complemento do documento + ID do Fornecedor. Os próximos registros serão considerados alteradores, rateio ou parcelas de um mesmo documento. |
Deverá ser gerado um número único para envio ao CAP – sugerido utilizar DATA+HORA da geração do documento. No Protheus será criado no momento de geração do arquivo com o seguinte formato: "00" + AAMMDDHHMMSS + Sequência numérica Exemplo: dois títulos gerados em 01 de Janeiro de 2017 às 13:30 001701011330001 - Número do primeiro título 001701011330002 - Número do segundo título Após executar a integração dos títulos, os registros no Protheus terão os campos RC1_INTEG e RC1_TITEXT atualizados com os valores: 1 (Liberado) e com o Número do Documento, respectivamente. Observação: o campo RC1_TITEXT possui o tamanho padrão de 13 caracteres, e o número do documento gerado para o CMNET possui 15 caracteres. Por esse motivo, no Protheus não serão gravados os dois primeiros zeros à esquerda. |
"00" + AAMMDDHHMMSS + Sequência (ano+mês+dia+hora+min+seg+seq da geração do arquivo) |
Complemento do Documento |
Sim |
Caractere |
3 |
42-44 |
Campo chave para criação do documento no sistema da CMNET, para um mesmo número de documento + complemento do documento + ID do Fornecedor. Os próximos registros serão considerados alteradores, rateio ou parcelas de um mesmo documento. |
Como os títulos do financeiro não são parcelados, o campo sempre será enviado em branco. |
Espaços |
Data de Emissão |
Não |
Data |
10 |
45-54 |
Data de emissão do documento. |
Data de geração do documento (mesma data do Lançamento) |
RC1_EMISSA |
Data de Vencimento |
Não |
Data |
10 |
55-64 |
Data de vencimento do documento. |
Preencher com a data do vencimento original. |
RC1_VENCTO |
Data Programada |
Não |
Data |
10 |
65-74 |
Data programada para pagamento do documento, geralmente a mesma do vencimento. |
Preencher com data de vencimento real. Será alterada no CAP conforme necessidade |
RC1_VENREA |
Operação |
Não |
Caractere |
1 |
75-75 |
Preencher com 2 |
2 |
|
Código do Alterador |
Sim |
Numérico |
8 |
76-83 |
Proveniente da tabela da CMNET TipoAlterador, campo CODALTERADOR. Caso este campo esteja preenchido, o sistema ignora a informação do campo Código do Tipo de Documento. |
Não utilizado pela Folha. Preencher com zeros. |
00000000 |
Data Lançamento |
Não |
Data |
10 |
84-93 |
Data de lançamento da nota no sistema de origem. |
Informação vinda do campo Data de Pagamento da tela de Integração CAP. |
RC1_EMISSA |
Valor do Lançamento |
Não |
Numérico |
17,2 |
94-110 |
Valor original do documento. |
Valor total do lançamento. Obs.: os lançamentos são agrupados por fornecedor/filial e rateados por CC |
Valor total do documento. |
Operação do Lançamento |
Não |
Numérico |
2 |
111-112 |
1 - Caso seja um lançamento de documento a ser parcelado/englobado no futuro, dentro do sistema CMNET. |
No caso da Folha, sempre 02. |
02 |
Código do Desembolso |
Não |
Caractere |
15 |
113-127 |
Originário da tabela da CMNET TipoRecebDesemb, campo CODTIPRECDES |
A tabela é definida pelo usuário no CAP. Depois, na Folha, o Tipo de Desembolso é vinculado a diversas Rubricas. No momento da integração Folha x CAP, as rubricas que estiverem vinculadas ao Tipo de Desembolso selecionado serão consideradas para a formação do valor a ser enviado par ao CAP. Em tela aparece a descrição porém é enviado na verdade o código. Utilizar entidade NATUREZA no Protheus. |
RC1_NATURE |
Indica Pagamento ou Recebimento |
Sim |
Caractere |
1 |
128-128 |
P - Pagamento |
Será sempre enviado P (Pagamento) |
P |
Indicação do Centro de Responsabilidade |
Sim |
Caractere |
10 |
129-138 |
Originário da tabela da CMNET CentroRespon, campo CODCENTRORESPON. |
Não é utilizado pela Folha, e deve ser informado o código padrão (9999999999). |
9999999999 |
Indicação da Atividade/Projeto |
Não |
Numérico |
8 |
139-146 |
Originário da tabela da CMNET UnidNegoc, campo UNIDNEGOC. |
Não utilizado pela Folha. Preenchido sempre com código atividade padrão. Pode enviar em branco que o sistema auto preenche. |
Espaços |
Valor do Rateio |
Não |
Numérico |
17,2 |
147-163 |
Preenchimento obrigatório mesmo que não haja rateio |
Obs.: os lançamentos são agrupados por fornecedor e rateados por CC. |
RC1_VALOR |
Contabiliza |
Sim |
Caractere |
1 |
164-164 |
S - Indique que o lançamento é para contabilizar |
Como a contabilização será feita por rotina específica, preencher sempre N |
N |
Código da Forma de Pagamento OU Tipo de Cobrança |
Sim |
Numérico |
8 |
165-172 |
Campo numérico alinhado à direita que deve conter o código da forma de pagamento (CAP) ou do tipo de cobrança (CAR). Tabela TIPODOCRECPAG. Se estiver preenchido com brancos será ignorado. |
Campo em desuso. Completar com espaços. |
Espaços |
Centro de Custo para baixa |
Sim |
Caractere |
10 |
173-182 |
Campo numérico alinhado à direita que deve conter o código do Centro de Custo a ser utilizado para a baixa. |
Centro de Custo do Funcionário. |
RC1_CC |
Histórico do Lançamento |
Sim |
Caractere |
60 |
183-242 |
Campo alfanumérico. Se não estiver preenchido, utilizará o da tela de importação. |
Definido valor padrão: “Integração Folha Protheus” |
“Integração Folha Protheus” |
Espaços |
8 |
243-250 |
Preenchido com espaços. |
Espaços |
|||
Código Correspondente |
Sim |
Numérico |
30 |
251-280 |
Campo numérico alinhado à direita (complementando com espaços à esquerda até a posição 280, inclusive), que deve conter o código correspondente do fornecedor. Quando você utilizar o código correspondente, preencha as posições do identificador do fornecedor (9 a 16) com zeros, pois é isto que faz o programa usar o código correspondente. |
Não utilizado pela Folha. Completar com espaços |
Espaços |
Texto de olho no imposto |
Sim |
Caractere |
92 |
281-382 |
Campo alfanumérico. Criado para atender a Lei 12.741/2012. Deverá corresponder ao texto a ser impresso na RPS já com o valor calculado do imposto. |
Não utilizado pela Folha. Completar com espaços |
Espaços |