Histórico da Página

...

A TOTVS não orienta a natureza de rubrica a ser utilizada em cada verba, mas sugerimos validar o Manual de Orientação do Empregador em que, a partir da página 27 (item 5.2.1 Exemplos de Apuração da Remuneração Disponível) contam exemplos de cálculos, apresentando algumas naturezas também. 

03 - Parametrizador

03.001 - 

04 - Importação do Empréstimo - Crédito do Trabalhador

...

Veja mais detalhes do cálculo na documentação a seguir: Crédito do Trabalhador - Cálculo 35% da Margem Consignável

05.002 - Quais são os eventos considerados na margem consignável para desconto do empréstimo?

05.003 - Por que os campos "valor" e "número de parcela" aparecem zerados após o lançamento da folha?

05.004 - Qual é o comportamento que o sistema vai fazer quando não houver margem consignável?

...

Não é obrigatório. Para lançar a provisão do empréstimo Crédito Trabalhador nas férias deve marcar o parâmetro "Lança provisionamento do empréstimo Crédito Trabalhador nas férias" no menu No menu Configurações | Parametrizador | Férias | Empréstimos.
O lançamento do valor referente a provisão do empréstimo Crédito Trabalhador nas férias do funcionário deverá ser realizado automaticamente por meio do cálculo das férias, acessado pelo menu Administração de Pessoal | Funcionários | Movimento ! Férias.
Veja mais detalhes no TDN: https://tdn.totvs.com/pages/viewpage.action?pageId=925361639

06.002 - 

07 - Rescisão - Crédito do Trabalhador

07.001 - Como fazer para, na rescisão, o sistema considerar a margem de 35% e não o valor integral da parcela?07.002 - 

08 - eSocial - Crédito do Trabalhador

...

08.002 -  Poderiam informar quais são as naturezas de rubricas corretas do eSocial que devem ser utilizadas nos eventos relacionados ao Crédito do Trabalhador, incluindo provisões, proventos, descontos e códigos de cálculo como 481, 482, 483 e 484? Além disso, todos os eventos criados precisam ter rubrica vinculada?

Em relação às naturezas de rubrica do Crédito do Trabalhador, sugerimos consultar o Manual de Orientações do Empregador - Programa Crédito do Trabalhador disponibilizado no site do governo.
A partir da página 27 são demonstrados exemplos contendo, inclusive, a natureza de rubrica nos eventos relacionados ao empréstimo (desconto do empréstimo, provisão, provento da provisão, etc.).

Link do manual: Manual de Orientação Crédito do Trabalhador

Todos os eventos criados precisam ter natureza de rubrica, pois é uma informação obrigatória no XML do "S-1010 - Tabelas de Rubricas".

A partir do Leiaute S-1.3 do eSocial, foi disponibilizada a natureza de rubrica "9253 - Empréstimos eConsignado - Desconto" para diferenciar a rubrica de desconto do Crédito do Trabalhador dos demais empréstimos consignados. Sendo assim, essa natureza deve ser utiliza no evento de CC 480, visto orientação do Governo. Contudo, as demais verbas não possuem orientação direta do Governo quanto às naturezas de rubrica, sendo assim, fica à cargo do usuário do sistema definir a natureza que entende mais adequada.

A TOTVS não orienta a natureza de rubrica a ser utilizada em cada verba, mas sugerimos validar o Manual de Orientação do Empregador em que, a partir da página 27 (item 5.2.1 Exemplos de Apuração da Remuneração Disponível) contam exemplos de cálculos, apresentando algumas naturezas também. 

08.003 - O evento de desconto do Crédito do Trabalhador tem incidência de FGTS ou não? Há divergência entre a documentação da TOTVS, que orienta a criar o evento sem incidência, e o site do governo, que indica que há incidência. 

Na geração do eventoS-1010, quando o campo PEVENTO.NATRUBRICA está preenchido com o valor 9253, o sistema envia o código "31 - Desconto consignado" na tag codIncFGTS. Ou seja, há sim incidência de FGTS conforme essa configuração.

...

08.007 - Mesmo após a atualização do sistema, ainda é necessário criarmos manualmente as tabelas e os eventos de rubricas?

A rubrica 9253 - Empréstimos eConsignado - Desconto será criada automaticamente por meio do rmRM.atualizadorAtualizador.exe. Após a criação, será necessário apenas associá-la ao evento correspondente.

Para mais detalhes sobre as parametrizações, acesse:
👉 Documentação TOTVS - Crédito do Trabalhador

...

Não é necessário cadastrar, precisa apenas atualizar atualizar a tabela a partir do pacote informado no Link .

08.009 - É necessário atualizar o TAF para garantir a geração correta do XML? Existe alguma atualização específica recomendada?

Sim, é recomendável aplicar o último pacote de Expedição Contínua do TAF, garantindo assim que todas as correções e melhorias estejam contempladas na geração dos XMLs.
Você pode acessar o pacote mais recente através do link:
🔗 Expedição Contínua do TAF

09 - Erros Comuns x Soluções

