Ajuda › Recursos Humanos

Recursos Humanos — Guia do zero

Este módulo coloca a pessoa no centro. Antes, um funcionário vivia em quatro lugares separados: um nome numa ficha de conta, outro registro na produção, um nome digitado livremente no livro de férias, uma conta de acesso. A mesma pessoa, quatro identidades separadas. Agora existe um único registro de funcionário; controle de ponto, remuneração, férias, saúde, guarda de bens e permissões, tudo se liga a ele.

1. Para que serve este módulo?

A janela Funcionários tem catorze abas. Ninguém usa todas; basta ler a que corresponde ao seu trabalho. Ainda assim, todos devem ler as Seções 2 e 3 — saber onde um registro é aberto elimina a pergunta "quem é este?" no fim do mês.

2. O registro do funcionário — onde tudo começa

Para um novo funcionário abre-se primeiro a ficha do funcionário e depois um período de vínculo. São coisas separadas, e a separação importa: a pessoa é definida uma só vez, mas pode entrar, sair e entrar de novo. No trabalho sazonal a mesma pessoa é contratada uma terceira vez; se guardássemos um único par de entrada–saída, o tempo de casa e o direito a férias já sairiam errados desde o início.

2.1 Dois campos obrigatórios

Matrícula e tipo de vínculo não podem ficar em branco. Sem matrícula, no fim do mês aparecem dois do mesmo nome. Sem tipo de vínculo (folha / terceirizado / autônomo / estagiário / serviço externo), a rotatividade, o custo por pessoa e o resumo do ponto quebram em silêncio: se um transportador terceirizado for contado no quadro, três relatórios saem errados de uma vez.

2.2 Quem vê os campos sensíveis?

Remuneração, número de identidade, conta bancária, informação de saúde e endereço são filtrados conforme o papel. Há aqui uma decisão de projeto importante: se você não tem permissão, o campo não aparece vazio, ele não chega de forma alguma. Mascarar com asteriscos engana — "existe algo mas não posso ver" também é informação. O encarregado lança o ponto mas não vê remuneração nem identidade; não é preciso para lançar o ponto.

3. Legislação — os números não ficam embutidos no código

O multiplicador de hora extra, o limite semanal, o número de dias de férias, o teto de desconto, o prazo de aviso prévio — são todos números que mudam conforme o país e nenhum deles está escrito dentro do programa. Ficam na aba Legislação e podem ser editados. Abrir em um novo país não exige código: copie o conjunto existente e mude os números.

As linhas cuja origem aparece como "Aguardando confirmação" são números que o programa supôs mas ainda não verificou. Confirme-os com seu contador ou consultor antes de usá-los na folha e atualize o registro. O aviso fica numa faixa amarela; não desaparece sozinho.

4. Jornada — turno, controle de ponto, hora extra

Um turno é um modelo: início, fim, intervalos e se o intervalo é remunerado. O turno da noite avança para o dia seguinte; o programa resolve isso sozinho — não abra um segundo registro porque "passou da meia-noite". O ponto é mantido dia a dia e cada dia tem um status: trabalhou, de férias, com atestado, acidente de trabalho, faltou, feriado.

4.1 Se você não tem relógio de ponto

Não é preciso aparelho. Uma marcação pode chegar por quatro caminhos: terminal compartilhado (um tablet na oficina, número do cartão + PIN — sem hardware extra), telefone (portal do funcionário), importação CSV (se você já tem um aparelho) e lançamento manual. Venha por onde vier, a marcação bruta é escrita no mesmo livro.

10. Datas do pessoal: período de experiência, contrato por prazo determinado, exame médico

5. Competência — nem todos podem assumir qualquer máquina

Qual máquina um operador pode conduzir, qual operação pode executar e qual decisão pode tomar fica registrado. Onde existe uma exigência de competência definida, o programa bloqueia: quem não tem a qualificação não pode apontar aquele trabalho. Onde não há exigência definida, nada é bloqueado — instalar o pacote não para uma produção em andamento.

A matriz de competências mostra ainda o risco de ponto único: se só uma pessoa sabe fazer um trabalho, o trabalho para quando ela sai de férias. O painel mostra esse número em vermelho; é um aviso antecipado para formar uma segunda pessoa.

6. Saúde e segurança do trabalho

