Nexus Atlas

Financeiro

Folha de pagamento

O ERP não calcula folha — quem calcula é o sistema de folha da instituição. Aqui entra o resumo pronto de cada competência e contrato de gestão, por três caminhos (digitado, por arquivo CSV ou pela API do fornecedor da folha). Lançar transforma o resumo em títulos a pagar: o líquido dos…

Onde encontrar/financeiro/folha · "Folha de pagamento"
Quem abrequem trabalha no financeiro (interno). Importar, digitar, lançar e anexar/remover arquivos: financeiro.excluir_arquivo_folha; excluir e desfazer: financeiro.desfazer_folha.

Para que serve

O ERP não calcula folha — quem calcula é o sistema de folha da instituição. Aqui entra o resumo pronto de cada competência e contrato de gestão, por três caminhos (digitado, por arquivo CSV ou pela API do fornecedor da folha). Lançar transforma o resumo em títulos a pagar: o líquido dos colaboradores por rubrica, cada encargo no seu, e as provisões como título previsto (entra na projeção de caixa sem virar dívida vencida). Com CEBAS vigente, a cota patronal sai isenta: não vira título e fica registrada com o valor que seria devido. A contribuição descontada do empregado segue normal. Nenhum nome ou CPF de colaborador é guardado aqui: a referência, quando vem, é a matrícula.

A tela, marcação por marcação

As figuras abaixo mostram a tela como ela aparece para quem usa. Os números em vermelho marcam os botões e campos; logo abaixo de cada figura, cada número é explicado: onde fica, o que faz e o que acontece depois.

Visão geral da tela

1Importar arquivo2Digitar competência
Figura 1 — Folha de pagamento
O que cada marcação faz
1
Importar arquivo
  • Aparece quando: chave financeiro.folha. O que faz: pede o arquivo (.csv, .txt, .tsv), lê as linhas e abre "Importar <arquivo>" para conferir.
  • Se der errado: "Não reconheci nenhuma linha. O arquivo precisa ter, no mínimo, uma coluna de evento (ou descrição) e uma de valor." Colunas não usadas aparecem em amarelo na janela.
2
Digitar competência
  • Aparece quando: chave financeiro.folha. O que faz: abre "Digitar a competência" com uma linha vazia.

Folha importada a lançar (mais abaixo na tela)

1Ver linhas (em cada um)2Lançar3Desfazer (em cada um)
Figura 2 — Folha de pagamento: Folha importada a lançar (mais abaixo na tela)
O que cada marcação faz
1
Ver linhas (em cada um)
  • Abre as linhas e os arquivos da competência.
2
Lançar
  • Aparece quando: chave financeiro.folha e situação "a lançar". O que faz: cria os títulos: "N título(s) criado(s) em Contas a pagar. A folha passa a aparecer na execução por rubrica e no fluxo de caixa. O que a certificação beneficente isenta não vira título: fica registrado como isento, com o valor que seria devido."
3
Desfazer (em cada um)
  • Aparece quando: chave financeiro.desfazer_folha e competência lançada. O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."
  • Onde aparece: na coluna de ações da competência lançada, no lugar de "Lançar" e "Excluir". Clicar abre "Desfazer o lançamento da folha" (motivo de 10 caracteres ou mais); confirmado, os títulos da folha são cancelados e aparece "N título(s) cancelado(s). A competência voltou a aceitar nova carga.". Quem pode: financeiro.desfazer_folha.

Folha importada a lançar (mais abaixo na tela)

1Ver linhas (em cada um)2Lançar3Excluir4Desfazer (em cada um)
Figura 3 — Folha de pagamento: Folha importada a lançar (mais abaixo na tela)
O que cada marcação faz
1
Ver linhas (em cada um)

Abre as linhas e os arquivos da competência.

Explicado em detalhes na Figura 2.

2
Lançar