09 - Erros/Dúvidas Comuns x Soluções

09.001 - Ao enviar o S-1200 e/ou S-2299 ocorre o erro de schema: Element '{http://www.esocial.gov.br/schema/evt/evtDeslig/v_S_01_03_00}nrDoc': [facet 'pattern'] The value 'xxxxxxxxxxxxxxx' is not accepted by the pattern '\d{8,12}'.

O erro ocorre devido aos Schemas do TSS estarem desatualizados, não estando em conformidade com a versão do leiaute S-1.3 NT 03/2025. Os novos Schemas aceitam na tag nrDoc 15 dígitos no número do contrato do empréstimo do Crédito do Trabalhador. Siga as orientações da documentação abaixo para atualizar os Schemas do TSS, e após conclusão, reenviar o evento S-1200/S-2299. Obs.: Tanto clientes Middleware quanto clientes TAF Full precisam atualizar o TSS.

Cross Segmentos - TSS - Atualização dos SCHEMAS

09.002 - Ao realizar a importação do arquivo do Portal Emprega Brasil, os valores do empréstimo ficaram incorretos.

Geralmente este problema ocorre devido ao separador do arquivo de importação estar incorreto. O arquivo exportado no Portal Emprega Brasil apresenta o caractere "," enquanto o RM considerava o caractere "." gerando assim divergência de valores na importação. Para ajuste, é necessário atualização do Patch conforme disponibilização abaixo na Central de Downloads do Portal do Cliente. Com a atualização, o sistema fará a conversão automática dos caracteres passando a importar corretamente os valores.
     - 12.1.2502.150
     - 12.1.2410.238
     - 12.1.2406.280

Como realizar atualização de patches da biblioteca

Obs.: Cliente CLOUD - Solicite atualização do seu ambiente abrindo um novo Ticket para a equipe Cloud RM ou, caso possua acesso ao TCloud, realize a atualização seguindo a documentação a seguir: Atualizar Patch do RM via T-Cloud

09.003 - Observei que no arquivo do Portal Emprega Brasil os números de CPF e CNPJ estão sem os zeros à esquerda. Qual procedimento realizar para ajuste?

O Ministério do Trabalho e Emprego divulgou um comunicado aos empregadores alertando um ajuste técnico necessário nos arquivos disponibilizados no Portal Emprega Brasil. Esses arquivos contêm os contratos de empréstimos consignados averbados entre 21 de março e 20 de abril de 2025, cujas parcelas devem ser descontadas na folha de pagamento de maio. No entanto, foi identificado que alguns registros apresentaram o campo de CPF dos trabalhadores sem os zeros à esquerda, o que resultou em CPFs com menos de 11 dígitos.

O MTE orienta os empregadores a ajustarem esses CPFs, inserindo os zeros à esquerda, para garantir que o número tenha a formatação correta. Além disso, o código da instituição financeira consignatária, presente nos arquivos, deve ser mantido exatamente como consta, preservando qualquer zero à esquerda, e não deve ser substituído por códigos de outras fontes.

Veja orientação completa no documento a seguir: Crédito do Trabalhador : CPF/CNPJ dos trabalhadores sem os zeros à esquerda

09.004 - Ao realizar a importação do arquivo do Portal Emprega Brasil é apresentada a mensagem de erro "Erro na leitura do Excel: [ diretório\arquivo.xlsx ] Mensagem: Falha na recuperação de fábrica de classes COM do componente com CLSID {xxxxxxxxxxxxxxx} devido ao seguinte erro: 80070005 Acesso negado. (Exceção de HRESULT: 0x80070005 (E_ACCESSDENIED)). - não está instalado no servidor". Como resolver?

Para este erro é necessária atualização do Patch conforme disponibilização abaixo na Central de Downloads do Portal do Cliente.
https://suporte.totvs.com/portal/p/10098/download#all/all/all/search/searchAll
     - 12.1.2502.150
     - 12.1.2410.238
     - 12.1.2406.280

Como realizar atualização de patches da biblioteca

Obs.: Cliente CLOUD - Solicite atualização do seu ambiente abrindo um novo Ticket para a equipe Cloud RM ou, caso possua acesso ao TCloud, realize a atualização seguindo a documentação a seguir: Atualizar Patch do RM via T-Cloud

09.005 - Ao realizar o lançamento de verbas pelo Grupo de Eventos é apresentada mensagem "Chapa XXXX: Parcela do empréstimo EMPT0000002 não foi lançada porque o evento XXXX já existe no envelope". Como resolver?

O erro ocorre pois o evento informado para compor a base de cálculo da remuneração do crédito trabalhador já está presente no envelope de pagamento, lançado por outro meio — como grupo de eventos, eventos adicionais ou códigos fixos. Quando o mesmo evento é incluído novamente via parametrizador do crédito trabalhador, o sistema impede o lançamento duplicado para evitar inconsistências. Veja orientações de ajuste na documentação a seguir: Crédito do Trabalhador - Chapa XXXX: Parcela do empréstimo não foi lançada porque o evento XXXX já existe no envelope09.001 -