Um exame médico pode impor uma restrição: "não pode trabalhar em ambiente ruidoso", "não pode levantar cargas". A partir do momento em que é registrada, a restrição impede a designação. Não é um aviso; a designação para aquele ambiente ou função fica impossível. A restrição é específica do agente: quem tem restrição a ruído pode ser designado para um trabalho com poeira.

A mesma lógica funciona em mais três lugares: quem é menor de 18 anos não pode ser designado para turno noturno nem para ambiente com exposição; quem não tem o certificado obrigatório (carteira de motorista, certificado de operador) não pode ser designado àquele equipamento; e quando a vida útil do EPI vence, o item cai na lista de renovação.

7. Ganhos — produção por peça, comissão, viagens, veículos

7.1 Produção por peça

A tabela de preços é mantida por operação × produto e é vinculada à data; após um reajuste, os registros antigos ficam com a tarifa antiga. Duas regras são fixas: refugo não se paga (pagar por peça sem aprovação da qualidade derruba o sistema de produção por peça) e sem aprovação da qualidade não nasce direito.

O ganho por peça não pode ficar abaixo do salário mínimo. A diferença é complementada pela empresa e aparece em uma coluna separada do resumo — para que "produção por peça" e "complemento de garantia" não se confundam no holerite. O salário mínimo é informado na aba Legislação; se não tiver sido informado, o complemento não é calculado. Melhor não produzir nada do que produzir um número inventado.

7.2 Comissão — três etapas

A comissão não é paga em um único passo; ela passa por três estados:

1. Provisionada — a venda foi faturada e a comissão calculada, mas ela ainda não foi ganha.

2. Ganha — o dinheiro foi recebido. Esta é a regra padrão: não se paga comissão sobre venda não recebida.

3. Estorno — a mercadoria foi devolvida ou não foi possível receber. Se a comissão não foi paga, ela é cancelada; se foi paga, não é apagada — é marcada como "a recuperar" e sai como desconto na folha seguinte. O rastro de um valor pago não pode sumir.

Um estorno não pode ser feito sem justificativa. Se o campo de motivo ficar vazio a operação é recusada; seis meses depois, a resposta para "que desconto foi esse?" precisa estar no registro.

7.3 Comissão de equipe

Em alguns trabalhos a comissão cabe à equipe e não à pessoa, e depois é dividida conforme a cota de cada um. A soma das cotas não precisa dar 100 — pode-se dar uma cota extra ao encarregado; o programa faz a proporção sobre o total. O resto dos centavos é somado à maior cota, de modo que o total distribuído fique exatamente igual ao valor concedido.

7.4 Viagens, veículos e multas

A viagem é aberta e fechada no retorno; o número de dias e a diária são calculados automaticamente. Uma viagem abaixo do limite de horas conta como meio dia. As despesas (hospedagem, alimentação) são vinculadas à viagem e o valor a pagar é somado como diária + despesas + valor da viagem.

A guarda do veículo responde à pergunta "quem está usando qual veículo". Um veículo pode estar com uma só pessoa por vez; não pode ser passado a outra sem ser devolvido antes. O lançamento de combustível e quilometragem pode ser feito pelo motorista no próprio telefone, mas somente para o veículo sob sua guarda.

8. O portal do funcionário e o aplicativo de telefone

O trabalhador do chão de fábrica não tem conta no programa e nem precisa ter. O portal usa uma identidade separada: matrícula + PIN. O RH abre a conta (aba Contas do portal); se nenhum nome de usuário for dado, usa-se a matrícula — é a única coisa que se lembra no chão de fábrica.

O que dá para fazer pelo portal: marcação de turno (um toque), comunicado de produção, lançamento de inventário do depósito, solicitação de férias, quilometragem/combustível do veículo e o próprio resumo (saldo de férias, itens sob guarda, documentos a vencer). O endereço no navegador é /personel.

8.1 Primeiro, entrar no portal: matrícula + PIN

O portal é aberto acrescentando /personel ao endereço do programa no navegador — por exemplo http://192.168.100.24:5173/personel. Aparecem duas caixas: Matrícula / usuário e PIN. Isto não é um usuário do HNR: a pessoa do chão de fábrica não tem conta no programa, o RH abre para ela uma identidade de portal separada. Se nenhum nome de usuário foi dado, usa-se a matrícula — é a única coisa que se lembra no chão de fábrica.

8.1A Se a conta do portal mudou: 409 e atualizar