O que faz: cria os títulos: "N título(s) criado(s) em Contas a pagar. A folha passa a aparecer na execução por rubrica e no fluxo de caixa. O que a certificação beneficente isenta não vira título: fica registrado como isento, com o valor que seria devido."

Explicado em detalhes na Figura 2.

3
Excluir
  • Aparece quando: chave financeiro.desfazer_folha, "a lançar" e nunca lançada. Pede confirmação? "Excluir folha importada — a folha de MM/AAAA de <contrato>. Sai junto: as linhas e os colaboradores da carga; os arquivos importados e os comprovantes desta competência". Sucesso: "Folha excluída. A competência pode ser importada de novo."
4
Desfazer (em cada um)

O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."

Explicado em detalhes na Figura 2.

Folha importada a lançar (mais abaixo na tela)

1Baixar a especificação técnica para o fornecedor
Figura 4 — Folha de pagamento: Folha importada a lançar (mais abaixo na tela)
O que cada marcação faz
1
Baixar a especificação técnica para o fornecedor
  • Baixa o arquivo especificacao-envio-da-folha.txt com o endereço, o cabeçalho x-folha-token, o formato JSON (contrato de gestão, competência "AAAA-MM", colaboradores, linhas com rubrica, tipo PROVENTO/DESCONTO/ENCARGO/PROVISAO, evento e valor com ponto decimal) e as regras de reenvio.

Folha importada a lançar

1Importar arquivo2Digitar competência3Ver linhas (em cada linha)
Figura 5 — Folha de pagamento: Folha importada a lançar
O que cada marcação faz
1
Importar arquivo

O que faz: pede o arquivo (.csv, .txt, .tsv), lê as linhas e abre "Importar <arquivo>" para conferir.

Explicado em detalhes na Figura 1.

2
Digitar competência

O que faz: abre "Digitar a competência" com uma linha vazia.

Explicado em detalhes na Figura 1.

3
Ver linhas (em cada linha)

Abre as linhas e os arquivos da competência.

Explicado em detalhes na Figura 2.

Especificação técnica para o fornecedor da folha (mais abaixo na tela)

1Importar arquivo2Digitar competência
Figura 6 — Folha de pagamento: Especificação técnica para o fornecedor da folha (mais abaixo na tela)
O que cada marcação faz
1
Importar arquivo

O que faz: pede o arquivo (.csv, .txt, .tsv), lê as linhas e abre "Importar <arquivo>" para conferir.

Explicado em detalhes na Figura 1.

2
Digitar competência

O que faz: abre "Digitar a competência" com uma linha vazia.

Explicado em detalhes na Figura 1.

Especificação técnica para o fornecedor da folha (mais abaixo na tela)

1Ver linhas (em cada um)2Lançar3Desfazer (em cada um)4<tipo> — <nome> (em cada um)
Figura 7 — Folha de pagamento: Especificação técnica para o fornecedor da folha (mais abaixo na tela)
O que cada marcação faz
1
Ver linhas (em cada um)

Abre as linhas e os arquivos da competência.

Explicado em detalhes na Figura 2.

2
Lançar

O que faz: cria os títulos: "N título(s) criado(s) em Contas a pagar. A folha passa a aparecer na execução por rubrica e no fluxo de caixa. O que a certificação beneficente isenta não vira título: fica registrado como isento, com o valor que seria devido."

Explicado em detalhes na Figura 2.

3
Desfazer (em cada um)

O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."

Explicado em detalhes na Figura 2.

4
<tipo> — <nome> (em cada um)
  • O botão abre o arquivo (link de 2 minutos). A lixeira (chave financeiro.excluir_arquivo_folha) pede confirmação "Remover arquivo da folha".
  • Sucesso ao anexar: "Arquivo anexado. Ele vai junto no documento da folha dentro da prestação de contas."

Especificação técnica para o fornecedor da folha (mais abaixo na tela)

