Convergência para os Módulos de Recursos Humanos do Protheus
Produto: | Protheus |
Versões: | 12.1.16 e superiores |
Ambiente: | Todos Módulos de Recursos Humanos |
Neste Upgrade, será contemplado o envio de informações que são compatíveis entre ambos os sistemas e que envolvem cadastros básicos, cadastros que estão relacionados diretamente a funcionários, além de informações que envolvam dados de históricos de pagamentos, onde há um grande volume de informações.
Aqui serão listados os passos necessários para realizar a extração de dados da solução CMNET Hospitality a fim de realizar a importação no Protheus.
Aqui serão listadas as particularidades a respeito da importação de dados provenientes da solução CMNET Hospitality.
Integração Contábil CMNET x SIGAGPE
Linha de Produto: |
Microsiga Protheus® |
||||||||
Segmento: |
Recursos Humanos |
||||||||
Módulo: |
SIGAGPE |
||||||||
Rotina: |
|
||||||||
Cadastros Iniciais: |
SRA - Cadastro de Funcionários SRC - Movimento Mensal SRV - Cadastro de Verbas CT5 - Lançamento Padrão RHQ - Base de Rateio CT1 - Cadastro Plano de Contas CTD - Cadastro Itens Contábeis CTT - Cadastro Centro de Custo |
||||||||
Parâmetro(s): |
MV_RHCONEX MV_ERPCM |
||||||||
Requisito/Story/Issue (informe o requisito relacionado): |
DRHPONTP-25 | ||||||||
Tabelas Utilizadas: |
CT2 - Lançamento Contábil SRZ - Resumo da Folha |
Gerar arquivo texto com lançamentos contábeis do GPE a fim de serem importados pela rotina de Importação de Lançamentos do Contábil CMNET.
Após realizar a Contabilização da Folha/Provisão no SIGAGPE, possuindo as configurações de integração CMNET ativas, é possível gerar os arquivos dos lançamentos contábeis 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 ha integração com BackOffice CMNET.
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o parâmetro a seguir:
Itens/Pastas
Descrição
Nome:
MV_RHCONEX
Tipo:
Lógico
Cont. Por.:
.T.
Descrição:
Indica se a rotina de Fechamento Contábil será processada em Sistema Externo.
Para realizar a contabilização da Folha no Protheus e exportação dos lançamentos em arquivo texto, siga os seguintes passos:
- Acesse a rotina através do menu SigaGPE > Miscelânea > Fechamentos > Contabilização
- Clique em Parâmetros e selecione as opções conforme desejado.
- Confira as informações e clique em OK.
- Uma nova janela será aberta requisitando o período da Folha a ser contabilizado.
- Digite o mês e ano do período e clique em OK.
- Ao retornar à tela inicial da rotina de contabilização, clique em OK.
- O aviso “Confirma configuração dos parâmetros?” será exibido. Confirme.
- Caso o período escolhido para contabilização já tenha sido contabilizado pelo sistema um novo aviso será emitido:
- “Este período já foi contabilizado. Deseja continuar?”
- Confirme ou não o processamento da rotina.
- Aguarde o processamento.
- Uma nova tela será aberta exibindo os valores contabilizados, cada um com seu tipo de operação (débito/crédito).
- Na parte inferior é exibido o saldo de valores.
- Confira os dados e faça alterações conforme necessidade.
- Ao finalizar a conferência, clique em Salvar.
- Os dados serão gravados no sistema.
- Caso haja mais de uma filial selecionada para contabilização, será realizado o processamento destas (repetir os passos 8 a 13).
- Após o processamento de todas filiais selecionadas, uma nova tela será exibida para geração do arquivo texto.
- Escolha o diretório para geração do arquivo.
- Confira as informações e clique em Salvar.
- Ao fim do processamento, um aviso é emitido informando se o arquivo foi gerado com sucesso.
- Será gerado 1 arquivo por filiail + 1 arquivo de Log de processamento.
- Os arquivos serão gravados no diretório indicado.
- Clique em Confirmar.
- Para sair da rotina clique em Cancelar.
- Validação 01: Caso não seja informado o diretório destino do arquivo, é emitido alerta.
- Validação 02: para o correto preenchimento do Tipo de Lançamento. São aceitos apenas os tipos:
- Crédito;
- Débito;
- Partida Dobrada.
- Os tipos são configurados em SigaGPE > Atualizações > Cadastrados > Lançamento Padrão
Arquivo de Lançamentos Contábeis
Para cada filial processada é gerado 1 arquivo de lançamentos contábeis.
O nome do arquivo segue a seguinte estrutura: contabFOL_201702_T1D MG 01_152319
- contabFol - indica que o arquivo é da Contabilização da Folha
- 201702 - indica competência contabilizada (informação é montada a partir da Data da Contabilização)
- T1D MG 01 - indica Grupo Empresa + Filial dos lançamentos contábeis.
- 152319 - indica hora do processamento (Hora+Minuto+Segundo)
O arquivo segue o leiaute definido para integração CMNET.
Arquivo de Log de Processamento
Para cada processamento, é gerado um arquivo Log.
A nomenclatura do arquivo segue a seguinte estrutura: contabFOL_Log_20170412_152319
- contabFOL - indica que o arquivo é da Contabilização da Folha
- Log - indica este é o arquivo de log.
- 20170412 - data do processamento
- 152319 - hora do processamento (Hora+Minuto+Segundo)
Conteúdo do arquivo:
Empresa/Filial: T1/D MG 01 Número do Documento no Protheus: 000008 Valor a Débito: 127497.08 Valor a Crédito: 48477.25 Balanço: Saldo de 79019.83 a Debito. Arquivo(s) gerado(s) com sucesso! --------------------------------------------------
Empresa/Filial: T1/M PR 01 Número do Documento no Protheus: 000002 Valor a Débito: 3000 Valor a Crédito: 240 Balanço: Execução interrompida. Erro na linha: 003(CT2_LINHA) Lançamento Padrão: C01 Mensagem: Tipo de Lançamento Inválido - Configure o lançamento como 1-Debito; 2-Credito; ou 3-Partida Dobrada. --------------------------------------------------
Campo |
Nulo |
Tipo |
Tamanho |
Posição |
Observação/conceito CM |
CMNET x PROTHEUS |
Campo Protheus (enviado no arquivo) |
Data do Lançamento |
Não |
Data |
10 |
01-10 |
Data do lançamento contábil. Formato: dd/mm/aaaa. |
A data que o usuário informa no momento da contabilização - carrega automático a data do sistema, mas pode ser modificada pelo usuário. |
CT2_DATA |
Tipo de Lançamento |
Não |
Num. |
1 |
11-11 |
0 – Débito; |
Identificação do tipo de lançamento. |
CT2_DC |
Tipo de Lançamento |
Não |
Caract. |
1 |
12-12 |
D – Débito; C – Crédito. |
Identificação do tipo de lançamento. |
CT2_DC |
Origem Aplicação |
Sim |
Caract. |
1 |
13-13 |
O – Origem; A – Aplicação. |
Não é mais utilizado pelo CM |
Espaços |
Número do Documento |
Sim |
Caract. |
15 |
14 - 28 |
Campo livre para indicação de um documento. |
É gerado automaticamente pelo sistema (quando contabilizado via RH CM). Para o RH, utiliza o valor da Competência (AAAA/MM) como regra de preenchimento. |
CT2_DATA |
Histórico 1 |
Não |
Caract. |
40 |
29 - 68 |
Preenchimento obrigatório. |
Como forma de identificação do lançamento, será enviada a descrição do Lançamento Padrão. Configurar o campo CT5_HIST com "CT5->CT5_DESC" para preencher automaticamente o campo CT2_HIST. |
CT2_HIST |
Histórico 2 |
Sim |
Caract. |
40 |
69 - 108 |
Descrição do Lançamento. |
Continuação do campo Histórico 1. No caso do RH não será necessária utilização de mais caracteres. |
Espaços |
Histórico 3 |
Sim |
Caract. |
40 |
109-148 |
Descrição do Lançamento. |
||
Histórico 4 |
Sim |
Caract. |
40 |
149-188 |
Descrição do Lançamento. |
||
Histórico 5 |
Sim |
Caract. |
40 |
189-228 |
Descrição do Lançamento. |
||
Centro de Custo |
Sim |
Caract. |
10 |
229-238 |
Código do centro de custo da tabela da CENTCUST. |
Os lançamentos contábeis são separados pelo C.Custo, podendo agrupar pelo C.Custo do funcionário em si. Utilizar os campos: Se lançamento da linha Débito, preencher com CT2_CCD. Se lançamento da linha Crédito, preencher com CT2_CCC. |
CT2_CCD / CT2_CCC |
Conta Contábil |
Não |
Caract. |
18 |
239-256 |
Conta contábil sem máscara. Alinhada à esquerda, com espaços à direita, para completar as 18 posições. |
Conta contábil definida no Lançamento Padrão. Define-se a conta para Débito e a conta para Crédito. Utilizar os campos: Se lançamento da linha Débito, preencher com CT2_DEBITO. Se lançamento da linha Crédito, preencher com CT2_CREDITO. |
CT2_DEBITO / CT2_CREDITO |
Valor do Lançamento |
Não |
Num. |
17,2 |
257-273 |
Valor em moeda corrente. O campo total deverá ter 17 posições, já contando com o ponto e as casas decimais. EX: 00000125425212.52 |
Valor gerado do lançamento. Utilizar o campo CT2_VALOR |
CT2_VALOR |
Valor Oficial |
Sim |
Num. |
17,2 |
274-290 |
Valor relativo à moeda oficial. |
Configuração realizada dentro do Contábil CM. Não utilizada diretamente dentro do RH CM. Por isso, não será enviado no TXT, uma vez que estamos tratando dos dados gerados apenas pelo RH. Caso queira fazer o tratamento de moedas, o mesmo deverá ser feito no próprio Contábil CM. |
00000000000000.00 |
Valor Gerencial 1 |
Sim |
Num. |
17,2 |
291-307 |
Valor relativo à moeda gerencial 1. |
||
Valor Gerencial 2 |
Sim |
Num. |
17,2 |
308-324 |
Valor relativo à moeda gerencial 2. |
||
Valor Gerencial 3 |
Sim |
Num. |
17,2 |
325-341 |
Valor relativo à moeda gerencial 3. |
||
Atividade/Projeto (OBRA) |
Sim |
Num. |
8 |
342-349 |
Indicar código da atividade/projeto da tabela da UNIDNEGOCIO. Este é o código hierárquico que deve ser indicado neste caso. |
Para a contabilização da Folha, o Contábil SEMPRE trata o código com valor PADRÃO - 001001 (que é preenchido quando a informação vem vazia). Assim, o campo NÃO SERÁ INFORMADO no arquivo. |
Espaços |
Valor Histórico |
Sim |
Num. |
17,2 |
350-366 |
Caso lançamento seja relativo à moeda histórica. O campo total deverá ter 17 posições já contando com o ponto e as casas decimais. EX: 00000125425212.52 |
Configuração realizada dentro do Contábil CM. Não utilizada diretamente dentro do RH CM. Por isso, não será enviado no TXT, uma vez que estamos tratando dos dados gerados apenas pelo RH. Caso queira fazer o tratamento de moedas, o mesmo deverá ser feito no próprio Contábil CM. |
00000000000000.00 |
Código Subconta |
Sim |
Num. |
6 |
367-372 |
Código da subconta da tabela da CMNet Soluções. |
Possível utilização da entidade ITEM para atender a essa necessidade. Configurar no Lanc.Padrão caso a entidade ITEM seja usada. |
CT2_ITEMD / CT2_ITEMC |
Código do Histórico Padrão |
Sim |
Caract. |
4 |
373-376 |
Código do histórico padrão da tabela HISTOPADRAO. |
Campo destinado para identificação de uma lista de descrições padrão para o Lançamento. Para facilitar emissão de relatórios. Há o cadastro de Histórico Padrão no Protheus. Necessário envio do cadastro do item no CMNET para manter os mesmos códigos em ambos os sistemas. Utilizar campo CT2_HP. **O campo no Protheus possui 1 caractere a menos. |
CT2_HP |
Planilha |
Não |
Num. |
8 |
377 - 384 |
Todos os registros com um número igual de planilha serão agrupados numa mesma planilha no sistema da CMNet, sem no entanto, corresponder a este número aqui informado. |
O código refere-se ao agrupamento de lançamentos. É controlado pela chave Data + Planilha Utilizar o campo CT2_DOC que possui funcionalidade similar. Ficou definido que será enviado o código gerado pelo Protheus, porém, o CM irá gerar seu próprio número de planilha ao realizar a importação. |
CT2_DOC |
Lançamento |
Sim |
Num. |
8 |
385-392 |
Número de ordem dos lançamentos dentro de uma planilha. |
Linha (ordem/sequencia) do lançamento na planilha Por causa da necessidade de utilizar 2 linhas para lançamentos Partida Dobrada, será realizado o controle das linhas do arquivo através de uma variável. |
nLinha – variável |
Plano Previdenciário |
Sim |
Num. |
10 |
393-402 |
Código do Plano Previdenciário da tabela PLANPREVCONTABIL. |
Não é mais utilizado pelo CM |
Espaços |
Patrocinadora |
Sim |
Num. |
10 |
403-412 |
Código da Patrocinadora da tabela PATRO. |
Não é mais utilizado pelo CM |
|
Código Outro Sistema |
Sim |
Caract. |
20 |
413-432 |
Código de referência desta planilha no sistema de origem. |
Não será utilizado para importação RH Protheus - Contábil CM. É utilizado apenas quando sair do CMNET e ir para outro sistema. |
(Não informar) |
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 |
Ferramenta de Importação Genérica de Tabelas Protheus
Visando ofertar uma solução adequada para auxílio na implantação dos módulos de RH, bem como na importação de tabelas posterior ao período de implantação, foi desenvolvida a ferramenta genérica de importação de tabelas RHIMPGEN.
Através da ferramenta RHIMPGEN é possível a definição de leiautes para importação de arquivos texto para as tabelas do Protheus.
Para execução da ferramenta é preciso executar o Smartclient com o programa inicial como RHIMPGEN.
Pré-Requisitos: lista dos itens necessários para realização das importações.
Manutenção de Layouts: rotina responsável pela definição dos leiautes dos arquivos de importação. Pode ser configurado a partir de uma Tabela do Protheus OU a partir de um Modelo Pré-Definido.
Manutenção de Layouts - Tabelas Genéricas: ramificação da rotina de Manutenção de Layouts. Essa opção permite configurar um leiaute para as Tabelas Genéricas do SIGAGPE (e.g. S008 - Assistência Médica Faixa Salarial)
Manut. De-Para: rotina responsável pela configuração do relacionamento entre os códigos externos (valor contido no arquivo - De) e os códigos internos (valor a ser gravado no Protheus - Para). É possível realizar a exportação e importação da lista para um arquivo CSV a fim de facilitar a manutenção dos dados.
Gerar XML: rotina responsável por gerar uma planilha com a estrutura do leiaute selecionado. Este arquivo procura facilitar a geração do arquivo de importação dentro da estrutura configurada.
Geração de Verbas (SRV): rotina responsável pela geração de verbas no Protheus. É feita a carga das verbas padrão do sistema, possibilitando a alteração da configuração de cada verba, acrescentar novas verbas e indicar De-Para para cada verba listada.
Processamento: Passo a passo de como realizar a importação dos dados.
Rotinas alteradas/incluídas:
Linha de Produto: |
Protheus |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmento: |
Serviços |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Módulo: |
SIGAGPE - Gestão de Pessoal |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rotina: |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cadastros Iniciais: |
Tipos de Ausências Processos Períodos Definição e Manutenção de Tabelas. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Requisito (ISSUE): | RHRH002-4 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Outros | ER Ferramenta Importação Protheus |
- Realizar carga padrão dos cadastros:
- Processo (SIGAGPE > Atualizações > Definições de Cálculo > Processos)
- Roteiros de Cálculo (SIGAGPE > Atualizações > Definições de Cálculo > Roteiros de Cálculo)
- Definição de Tabelas (SIGAGPE > Atualizações > Definições de Cálculo > Definição de Tabelas)
- Manutenção de Tabelas (SIGAGPE > Atualizações > Definições de Cálculo > Manutenção de Tabelas)
- Tipos de Ausências (SIGAGPE > Atualizações > Definições de Cálculo > Tipos de Ausência)
- Verbas: realizar carga padrão através da opção RHIMPGEN > Outras Ações > Geração de Verbas (SRV) OU realizar importação dos dados. As verbas são essenciais para realização da importação de qualquer movimentação de cálculo.
- Cadastro de De-Para: realizar o cadastro de De-Para para os campos-chave a serem importados e que não possuem opção de De-Para automático. O De-Para das Filiais é essencial para importação de qualquer registro (realizar cadastro em caso de necessidade).
- Cadastro de De-Para Específico:
- Tipos de Rescisão: influenciará diretamente na importação de Rescisões
- Tipos de Alteração Salarial: influenciará diretamente na importação de Histórico Salarial
Tipos de Afastamentos: influenciará diretamente na importação de Ausências, Rescisão, Férias.
Na montagem de leiautes genéricos é possível definir quais campos serão importados, sendo que os campos obrigatórios sempre deverão constar no leiaute, seja como uma posição no arquivo ou como uma fórmula pré-definida.
Ao abrir a tela principal, é exibido um browser com todos os leiautes definidos. Em Outras Ações, há opção Manutenção de Layouts.
Importante
Delimitadores no Arquivo texto:
O sistema realiza a importação das tabelas a partir da leitura de um arquivo de texto delimitado por pipes ("|").
Sequência:
O campo Sequência será utilizado para ordenar as importações durante o processamento. Ele é gerado automaticamente e poderá ser alterado a qualquer momento.
Tabela ≠ Modelo
Os leiautes com origem em um Modelo e os leiautes com origem em uma Tabela de sistema são cadastros distintos na tabela GPETABGEN. Assim, é possível configurar o modelo de Funções e também configurar a tabela SRJ (Funções) de forma diferente. Ao final estará disponível para utilização 2 leiautes distintos.
Modelo
No primeiro acesso à rotina RHIMPGEN, os modelos de leiaute padrão serão criados automaticamente. Esses leiautes disponíveis no campo "Modelo" são referentes aos modelos de importação com posições pré-definidas e não podem ser alteradas.
A rotina de Manutenção de Layouts possui 2 opções de utilização:
- Seleção de uma Tabela para definição do leiaute.
Ao selecionar uma tabela, se já existir um leiaute previamente cadastrado, ele é carregado para alteração. Do contrário um novo leiaute genérico baseado na ordem dos campos no dicionário de dados (SX3) é gerado.
Na grid é exibido Campo, Título (nome do campo), Tipo (C- caracter, N- numérico, D- Data, L- lógico, M- memo), Obrigatório (se é obrigatório informar campo no Protheus), Posição (a posição no arquivo texto, que é inicialmente baseado na ordem do SX3) e Fórmula (detalhes mais abaixo).
Dos campos da grid será possível apenas alterar a posição e a fórmula. Não é permitido inclusão de novas campos ao leiaute.
No cabeçalho, é possível alterar a Descrição (carregado o nome da tabela no SX2 por padrão), o Nome do Arquivo de importação, a Sequência de execução, e o De-Para automático (detalhes mais abaixo).
Todo campo obrigatório deve possuir uma posição válida (diferente de ZERO) ou uma fórmula definida. Por exemplo, se a Empresa é a mesma e não existe informação nela no arquivo, a posição pode ser 0 (ZERO), e na Fórmula deve ser informado um valor para o campo: "T1". Em resumo, deve ser informado a posição apenas de campos que efetivamente existem no arquivo texto, os demais devem ficar com a posição "0" (ZERO). No campo fórmula podem ser utilizadas Strings, Funções Protheus e Funções de Usuário.
2. Seleção de um Modelo de importação padrão.
Ao selecionar o modelo desejado os campos Descrição, Nome do Arquivo e Sequência presentes no cabeçalho serão carregados. Qualquer alteração realizada previamente e salva será carregada.
No grid, serão carregados os campos do leiaute.
Quando utilizada a opção Modelo, será possível alterar apenas o campo Fórmula no grid. Não é permitido inclusão de novas campos ao leiaute.
No cabeçalho os campos Descrição, Nome do Arquivo, Sequência e De-Para Automático são abertos para alteração.
Caso tenha sido realizada alguma alteração anterior no cadastro do modelo, estas serão carregadas.
De-Para Automático
De-Para automático está disponível apenas para algumas tabelas/modelos. Ao habilitá-lo, ele será utilizado apenas para o campo chave principal da tabela, realizando a busca do código identificador (De) a ser importado na tabela de De-Para, caso não encontre o registro na tabela, será gerado um novo código (Para) a partir da numeração automática da tabela importada e também gravado a relação entre os códigos na tabela de De-Para.
Quando esta opção estiver desativada, será realizada a busca do relacionamento na tabela de De-Para, porém caso não encontre registro será realizada a tentativa de gravação com o próprio valor proveniente do arquivo texto, passando pela validação do sistema (tamanho do campo, conteúdo, relacionamento com outras tabelas).
Exemplo
No leiaute de importação dos Sindicatos foi definido que seria feito o De/Para automático:
Após a importação do arquivo de Sindicatos, o De/Para foi gerado de maneira automática:
Durante a importação do arquivo de funcionários, que continha o valor original do Sindicato, o sistema busca o valor da chave externa e preenche o campo RA_SINDICA com valor cadastrado na chave interna:
Gerar Arquivo Texto de exemplo:
No cabeçalho, há disponível um botão que possibilita a geração de um exemplo de arquivo texto baseado no leiaute carregado em tela. Assim como a opção de Gerar XML, esta opção visa facilitar a configuração/geração do arquivo de importação.
Fórmulas
Para cada campo presente no leiaute, é possível configurar uma fórmula para tratar o conteúdo a ser gravado no sistema.
As fórmulas podem ser uma string com valor fixo (sempre entre aspas), referência para um campo existente no Protheus, chamada de funções internas do Protheus ou chamada de funções de usuário executadas via RdMake. Foram disponibilizadas 2 funções de usuário para o auxílio da gravação dos campos Período ( U_Periodo() - retorna o período do registro ) e Processo ( U_Processo() - retorna o código do processo do funcionário do registro/linha atual).
Exemplo 01:
O campo Empresa não está presente no arquivo (posição = zero) e possui uma Fórmula de usuário para retornar o valor a ser gravado no campo.
O campo Filial também não está presente no arquivo (posição = zero) e possui uma string com valor fixo para gravação do conteúdo. Assim, todos os registros serão gravados com o conteúdo "D MG 01" no campo QB_FILIAL.
Exemplo 02:
O campo Cod. Processo não está presente no arquivo (posição = zero) e possui chamada para a função U_Processo(). Desta forma, a cada linha processada, será verificado e retornado o código do Processo referente ao funcionário do registro (PC_MAT - posição 3)
O campo Periodo não está presente no arquivo (posição = zero) e possui chamada para a função U_Periodo(). Desta forma, a cada linha processada será verificado e retornado o código do Período referente ao registro importado baseando no campo data do lançamento (neste caso PC_DATA - posição 4).
O campo Número Pagto não está presente no arquivo (posição = zero) e possui um conteúdo fixo informado. Assim, em todos os registros o campo PC_NUMPAG será gravado com conteúdo "01".
Os campos Centro de Custo, Departamento, Posto, Função e Turno não estão presentes no arquivo (posição = zero) e estão referenciados aos campos do cadastro de Funcionários que armazenam as mesmas informações. Assim, para cada campo, será consultado o valor presente no cadastro do funcionário do registro e gravará o conteúdo lido no referente campo da tabela alvo.
O campo Sequencia não está presente no arquivo (posição = zero) e possui chamada para a função Protheus Posicione(tabela, ordem, chave de busca, campo de retorno). Esta função irá retornar o conteúdo presente no campo PJ_SEMANA.
Variáveis de Manipulação do Arquivo
A fim de flexibilizar e facilitar a manipulação dos dados do arquivo no momento da importação, está disponível para uso 3 variáveis que fazem referência aos dados do arquivo. Essas variáveis podem ser utilizadas como parâmetros nas chamadas das funções presentes no campo Fórmula.
- aCampos: matriz que guarda todos os campos utilizados no leiaute. Cada índice da matriz guarda um campo e é composto por sete posições, sendo elas:
- Nome do campo
- Posição na linha
- Fórmula do campo
- De/Para
- Posição reservada
- Tipo do campo
- Ordem.
- aLinha: vetor que armazena todos os valores da linha atual.
- nPos: armazena o índice do campo atual dentro de aCampos. Dessa forma para se acessar o campo que está sendo processado atualmente basta utilizar aCampos[nPos].
Exemplo 01:
No cadastro de Bancos do Protheus, as informações de Número da Conta e Dígito são armazenadas em campos separados. Isso não é comum em todos os sistemas. Caso o arquivo a ser importado possua essas informações unificadas em apenas um campo, é possível fazer o tratamento da informação via fórmula no leiaute sem haver necessidade de alteração do arquivo. No caso deste cenário, os campos A6_NUMCON e A6_DVCTA serão referenciados à mesma coluna do arquivo (5) no campo Posição, e no campo Fórmula realiza-se o tratamento da informação lida.
Como demonstra a figura abaixo, a referência aLinha[aCampos[nPos,2]] carrega o dado presente na posição atual (nPos = 5) da linha que está sendo lida.
No campo A6_NUMCON a função Right() indica que será carregado neste campo somente os 4 primeiros caracteres da coluna lida. Já no campo A6_DVCTA a função Left() indica que será carregado neste campo somente os últimos 2 caracteres da coluna lida.
Exemplo 02:
Caso algum campo possua tamanho menor ao tamanho do campo no Protheus, é possível realizar um tratamento para completar o tamanho do campo com certo caractere a fim do preenchimento completo do campo.
No exemplo abaixo, imagine que o campo Matrícula possua 4 caracteres no sistema anterior e, no Protheus temos o campo Matrícula com 6 caracteres. Caso não deseje gerar as matrícula por De-Para automático, pode-se realizar uma tratamento no próprio campo para completar com zeros (0) à esquerda a fim de ter o conteúdo totalmente preenchido.
Com uso da função Protheus StrZero() completa-se a cadeia de caracteres lida na coluna do campo Matrícula (aLinha[aCampos[nPos,2]]).
A rotina de Manutenção de Layouts também atende à necessidade de configurar leiautes para tabelas genéricas (Manutenção de Tabelas).
Para realizar a configuração de leiaute para uma tabela genérica, é necessário selecionar a tabela RCB - Configuração de Parâmetros no campo Tabela, o que fará com que o campo Tab.Aux. seja habilitado para edição.
No campo Tab.Aux. selecionar a tabela genérica desejada através da busca padrão ou digitando seu código. É possível escolher qualquer tabela definida na rotina Definição de Tabelas, inclusive tabelas de usuário.
Após escolher a tabela genérica, o grid será atualizado com a estrutura de campos desta tabela.
A estrutura das tabelas genéricas é armazenada fisicamente no banco de dados na tabela RCB (por isso o leiaute é configurado a partir desta tabela) porém, os dados dessas tabelas ficam fisicamente armazenados na tabela RCC - Parâmetros. Com isso, foi necessário a inclusão fixa de alguns campos da tabela RCC na estrutura dos leiautes das tabelas genéricas (por mais que não estejam presentes no arquivo) a fim de assegurar a correta gravação dos dados.
- O campo EMPRESA é utilizado em todos os leiautes para identificar a empresa alvo da importação.
- O campo RCC_FILIAL é utilizado em todos os leiautes para Tab.Aux. a fim de identificar a Filial para qual a informação será gravada. Caso o campo não seja informado, será gravada a primeira Filial presente no SM0 obedecendo a regra de compartilhamento da tabela alvo (RCC).
- O campo RCC_FIL é utilizado nas tabelas genéricas para especificar a Filial do registro. É um campo disponibilizado na própria rotina de Manutenção de Tabelas. Seu preenchimento é opcional.
- O campo RCC_CHAVE é utilizado nas tabelas genéricas para especificar a competência de vigência do registro. É um campo disponibilizado na própria rotina de Manutenção de Tabelas para as tabelas que não possuem o campo Ano/Mes em sua definição de leiaute. Seu preenchimento é opcional.
Ao confirmar a configuração do leiaute, a janela de edição é fechada retornando-se à tela inicial da rotina. O leiaute estará disponível na lista, obedecendo o número do campo Sequência.
Realizada a importação, os dados estarão disponíveis para visualização e manutenção na rotina SIGAGPE > Atualizações > Definições de Cálculo > Manutenção de Tabelas.
A rotina de Manutenção de De-Para possibilita incluir, alterar e visualizar os relacionamentos entre os códigos externos (valor presente no arquivo texto) e internos (valor a ser gravado no Protheus).
Acesse em Importação de Tabelas (RHIMPGEN) > Outras Ações > Manut. De-Para.
No cabeçalho, o campo Tabela é carregado com os nomes das tabelas que possuem De-Para cadastrado, possibilitando assim o filtro desses dados a fim de facilitar a manutenção dos registros. Quando selecionado a opção em branco, serão carregados todos os registros cadastrados na tabela de De-Para (GPETABDP).
O campo Buscar possibilita encontrar um registro carregado no grid da tela.
No cadastro de De-Para é possível criar um relacionamento de valores para quaisquer campos existentes no Protheus. Para incluir um novo De-Para inclua uma nova linha de registro informando Campo (nome do campo na tabela do Protheus, e.g.: RA_MAT), Chave Externa (valor presente no arquivo texto) e Chave Interna (valor a ser gravado no Protheus).
Exemplo 01:
Campo Tipo de Aviso de Prévio (RG_TPAVISO) da tabela de Rescisão (SRG) possui tamanho diferente entre o sistema anterior (tamanho 5) e o Protheus (tamanho 2), fazendo necessário o cadastro de De-Para a fim de gerar um novo código para gravação da informação no Protheus. Desta forma, ao executar a importação do arquivo de Rescisão, antes de gravar o conteúdo no campo RG_TPAVISO, o sistema efetuará busca no De-Para e gravará no campo o conteúdo presente em Chave Interna. Caso a chave não seja encontrada no De-Para, o valor original (do arquivo) será truncado e gravado.
Campo | Chave Externa | Chave Interna |
---|---|---|
RG_TPAVISO | 00001 | 01 |
RG_TPAVISO | 00002 | 02 |
RG_TPAVIO | 00010 | 03 |
Exemplo 02:
Outro cenário que pode ocorrer, é a configuração de De-Para para os códigos das Filiais que podem sofrer alteração na mudança de sistemas. Para configurar De-Para de Empresa+Filial é necessário preencher com FILIAL o campo Campo. Ao incluir duas informações na chave (e.g.: Empresa+Filial) é necessário separá-las utilizando pipes ("|").
Campo | Chave Externa | Chave Interna |
---|---|---|
FILIAL | 01|01 | T1|D MG 01 |
FILIAL | 01|02 | T1|D MG 02 |
FILIAL | 02|01 | T2|L MG 01 |
Exemplo 03:
Ao realizar De-Para de campos que possuem identificação por Filial, é necessário incluir o valor da Filial na chave, separando o código da Filial e o código do campo por pipes ("|").
Campo | Chave Externa | Chave Interna |
---|---|---|
RA_MAT | 01|A00001 | D MG 01|000001 |
RA_MAT | 02|A00002 | D MG 02|000002 |
RA_MAT | 01|B00003 | L MG 01|000001 |
Caso o valor da Filial informado na Chave Interna seja inexistente no Protheus, não será realizada a importação.
Outras Ações > De-Para Específicos
Dentro da rotina de Manutenção de De-Para há a opção De-Para Específicos para configuração de alguns itens que possuem valor padrão dentro do Protheus e, por diferença de tamanho ou outras características se torna necessário a configuração do De-Para.
- Tipos de Rescisão: No Protheus, os tipos de rescisão (e.g.: Pedido de Demissão Trabalhado) são configurados a partir da tabela genérica S043 (presente na rotina Manutenção de Tabelas). Por padrão o sistema carrega 14 tipos de rescisão. Ao acionar a opção de De-Para Específico Tipos de Rescisão, uma nova tela é exibida com a listagem dos tipos padrão do Protheus e uma coluna para informar o valor externo (De). Ao confirmar a configuração, será gravado na tabela de De-Para (GPETABDP) a relação informada para o campo RG_TIPORES (tabela SRG - Rescisão. Na importação dos cálculos de rescisão, o sistema verifica se o Tipo de Rescisão está gravado no sistema. Caso não esteja, a importação dos dados não ocorrerá. Por isso é necessário a configuração da tabela ou do De-Para antes da importação desse item.).
- Tipos de Alteração Salarial: No Protheus, os tipos de alteração salarial (e.g.: Salário Inicial) ficam gravados na tabela SX5 (Tabelas) com chave de identificação 41. Essa tabela somente é alterada via Configurador (SIGACFG). Por padrão o sistema carrega 3 tipos de alteração salarial. Ao acionar a opção de De-Para Específico Tipos de Alteração Salarial, uma nova tela é exibida com a listagem dos tipos padrão do Protheus e uma coluna para informar o valor externo (De). Ao confirmar a configuração, será gravado na tabela de De-Para (GPETABDP) a relação informada para o campo R3_TIPO (tabela SR3 - Histórico Valores Salariais. Na importação do Histórico de Alteração Salarial, o sistema verifica se o Tipo de Alteração Salarial está gravado no sistema. Caso não esteja, a importação dos dados não ocorrerá. Por isso é necessário a configuração da tabela ou do De-Para antes da importação desse item.).
- Tipos de Afastamento (Ausências): No Protheus, os tipos de ausências (e.g.: Afastamento Temporário por Doença) ficam gravados na tabela RCM. Por padrão o sistema carrega 18 tipos de ausências. Ao acionar a opção de De-Para Específico Tipos de Afastamentos, uma nova tela é exibida com a listagem dos tipos padrão do Protheus e uma coluna para informar o valor externo (De). Ao confirmar a configuração, será gravado na tabela de De-Para (GPETABDP) a relação informada para o campo R8_TIPOAFA (SR8 - Lançamentos de Ausências. No momento da importação de Ausências, o sistema verifica a existência dos Tipos de Ausências. Caso o valor a ser importado não exista no sistema, a importação dos dados não ocorrerá. Por isso é necessário a configuração da tabela ou do De-Para antes da importação.).
Outras Ações > Exportar CSV e Importar CSV
Foi implementada também as opções de Exportar e Importar o cadastro de De-Para para um arquivo CSV (delimitado por ponto-e-vírgula) a fim de permitir a edição via editores de planilha facilitando a manipulação/criação de dados.
Para realizar a importação é necessário utilizar o mesmo arquivo exportado (mesmo nome e leiaute).
A opção Exportar CSV gera um arquivo com todos os registros da tabela de De-Para.
A opção Importar CSV funciona de forma incremental, onde é possível importar apenas o diferencial (novos registros) e a rotina irá acrescentar os dados lidos à tabela de De-Para.
Leiaute do Arquivo DEPARA - edição em planilha.
Leiaute do Arquivo DEPARA - edição em texto.
A opção Gerar XML presente na rotina de Importação de Tabelas permite a geração de um arquivo planilha do leiaute configurado em Manutenção de Layouts. O objetivo da rotina é facilitar a geração do arquivo texto de importação através da manipulação de dados via planilha.
Acesse em Importação de Tabelas (RHIMPGEN) > Outras Ações > Gerar XML.
Atenção!
Esta planilha poderá ser utilizada para preenchimento e posterior conversão para arquivo texto para efetuar a importação. Opção será válida apenas para os leiautes genéricos. (Não utilizada com modelos RHIMP).
A opção Geração de Verbas (SRV) tem como objetivo auxiliar a geração e relacionamento das verbas entre os sistemas (origem e destino). Ao acessar a rotina é carregado em tela uma lista de verbas padrão pré-configuradas. A primeira coluna do grid é disponibilizada para inserção do código externo (De) para agilizar o cadastro de De-Para dos itens. É possível realizar a alteração de todos os campos do grid a fim de atender às necessidades de uso do cliente (e.g.: configuração de Incidências.). Também é possível a inserção de novas linhas a grid caso as verbas carregadas não atendam todas as necessidades do cliente.
Em resumo, é possível realizar o cadastro e configuração de todas as verbas a serem utilizadas pelo sistema nesta tela, antes de iniciar o uso do sistema. A gravação das informações na tabela de Verbas (SRV) via esta rotina é feita apenas enquanto a tabela estiver vazia. Após o cadastro de itens na tabela, a manutenção dos dados é feita via rotina padrão do Protheus (SIGAGPE > Atualizações > Definições de Cálculo > Verbas).
Acesse em Importação de Tabelas (RHIMPGEN) > Outras Ações > Geração de Verbas (SRV).
Geração das Verbas
A TOTVS se exime de qualquer responsabilidade no tocante a utilização deste modelo. A configuração disponibilizada é um mero modelo. Toda a validação do cadastro, principalmente das incidências, é de responsabilidade do cliente.
Outras Ações > Exportar CSV e Importar CSV
Foi implementada também as opções de Exportar e Importar a lista de De-Para das verbas padrão (Código Externo, Código Verba, Descrição, Desc.Det.) para um arquivo CSV (delimitado por ponto-e-vírgula) a fim de permitir a edição via editores de planilha facilitando a configuração do relacionamento de De-Para.
Para realizar a importação é necessário utilizar o mesmo arquivo exportado (mesmo nome e leiaute).
A opção Exportar CSV gera um arquivo com toda a lista das verbas padrão carregadas.
A opção Importar CSV funciona permite importar apenas o diferencial (registros com código externo) e a rotina atualizar os dados lidos à tabela de Configuração de Verbas.
Após configuração dos leiautes e De-Para, é possível realizar a importação dos arquivos para o Protheus.
Na tela principal da rotina de Importação de Tabelas (RHIMPGEN), selecione os leiautes dos arquivos que serão processados (possível seleção de vários leiautes) e clique em Confirmar. Será solicitado para informar o diretório onde estão localizados os arquivos para importação.
Então, a tela de processamento será aberta. Na aba Perguntas, configure os parâmetros:
- ExecAuto?: Se marcado com SIM, a importação de algumas tabelas será feita via rotina automática. A vantagem deste método é que serão feitas todas as validações necessárias para inclusão do registro, a desvantagem é que o tempo de processamento é maior. Se marcado com NÃO, nenhuma rotina automática é executada, tornando o processamento mais rápido, porém, a maioria das validações não são feitas e por este motivo podem ser incluídos registros sem integridade garantida. Parâmetro não é válido para modelos RHIMP, que possui validações fixas.
- Erro no Fim?: Se marcado com SIM, ao encontrar uma inconsistência em determinada linha, o processo de importação continua a leitura do arquivo, importando os registros que possuem os dados sem problemas. Se marcado com NÃO, ao constatar a primeira inconsistência, o processo de leitura do arquivo atual é abortado (caso esteja importando mais de um leiaute, incia-se o processamento do próximo arquivo).
Na aba Informações, clique em Executar e aguarde o processamento. Um log será emitido somente se houver algum problema na importação, caso contrário ao fim do processamento será retornado à tela inicial da rotina.
Em casos de importação de cálculos (Rescisão, Férias, 13º, Folha) caso a tabela já possua dados é exibida a pergunta Apaga importação de Movimento Anterior?. Confirme caso deseje sobrepor os dados presentes na tabela.
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|