Manual do Usuário

Download PDF

Documentação oficial dos módulos.

1. Visão Geral (NF-e Entrada)

O módulo NF-e Automático ("Robô de NFe") tem como objetivo:

  • Monitorar a SEFAZ em busca de novas notas fiscais emitidas para sua empresa.
  • Armazenar os documentos fiscais (XMLs) de forma segura.
  • Gerenciar a Manifestação do Destinatário (Ciência da Emissão, Confirmação da Operação, Desconhecimento).
  • Facilitar o Download dos arquivos XML e PDF (DANFE).

2. Configuração Inicial

Antes de utilizar o sistema, é necessário configurar o Certificado Digital, pois toda comunicação com a SEFAZ é assinada digitalmente.

  1. Navegue até Configurações > Certificado Digital.
  2. Clique em Atualizar/Carregar Certificado.
  3. Selecione o arquivo .PFX do seu certificado digital (A1).
  4. Insira a senha do certificado.
  5. O sistema validará e exibirá a data de validade.
Importante: O sistema utiliza o certificado A1. Certifique-se de que ele esteja válido. O sistema avisará quando estiver próximo do vencimento.

3. Painel de Documentos

A tela principal (NF-e (Produtos) > Notas Recebidas) apresenta a lista de todas as notas fiscais encontradas.

Legenda de Cores
  • Verde: Operação Confirmada (Reconhecida e válida).
  • Amarelo: Ciência da Emissão (O sistema sabe que existe, mas você não confirmou recebimento).
  • Vermelho: Nota Cancelada ou Desconhecida.
  • Cinza: Sem manifestação.
Novidade na Interface: O painel de documentos agora conta com filtros recolhíveis para maximizar a área de visualização e contadores totalizadores integrados ao cabeçalho da lista, facilitando o controle rápido de pendências.

4. Fluxo de Trabalho

Passo 1: Buscar Novas Notas

O Robô roda a cada hora. Para forçar: clique em "Buscar Novos Documentos".

Passo 2: Dar "Ciência da Operação"

Ao receber uma nota, ela entra como "Resumo". Para baixar o XML, dê a Ciência (Menu Manifestar > Ciência).

Passo 3: Confirmar a Operação

Quando a mercadoria chegar, clique em Confirmar. Isso valida a transação fiscalmente.

Passo 4: Download

Após confirmar, use os ícones para baixar o XML ou visualizar o DANFE (PDF).

5. Dúvidas Frequentes (NF-e)

Por que a nota aparece, mas não consigo baixar o PDF?
A nota precisa ter o XML completo. Faça a Ciência da Operação e aguarde o download automático.
O que é "Desconhecimento da Operação"?
Use se não reconhecer a compra. Isso protege seu CNPJ contra fraudes.

6. NFS-e Nacional — Dashboard

O Dashboard do módulo NFe consolida em uma única tela os indicadores de mercadorias (NFe/CTe) e serviços (NFS-e Nacional) do mês atual.

  • Bloco de Serviços Tomados: Valor total acumulado e contagem de notas onde sua empresa é a destinatária dos serviços.
  • Bloco de Serviços Prestados: Valor total acumulado e contagem de notas onde sua empresa é a emitente.
  • Barra de Progresso: Proporção visual de notas concluídas (verde) vs. canceladas (vermelho) no mês.
  • Status do Robô: Indicador em tempo real do agente de sincronização automática com datas da última e da próxima consulta.
  • Aba "Serviços (NFS-e Nacional)": Listagem rápida das 5 últimas notas de serviço com atalhos para baixar XML e visualizar DANFSe.

7. NFS-e Nacional — Robô Automático 🤖

O módulo conta com um Robô de Sincronização que consulta a API Nacional de NFS-e (ADN — Ambiente de Dados Nacionais) periodicamente, sem intervenção manual.

Indicador de Status (canto superior direito da tela NFS-e Nacional)
  • Robô Ativo O robô está ativo e executando consultas periódicas. Passe o mouse sobre o badge para ver a data/hora da última e da próxima consulta.
  • Robô Parado O robô está pausado.