1Ver linhas (em cada um)2Lançar3Excluir4Desfazer (em cada um)5<tipo> — <nome> (em cada um)
Figura 8 — Folha de pagamento: Especificação técnica para o fornecedor da folha (mais abaixo na tela)
O que cada marcação faz
1
Ver linhas (em cada um)

Abre as linhas e os arquivos da competência.

Explicado em detalhes na Figura 2.

2
Lançar

O que faz: cria os títulos: "N título(s) criado(s) em Contas a pagar. A folha passa a aparecer na execução por rubrica e no fluxo de caixa. O que a certificação beneficente isenta não vira título: fica registrado como isento, com o valor que seria devido."

Explicado em detalhes na Figura 2.

3
Excluir

Aparece quando: chave financeiro.desfazer_folha, "a lançar" e nunca lançada. Pede confirmação? "Excluir folha importada — a folha de MM/AAAA de <contrato>. Sai junto: as linhas e os colaboradores da carga; os arquivos importados e os comprovantes desta competência". Sucesso: "Folha excluída. A competência pode ser importada de novo."

Explicado em detalhes na Figura 3.

4
Desfazer (em cada um)

O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."

Explicado em detalhes na Figura 2.

5
<tipo> — <nome> (em cada um)

O botão abre o arquivo (link de 2 minutos). A lixeira (chave financeiro.excluir_arquivo_folha) pede confirmação "Remover arquivo da folha".

Explicado em detalhes na Figura 7.

Especificação técnica para o fornecedor da folha

1Baixar a especificação técnica para o fornecedor
Figura 9 — Folha de pagamento: Especificação técnica para o fornecedor da folha
O que cada marcação faz
1
Baixar a especificação técnica para o fornecedor

Baixa o arquivo especificacao-envio-da-folha.txt com o endereço, o cabeçalho x-folha-token, o formato JSON (contrato de gestão, competência "AAAA-MM", colaboradores, linhas com rubrica, tipo PROVENTO/DESCONTO/ENCARGO/PROVISAO, evento e valor com ponto decimal) e as regras de reenvio.

Explicado em detalhes na Figura 4.

Competência lançada: Desfazer (mais abaixo na tela)

1Ver linhas (em cada um)2Lançar3Desfazer (em cada um)4<tipo> — <nome> (em cada um)
Figura 10 — Folha de pagamento: Competência lançada: Desfazer (mais abaixo na tela)
O que cada marcação faz
1
Ver linhas (em cada um)

Abre as linhas e os arquivos da competência.

Explicado em detalhes na Figura 2.

2
Lançar

O que faz: cria os títulos: "N título(s) criado(s) em Contas a pagar. A folha passa a aparecer na execução por rubrica e no fluxo de caixa. O que a certificação beneficente isenta não vira título: fica registrado como isento, com o valor que seria devido."

Explicado em detalhes na Figura 2.

3
Desfazer (em cada um)

O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."

Explicado em detalhes na Figura 2.

4
<tipo> — <nome> (em cada um)

O botão abre o arquivo (link de 2 minutos). A lixeira (chave financeiro.excluir_arquivo_folha) pede confirmação "Remover arquivo da folha".

Explicado em detalhes na Figura 7.

Competência lançada: Desfazer (mais abaixo na tela)

1Ver linhas (em cada um)2Lançar3Excluir4Desfazer (em cada um)5<tipo> — <nome> (em cada um)
Figura 11 — Folha de pagamento: Competência lançada: Desfazer (mais abaixo na tela)
O que cada marcação faz
1
Ver linhas (em cada um)

Abre as linhas e os arquivos da competência.

Explicado em detalhes na Figura 2.

2
Lançar

O que faz: cria os títulos: "N título(s) criado(s) em Contas a pagar. A folha passa a aparecer na execução por rubrica e no fluxo de caixa. O que a certificação beneficente isenta não vira título: fica registrado como isento, com o valor que seria devido."

Explicado em detalhes na Figura 2.

3
Excluir

