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, plano, recursos liberados 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, definir o plano e os recursos disponíveis, configurar nota fiscal, cadastrar contas de e-mail, 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.
  • Fluxo de aprovação: Perfis participantes e regra de pagamento, quando esse recurso fizer parte do plano da unidade.
  • Contas de e-mail: Contas usadas para busca automática de documentos por e-mail.

As integrações bancárias e o SMTP de cobrança são configurados no cadastro de Conta Bancária, para que cada conexão fique vinculada à conta correspondente.

Na aba Cadastro, revise ou altere os dados gerais:

  • Plano da unidade: Plano associado à unidade. Para usuários com permissão de gestão, a seleção é obrigatória e determina as ferramentas disponíveis. Usuários sem permissão para alterá-lo visualizam somente o plano atual e seus recursos.
  • 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.

O Token da API da unidade fica disponível no cadastro de unidades para os usuários que possuem acesso à API. Copie-o para preencher o campo unit_token nas operações da API; a autenticação continua sendo feita com o token de API do domínio.

As ferramentas não são mais marcadas individualmente no cadastro da unidade: elas são exibidas conforme o plano selecionado. Quando o plano incluir o fluxo de aprovação, a aba Fluxo de aprovação permite definir os perfis na ordem desejada e, se necessário, habilitar 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.

Os webhooks de recebimento também não exigem uma URL informada manualmente. Ao salvar uma conexão bancária, o Fipli registra automaticamente os endpoints necessários no provedor. Quando exibidos para a unidade, esses endereços são somente para consulta e cópia, separados por provedor, e recebem eventos de cobranças, PIX e PIX Automático. Use Testar integração para validar as credenciais do provedor; esse teste não cria nem altera cobranças.

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:

  • Plano da unidade: Selecione o plano que a unidade utilizará. Ele é obrigatório para quem pode administrar planos e define as ferramentas liberadas no cadastro.
  • 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 Fluxo de aprovação, defina os perfis e a exigência de aprovação caso esse recurso esteja disponível no plano selecionado.
  • Em Contas de e-mail, inclua contas de e-mail para captura automática de documentos, caso essa rotina seja usada.
  • Depois de salvar a unidade, cadastre as contas e conexões em Conta Bancária, inclusive o SMTP e o rodapé dos e-mails de cobrança quando necessários.

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.
  • O Plano da unidade é obrigatório para usuários com permissão de escolhê-lo.
  • 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.

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?.