Como Ativar ou Pausar
  • Clique no botão ▶ (Play) para iniciar — uma consulta imediata é disparada ao ativar.
  • Clique no botão ⏸ (Pause) para pausar — os dados já baixados são preservados.
Pré-requisito: O robô utiliza o certificado digital PFX da empresa. Certifique-se de que ele está cadastrado e válido em Configurações → Certificado Digital. Se o certificado estiver vencido ou ausente, a sincronização é bloqueada automaticamente.

8. NFS-e Nacional — Sincronização Manual 🔄

Além do robô, é possível forçar uma consulta imediata à API — útil para recuperar documentos de períodos anteriores ou reprocessar a partir de um NSU específico.

Como Executar
  1. Na tela de NFS-e Nacional, clique no botão ↺ (Sincronização Manual).
  2. O modal exibe o NSU Atual (último número processado). Opcionalmente, preencha o campo "Reiniciar a partir do NSU":
    • Digite 0 para reprocessar tudo desde o início.
    • Deixe em branco para continuar do último ponto.
  3. Clique em "Iniciar Consulta".
Acompanhamento em Tempo Real

O modal exibe um painel de progresso com spinner animado e contadores de notas e eventos atualizados a cada 2 segundos via polling. Se você navegar para outra tela e voltar, o modal reabrirá automaticamente mostrando o status atual.

Parar a Sincronização

Clique em ⏹ "Parar Sincronização" no rodapé do modal. O processo termina o lote atual e para. Ao concluir, clique em "Fechar e Atualizar" para ver os novos registros.

ResultadoIndicadorDescrição
✅ SucessoVerdeTodos os documentos importados com sucesso.
⚠️ InterrompidaAmareloProcesso parado manualmente pelo usuário.
❌ ErroVermelhoFalha no processo. Verifique os logs do sistema.

9. NFS-e Nacional — Ações e Exportações ⚡

Ações por Registro

Cada linha da listagem com XML disponível exibe três botões de ação rápida:

  • Baixar XML: Faz o download do arquivo XML completo no formato .xml.
  • Visualizar DANFSe: Gera e exibe o Documento Auxiliar da NFS-e em PDF diretamente no navegador, sem downloads intermediários.
  • Visualizar XML: Abre um modal com o conteúdo XML formatado e indentado para leitura técnica.
Exportações (barra superior — respeitam os filtros ativos)
Relatório PDF

Gera instantaneamente um PDF com cabeçalho de filtros, listagem e bloco de totais no rodapé.

Relatório Excel

Exporta para .xlsx com valores no padrão R$ #,##0.00, datas em dd/MM/yyyy e chaves como texto.

Download Lote ZIP

Gera em segundo plano (Hangfire) um .zip com todos os XMLs organizados em pastas: Prestados/, Tomados/, Canceladas/ e Eventos/. Disponível em Meus Arquivos.

Validação: Se a listagem filtrada não contiver nenhuma nota com XML disponível, o download em lote é cancelado com uma mensagem de aviso.

6. Visão Geral (RPS)

O módulo de RPS (Recibo Provisório de Serviços) é projetado para empresas que emitem notas fiscais de serviço na prefeitura de São Paulo (padrão v2 da Reforma Tributária). Ele permite automatizar o faturamento, transmitir recibos de forma unitária ou em lote, e monitorar a conversão em NFS-e.

7. Criando um Novo RPS

  1. Acesse Recibos > Novo RPS (ou clique no botão "+" na listagem).
  2. Informe o CPF/CNPJ do Tomador. O sistema busca os dados cadastrados automaticamente.
  3. Detalhe os serviços prestados (Código de Serviço, Alíquota, ISS Retido e Discriminação).
  4. Informe os valores financeiros e, se aplicável, as tags de Novos Impostos (IBS/CBS, NBS, Ind. Final).
  5. Clique em Salvar. O RPS entrará na listagem com status "PENDENTE".

8. Importação de Planilhas

