Pular para o conteúdo principal

Seção de Unidades - Fipli

Descrição​

A seção de Unidades no Fipli permite cadastrar, consultar e gerenciar as empresas ou unidades operacionais associadas ao domínio. Cada unidade pode representar uma empresa, filial, operação, localidade ou cadastro pessoal usado para separar movimentações, configurações fiscais, integrações bancárias, módulos habilitados e permissões.

Na interface, essa área pode aparecer com o título Empresas, e o botão de criação aparece como Nova Empresa. Mesmo assim, a funcionalidade corresponde ao cadastro de unidades do sistema. A partir dessa tela, o usuário consegue acompanhar unidades ativas e inativas, criar novos cadastros, editar dados gerais, configurar nota fiscal, selecionar módulos, cadastrar contas de e-mail, configurar integrações bancárias, exportar a lista e ativar ou desativar unidades quando necessário.

Funcionalidades Principais​

Listar unidades​

Para listar unidades, acesse Unidades pelo menu lateral. A tela abre a listagem com o título Empresas, pois cada unidade cadastrada representa uma empresa ou unidade operacional dentro do sistema.

No topo da tela ficam os botões Nova Empresa e Exportar. Ao lado deles há o filtro de status com as opções Ativos, Inativos e Todos. Logo abaixo, a tela mostra contadores de Empresas, Ativas e Inativas, indicando a quantidade de registros carregados.

A listagem é carregada automaticamente ao abrir a tela. A tabela fica abaixo dos contadores e apresenta as seguintes colunas:

  • Ativo: Indica se a unidade está ativa ou inativa.
  • Nome: Nome usado para identificar a unidade no sistema.
  • CNPJ: Documento da unidade empresarial, quando houver.
  • Endereço: Endereço principal cadastrado.
  • Telefone: Telefone da unidade.
  • Observação: Observação interna cadastrada.
  • Ações: Botões para editar, ativar ou desativar a unidade.

Use o filtro Ativos para visualizar somente unidades ativas, Inativos para visualizar unidades desativadas e Todos para consultar os dois status na mesma tabela. A troca de status filtra os dados já carregados na tela.

Para exportar a lista, clique em Exportar, localizado no topo da tela. Se não houver dados carregados, o sistema exibirá Sem dados para exportar. Quando houver dados, será exibida a confirmação Deseja exportar esses registros?. Ao confirmar em Exportar, o sistema gera uma planilha Excel com nome, CNPJ, endereço, telefone e status ativo.

O botão Nova Empresa pode não aparecer quando o plano contratado atingir o limite de unidades ativas permitido.

Desativar unidade​

Para desativar uma unidade, mantenha o filtro de status em Ativos ou Todos, localize a unidade na tabela e vá até a coluna Ações, localizada no lado direito da linha.

Clique no botão vermelho com ícone de lixeira. O sistema exibirá uma confirmação com o título Desativar e a pergunta Deseja desativar esse registro?.

Clique em Desativar para confirmar. Após a confirmação, a unidade será marcada como inativa, a listagem será recarregada e o sistema exibirá a mensagem Unidade desativada com sucesso.

A desativação não exclui a unidade nem remove seu histórico. Ela apenas altera o status do cadastro, impedindo que a unidade seja tratada como ativa nas rotinas do sistema.

Ativar unidade​

Para ativar uma unidade, selecione o filtro de status Inativos ou Todos no topo da tela.

Na tabela, localize a unidade inativa e vá até a coluna Ações. Clique no botão verde com ícone de confirmação.

O sistema exibirá uma confirmação com o título Ativar e a pergunta Deseja ativar esse registro?. Clique em Ativar para confirmar.

Depois da confirmação, a unidade volta a ficar ativa, a listagem é atualizada e o sistema exibe a mensagem Unidade ativada com sucesso.

Editar unidade​

Para editar uma unidade, mantenha o filtro em Ativos ou Todos, localize o registro na tabela e clique no botão verde com ícone de lápis na coluna Ações.