Aparece quando: chave financeiro.desfazer_folha, "a lançar" e nunca lançada. Pede confirmação? "Excluir folha importada — a folha de MM/AAAA de <contrato>. Sai junto: as linhas e os colaboradores da carga; os arquivos importados e os comprovantes desta competência". Sucesso: "Folha excluída. A competência pode ser importada de novo."

Explicado em detalhes na Figura 3.

4
Desfazer (em cada um)

O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."

Explicado em detalhes na Figura 2.

5
<tipo> — <nome> (em cada um)

O botão abre o arquivo (link de 2 minutos). A lixeira (chave financeiro.excluir_arquivo_folha) pede confirmação "Remover arquivo da folha".

Explicado em detalhes na Figura 7.

Competência lançada: Desfazer (mais abaixo na tela)

1Baixar a especificação técnica para o fornecedor
Figura 12 — Folha de pagamento: Competência lançada: Desfazer (mais abaixo na tela)
O que cada marcação faz
1
Baixar a especificação técnica para o fornecedor

Baixa o arquivo especificacao-envio-da-folha.txt com o endereço, o cabeçalho x-folha-token, o formato JSON (contrato de gestão, competência "AAAA-MM", colaboradores, linhas com rubrica, tipo PROVENTO/DESCONTO/ENCARGO/PROVISAO, evento e valor com ponto decimal) e as regras de reenvio.

Explicado em detalhes na Figura 4.

Competência lançada: Desfazer

1Importar arquivo2Digitar competência
Figura 13 — Folha de pagamento: Competência lançada: Desfazer
O que cada marcação faz
1
Importar arquivo

O que faz: pede o arquivo (.csv, .txt, .tsv), lê as linhas e abre "Importar <arquivo>" para conferir.

Explicado em detalhes na Figura 1.

2
Digitar competência

O que faz: abre "Digitar a competência" com uma linha vazia.

Explicado em detalhes na Figura 1.

Como a tela está organizada (de cima para baixo)

  1. Avisos de erro e de sucesso.
  2. Cartões: "Competências carregadas", "Líquido dos colaboradores", "Encargos", "Isento por certificação", "Ainda não lançadas" (amarelo se houver).
  3. Cartão das competências: "Contrato de gestão" ("Todos"), botões "Importar arquivo" e "Digitar competência"; texto "O ERP não calcula folha…". Tabela Competência · Contrato de gestão · Origem (API, arquivo, digitada) · Pessoas · Líquido · Encargos · Isento (verde, com a portaria ao passar o mouse) · Provisões · Situação ("lançada em <data>" ou "a lançar") · ações "Ver linhas", "Lançar", "Excluir", "Desfazer". Vazia: "Nenhuma competência carregada ainda."
  4. "Linhas de MM/AAAA · <contrato>" (ao clicar "Ver linhas") — "Última carga em …" e o aviso da isenção (quando há): "A cota patronal desta competência está isenta pela certificação beneficente (portaria …): R$ … que seriam devidos não são recolhidos, e por isso não viraram título a pagar…". Tabela Tipo (Provento, Desconto, Encargo, Provisão, Informativo) · Rubrica · Evento · Unidade · Referência · Valor (riscado se isento) · Tributo ("<tributo> isento", "do empregado", "patronal").
    • "Arquivos originais desta folha" — "O CSV serve para o sistema extrair os lançamentos por colaborador. O que o ente recebe é a folha como ela sai do sistema de folha — a analítica, o resumo, os recibos, o arquivo do FGTS Digital. Anexe aqui: esses arquivos entram no documento da folha dentro do pacote de prestação de contas." Lista: botão com o tipo e o nome (abre o arquivo), data e lixeira. Embaixo, a lista do tipo do arquivo ("Folha de pagamento analítica", "Resumo da folha", "Recibos de pagamento", "Arquivo do FGTS Digital", "Arquivo da DCTFWeb", "Arquivo importado (CSV)", "Outro documento da folha") e o seletor de arquivo (sobe ao escolher; "Enviando…").
  5. Gráfico "Folha por competência" (líquido de cada mês).
  6. "Envio automático pelo sistema de folha" — "A porta já existe e está ligada…"; Endereço (a função folha-receber), Autenticação ("Token próprio do fornecedor, enviado em cada envio"), tabela do que o sistema de folha envia (contrato de gestão, competência, colaboradores, uma linha por rubrica e evento) e o botão "Baixar a especificação técnica para o fornecedor". "Reenviar o mesmo arquivo não duplica nada. Enviar um arquivo diferente para a mesma competência substitui as linhas… O token fica no cofre do banco e é entregue por um administrador do ERP."

