A partir do release 12.1.11, estará disponível aos clientes TOTVS a oferta de Integração do RM Folha de Pagamento ao ERP Logix. A integração possibilitará a realização de todos os processos de uma folha de pagamento de forma simples e segura, gerando os compromissos a pagar diretamente no financeiro do Logix, assim também os lançamentos contábeis diretamente no módulo contábil do ERP. Além dos lançamentos financeiros e contábeis, também são integrados os cadastros que sustentam estas operações.O funcionamento da integração ocorre de forma “Síncrona” entre os sistemas, utilizando a tecnologia EAI. Ou seja, sempre que o usuário cadastrar ou alterar uma informação no Logix e a mesma estiver dentro do contexto da integração, a informação será replicada.
ERP Logix: O BackOffice Logix é o produto Totvs responsável por enviar via EAI as mensagens de Cliente/Fornecedor, Banco/Agencia, Item contábil (Área e Linha de Negócio), Período Contábil, Histórico padrão, Centro de Custo e Plano de Contas.
O objetivo do projeto é integrar o ERP Logix com o Totvs RM Folha de Pagamento, através das mensagens únicas "EAI". Desta forma será disponibilizado aos clientes do ERP a possibilidade de trabalhar a sua gestão de backOffice de forma integrada ao Totvs RM.
O escopo da integração é a sincronização entre os cadastros de backOffice de ambos sistemas. Para fazer esse controle as seguintes entidades foram integradas:
Para o correto funcionamento da integração é necessário realizar as seguintes configurações nos sistemas envolvidos:
1. Configurar o TBC para comunicação do Logix com o RM:
Seguir a orientação do link abaixo para configurar o TBC: http://tdn.totvs.com/pages/releaseview.action?pageId=82477609
Colocar o endereço abaixo nas configurações de webservice do Logix: http://{ip-servidor-TBC}/TOTVSBusinessConnect/wsEAIService.asmx?wsdl
2. Executar o Configurador para Integração Logix
Acesse o módulo Integração: Integração / Ferramentas / Configurar
Na tela do configurador:
Selecione a integração: TOTVS Folha de Pagamento RM x BackOffice Logix
Clique em Avançar
Na tela seguinte clique em Executar, e aguarde o final do processo conforme imagem abaixo.
3. Configurando Integração Logix
Acesse a integração através do menu: Integração / Mensagem Única / Integrações
Edite o registro e insira as configurações necessárias para o webservice Logix.
Verifique e configure (se necessário) os Parâmetros da Integração através do anexo Parâmetro de Integração.
Verifique se todas as Entidades necessárias para a integração foram mapeadas com sucesso.
4. Configurando o De-Para
Para a integração é necessário criar manualmente um novo registro para o de-para para coligada.
Acesse: Integração / Integração / Mensagem Única / De-Para.
Realize um novo cadastro onde:
Tabela RM: GCOLIGADA
Chave Primária RM: CODCOLIGADA
Valor Chave Primária RM: [Código da coligada utilizada para integração]
Sistema Integrado: LOGIX
Valor Chave Integração: [Empresa do Logix enviada pela mensagem EAI]
5. Parametrizando o Folha de Pagamento para a Integração
É necessário parametrizar no modulo Folha de Pagamento a utilização de integração com outros BackOffice.
Acesse o modulo de Folha de Pagamento: RH / Folha de Pagamento / Configurações / Parametrizador
Selecione a configuração: 06.02 – Integrações / 06.02.06 – Outros BackOffice
Ative a opção “Usa integração outros BackOffice”, configure a quantidade de partidas contábeis que serão enviados por pacote. Ao ativar a opção de integração com outros BackOffices, automaticamente o parâmetro “Gera lotes contábeis no Folha de Pagamento antes de enviar para o Saldus” localizado em 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal é marcado e bloqueado para alteração.
Para configurar o agrupamento de partidas contábeis e a geração de lançamentos financeiros rateados por: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor, selecione a configuração: 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal.
Obs.: Os parâmetros deverão ser habilitados somente se o parâmetro “usa integração outros backOffice” estiver marcado.
Para a configuração agrupamento de partidas contábeis, acesse a Etapa 11 (Contabilização) e marque as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor.
Obs.: Os parâmetros dos grupos “Lançamento Contábil (RM Saldus)” e “Contabilização” foram movidos da na Etapa 17 (Geral) para a Etapa 11 (Contabilização).
Para a configuração da geração de lançamentos rateados, acesse a Etapa 12 (Lancto Financeiro) e marque as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor.
Necessário:
No Logix os seguintes pré-requisitos devem ser atendidos
1. Versão 12.1.11 ou superior.
Atenção: empresas que utilizam a versão 12.1.11 deverão solicitar os seguintes pacotes de chamados/projetos para a área de framework: FRWJOI01-416, FRWJOI01-173, TSTRNJ, TSRLF0, TSRKTG.
2. Build Totvstec na versão 7.00.131227A-20140829 ou superior.
3. EAI Logix e WebService instalados e configurados. Mais informações em: http://tdn.totvs.com/pages/releaseview.action?pageId=223159857
4. Configurar a chave MAXSTRINGSIZE que está localizada na seção General do TotvsAppServer.ini. Caso não exista deverá ser adicionada. Ela define o tamanho máximo das mensagens (em MB) que serão trocadas entre os sistemas. Recomendamos qualquer valor acima de 15.
Exemplo:
Mais informações em: http://tdn.totvs.com/pages/viewpage.action?pageId=161349793
5. Executar o conversor cap00977.cnv através do programa LOG6000 (Gerenciador de conversores). Será criada a tabela: cap_integracao_inss_auton (versão 12.1.13 ou superior).
6. Executar o conversor de parâmetro fin10089.cnv, através do programa LOG00088 (Processamento de conversores). Será criado ou alterado o parâmetro: “Último número de nota fiscal para integração de títulos por EAI” (versão 12.1.13 ou superior).
7. Cadastrar o Aplicativo externo RM com sua respectiva URL de acesso ao WEB SERVICE no EAI10000.
8. Cadastrar o relacionamento DE-PARA de empresas do Logix com as coligadas/filiais do RM, no EAI10000, conforme exemplo abaixo:
Os seguintes procedimentos deverão ser realizados para a implantação da integração entre os sistemas.
Insira aqui as informações pertinentes ao RM.
O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Logix estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Método | ID | Descrição | Origem | Destino | XSD (versões podem variar) |
Cadastros | 01 | Cliente/Fornecedor | Logix | RM | CustomerVendor_2_000.xsd |
02 | Banco/Agência | Logix | RM | Bank_2_002.xsd | |
03 | Item Contábil (Área e Linha de Negócio) | Logix | RM | AreaAndLineOfBusiness_1_000.xsd | |
04 | Período Contábil | Logix | RM | AccountingCalendar_1_000.xsd | |
05 | Histórico Padrão | Logix | RM | ListOfAccountantDefaultHistory_2_000.xsd | |
06 | Centro de Custo | Logix | RM | ListOfCostCenter_2_001.xsd | |
07 | Plano de Contas | Logix | RM | ListOfAccountantAcoount_2_002.xsd | |
08 | Lançamento Contábil | RM | Logix | AccountingEntry_2_002.xsd | |
09 | Lançamento Financeiro | RM | Logix | AccountantPayableDocument_2_002.xsd | |
10 | Pagamentos a autônomos | Logix | RM | ExternalAutonomousPayment_1_000.xsd | |
11 | Comissão de representantes / Devolução de adiantamento de viagem | Logix | RM | MonthlyPayroll_1_000.xsd | |
12 | Cargos / funções | RM | Logix | Role_1_000.xsd |
LOGIX
O cadastro de clientes e fornecedores é realizado no Logix e integrado ao RM através da mensagem CUSTOMERVENDOR versão 2.000. Portanto, a mensagem precisa estar habilitada para envio no EAI10000. Possíveis inconsistências ou erros ocorridos durante o processo de integração serão apresentados em tela e a operação não será efetivada, possibilitando ao usuário tomar a ação de correção ou ajuste da inconsistência. Toda o processo de integração fica registrado no monitor de integração do EAI10000 e pode ser consultado a qualquer momento.
As integrações são síncronas, ou seja, para a alteração, inclusão ou exclusão ser efetivada o Logix aguarda o OK da mensagem enviada para o RM, As mensagens retornam além do "status" da operação ("OK" ou "ERROR") os códigos do fornecedor na origem (Logix) e no destino (RM), este código é chamado de "InternalID" e é composto pelos campos das chaves primárias do cadastro nos respectivos produtos.
O código interno, também pode ser consultado a qualquer momento no EAI10000 > Configuração > Aplicativo Externo. Efetue a consulta pelo aplicativo RM e utilize o botão "Consulta De/Para", faça a busca conforme o critério desejado:
Atenção: Para a integração com o RH são integrados somente fornecedores, portanto os clientes não são enviados ao RM, embora a mensagem permita tal integração.
RM
Para o RM receber a integração de fornecedor é necessário que a entidade CUSTOMERVENDOR na versão 2.000 esteja configurada na integração juntamente com o evento d25b1b1f-2878-40d4-a7bc-ab27ceca5566 (Tratamento de cliente/fornecedor).
Para a mesma também é necessário que a integração tenha os parâmetros RH_CLIFORAUTOINC e RH_CODCLASSIFICPAIS configurados.
O parâmetro RH_CLIFORAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCFO.CODCFO”.
Caso o parâmetro esteja configurado para não considerar o auto incremento, a máscara do código do Cliente/Fornecedor do RM deve ser configurada de acordo com a máscara do cliente/fornecedor enviada pelo Logix:
Ex: “QQQQQQQQ”. [Permite qualquer caractere limitado a 8 posições].
Caso o parâmetro esteja configurado para ativar o auto incremento, a máscara deve ser definida como # (numérica) e o parâmetro do financeiro “Usar código sequencial (se máscara for numérica)” deve ser marcado.
Obs.: Por default a opção “Usar código sequencial (se máscara for numérica)” fica desativada. A mesma só é ativa para seleção após definir a máscara como numérica, conforme imagem acima.
Após o envio da mensagem pelo Logix, é possível verificar o recebimento da mesma através da Fila de mensagens únicas que pode ser acessada através do caminho: Integração / Integração / Mensagem Única / Fila de mensagens únicas.
No anexo “Informação de execução de mensagem” acessado através da tela de Fila de mensagem pode verificar o status da mensagem enviada pelo Logix.
Ao receber/atualizar o Cliente/Fornecedor, o EAI deverá criar automaticamente o cadastro De-Para referente a esta integração.
Integração / Integração / Mensagem Única / De-Para
Logix
O cadastro de banco, agências e contas bancárias é de responsabilidade do Logix, para integrar ao RM a mensagem Bank na versão 2.002 deve estar habilitada para envio.
A mensagem é disparada a partir dos programas FIN30065 (Agências bancárias) e CAP0120 (Agências). Os dados enviados são: banco, agencia bancária e as contas bancárias pertencentes ao banco e agência em questão.
Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno (Bank) do banco no RM, que será utilizado posteriormente em outras mensagens.
Atenção: A integração leva somente as contas bancárias da empresa corrente. Portanto, contas bancárias de outras empresas não serão integradas mesmo que pertençam ao mesmo banco e agência.
RM
Para o RM receber a integração de Banco/Agência é necessário que a entidade BANK na versão 2.002 esteja configurada na integração juntamente com o evento 1ee544f5-4b15-45cc-aee3-f0a05fde4644 (Tratamento de dados bancários).
Nesta integração é realizado os cadastros de Banco, Agência, Conta Corrente e Conta Caixa. Agência é um anexo da visão de Banco, assim como Conta Corrente é um anexo da visão de Agência. Na Linha RM são tabelas independentes: Banco (GBANCO), Agência (GAGENCIA), Conta Corrente (FCONTA) e Conta Caixa (FCXA). Com isso, a exclusão da entidade banco no Logix, reflete na exclusão de uma Conta caixa, conta, agencias e banco no Lado RM.
Para a mesma também é necessário que a integração tenha o parâmetro RH_ CONTACAIXAAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.
O parâmetro RH_ CONTACAIXAAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCXA.CODCXA”.
Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “FCXA.CODCXA” a conta caixa enviada na mensagem.
Caso o parâmetro esteja configurado para ativar o auto incremento o Código da conta caixa no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o número da conta bancária enviada na mensagem única.
Ao receber/atualizar o Banco/Agência, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.
Integração / Integração / Mensagem Única / De-Para
Logix
A integração ocorre pela mensagem AREAANDLINEOFBUSINESS, portanto deve estar habilitada para envio. Disparamos a mensagem através dos programas VDP0340 e VDP10056 (Área Estratégica de Negócio).
Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno "AreaAndLineOfBusinessInternalId" que será utilizado nas integrações de títulos, lançamentos contábeis, entre outras. Portanto, é imprescindível o retorno testa informação.
RM
Para o RM receber a integração de Item Contábil (Área e Linha de Negócio) é necessário que a entidade AREAANDLINEOFBUSINESS na versão 1.000 esteja configurada na integração juntamente com o evento e9e9d0bf-32d6-4343-9531-92d174f92faf (Tratamento de item contábil).
Existem três pontos para visualizar os registros integrados de item contábil (Área e Linha de Negócio):
No intuito de evitar cadastros duplicados, e tornar possível utilizar as mesmas informações para mais de uma integração, foi padronizado para que ambos menus apontem para a mesma tela (Tela de item contábil do módulo Educacional).
Item contábil no módulo Educacional:
Ao receber/atualizar o Item Contábil (Área e Linha de Negócios), o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.
Integração / Integração / Mensagem Única / De-Para
Após recebimento, o Item Contábil (Área e Linha de Negócio) poderá ser vinculado ao Funcionário, na Seção, e no Agrupamento de Contas através do lookup disponibilizado nas respectivas telas.
RM / Folha de Pagamento / Administração de Pessoal / Funcionários
Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Item Contábil.
RM / Folha de Pagamento / Administração de Pessoal / Seções
Na tela de cadastro de Seção acesse: Dados Contábeis / Item Contábil.
RM / Folha de Pagamento / Encargos / Contabilização – Cadastros / Cadastros Contábeis / Agrupamento de Contas
Na tela de cadastro do Agrupamento de Contas: Item Contábil (Área e Linha de Negócio).
Obs 1: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver desmarcado, o campo deverá ficar oculto
Obs 2: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver marcado e os parâmetros "Agrupar partidas contábeis por Item Contábil" e "Gerar lanctos rateados por Item Contábil" estiverem desmarcados, o campo deverá ficar desabilitado.
Logix
Disparamos a mensagem ACCOUNTINGCALENDAR a partir dos programas CON0050 e CON10009 (Períodos contábeis). É importante ressaltar que esta mensagem enviará uma lista contendo todos períodos e segmentos de períodos da empresa corrente.
A mensagem só é disparada em operações que envolvam o menor ou maior período cadastrado para a empresa. Sendo assim ao incluir um período, que seja posterior ao maior período cadastrado, será enviado uma mensagem contendo todos os períodos e segmentos da empresa. Da mesma forma ao incluir um período anterior ao menor período já cadastrado. A modificação ou exclusão do maior e menor período também dispara a mensagem. As demais operações não geram integração, pois para o RM a informação relevante são os limites inferior e posterior de período do calendário.
RM
Para o RM receber a integração de Período Contábil é necessário que a entidade ACCOUNTINGCALENDAR na versão 1.000 esteja configurada na integração juntamente com o evento d1f09a24-9148-4e2d-8e17-bc5a76c9f933 (Período contábil).
Nesse processo de integração, o lado RM atualizará as datas de período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Logix. No Logix, essas informações são armazenadas em um cadastro, e no Rm essas informações são armazenadas nos parâmetros, sendo assim, teremos espaço para armazenar somente uma dataIncial e uma dataFinal.
Para esta integração não é salvo um cadastro De-Para porque o período contábil é um parâmetro que não tem uma tela de cadastro, para a sua atualização é realizado um update em seu registro direto no banco de dados.
Logix
A sincronização do histórico padrão ocorre através da mensagem LISTOFACCOUNTANTDEFAULTHISTORY e é disparada a partir dos programas CON0020 e CON10002 (Histórico padrão dos lançamentos contábeis). Este código é utilizado no lançamento contábil das movimentações da folha de pagamento para a integração com a contabilidade Logix,
Para as empresas que utilizam a centralização do histórico contábil (Empresa histórico padrão) será envia uma lista onde o histórico padrão será replicado para cada empresa que compartilha o histórico. Conforme exemplo:
Empresa 01 e 02 compartilham o mesmo cadastro de histórico. Então a mensagem de integração conterá uma lista com informações de histórico para a empresa 01 e para a 02.
Atenção: será gravado o internalid "AccountantDefaultHistory" no de-para do Logix somente para a empresa do histórico.
RM
Para o RM receber a integração de Histórico Padrão é necessário que a entidade LISTOFACCOUNTANTDEFAULTHISTORY na versão 2.000 esteja configurada na integração juntamente com o evento 41559d6e-9713-492f-b395-f1e807c32b22 (Tratamento de histórico padrão).
Esta integração se fez necessária devido ao Logix permitir vincular o mesmo histórico padrão para um grupo de empresas.
Ex:
Empresa 01 e 02 utilizam o histórico padrão 01
Empresa 03, 04 e 05 utilizam o histórico padrão 02
Considerando que o De-Para de empresas esteja configurado da seguinte forma:
O RM deverá salvar da seguinte maneira:
Ao receber/atualizar o Histórico Padrão, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.
Integração / Integração / Mensagem Única / De-Para
Logix
A mensagem LISTOFCOSTCENTER é utilizada para a integração do cadastro de centro de custos.
Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será envia uma lista onde o centro de custo será replicado para cada empresa que compartilha o histórico. Conforme exemplo:
Empresa 01 e 02 compartilham o mesmo cadastro de centro de custo. Então a mensagem de integração conterá uma lista com informações de centro de custos para a empresa 01 e para a 02.
Atenção: será gravado o internalid "CostCenter" no de-para do Logix somente para a empresa do plano.
RM
Para o RM receber a integração de Centro de Custo é necessário que a entidade LISTOFCOSTCENTER na versão 2.001 esteja configurada na integração juntamente com o evento 670be9e3-f144-4ac9-91f3-1a8eee3c1355 (Tratamento de centro de custo).
Esta integração se fez necessária devido ao Logix permitir vincular o mesmo centro de custo para um grupo de empresas.
Ex:
Empresa 01 e 02 utilizam o centro de custo 01.01
Empresa 03, 04 e 05 utilizam o centro de custo 01.02
Considerando que o de-para de empresas esteja configurado da seguinte forma:
O RM deverá salvar da seguinte maneira:
Para a mesma também é necessário que a integração tenha o parâmetro RH_ CENTROCUSTOAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.
O parâmetro RH_ CENTROCUSTOAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “GCCUSTO. CODCCUSTO”.
Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “GCCUSTO. CODCCUSTO” a conta caixa enviada na mensagem de acordo com a máscara do centro de custo enviada pelo Logix.
Ex: “QQQQQQQQ” [permite qualquer caractere limitado a 8 posições].
Caso o parâmetro esteja configurado para ativar o auto incremento o Código do Centro de Custo no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o código informado na mensagem única. Nesse caso, o parâmetro “Máscara do Centro de Custo” deve ser preenchido como “QQQQQQQ” [qualquer caractere].
Ao receber/atualizar o Centro de Custo, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.
Integração / Integração / Mensagem Única / De-Para
Obs.: Os centros de custos serão sincronizados com a GCCUSTO e a PCCUSTO (inclusão/alteração/exclusão).
Após o recebimento o Centro de Custo poderá ser vinculado ao Funcionário através do lookup disponibilizado no cadastro de Funcionários.
RM / Folha de Pagamento / Administração de Pessoal / Funcionários
Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Centro de Custo.
Logix
O plano de contas é integrado pela mensagem LISTOFACCOUNTANTACCOUNT que é disparada pelos programas CON0010 e CON10001 (Plano de contas).
Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será envia uma lista onde a conta contábil será replicado para cada empresa que compartilha o histórico. Conforme exemplo:
Empresa 01 e 02 compartilham o mesmo plano de contas. Então a mensagem de integração conterá uma lista com informações da conta contábil para a empresa 01 e para a 02.
Atenção: será gravado o internalid "AccountingEntry" no de-para do Logix somente para a empresa do plano.
RM
Para o RM receber a integração de Plano de Contas é necessário que a entidade LISTOFACCOUNTANTACCOUNT na versão 2.002 esteja configurada na integração juntamente com o evento 9f0f85bf-f5c8-4ecb-b439-783acd087e11 (Tratamento de conta contábil).
Esta integração se fez necessária devido ao Logix permitir vincular o mesmo plano de contas para um grupo de empresas.
Ex:
Empresa 01 e 02 utilizam o plano de contas P001
Empresa 03, 04 e 05 utilizam o plano de contas P002
Considerando que o de-para de empresas esteja configurado da seguinte forma:
O RM deverá salvar da seguinte maneira:
Ao receber/atualizar o Plano de Contas, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.
Integração / Integração / Mensagem Única / De-Para
Obs 1: O campo “CCONTA.NATSPED” não é enviado pela mensagem pois o mesmo deve estar somente no BackOffice. Por ser obrigatório no RM, ao receber a mensagem de Plano de Contas o mesmo será gravado com o valor “00” (Não informada).
Obs 2: A máscara parametrizada da conta contábil no RM será validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado sem máscara contábil para possibilitar o recebimento pelo Logix. Com isso o sistema poderá montar a árvore de plano de contas que atenda o Logix e esteja dentro das regras do RM.
RM
Para o RM enviar a integração de Lançamento Contábil ao Logix é necessário que a entidade ACCOUNTINGENTRY na versão 2.002 esteja configurada na integração juntamente com o evento xrf09a24-9148-4e2d-8e17-t15a76c9f999 (Envio de lançamentos contábeis).
Gerar os lançamentos contábeis
Para o processo de geração de lançamentos contábeis segue os critérios de aceitação:
Obs.: O parâmetro "Utiliza o cálculo por centro de custo" deverá estar desmarcado.
Para enviar o lançamento Contábil via integração com Logix é necessário acionar o processo:
RH / Folha de Pagamento / Encargos / Contabilização – Lançamentos / Lançamentos / Processos – Integração contábil com outros BackOffices
Ao finalizar o processo é criado um registro na Fila de Mensagem do EAI, nele é possível consultar o status da mensagem enviada ao Logix.
Logix
Para que o Logix recepcione e processo com sucesso a mensagem de lançamento contábil (ACCOUNTINGENTRY) é necessário efetuar as seguintes configurações:
Os lançamentos gerados pela integração são gravados na tabela "ctb_lanc_ctbl_ctb", pois sua origem não é o Logix.
Na recepção da mensagem são efetuadas algumas validações, como: período contábil valido, conta contábil ativa, AEN válida, valor de crédito e debito corretos, entre outras validações. Caso encontre alguma inconsistência a mensagem é devolvida com indicador "ERROR" e a descrição do erro encontrado, a operação é desfeita ou seja, os lançamentos não são gravados.
Após a recepção ser efetuada com sucesso o lote poderá ser consultado no CON10000 (Consulta de lançamentos por origem) utilizando o botão de origem "Contabilidade".
Os lotes integrados pelo EAI não são automaticamente efetivados. A efetivação deve ser realizada pelo CON10019 (Consistência/Efetivação de lançamentos) . Na aba "Lotes manuais" selecionar os lotes a serem efetivados.
A mensagem de lançamento contábil está preparada para receber lotes contábeis de forma particionada. Isto é, em situações em que o volume de lançamentos é muito grande, pode ocorrer queda no desempenho do processamento gerando lentidão e até mesmo erro de "TIME OUT". Então, disponibilizamos a opção da integração segmentada em partes menores, conforme regras abaixo:
RM
Para o RM enviar a integração de Lançamento Financeiro ao Logix é necessário que a entidade ACCOUNTPAYABLEDOCUMENT na versão 2.002 esteja configurada na integração juntamente com o evento 2810e737-4e2c-4321-ac27-3b398cc4d7fb (AccountPayableDocument_2_002).
Gerar os lançamentos financeiros:
Para ratear o lançamento financeiro por Item Contábil (Área e Linha de Negócio)/Classe de valor é necessário seguir os seguintes critérios de aceitação:
Para enviar o lançamento Financeiro via integração com Logix é necessário acionar o processo:
RH / Folha de Pagamento / Encargos / Contabilização – Lançamentos / Lançamentos / Processos – Integração contábil com outros BackOffices
Ao finalizar o processo é criado um registro na Fila de Mensagem do EAI, nele é possível consultar o status da mensagem enviada ao Logix.
LOGIX
Abaixo encontra-se o detalhamento da Integração Financeira, na qual os Títulos do RM serão integrados no módulo Financeiro Logix.
Pré-requisitos:
Parametrizar a geração automática de APs para todos os fornecedores envolvidos na integração. Conforme abaixo:
VDP10000 Fornecedores > Informações bancárias > campo “Gera ordem de pagamento?” = “NF’S e conhecimento”. Ou no VDP0815: Fornecedores > Inf. Bancárias > campo “Indicador de geração de APs” = “S”;
Campo | Conteúdo | ||||||
---|---|---|---|---|---|---|---|
Tabela | TIPO_DESPESA | ||||||
Sistema integração | RM | ||||||
DE:
| |||||||
Para:
|
Atenção: Repetir o cadastro para todos os tipos de despesas que serão utilizados na integração.
Nota: Este procedimento não será necessário no caso dos códigos em ambos os sistemas serem iguais.
Para a integração de títulos poderão ser definidas AENs padrão, que serão utilizadas quando esta informações não constar no XML de integração. Os parâmetros ficam localizados no LOG00087 > Administração Logix > Controle geral > Integração entre sistemas:
Parâmetro | Objetivo |
---|---|
Linha produto padrão | Definir o código da linha de produto padrão |
Linha receita padrão | Definir o código da linha de receita padrão |
Segmento mercado padrão | Definir o código do segmento de mercado padrão |
Classe uso padrão | Definir o código da classe de uso padrão |
Os títulos gerados pelo RM serão incluídos como AD (Apropriação de Despesas) no Logix, na inclusão também será gerada a AP (Autorização de pagamento). Em caso de inconsistência ou erro a mensagem de integração será recusada e o motivo gravado para consulta no monitor do EAI (EAI10000).
Após a implantação do título ser efetuada com sucesso o Logix retornará uma resposta (XML) contendo informações do processamento e o número do título na origem (RM) e destino (LOGIX). Esta informação também pode ser consultada no monitor no EAI.
O título poderá ser consultado no FIN30058 (Apropriações de despesa). Note que a origem da AD será: "INCLUÍDA VIA INTEGRAÇÃO COM OUTROS SISTEMAS" e a aba de informações complementares conterá a chave do título no RM.
A relação dos títulos na origem e no destino também poderá ser consultada no EAI10000 > Aplicativos Externos > "Consulta De/para", utilizando o filtro abaixo:
A integração também permite modificar e excluir títulos, porém somente será permitido se as regras de negócio aplicadas ao Logix foram atendidas, como: titulo não pode estar pago, não pode estar contabilizado, entre outras validações do produto padrão Logix.
A integração de títulos utiliza a mesma API (FIN80030) de manutenção de títulos do produto padrão Logix, isso significa que títulos implantados pela integração ou manualmente no financeiro passarão pelas mesmas etapas de validação e processamento. Sendo assim, processo de contabilização, lançamento no fluxo de caixa, calculo de impostos etc. permanecem inalterados.
Após a integração o título fica sob responsabilidade do módulo financeiro, usuário do CAP poderá fazer alterações, cancelamento/exclusão, e/ou pagamento. Estas operações não geram retorno ao RM.
Pagamentos a autônomos - SEFIP
Os pagamentos a autônomos continuam sendo realizados no financeiro do Logix, assim como a retenção e o posterior pagamento dos impostos e tributos. No entanto, desenvolvemos um programa que enviará ao RM todas as informações de INSS de fornecedores autônomos para que seja consolidada com as informações do RH na geração do arquivo da SEFIP pelo RM.
Para a utilização desta rotina a mensagem única ExternalAutonomousPayment versão 1.0 deve ser configurada, no EAI10000, para envio.
O processamento é mensal, na tela deve-se informar as empresas que farão parte do processamento e a data de referência no formato mês/ano.
Serão enviadas ao RM as informações de retenção de INSS referentes ao mês indicado na tela. A tabela abaixo indica as informações contidas na mensagem única:
Campo | Descrição | Tabela.campo Logix |
CompanyId | Empresa Logix | cap_ret_inss_auton.cod_empresa |
BranchId | Nulo | Nulo |
CompanyInternalId | Empresa Logix | cap_ret_inss_auton.cod_empresa |
InternalId | Indentificador do registro | Chave da inss_auton |
TakerId | CNPJ do tomador do serviço | empresa.num_cgc |
TakerSpecificId | CEI do Tomador de serviços, quando o tipo do tomador for Construção Civil | par_cap_pad.cod_parametro='num_matricula_inss' (se par_cap_pad.cod_parametro='ies_tip_iden_inss' = '2') |
TakerType | O serviço foi executado para o segmento 1 = Cessão Mão de Obra ou 2 = Construção Civil | Se possuir CEI = 2 senão = 1 |
AutonomousName | Nome do fornecedor | fornecedor.raz_social |
DateOfBirth | Data de nascimento | sup_par_fornecedor.parametro ='dat_nascimento' |
AutonomousId | CPF do autonomo | fornecedor.num_cgc_cpf |
RegistrationNumber | Número de Inscrição do Trabalhador (NIT) | fornec_auton.num_inscr_inss |
AutonomousOcupationNationalCode | CBO - Código Brasileiro de Ocupação do Autônomo | fornec_auton.num_cbo |
AutonomousCategory | Categoria autonomo | sup_par_fornecedor.parametro='categoria_sefip' |
SefipEventCode | Código Ocorrência Sefip | sup_par_fornecedor .parametro='grau_risco' |
IssueDate | Data de emissão do pagamento | ad_mestre ou nf sup frete_sup (data de emissão) |
DueDate | Data de vencimento do pagamento | cap_ret_inss_auton.dat_moviment |
InitiationDate | Primeiro dia de prestação de serviço do autônomo | fornecedor.dat_cadast |
ServiceNature | Natureza do serviço (Atividade Rural ou Urbana) | Nulo. |
DependentsNumber | Quantidade de Dependentes Salário família | cap_forn_dep_sped_social.ind_receb_sal_fam='S' |
IRRFDependentsNumber | Quantidade de Dependentes IRRF | cap_forn_dep_sped_social.indica_deducao_irrf='S' |
PaymentValue | Valor bruto do pagamento | ad_mestre.val_tot_nf ou nf_sup.val_tot_nf_d e frete_sup.val_conhec |
INSSValue | Valor do INSS | cap_ret_inss_auton.val_inss |
O Logix armazena na tabela cap_integracao_inss_auton as chaves primarias de todos os registros enviados.
Atenção: Só poderá haver um processamento por mês/ano. Havendo necessidade de refazer o processamento de um período já processado, a mensagem abaixo será exibida:
O usuário deverá optar por continuar o processo (Sim) ou interromper (Não) .
Sim: Envia uma mensagem de com o evento "DELETE" contendo todos os registros enviados anteriormente ao RM. Em seguida é enviada uma nova mensagem com evento "UPSERT" contendo todos os registros de retenção de INSS de autônomos no período.
Não: Finaliza o processo sem qualquer alteração dos dados.
Atenção: durante o processamento desta rotina são efetuados os cálculos e ajustes referentes a desoneração de INSS (MP 563).
DIRF
As informações do financeiro para a DIRF não serão integradas ao RM. Desenvolvemos um novo programa chamado CAP6545 (Geração da DIRF) que seleciona as informações do módulo de contas a pagar (CAP) e gerando o arquivo de acordo com o layout da DIRF, desconsiderando as informações de movimentação da folha de pagamento.
Para mais informações acesse: http://tdn.totvs.com/pages/viewpage.action?pageId=224443168
DEPARA_ID | TABELA_INTERNA | CAMPO_INTERNO |
AccountantAccount | plano_contas | cod_empesa|num_conta|num_conta_reduz |
AccountantDefaultHistory | hist_padrao | cod_empresa|cod_hist |
AccountingCalendar | periodos | cod_empresa|per_contabil |
AreaAndLineOfBusinessInternalId | linha_prod | cod_lin_prod|cod_lin_recei|cod_seg_merc|cod_cla_uso |
Bank | agencia_bco | cod_agen_bco |
CostCenter | cad_cc | cod_empresa|cod_cent_cust |
CustomerVendorInternalId | fornecedor | cod_fornecedor |
Carga inicial de cadastro do Logix para RM
Checklist de Verificações:
Passos para Integração RM x ERP Logix