A conta do portal pode ser aberta por dois usuários de RH ao mesmo tempo. Agora quem grava por último já não sobrescreve o anterior em silêncio. Se, depois de você abrir a lista, outra pessoa alterar o PIN, a situação de ativo ou o papel dessa conta, você recebe o aviso 409 / registro alterado ao gravar.

• Este aviso não é erro, é proteção. Atualize a lista primeiro; a nova versão, a nova situação de ativo e o novo papel aparecem na tela.
• Depois digite de novo apenas aquilo que você realmente quer mudar. Ao redefinir o PIN, os campos de situação de ativo e de papel já não mudam sozinhos.

8.2 O que há na aba Turno?

A aba tem três cartões, e a ordem é proposital: primeiro o que fazer agora, depois o que você fez hoje, e por último o que você vai fazer nesta semana.

8.3 Como ler a tabela do plano

Acima da tabela vem escrita a faixa da semana (ex.: 17.08.2026 → 23.08.2026). Há três colunas:

8.4 O plano e o histórico de marcações não são a mesma coisa

Como as duas tabelas ficam lado a lado, elas acabam sendo confundidas. A diferença é jurídica e prática: o plano é uma intenção, a marcação é uma prova. Seu ponto, sua hora extra e seu salário são calculados pela marcação, não pelo plano.

8.5 Passo a passo: "Em que turno eu estou amanhã?"

1. Abra o portal no navegador do telefone (toque no ícone se você criou um atalho na tela inicial). Se sua sessão ainda estiver aberta você entra direto; se não, matrícula + PIN.
2. Toque na aba Turno. A tabela do plano é buscada de novo cada vez que você entra na aba — ou seja, o que você vê é sempre o último plano; não é preciso recarregar a página.
3. Role a página para baixo até o cartão Meu plano semanal de turnos. A linha destacada é hoje; a linha logo abaixo é amanhã. Leia o nome do turno e a faixa de horário.
4. Se a linha de amanhã trouxer um selo laranja, leia o texto — foi lançada uma situação especial para aquele dia (férias, troca…). Se houver um texto pequeno abaixo da célula do turno, é a observação do supervisor.
5. Se você fizer a mesma pergunta num domingo, a resposta não está na tabela: ela mostra apenas a semana em que você está, e a segunda-feira abre como uma nova semana. Para saber a semana seguinte, pergunte ao seu supervisor.

8.6 O plano de turnos — perguntas frequentes

A tabela diz "nenhum plano lançado para esta semana".

Isto não é um erro; nenhuma linha foi escrita para você ainda naquela semana. A causa costuma ser uma de duas: o plano não foi preparado, ou foi lançado em outra matrícula e não na sua. Pergunte ao seu supervisor se o plano desta semana foi lançado — do lado do RH isso se vê de relance na tela Plano de turnos.

O nome do turno aparece, mas o horário está "—".

A informação de horário não vem do plano, e sim da ficha do turno. Se não houver minuto de início/fim definido na ficha, o portal não inventa: mostra honestamente "—". A solução está no RH: informe a faixa de horário naquela ficha de turno e ela cai na tabela na consulta seguinte. Sua linha do plano não é afetada.

Posso ver o plano de um colega?

Não — e isso é proposital. Quando o portal pede o plano, ele lê a matrícula não do seu telefone, mas da sessão obtida na entrada. Não há como pedir outra matrícula mexendo no endereço; diga o que disser o pedido, o servidor usa a matrícula do próprio registro dele. A mesma proteção vale para marcações, solicitações de férias e lançamentos de veículo.

O plano pula um dia no turno da noite?

Não. Os limites da semana e o destaque de "hoje" são calculados com o calendário local do servidor — feito assim de propósito para evitar que a data recue um dia nos turnos que passam da meia-noite. Se você abrir a tabela às 23:00, a linha destacada continua sendo a daquele dia.

O portal não abre / diz "sessão necessária".