A janela Alterar Unidade será aberta sobre a tela. No topo da janela aparecem o título, uma descrição curta e o botão de fechar no canto superior direito. Abaixo, o formulário é organizado em abas:

  • Cadastro: Dados principais, identificação, contato e endereço.
  • Nota Fiscal: Configurações fiscais, emissão de notas, certificado, logo e CNAEs.
  • Configurações: Token técnico da unidade, módulos habilitados e, quando aplicável, fluxo de aprovação.
  • Contas de e-mail: Contas usadas para busca automática de documentos por e-mail.
  • Integrações Bancárias: Configurações de bancos, SMTP de cobrança, webhook e rodapé dos e-mails.

Na aba Cadastro, revise ou altere os dados gerais:

  • Nome: Nome da unidade. Campo obrigatório.
  • CNPJ: Documento da unidade empresarial. Na edição, esse campo fica bloqueado.
  • Nome Fantasia e Razão Social: Campos usados para unidade empresarial. A razão social é obrigatória para unidade empresarial.
  • Telefone: Telefone da unidade.
  • E-mail principal, E-mail opcional 1 e E-mail opcional 2: E-mails de contato. Quando preenchidos, devem ser válidos.
  • CEP, Estado, Cidade, Bairro, Endereço, Complemento e Número: Dados de endereço. CEP, endereço, cidade, estado e bairro são obrigatórios.
  • Observação: Observação interna sobre a unidade.

Na aba Nota Fiscal, configure os recursos fiscais da unidade:

  • Gerar NFS-e, Gerar NFS-e Nacional, Gerar NF-e, Gerar NFC-e e Consultar NF-e: Marcam os tipos de documento fiscal usados pela unidade.
  • Regime da Empresa: Obrigatório quando Gerar NFS-e estiver ativo.
  • Inscrição Municipal: Obrigatória para NFS-e tradicional quando Gerar NFS-e estiver ativo.
  • Inscrição Estadual: Obrigatória quando Gerar NF-e ou Gerar NFC-e estiver ativo. É possível informar ISENTO.
  • CSC NFC-e e ID Token NFC-e: Obrigatórios quando Gerar NFC-e estiver ativo.
  • Logo: Imagem usada em documentos e exibições.
  • Certificado digital A1: Arquivo .pfx ou .p12 usado na emissão fiscal. Ao enviar um novo certificado, informe a senha e clique em Validar certificado A1.
  • Gerenciar CNAE e códigos de serviço: Abre a janela de CNAEs da unidade, onde é possível buscar CNAE, adicionar, ativar, desativar, remover e salvar alterações.

Na aba Configurações, revise o Token API (exclusivo desta unidade) quando estiver editando uma unidade. O token pode ser copiado pelo ícone ao lado do campo. Nessa aba também é possível selecionar os Módulos da unidade. Quando o módulo de conciliação estiver habilitado, aparece a opção Conciliação automática. Quando o módulo de fluxo de aprovação estiver habilitado, aparecem as opções de fluxo, como Selecione os perfis na ordem e Pagar somente com aprovação.

Na aba Contas de e-mail, clique em Incluir e-mail para cadastrar uma conta usada na captura de documentos por e-mail. A janela permite escolher o tipo de conta:

  • Google: Conecta uma conta Gmail por autenticação Google.
  • Microsoft: Conecta Outlook ou Microsoft 365 por autenticação Microsoft.
  • IMAP: Usa configuração manual de servidor, porta, usuário e senha.

Depois de cadastrar contas, a tabela da aba exibe Provedor, E-mail, Pastas, Status e Ações. Nas ações, é possível editar, ativar, desativar ou remover uma conta. Ativações, desativações e remoções exibem confirmação antes de aplicar.

Na aba Integrações Bancárias, revise ou configure:

  • Webhook da unidade: URL usada para envio de eventos. O botão de teste envia um payload de exemplo pelo back-end.
  • Bancos: Cards de integrações como Asaas, C6 Bank e Cora. Cada card indica se está configurado e abre uma janela própria para credenciais.
  • Configurar Asaas: Permite informar o Token do Asaas.
  • Configurar C6 Bank: Permite enviar certificado e chave, além de informar C6 Client ID, C6 Client Secret, Chave PIX (C6) e Chave aleatória do Bolepix.
  • Configurar Cora: Permite enviar certificado, chave e informar Cora Client ID.
  • Utilizar este e-mail para envio de cobranças: Habilita SMTP próprio da unidade. Quando ativo, exige E-mail de cobrança, Senha, Porta e Endereço SMTP.
  • Texto a ser anexado no rodapé dos e-mails de cobrança: Texto opcional de rodapé, com limite de 250 caracteres.

