Totvs-RM

Sobre

O Driver TOTVS RM (DTR), foi desenvolvido para integrar as movimentações de COLABORADORES do sistema de folha de pagamento TOTVS-RM, utilizando os bancos de dados:

TOTVS-RM, SQLServer, leitura de algumas tabelas e/ou views, detalhadas a seguir;
nwayprototvs, SQLServer, configurações da integração NwayPro no mesmo nível TOTVS-RM e
nwaypro, PostgreSQL, banco de dados do controle de acesso NwayPro.

As movimentações serão executadas pelo DTR, observando os parâmetros DIAS DA SEMANA e FREQUENCIA de execução, os processos envolvidas são:

Admissões, serão incluídos os novos colaboradores e alocados nas unidades no NwayPro usando as unidades Coligadas e Sessões mapeadas do TOTVS-RM;
Demissões, os usuários serão inativados no NwayPro;
Férias, serão inativados na data de saída e ativados na data de retorno;
Afastamentos, serão inativados na data do início e ativados na data observando a quantidade de dias parametrizados.

O técnico responsável pelo banco SQLServer (DBA) do cliente, precisará:

Criar o banco de dados “nwayprototvs“ no mesmo esquema do totvs, que será dedicado aos controles das integrações.
Criar a view CodHorarioView no totvs utilizando a DDL abaixo.

Create view CodHorarioView AS
  select
  a.codcoligada,
  a.CODHORARIO,
  (select top 1 DESCRICAO from AHORARIO where codigo = a.codhorario and codcoligada = a.codcoligada) as Descricao,
  (select top 1 databasehor from AHORARIO where codigo = a.codhorario and codcoligada = a.codcoligada) as DataBaseHor,
a.INDINICIO,   
CASE
    WHEN a.INDINICIO BETWEEN 1 AND 7 THEN
        CASE ((a.INDINICIO + DATEPART(DW, (SELECT TOP 1 databasehor 
                                           FROM AHORARIO 
                                           WHERE codigo = a.codhorario 
                                             AND codcoligada = a.codcoligada)) - 2) % 7) + 1
            WHEN 1 THEN 'DOM'
            WHEN 2 THEN 'SEG'
            WHEN 3 THEN 'TER'
            WHEN 4 THEN 'QUA'
            WHEN 5 THEN 'QUI'
            WHEN 6 THEN 'SEX'
            WHEN 7 THEN 'SAB'
        END
END AS [DIAINICIO],      
a.BATINICIO as HORAINICIO,        
CASE
    WHEN a.INDFIM BETWEEN 1 AND 7 THEN
        CASE ((a.INDFIM + DATEPART(DW, (SELECT TOP 1 databasehor 
                                           FROM AHORARIO 
                                           WHERE codigo = a.codhorario 
                                             AND codcoligada = a.codcoligada)) - 2) % 7) + 1
            WHEN 1 THEN 'DOM'
            WHEN 2 THEN 'SEG'
            WHEN 3 THEN 'TER'
            WHEN 4 THEN 'QUA'
            WHEN 5 THEN 'QUI'
            WHEN 6 THEN 'SEX'
            WHEN 7 THEN 'SAB'
        END
END AS [DIAFIM], 
a.BATFIM as HORAFIM, 
a.INDFIM, 
  CASE WHEN ((select top 1 HORARIOJOR from AHORARIO where codigo = a.codhorario and codcoligada = a.codcoligada) = 1) THEN 'Sim' ELSE 'Não' END AS ESCALA,
  (select aindhor.descricao
   from aindhor        
   where  a.codcoligada = aindhor.codcoligada AND a.codhorario = aindhor.codhorario and aindhor.indiniciohor=a.INDINICIO) as LETRA
  from
  AJORHOR a;

Criar um usuário de login que irá acessar os dois bancos, descritos a seguir com as seguintes características:
1. Mapeamento > Banco de dados = Master | Esquema padrão = dbo (Proprietário do banco de dados) e permissões.
2. Funções de Servidor > Public e sysadmin nos bancos de dados a seguir:

nwayprototvs = acesso total (full control)
totvs (banco de dados da folha de pagamento) = apenas leitura (read).
Incluir usuário associado com limitação de visibilidade em “Esquema Proprietários” nas colunas das seguintes tabelas ou views (caso o cliente faça opção da integração não ler tabela diretamente), a seguir:

- PFUNC
	CHAPA
	CODCOLIGADA
	CODFILIAL
	CODHORARIO
	CODSECAO
	DATAADMISSAO
	DTTRANSFERENCIA
	DATADEMISSAO
	CODSITUACAO
	NOME
	CODFUNCAO
	CODPESSOA
 
- PPESSOA
	NOME
	CPF
	CARTIDENTIDADE
	RUA
	NUMERO
	COMPLEMENTO
	BAIRRO
	CEP
	CIDADE
	ESTADO
	TELEFONE1
	TELEFONE2
	EMAIL
	SEXO
	CODIGO
 
- PEXTERNO
	CODCOLIGADA
	CODEXTERNO
	CODPESSOA
	CODFUNCAO
	CODSECAO
 
- PFUNCAO
	CODCOLIGADA
	CODIGO
	NOME
 
- PSECAO
	CODCOLIGADA
	CODIGO
 
- PFUFERIAS
	CODCOLIGADA
	CHAPA
	PERIODOABERTO
	FIMPERAQUIS 
 
- PFUFERIASPER
	CHAPA
	DATAINICIO
	DATAFIM
	CODCOLIGADA
	FIMPERAQUIS 
 
- PFHSTAFT
	CODCOLIGADA
	CHAPA
	DTINICIO
	DTFINAL

Matriz de Versões

A seguinte matriz tem como intuito correlacionar o número da versão do NwayPro Driver Totvs RM com as datas de liberações. Clicando no link será direcionado para página de notas da versão, observar que existem outras páginas que fazem parte da documentação.

Versão	Data de Liberação

Versão	Data de Liberação
v2.10.0	05 de Dezembro de 2025
v2.9.1	05 de Novembro de 2025
v2.9.0	29 de Outubro de 2025
v2.8.0	28 de Maio de 2025
v2.7.0	12 de Fevereiro de 2025
v2.6.0	20 de Janeiro de 2025
v2.5.0	22 de Agosto de 2024
v2.4.0	27 de Maio de 2024
v2.3.1	09 de Abril de 2024
v2.3.0	13 de Novembro de 2023
v2.2.0	25 de Outubro de 2023
v2.1.0	20 de Março de 2023
v1.1.13	22 de Dezembro de 2021
v1.1.4	19 de Janeiro de 2022
v1.0.0	22 de Junho de 2021

Para consultar mais informações sobre a compatibilidade do NwayPro Driver Totvs RM acesse a página Versões e Compatibilidades