"Sessão necessária" indica que o prazo de 8 horas terminou: entre de novo com matrícula + PIN, nada é perdido. Se a página não abrir de jeito nenhum, o problema quase sempre é de rede — o telefone e o servidor estão na mesma rede, o endereço está certo (http:// e a porta), há firewall bloqueando. O terceiro é a causa mais comum e a solução está com o seu administrador de sistema.

É por isso que a janela Funcionários tem uma aba Aprovações. Os rascunhos de inventário ficam ali ao lado da quantidade do livro, com a diferença mostrada; ao aprovar, a ficha é emitida. Os comunicados de produção pendentes são contados na mesma tela.

Os aplicativos de telefone usam os mesmos endereços; não existe uma interface separada. Nenhuma chave compartilhada fica guardada no aparelho — o único segredo é o PIN da pessoa. Depois de cinco tentativas erradas a conta é bloqueada por pouco tempo, e o bloqueio é por pessoa: num terminal compartilhado, o erro de um não bloqueia os demais.

9. Pacote de defesa — selos, alçada de assinatura, acesso

Este pacote é opcional; sem ele o módulo funciona exatamente igual. Ele existe para empresas que fabricam peças para a indústria de defesa ou para a aviação.

O selo da qualidade é um bem físico sob guarda: seu número, com quem está e quando foi entregue ficam registrados. Um selo não pode estar com duas pessoas ao mesmo tempo. Um selo perdido é cancelado, e o cancelamento não pode ser desfeito: aquele número nunca mais é entregue, porque toda peça marcada com ele precisa continuar rastreável e um novo dono embaralharia o rastro.

A alçada de assinatura depende do assunto e do valor. A distinção crítica é esta: algumas alçadas não podem ser delegadas. Dizer "o gerente está de férias, que o substituto assine" elimina a própria razão de existir deste pacote nas alçadas ligadas à qualificação, como a liberação da qualidade ou a aprovação da primeira peça. O programa recusa esse tipo de procuração. Nas alçadas delegáveis, o limite do substituto não pode ultrapassar o de quem delegou — é cortado automaticamente se pedirem mais.

O acesso ao projeto pode ser vinculado a um grau de sigilo e a um termo de confidencialidade assinado. Onde há regra definida, o programa não concede o acesso; é recusa, não aviso. O grau é hierárquico: quem tem grau "secreto" não pode entrar num projeto que exige "ultrassecreto". Onde não há regra definida, nada é bloqueado.

10. Disciplina e desligamento

Nenhuma decisão disciplinar pode ser registrada sem a defesa. Isto é um bloqueio, não um aviso; uma punição sem defesa é viciada no procedimento e não se sustenta em juízo. O fluxo é: registrar o fato → solicitar a defesa → receber a defesa → decidir. Se a defesa não chegar no prazo, essa circunstância é lavrada em ata e a decisão é registrada nessa base.

Em fatos repetidos do mesmo tipo, o grau sobe automaticamente (advertência verbal → advertência escrita → desconto → demissão). Você não precisa digitar o grau à mão; o programa o conta a partir dos registros anteriores.

10.1 Baixa do funcionário

No desligamento abre-se uma lista de verificação: devolução do selo, guarda de caixa/cheques/talão de recibos, chaves do veículo, encerramento dos acessos ao sistema e aos projetos, cancelamento do cartão, encerramento da conta do portal, transferência da carteira, acerto das férias restantes, termo de quitação. Enquanto os itens obrigatórios não forem marcados, a janela não diz "liberado para sair".

No painel direito da ficha da pessoa há ainda um resumo da situação de baixa: bens sob guarda em aberto, selos em aberto, acessos em aberto, veículos sob guarda, saldo de férias e comissões não pagas aparecem de relance. Olhe aqui antes de entrar na entrevista de desligamento.

11. Formulários de registro e anexos

O módulo Funcionários já não é apenas uma tela de listas e decisões. Os formulários de registro cobrem todos os campos opcionais da pessoa, o período de vínculo, a definição de turno e rotação, a ligação com a marcação bruta, o pacote de acesso e defesa, a escolha de legislação, os dados de comissão e de produção por peça e os anexos de férias, SST, EPI e entrada-saída.

📷 Tela real

Observação: não foi capturado um PNG novo para os formulários de RH. Esta tela existente é a imagem real mais próxima, representando o comportamento de metadados, classe de segurança e identidade de arquivo do painel de anexos comum.

11.1 Configuração de turnos e padrões — antes do ponto

A ficha do turno define o horário de trabalho; o padrão define a ordem de repetição desses turnos dia a dia. O gestor de RH registra primeiro, na seção Tempo → Turnos, o código do turno, o nome, o início e o fim e a condição de virada de dia/noite. Depois, na seção Padrões, coloca os códigos de turno em sequência; para o dia de descanso usa X.

1. Salve os horários dos turnos diurno/escritório, manhã, tarde e noite. Se o turno da noite terminar no dia seguinte, verifique a virada de dia.
2. Para o escritório monte, por exemplo, G,G,G,G,G,X,X; para uma produção em três turnos, S,S,A,A,N,N,X,X. Use no padrão apenas códigos de turno cadastrados; X significa dia de folga (não trabalhado) e não precisa ser um código de turno cadastrado.
3. Aplique o padrão a um funcionário de teste com uma data inicial. Se a ordem estiver correta no plano de oito dias, aplique em lote para a equipe.
4. Confira o plano semanal e o portal do funcionário. Horário “—” significa ficha de turno incompleta; sem nome de turno, o padrão ou o plano não foi aplicado.
5. Abra o período de ponto só depois de concluída essa verificação. Não apague o plano antigo; registre a mudança com uma nova data de vigência.

12. Painel — o resumo de hoje

O painel responde a três perguntas: como está o quadro (pessoas ativas, admitidas, desligadas, rotatividade), o que está pendente (solicitações de férias, comunicados de produção, rascunhos de inventário, documentos a vencer, disciplina em aberto) e onde está o risco (acidentes de trabalho, dias perdidos, risco de ponto único).

A rotatividade é a razão entre o número de desligados e o quadro ativo. Se o quadro for zero, ela não é calculada e mostra-se "—"; dizer que não dá para calcular é o certo, inventar um número dividindo por zero não é.

13. Erros frequentes

• Abrir a ficha do funcionário e não abrir o período de vínculo. A ficha sozinha não torna alguém empregado; quem não tem período não é contado no quadro e não consegue entrar no portal.

• Esperar marcações do portal sem informar o número do cartão. A marcação se liga ao número do cartão; quem não tem número não consegue marcar. A mensagem de erro diz isso.

• Esperar a garantia da produção por peça sem informar o salário mínimo. Se o salário mínimo estiver 0 na Legislação, o complemento não é calculado — não é defeito, é a decisão de não inventar um número.

• Esquecer de aprovar o rascunho de inventário. O estoque não muda só porque alguém do chão de fábrica lançou uma contagem. Se houver linhas esperando na aba Aprovações, seu inventário ainda não foi atualizado.

• Deixar aberta a conta de portal de quem saiu. O resumo de desligamento conta isso como impedimento. Quem não tem vínculo ativo já não consegue entrar, mas encerrar a conta é um item da lista.

14. Formulários de registro › "Inclusão de funcionários em lote (CSV / lista)" e o campo "Data de admissão"

Lançar um turno de cinquenta pessoas abrindo ficha por ficha significava abrir também um período de vínculo para cada ficha — cem operações. Chegaram duas facilidades. (1) "Data de admissão (abre o período junto)": se você preencher esse campo na ficha do funcionário, a ficha e o período de vínculo são abertos na mesma operação; se o período não puder ser aberto (por exemplo, já existe um período em aberto), a ficha também não é gravada — não ficam registros pela metade. (2) O cartão "Inclusão de funcionários em lote (CSV / lista)": cole a lista copiada do Excel, informe uma data de admissão comum e clique em Enviar.

1. RH › Formulários de registro › abra o cartão "Inclusão de funcionários em lote (CSV / lista)".
2. Cole as linhas. O separador pode ser ;, , ou tabulação. A linha de cabeçalho é opcional; sem ela espera-se a ordem fixa: sicilno;ad;soyad;istihdam_tipi;giris;departman_kod;gorev_kod;telefon.
3. Informe, se quiser, uma data de admissão comum (usada quando a linha não traz giris). Clique em Enviar.
4. O resultado vem linha a linha: número de sequência, número do período ou o texto do erro. Se uma linha falhar, as outras continuam sendo gravadas — o sucesso parcial é normal; corrija as linhas com erro e reenvie apenas elas.

Permissão: o papel de gestor de RH ou administrador do sistema. Limites e mensagens: uma matrícula que aparece duas vezes na mesma lista é recusada com "SICIL_TEKRAR" antes de chegar ao banco de dados; uma matrícula já cadastrada dá "matrícula já em uso" (409); mais de 500 linhas dá 413 — divida a lista; se todas falharem, 422. Cerca de 400 linhas por envio é o limite prático.

15. Bloqueio do portal: o freio de entrada conta apenas PINs errados e o bloqueio se abre sem espera

A entrada com "matrícula + PIN" da seção 8.1 tem duas proteções, e nenhuma delas trava mais a troca de turno:

15.1 Encontrar a conta certa numa lista cheia

Não procure a olho a conta bloqueada entre mais de cem contas de portal. Acima da tabela Funcionários › Contas do portal há uma caixa de busca (nome de usuário, matrícula ou nome) e um filtro "somente bloqueadas". Marque o filtro primeiro: a lista se reduz às linhas bloqueadas ou com tentativas erradas acumuladas — e o botão "Desbloquear" já só aparece nessas linhas.

16. Processos de penhora e o desconto do período

Os processos de penhora ficam no cartão Processos de penhora, na parte de baixo da aba Funcionários › Ganhos. Para abrir um processo são necessários o número do funcionário, o tipo (penhora ou pensão alimentícia), o número do processo, o valor principal e a data da intimação — a fila é montada por essa data, por isso ela é obrigatória.

16.1 A fila e o teto legal

O botão Calcular o desconto do período executa esta ordem: (1) os processos de pensão alimentícia vêm primeiro e ficam fora do teto; (2) os demais processos são ordenados pela data da intimação e pelo número de sequência, e não se passa ao seguinte antes de zerar o saldo de um processo; (3) a soma dos descontos de penhora não pode ultrapassar o percentual kesinti.icra_azami_oran da legislação sobre o salário líquido (25% no conjunto turco). Essa taxa é um parâmetro; não há número fixo no código, altera-se na aba Legislação.

16.2 Sem salário líquido NÃO há desconto

O desconto incide sobre o salário líquido. Se o contrato da pessoa não tiver um valor líquido aprovado, o programa não inventa uma penhora sobre o bruto: a pessoa é marcada com NET_UCRET_YOK e nenhum desconto é gerado. A solução é registrar o valor líquido no contrato.

16.3 Prévia e gravação são duas etapas separadas

Calcular o desconto do período (prévia) não grava nada; mostra, com a justificativa, quanto seria descontado de cada processo. O botão Gravar lança os descontos no livro, reduz os saldos dos processos e fecha sozinho o processo cujo saldo terminou. Se o mesmo período for gravado uma segunda vez, não se forma desconto em duplicidade — o valor já lançado no livro é abatido.

17. A aba Folha de pagamento — resumo, lista bancária, dados do SGK

A aba Funcionários › Folha de pagamento traz três subvisões: Resumo (ganhos e descontos por pessoa), Lista bancária (valor a pagar + conta) e Dados da declaração SGK. As três têm Baixar CSV no canto superior direito.

17.1 Este resumo é BRUTO

A faixa amarela no alto da tela não está ali à toa: nesta versão os descontos de previdência social e de imposto de renda NÃO são calculados. O resumo soma as rubricas já calculadas e aprovadas em cada módulo (salário bruto, produção por peça, comissão, hora extra, diária, adiantamento, desconto de veículo, penhora). Para o pagamento líquido, abata os descontos do seu programa oficial de folha; os valores da lista bancária não são uma ordem de pagamento.

17.2 As linhas "Não calculado" e a lista de pagamento

A pessoa com processo de penhora ativo cujo desconto do período ainda não foi calculado aparece com um selo vermelho Não calculado; as colunas Penhora e A pagar viram um traço (—) e a linha não entra na lista bancária — não sai em ordem de pagamento e é listada com a justificativa na seção "NÃO INCLUÍDOS na lista de pagamento". Antes essa situação derrubava o resumo inteiro; agora ela só marca aquela linha. Solução: grave o desconto do período pelo cartão Penhora, na aba Ganhos.

17.3 Lista bancária: soma de verificação e conta suspeita

A lista bancária dá o número de registros, o total em centavos e o resumo SHA-256 das linhas; compare o arquivo que você envia ao banco com esses três valores. A linha cujo dígito verificador do IBAN não fecha recebe um selo vermelho Suspeita (nos países que não usam IBAN, as contas compostas só de números não passam por essa verificação). O esquema de arquivo de colunas fixas do próprio banco não é gerado aqui — o esquema muda conforme o banco e a versão, e não se inventa; entrega-se CSV, e o mapeamento é outro trabalho.

17.4 Dados do SGK: código de ocupação e motivo predominante de dias faltantes

Os dados da declaração passam a trazer também o código de ocupação da pessoa (o campo na ficha do funcionário); os que não foram informados aparecem no contador. Quando uma pessoa tem vários motivos de dias faltantes, o órgão exige um único motivo: o programa escolhe o motivo com mais dias, desempata pela ordem de sgk.eksik_gun_oncelik e diz na linha o que escolheu — nunca decide em silêncio. O mapeamento dos motivos para o código oficial também está no parâmetro sgk.eksik_gun_kod; sem o mapeamento nenhum código é gerado e a linha registra isso. O arquivo oficial da e-declaração não é gerado aqui; o que se gera é o dado em que a declaração se apoia.

18. Transporte fretado — linha, ponto, lista de embarque, medição do terceirizado

A visão Transporte da aba Funcionários › Transporte / Refeitório / Sindicato guarda os veículos do terceirizado, seus pontos e os funcionários que embarcam neles. Para uma linha a capacidade é obrigatória; o percentual de ocupação sai dela. Isto não é viagem de funcionário (diária) — isso são os registros de Viagem na aba Ganhos.

18.1 A capacidade é uma porta, não um aviso

Lançar passageiro num veículo lotado é recusado (SERVIS_KAPASITE_DOLU). Se for preciso registrar conscientemente que o motorista levou passageiros a mais, faça a designação com kapasiteOnay; o registro então passa, mas o aviso CAPACIDADE EXCEDIDA permanece tanto na resposta quanto na lista da linha.

18.2 Medição e atraso

O número de viagens não é inventado: toma-se a quantidade de dias distintos em que o pessoal daquela linha efetivamente trabalhou no ponto naquele mês (o veículo saiu naquele dia). O valor é essa quantidade × a tarifa por viagem. O atraso, nesta versão, é apenas sinalizado; o programa não aplica sozinho a cláusula penal do contrato do terceirizado — o desconto é decidido e lançado por uma pessoa.

19. Refeitório — passagem do cartão, verificação do direito, conciliação do catering

Cada refeição é definida por um código, uma faixa de horário e um custo unitário. Ao passar o cartão, o programa testa três portas em ordem e, se recusar, diz o motivo: KART_TANIMSIZ se o cartão não está vinculado a nenhum funcionário, MUKERRER_BASIM se for a segunda passagem na mesma refeição, IZINLI_GUN se a pessoa está de férias aprovadas ou com atestado naquele dia, DAMGA_YOK se não há nenhuma marcação de entrada naquele dia.

19.1 Conciliação com a nota fiscal do catering

A conciliação conta apenas as passagens ACEITAS; o cartão recusado não entra no valor. Informe a quantidade e o valor da nota do terceirizado e o programa mostra a diferença de quantidade e de valor. A informação de dieta/alérgeno vem do campo código de dieta da ficha do funcionário e chega na resposta da passagem, na tela do cozinheiro.

20. Sindicato e acordo coletivo

O sindicato é definido por um código, um nome e um tipo de contribuição: diária (contribuição = bruto diário × número de diárias), percentual (percentual do bruto) ou fixo. O padrão do número de diárias é o parâmetro sendika.aidat_yevmiye da legislação; não há número fixo no código.

20.1 A licença sindical é dia remunerado

No ponto, o status sendikal_izin conta como dia remunerado e entra nos dias de contribuição previdenciária; não é declarado como dia faltante. As horas semanais de licença do representante ficam no registro de filiação. A lista de contribuições é agrupada por sindicato e pode ser exportada em CSV; ela não gera ordem de pagamento.

21. Declaração do SGK (MPHB) — preparação, ficha do estabelecimento, pacote XML

A aba Declaração do SGK da janela Folha de pagamento reúne numa única tela tudo em que a declaração do fim do mês se apoia: dias de contribuição por pessoa, salário devido, prêmio/gratificação, dias faltantes e seu motivo, admissão/desligamento, código de ocupação. Esta tela é uma tela de conferência — não gera arquivo, conta o que está faltando.

Abrangência — esta é meia declaração. O MPHB é a união de duas declarações: a de imposto (retenção na fonte) e a de contribuição/serviço do SGK. Como o HNR não calcula a retenção de imposto de renda, somente a parte do SGK é gerada; os campos de imposto ficam vazios e não são preenchidos com 0 — escrever 0 produz uma declaração que o órgão vai rejeitar. Antes de enviar o arquivo, complete a parte de imposto no programa do seu contador.

A ficha do estabelecimento é obrigatória. A declaração exige o registro SGK do estabelecimento, de 26 dígitos, separado em partes. Escreva o registro num único campo e clique em "Decompor o registro": a unidade nova, a unidade antiga, o número de sequência do estabelecimento, o código da província e o código do subempreiteiro são extraídos conforme as faixas de caracteres do guia oficial. Como a posição do ramo de atividade, do distrito e do número de controle não foi publicada no guia, esses não são derivados — você os informa à mão. Se uma parte que você digitou contradisser a que foi extraída do registro, a gravação para e o programa diz qual parte está em conflito; não há correção silenciosa.

Código de ocupação (NNNN.NN). O órgão exige um código ISCO-08 de 4 dígitos mais uma subdivisão de 2 dígitos. O HNR não embute o dicionário de ocupações de 7.556 linhas (direitos autorais, atualidade e custo de manutenção); ele verifica apenas o formato e oferece dois caminhos para informar o código: a ficha da pessoa ou o rótulo do cargo. Se você escrever o código no rótulo do cargo, todos naquele cargo o herdam. Quem não tem código aparece em vermelho na preparação da declaração.

Por que o XML e o pacote ZIP nascem desligados. O esquema legível por máquina do órgão (XSD) não é público e o formato mudou no período de junho/2026. Por isso o HNR não inventa um esquema: os nomes dos elementos XML são definidos por você na aba Esquema da declaração (a partir dos nomes de campo do programa do órgão). Enquanto Configurações › Portas de segurança › sgk.xml_uret estiver desligado, a preparação e o CSV funcionam exatamente como antes e o XML/pacote é recusado. Abra a porta depois de confirmar que a sua definição é compatível com o programa do órgão. O tamanho do pacote é de no máximo 15 MB conforme o guia; se exceder, divida a declaração com o filtro de estabelecimento.

A linha cujo campo obrigatório está vazio NÃO é escrita no arquivo. Se um campo que você marcou como "obrigatório" no esquema estiver vazio para uma pessoa, a linha dessa pessoa não entra no arquivo e aparece na lista de faltantes com a justificativa. É uma decisão consciente: campo obrigatório vazio significa uma declaração que o órgão vai rejeitar; ver a falha na tela é melhor do que ver a carta de rejeição do órgão.

22. Arquivo bancário de salários — o motor de modelos

A aba Folha de pagamento › Arquivo bancário converte a lista de pagamento bancário no formato de texto que o seu banco pede. O formato não está embutido no código, e há um motivo medido para isso: nenhum banco turco publica o seu esquema TXT de colunas fixas; o único documento oficial publicado é o modelo em Excel do Ziraat, e os próprios manuais dos bancos dizem que "também é possível atender a um layout específico". Ou seja, não existe um "formato bancário" único — você pega o mapa de colunas com o seu banco e o define aqui.

Seis portas, todas bloqueantes. (1) Se um valor não cabe no seu campo, o arquivo não é gerado; o programa diz em quem, em qual campo e por quantos caracteres estourou — cortar em silêncio é mandar um IBAN errado ao banco. (2) Se a posição de dois campos se sobrepõe, o modelo não é salvo. (3) Se você informou um comprimento de registro, cada linha fica exatamente com esse comprimento. (4) Se escolheu cp1254 ou ASCII, um caractere não conversível para o arquivo — um nome turco não vira "?" em silêncio; se quiser a simplificação, você a pede explicitamente informando bicimleme=ascii no campo em questão. (5) Quem não passa na verificação do IBAN não entra no arquivo; para enviar mesmo assim, marque a caixa "Gravar também as contas inválidas" e isso fica no rastro. (6) A quantidade de registros e o total em centavos do arquivo são comparados com a lista, e o SHA-256 do próprio arquivo também é calculado.

Por que a prévia mostra uma régua de colunas. Num arquivo de colunas fixas, um único caractere deslocado estraga o arquivo inteiro. O botão "Pré-visualizar" imprime uma régua numérica acima das primeiras linhas; você pode contar a olho onde cada coluna começa. Se deixou a origem do modelo em branco, tanto na tela quanto na nota da saída aparece o aviso "não é oficial — confirme com o seu banco". Enquanto Configurações › Portas de segurança › banka.txt_uret estiver desligado, as saídas CSV e JSON existentes continuam funcionando sem nenhuma mudança.

23. Aba Datas — experiência, fim do contrato, exame

A aba Datas mostra numa só lista os registros com prazo do pessoal: período de experiência e último dia para aviso de rescisão, fim do contrato por prazo determinado e prazo total máximo legal, validade de certificados e documentos, exame médico periódico. Os alertas legais aparecem em vermelho; os limites vêm dos parâmetros da aba Legislação. Lembretes e escalonamento são do Calendário de contratos — detalhes: Calendário de contratos › Datas do pessoal.