Para faturamento em massa, é possível importar lotes de RPS via arquivo Excel (.XLSX):

  1. Acesse Recibos > Importar.
  2. Clique em "Baixar Planilha Modelo".
  3. Preencha os campos obrigatórios (Número do RPS, Série, Dados do Tomador, Serviços e Valores) e os novos campos fiscais (IBS/CBS).
  4. Arraste a planilha preenchida para a área de upload. O sistema validará a estrutura e salvará os RPS com status PENDENTE.

9. Dashboard e Painel de Filtros

O módulo de RPS dispõe de um painel de Dashboard moderno e totalizadores inteligentes:

  • Filtro Temporal de Período: Seletor de período rápido localizado no topo (Mês Atual, 30 Dias, 90 Dias, Ano Atual ou Tudo) que atualiza as métricas e gráficos instantaneamente.
  • Cards de Resumo Premium (KPIs): Exibem o total de RPS Emitidos, o Valor Faturado (notas ativas), a Fila de Transmissão (processando/erros) e os RPS Cancelados.
  • Gráficos de Indicadores (Chart.js):
    • Evolução de Emissões e Faturamento: Gráfico de linhas combinadas mostrando o volume e valores faturados nos últimos 6 meses.
    • Distribuição por Status: Gráfico em rosca de segmentação das notas.
  • Atividades Recentes: Tabela compacta com as últimas 5 notas geradas e botões de atalho para consulta rápida.
  • Barra de Filtros na Listagem: Recolhível, contendo buscas por status, data início/fim, períodos rápidos e busca textual livre.

10. Envio e Ações em Lote

O envio de RPS para a prefeitura pode ser automatizado ou realizado sob demanda:

  • Robô de Envio Automático: Quando ativo (indicador verde "Robô Ligado" na barra de ferramentas), envia os RPS com status "PENDENTE" em segundo plano a cada 5 minutos.
  • Envio Unitário: Clique no ícone de Envio (avião de papel) na linha correspondente do RPS para transmiti-lo imediatamente.
  • Seleção em Lote: Marque os checkboxes dos RPS desejados na primeira coluna da grid. Uma barra azul aparecerá no topo da tabela com ações em lote:
    • Reenviar Selecionados: Transmite todos os RPS pendentes ou com erro que foram marcados.
    • Excluir Selecionados: Remove os registros pendentes ou com erro selecionados de forma definitiva do banco de dados.

11. Exportação de Relatórios

Na barra superior da listagem, estão disponíveis dois botões de exportação rápida que respeitam os filtros ativos na tela:

  • Exportar XLS: Gera uma planilha detalhada (.XLSX) contendo todos os campos do faturamento e impostos.
  • Exportar PDF: Gera um relatório profissional formatado em orientação Paisagem (Landscape) para conferência física, incluindo somatórios fiscais.

12. Diagnóstico, Visualização de Erros e XMLs

O módulo oferece transparência total em caso de problemas na transmissão com a prefeitura:

  • Detalhamento de Erro AJAX: Em caso de falha, um ícone de atenção amarelo ⚠️ é exibido ao lado do status "ERRO". Clique sobre ele para carregar dinamicamente o código do erro, descrição da prefeitura e uma sugestão de correção.
  • Visualização de Log e XMLs: Ao enviar RPS manuais ou em lote, o sistema apresenta um painel em abas contendo o Log de Processamento (rastreamento do robô), o XML de Envio (pedido enviado) e o XML de Retorno (resposta da prefeitura), ideal para depurações técnicas.
  • Armazenamento Permanente de XMLs: Para atender à obrigação legal de guarda de documentos fiscais por 5 anos, o sistema armazena permanentemente na tabela rps_lote_envio (colunas xml_envio e xml_retorno) o XML assinado enviado e a resposta correspondente obtida da prefeitura.
  • Strict Mapping Defensivo de Tomadores: As rotinas de geração de XML aplicam mapeamento rigoroso e defensivo na tag <EnderecoTomador> para evitar rejeições e erros de validação XSD no WebService da prefeitura (sobretudo para clientes de fora do município de SP). O sistema injeta automaticamente fallbacks como S/N para números ausentes, Nao Informado para logradouro ou bairros em branco, e chaves de CEP/Cidade estruturadas nos moldes válidos.

