Faturamento por profissional

Para cada profissional ativo do seu negocio, o sistema mostra a soma de todas as notas fiscais emitidas no ano atual. Os dados sao puxados do portal de notas fiscais (NFse) da prefeitura, usando o CNPJ do profissional.

Isso permite que você veja quem esta perto do limite do MEI (R$ 81.000/ano) e tome providencias antes que o profissional seja desenquadrado.

Para cada profissional, o sistema mostra um dos seguintes status:

E se a entidade fiscal não tem proprietario ativo?

O sistema ainda mostra a entidade na lista, com os dados de faturamento que ja existem no cache, mas não tenta atualizar os dados até que o profissional seja reativado.

O sistema busca as notas fiscais emitidas no portal da prefeitura (NFse). Para isso, ele passa por um servico intermediario que faz a ponte entre a plataforma e o portal nacional (nfse.gov.br). Esse servico intermediario é quem de fato acessa o portal, coleta os dados de cada mes, e devolve para a plataforma de forma organizada.

Para acessar o portal, o sistema precisa de uma das duas opcoes de credencial:

Para configurar uma das duas opcoes, você usa o painel da plataforma para fazer upload do certificado ou informar o usuario e senha do portal.

Nota para testes: A equipe de desenvolvimento mantem um servico de mock (simulador) deste intermediario, disponivel no ambiente de testes, para validar o fluxo sem chamar o portal real.

O sistema guarda os valores de faturamento em cache e os atualiza sob demanda, seguindo estas regras:

1. Primeira vez: se não existem dados para aquele CNPJ, o sistema busca todos os meses disponiveis (de janeiro até o mes anterior).
2. Meses com erro: se algum mes está marcado com erro, o sistema tenta buscar de novo aquele mes.
3. Mudanca de mes: a partir do dia 1 de cada mes, o sistema re-busca os meses que foram consultados antes do mes terminar (dados "prematuros"). Por exemplo: se junho foi consultado com sucesso em 23 de junho (antes do mes fechar), em 1 de julho o sistema re-busca junho para pegar os dados finais. Se junho foi consultado com sucesso em 1 de julho (depois de fechar), ele nunca mais é tocado.

O mes atual nunca é consultado — ele ainda não terminou. Por exemplo, em 15 de julho, o sistema consulta janeiro a junho. Julho só sera consultado a partir de 1 de agosto.

A busca é feita em segundo plano (sem travar a tela): a resposta vem com os dados que ja existem, e a proxima requisicao pega os dados atualizados.

Para cada entidade fiscal, a tela mostra:

• Tipo de cálculo: anual para MEI (soma do ano calendário) ou pelos últimos 12 meses para demais entidades.
• Período: mês inicial e mês final considerados (ex: janeiro a junho de 2026).
• Faturamento total em reais no período (ex: R$ 45.000,00).
• Média mensal em reais (total / quantidade de meses com dados).
• Quantidade de notas fiscais emitidas no período.
• Limite anual (MEI: R$ 81.000,00; demais entidades: configurável por plataforma).
• Percentual do limite usado (ex: 55,56%).
• Status da consulta (Emitida / Processando / Com Erro) conforme os registros mensais.
• Status de faturamento projetado (verde / amarelo / vermelho) projetando a média mensal para o resto do ano.
• Meses com erro: lista dos meses que falharam (ex: março de 2026).
• Meses em processamento: lista dos meses sendo atualizados.

E se algum mes deu erro?

O sistema mostra quais meses não foi possivel consultar (ex: março de 2026, julho de 2026). Isso geralmente acontece por:

• Senha do portal expirada.
• Certificado digital vencido.
• Portal da prefeitura fora do ar no momento da consulta.
• CNPJ sem notas no mes (esse caso não é erro — apenas não soma nada).

O faturamento é uma das 6 áreas do Diagnóstico MEI. A diferença é:

• Diagnostico MEI mostra o status consolidado de cada area (uma entrada por CNPJ).
• Faturamento por profissional mostra o detalhe por profissional (uma entrada por profissional, mesmo que compartilhem CNPJ).

Use o Diagnostico para ver "esta tudo bem com a saude fiscal?". Use o Faturamento por profissional para ver "quem esta perto do limite e precisa de atencao?".

Quando o profissional atinge 100% do limite (R$ 81.000/ano), o sistema mostra o status em vermelho e o percentual como ≥ 100%.

Isso não significa que o profissional ja foi desenquadrado — significa que o sistema detectou o risco. O desenquadramento de fato é decidido pela Receita Federal, e o sistema não tem como prever.

O que fazer?

Quando você ver um profissional em vermelho, vale a pena:

1. Conferir se os valores estao corretos (uma nota duplicada, por exemplo).
2. Avisar o profissional para que ele proprio decida o que fazer (declarar como MEI, migrar para Simples Nacional, etc.).
3. Considerar se a partir do proximo ano o profissional deve passar para outro regime tributario.