Após alterar os dados necessários, clique em Alterar, no rodapé da janela. O sistema exibirá a confirmação Deseja realmente editar esse dado?. Clique em Editar para gravar as alterações.

Se clicar no botão de fechar no canto superior direito, o sistema exibirá a confirmação Deseja realmente fechar a tela de cadastro?. Clique em Fechar para sair da janela ou em Cancelar para voltar ao formulário.

Por segurança, credenciais sensíveis, como senhas, tokens e segredos, não voltam preenchidas ao reabrir a tela. Preencha esses campos novamente apenas quando quiser alterar o valor salvo.

Criar unidade​

Para criar uma unidade, clique em Nova Empresa, localizado no topo da tela de unidades. Se o botão não aparecer, o limite de unidades ativas do plano pode ter sido atingido.

A janela Adicionar Unidade será aberta. No topo da janela aparecem o título, uma descrição curta e o botão de fechar no canto superior direito. Abaixo, use as abas para preencher o cadastro.

Na aba Cadastro, comece pelo bloco Tipo de unidade e escolha:

  • Unidade Empresarial: Usada para empresa com CNPJ.
  • Unidade Pessoal: Usada quando a unidade não possui CNPJ empresarial.

Para Unidade Empresarial, preencha o CNPJ. Ao informar um CNPJ válido, o sistema pode buscar automaticamente dados públicos da empresa, como razão social, telefone, nome fantasia, CEP, endereço, cidade, estado, bairro, complemento e número. Revise os dados preenchidos antes de salvar.

Em seguida, preencha os blocos principais:

  • Dados principais: Informe o Nome da unidade. Esse campo é obrigatório.
  • Razão social e marca: Para unidade empresarial, revise Nome Fantasia e preencha Razão Social, que é obrigatória.
  • Contato: Informe Telefone, E-mail principal, E-mail opcional 1 e E-mail opcional 2, conforme necessário.
  • Endereço: Informe CEP, Estado, Cidade, Bairro, Endereço, Complemento, Número e Observação. Ao informar um CEP válido, o sistema pode preencher automaticamente parte do endereço.

Depois, configure as demais abas conforme a necessidade da unidade:

  • Em Nota Fiscal, marque os tipos de documento fiscal que a unidade emitirá ou consultará, informe regime, inscrições, certificado, logo e CNAEs quando aplicável.
  • Em Configurações, selecione os módulos que a unidade poderá usar.
  • Em Contas de e-mail, inclua contas de e-mail para captura automática de documentos, caso essa rotina seja usada.
  • Em Integrações Bancárias, configure bancos, webhook, SMTP de cobrança e rodapé de e-mail quando necessário.

Antes de salvar, o sistema valida os campos obrigatórios. As principais validações são:

  • Para unidade empresarial, o CNPJ deve ser válido e obrigatório.
  • Nome é obrigatório.
  • Para unidade empresarial, Razão Social é obrigatória.
  • CEP, Endereço, Cidade, Estado e Bairro são obrigatórios.
  • E-mails preenchidos devem ter formato válido.
  • Se Gerar NFS-e estiver ativo, é necessário preencher Regime da Empresa; para NFS-e tradicional, também é necessário preencher Inscrição Municipal.
  • Se Gerar NF-e ou Gerar NFC-e estiver ativo, é necessário preencher Inscrição Estadual ou informar ISENTO.
  • Se Gerar NFC-e estiver ativo, é necessário preencher CSC NFC-e e ID Token NFC-e.
  • Se o envio de cobrança por SMTP estiver ativo, é necessário preencher E-mail de cobrança, Senha, Porta e Endereço SMTP.

Com os dados preenchidos, clique em Salvar, no rodapé da janela. O sistema exibirá a confirmação Deseja realmente salvar esse dado?. Clique em Salvar para concluir o cadastro.

Se clicar no botão de fechar no canto superior direito antes de salvar, o sistema exibirá a confirmação Deseja realmente fechar a tela de cadastro?.