13. Status dos Documentos

  • PENDENTE Documento cadastrado ou importado, aguardando envio.
  • CONVERTIDO RPS processado com sucesso. A NFS-e correspondente foi gerada.
  • ERRO Documento rejeitado pela prefeitura ou falha na assinatura/comunicação.
  • CANCELADO Nota Fiscal de serviço correspondente foi cancelada junto à prefeitura.

14. Visão Geral (Fiscal)

O Módulo Fiscal centraliza toda a escrituração da empresa, permitindo a gestão de documentos emitidos e recebidos, classificação tributária automática e geração de obrigações acessórias (SPED, Integrações Contábeis).

15. Cadastros e Tabelas

Mantenha seus registros atualizados para garantir a validação correta dos impostos.

Cadastros Básicos
  • Terceiros: Clientes, Fornecedores e Transportadoras. O sistema busca dados automaticamente pelo CNPJ na importação do XML.
  • Produtos: Itens comercializados ou materiais de consumo. Permite vincular NCM, unidade de medida e códigos de barras.
Segurança na Exclusão

A exclusão de cadastros agora possui Confirmação via Modal e Verificação de Integridade, impedindo a remoção de registros em uso.

Tabelas Fiscais
  • CFOP: Tabela completa de Códigos Fiscais de Operações.
  • CST/CSOSN: Códigos de Situação Tributária (ICMS, IPI, PIS, COFINS).
  • Classificação e Serviços: Tabelas auxiliares que relaciona os CFOP das notas fiscais de entrada

16. Rotinas de Importação

O sistema monitora a SEFAZ e baixa automaticamente Notas Fiscais (modelo 55) e Conhecimentos de Transporte (modelo 57) emitidos contra seu CNPJ. Basta dar a "Ciência da Operação".

Para notas de serviço (NFS-e) de prefeituras específicas (São Paulo, Barueri, etc.):

  1. Acesse Importação > Layout Prefeituras.
  2. Verifique se o código IBGE está correto.
  3. Arraste os arquivos (XML, TXT ou CSV).
  4. Ou use o botão Consultar WebService para baixar direto da prefeitura (se disponível).

Suporte completo para o novo padrão nacional de Nota de Serviço. Basta importar o XML no menu Importação > NFS-e Nacional.

17. Classificação Fiscal de Entradas

Ferramenta essencial para definir como os produtos comprados serão escriturados (ex: Compra para Revenda vs Consumo).

Dica: A edição em lote agora permite a aplicação massiva. Ao clicar em "Concluir e Salvar", a regra definida será aplicada a todos os itens da listagem atual (respeitando os filtros aplicados).
Como Usar:
  1. Acesse Ferramentas > Classificação.
  2. Busque a nota desejada.
  3. Clique no lápis (Editar).
  4. Use os botões de ação:
    • Por CFOP: Agrupa itens pelo CFOP original. Ótimo para converter 5405 em 1403, por exemplo.
    • Por Item: Ajuste fino item a item.
  5. Defina os novos CSTs de Entrada (ICMS, IPI, PIS, COFINS) e clique em Aplicar.
Regras de Validação & Segurança

Para garantir a consistência dos dados, o sistema aplica as seguintes travas:

  • CFOP de Entrada: Deve ter 4 dígitos e iniciar com 1, 2 ou 3 (Ex: 1102, 2556).
  • CST IPI: Apenas códigos de entrada (menores que 50).
  • CST PIS/COFINS: Apenas códigos de crédito/entrada (iguais ou maiores que 50).
  • Preenchimento: Todos os campos são obrigatórios para novas classificações.

Edição Inteligente: Se os itens já estiverem classificados corretamente, você pode clicar em Gravar sem preencher os campos novamente (o sistema ignora a validação para evitar retrabalho).

18. Gestão de Serviços (NFS-e)

O módulo de Serviços permite consultar notas Prestadas e Tomadas, além de oferecer ferramentas de correção em lote.

Zerar ISS (Tomados)