Situações

Situação O que se pode fazer
"a lançar" (importada) "Lançar" (cria os títulos) ou "Excluir" (carga errada)
"lançada em …" "Desfazer" (cancela os títulos)

Botões

Os botões marcados nas figuras estão explicados junto de cada figura (seção “A tela, marcação por marcação”). Não há outros botões nesta tela.

Janelas

"Importar <arquivo>" / "Digitar a competência"

  • Campos: "Contrato de gestão" (obrigatório) · "Competência" (mês; padrão o mês passado) · "Colaboradores" · "Folha original, como sai do sistema de folha" (arquivo opcional — vai junto como "Folha de pagamento analítica"; "Dá para anexar depois, e anexar mais de um, na competência já importada").
  • Tabela das linhas: Tipo · Rubrica (ex.: "3.1.1 — Pessoal") · Evento (ex.: "Salário") · Unidade · "Valor da linha N" · lixeira; botão "Linha" acrescenta uma linha. "Confira o tipo de cada linha antes de importar: é ele que decide se o valor vira título a pagar, encargo ou provisão. Linha sem evento ou com valor zero é ignorada."
  • Botões: "Cancelar" · "Importar" (mostra "Importando…").
  • Mensagens: "Escolha o contrato de gestão desta folha. A carga vai para o contrato escolhido e nenhum outro." · "N linha(s) importada(s). Arquivo(s) guardado(s): …" · "Este arquivo já havia sido importado." · "As linhas entraram, mas não consegui guardar <arquivo>: …"
  • Tirar uma linha do meio não mexe nos valores das outras (cada linha guarda o seu).

"Desfazer o lançamento da folha"

1Desfazer
Figura 14 — janela "Desfazer o lançamento da folha"
O que cada marcação faz
1
Desfazer

O que faz: abre "Desfazer o lançamento da folha" (motivo mínimo 10): "N título(s) cancelado(s). A competência voltou a aceitar nova carga."

Explicado em detalhes na Figura 2.

  • Motivo mínimo 10; "Os títulos criados serão cancelados."

Perguntas que as pessoas fazem

  • Importei a folha no contrato errado. → Se ainda não lançou, "Excluir". Se já lançou, "Desfazer" (os títulos são cancelados e a competência volta a aceitar nova carga); o botão "Excluir" só aparece para folha que nunca foi lançada.
  • A folha foi retificada. → Desfaça o lançamento e importe de novo (envio diferente para a mesma competência substitui as linhas).
  • Por que a cota patronal não virou título? → A certificação beneficente (CEBAS) vigente isenta; o valor fica registrado como isento.
  • O ente quer a folha analítica. → Anexe em "Arquivos originais desta folha".

Ligações com outros módulos e telas

  • Contas a pagar — títulos da folha (só se desfazem pela Folha).
  • Guias de recolhimento — contribuições da folha e isenções.
  • Cadastros — certificação beneficente (CEBAS).
  • Rateio de despesas — CLT de cada contrato de gestão vem da folha.
  • Provisão — o valor a provisionar sai da folha.
  • Prestação de Contas — documento da folha com os arquivos originais.

Nexus Atlas · As imagens mostram o sistema com dados fictícios.