Linha Microsiga Protheus

Árvore de páginas

Integração Financeiro CMNET x SIGAGPE

    Linha de Produto:

    		 
    Microsiga Protheus®

    Segmento:

    		 
    Recursos Humanos

    Módulo:

    		 
    SIGAGPE

    Rotina:

    Rotina

    Nome Técnico

    		 
    GPEM671
    		 Integração de Títulos - Protheus GPE x CMNET 

    Rotina(s) envolvida(s)

    Nome Técnico 

    GPEM670

    Integração com o Financeiro

    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

     

    1. 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
    • Código do Tipo de Doc.
    • Tipo: Numérico
    • Tamanho: 8
    • Picture: 99999999
    • Usado Pesq.? SIM
    • Módulo: GPE
    DESCRICAO
    • Nome do Tipo de Documento
    • Tipo: Caractere
    • Tamanho 60
    • Picture: @!
    • Usado Pesq.? SIM
    • Módulo GPE


    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

    1. Acesse a rotina Manutenção Tabelas através do menu SigaGPE > Atualizações > Definições de Cálculos > Manutenção Tabelas (GPEA320)
    2. Posicione na tabela Auxiliar S128 - TIPO DE DOCUMENTO INTEG. CMNET
    3. Faça o cadastro dos Tipos de documento considerando o Código com 8 dígitos e a respectiva descrição.
    4. Confira os dados e clique em salvar


    Realizar a Integração com o Financeiro

    1. Acesse a rotina através do menu SigaGPE > Miscelânea > Títulos > Integração Financeiro (GPEM670)

    2. Se o parâmetro MV_ERPCM estiver habilitado (.T.) o sistema apresentará a tela: "Integração de Títulos - Protheus GPE x Sistemas Externos"

    3. 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.

    4. Competência: Deve ser informado nos parâmetros a competência (Ano e Mês) com o formato AAAAMM. É obrigatório informar esse dado.

    5. 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).

    6. 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.
    7. 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)
    4 - CAR (Contas a Receber)

    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.
    2 - Caso seja um lançamento do documento sem parcelas.
    3 - Caso seja um documento com parcelas.
    4 - Caso seja alterador.
    14 - Caso seja um adiantamento.

    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
    R - Recebimento

    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
    N - Não contabiliza

    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