Ferramenta para remover destaque de ISS indevido em notas de terceiros (Tomados) de forma massiva.

Ajuste Inteligente de PIS/COFINS

Recalcula os impostos federais para todas as notas filtradas (Prestadas e Tomadas).

  • Diferenciação Automática: Aplica CST de Faturamento para Prestados e CST de Crédito para Tomados.
  • Base de Cálculo: Respeita regras da Tabela de Serviço, incluindo base reduzida ou zerada.

19. Gestão de Faturas

O painel de Faturas permite o controle financeiro dos documentos fiscais, consolidando vencimentos e valores.

Consulta e Filtros

Localize faturas por período, número ou tipo de operação (Entrada, Saída, Serviços).

Use o botão Exportar XLS para gerar planilhas para conferência financeira.

Geração Automática

Algumas notas importadas podem não conter a fatura XML. O sistema identifica essas pendências através do contador "Notas sem Fatura".

Funcionalidade: Ao clicar na ferramenta, o sistema gera faturas fictícias (data de hoje) para todas as notas do filtro atual que estão sem financeiro, permitindo o fechamento.

20. Exportações

SPED Fiscal

Gera o arquivo TXT pronto para validação no PVA da Receita Federal.

Outros Sistemas

Integração com contabilidade (Domínio, Prosoft, Contatic). Gera arquivos customizados por modelo (55, 59,ISS).

Relatórios Excel

Entradas, Saídas e Inventário em formato .XLS. Novos filtros específicos:

  • Participantes: Filtro de cadastro incompleto.
  • Relacionamento: Filtro por período.
  • Serviços: Filtro de CST.

*Log de Importação temporariamente desabilitado.

21. Apuração de Impostos

O sistema processa todos os documentos fiscais importados e oferece um painel completo para fechamento mensal de ICMS e IPI.

Apuração de ICMS

Cálculo automático baseado no confronto entre créditos e débitos.

  • Entradas (Crédito): Soma do valor de ICMS de todas as notas de compra, agrupadas por CFOP.
  • Saídas (Débito): Soma do valor de ICMS das vendas.
  • Saldo: Indica se há imposto a recolher ou saldo credor para o próximo mês.
Apuração de IPI

Controle para indústrias e equiparados.

  • Regra: Processa apenas itens com CST de IPI suscetível a crédito/débito.
  • Detalhamento: Apresenta a base de cálculo e valor do imposto linha a linha, também consolidado por CFOP.
  • Relatórios: O Resumo agora conta com Impressão PDF (com Gráfico de Movimentação e dados da empresa) e Exportação Excel formatada para facilitar a análise.

22. Visão Geral (Pessoal)

O Módulo Pessoal é focado na gestão de frequência e apontamentos dos funcionários, permitindo o controle de faltas, lançamentos diversos e a integração com sistemas de folha de pagamento.

23. Manutenção de Ponto

Esta é a tela principal para o dia a dia do RH (Manutenção > Lançamentos de Ponto).

  • Visualização: Exibe os lançamentos por funcionário e mês.
  • Lançamentos: Permite adicionar eventos (Proventos/Descontos).
  • Controle de Faltas: Inserção e exclusão de faltas, com cálculo automático de dias.
  • Histórico: Registro detalhado de todas as alterações.

24. Controle de Lote

Ferramenta para gestão em massa (Manutenção > Controle de Lote).

Permite excluir todo o movimento de um mês específico caso seja necessário reprocessar a folha ou corrigir importações incorretas.

Cuidado: A exclusão de lote é irreversível e remove todos os lançamentos e faltas do período selecionado.

25. Importação de Arquivos

O sistema permite importar dados de relógio de ponto ou arquivos de integração.

  1. Acesse Importação > Ponto.
  2. Selecione o arquivo desejado.
  3. O processamento identificará funcionários e eventos automaticamente baseados nos cadastros.

26. Exportação (Integração)

Para fechar a folha, você pode exportar os dados para o sistema contábil (Domínio).

  • Gera arquivo formatado com as rubricas e horas calculadas.
  • Facilita o envio de informações para o contador ou departamento responsável.