Empresas

As empresas reúnem as pessoas da comunidade que trabalham juntas: a startup da sala 3 de um coworking, o escritório associado de uma entidade, a empresa cliente de uma comunidade de clientes. Cada empresa tem um nome e uma equipa, e uma das pessoas pode ser admin da empresa e cuidar da própria equipa, sem depender da gestão.

A empresa serve para qualquer comunidade. Num coworking, ganha o bloco opcional Coworking (Empresa no coworking), que guarda o tipo de residência, os planos e produtos que a empresa pode contratar, os dados de faturação (denominação social, CNPJ e e-mail de faturação) e as datas de início e de saída. A empresa subscreve e paga em nome próprio, com o CNPJ dela: o plano que contrata dá acesso a toda a equipa, e os créditos do plano vão para uma carteira da empresa, que paga as reservas de qualquer pessoa da equipa.

A empresa não é um membro: não tem login, não aparece na lista de membros nem nas contagens. Quem entra na comunidade são as pessoas da equipa, cada uma com a sua conta.

#Para que serve

#Como funciona

#Onde fica

• Administração › Membros, secção Empresas: a lista das empresas, para o proprietário, o administrador, o financeiro e o moderador. É ali que se edita, convida e encerra. O botão Nova empresa fica no cabeçalho de Membros, para o proprietário e o administrador. Os links antigos de Empresas levam para essa aba.
• A minha empresa, no painel da sua fotografia, no topo: a empresa em que está e a equipa dela. O item só aparece para quem está na equipa de uma empresa. Todos os funcionários veem, na aba Equipa, o cartão O que tem através da empresa; o admin da empresa vê também as abas Contratar, Faturação e Créditos.
• Faturação (A Minha Conta › Faturação, /account?tab=billing; o antigo /billing leva para lá): quem tem acesso através de uma empresa vê no topo o cartão Através da sua empresa {nome}, com os planos da empresa e a ligação Ver a minha empresa.

#Os dados da empresa

O formulário Nova empresa (e Editar empresa) tem duas colunas:

• Dados gerais: o Nome da empresa, o único campo obrigatório. Como ele aparece na lista e em A minha empresa. Logo abaixo, o interruptor Avisar apenas os administradores da empresa sobre encomendas: desligado (a predefinição), "Todos os funcionários com acesso ao espaço de encomendas recebem o e-mail."; ligado, "Apenas os administradores da empresa recebem o e-mail quando chega uma encomenda para ela." Ver Encomendas › Encomenda para uma empresa.
• Coworking, com um interruptor. Ligado ("Empresa no coworking: tipo, ofertas, faturação e datas."), mostra os campos abaixo. Desligado ("Ative se a empresa estiver no coworking."), eles ficam vazios e a empresa é só nome e equipa.

A empresa fica Ativa até ser encerrada. Com o coworking ligado e a Saída prevista preenchida e no passado, ela passa a Encerrada pela data na lista, mas a equipa continua vinculada até alguém encerrar a empresa de fato (ver Encerrar uma empresa). Sem saída prevista, só o encerramento manual a encerra.

#Quem vê o quê

• O financeiro vê tudo, sem editar.
• O moderador vê só o nome, o selo e a equipa de cada empresa, sem o bloco Coworking.
• No detalhe da empresa, o proprietário, o administrador e o financeiro veem, com o coworking ligado, os cartões Coworking (tipo e datas), Ofertas (cada plano ou produto com o preço, por exemplo "R$ 640,00 por mês", e o botão Copiar link de compra), Faturação (denominação social, CNPJ e e-mail de faturação), Subscrições e Compras da empresa, e a secção Créditos da empresa, com o saldo e o extrato.
• O membro não vê a lista. Se ele está na equipa de uma empresa, vê a própria em A minha empresa.
• O admin da empresa vê A minha empresa com a equipa e as abas Contratar, Faturação e Créditos. Pode convidar e remover colegas, contratar e pagar enquanto a empresa está ativa. Os outros funcionários veem a equipa e o cartão O que tem através da empresa, sem preços.

#A empresa subscreve e paga

A empresa é a subscritora: a subscrição, a compra, o cartão e a cobrança ficam no nome dela, com o CNPJ dela, e não no de quem clicou em comprar.

• Quem contrata: só o admin da empresa, em A minha empresa › Contratar, entre os planos e produtos escolhidos no bloco Coworking. A gestão da comunidade não compra pela empresa; envia o link de compra.
• Checkout em modo empresa: é o checkout da Loja, com o aviso "Compra em nome de …: a subscrição fica na empresa, com o CNPJ dela." e o bloco Dados da empresa (Denominação social e CNPJ, já preenchidos com os dados de faturação). O CNPJ é obrigatório ("Indique o CNPJ da empresa."). O cupão vale normalmente, com os limites contados para a empresa.
• Sem período de teste: "As compras da empresa não têm período de teste: a cobrança começa no primeiro dia." Produto de preço zero não se compra pela empresa.
• Cupão de 100%: um cupão que anula o total (produto avulso, ou plano com cupão de 100% para sempre, sem adicionais) faz a empresa contratar sem pagamento e sem CNPJ, pelo Obter grátis. A confirmação diz "Contratado para {empresa}", o acesso já vale para a equipa e as renovações não cobram enquanto o cupão as cobrir. Num plano, um cupão de 100% uma vez ou repetindo é recusado. Ver Cupão de 100%.
• Acesso para toda a equipa: enquanto a subscrição ou a compra está ativa, cada pessoa com vínculo ativo na equipa tem acesso ao que o plano ou o produto liberta (espaços, conteúdos, cursos). Quem sai da equipa perde o acesso que vinha da empresa. Empresa encerrada, ou com a saída prevista vencida, não dá acesso a ninguém (o último dia ainda vale) e não é cobrada.
• Plano já subscrito: um funcionário não volta a subscrever, por conta própria, um plano que a empresa já paga: o checkout recusa, porque o plano já está ativo para ele.
• Faturação: em A minha empresa › Faturação, o admin da empresa vê cada subscrição da empresa, com Pagar agora quando a renovação está em atraso (ver Pagar agora), Mudar de plano, Adicionar extensão (os adicionais pedem o plano da empresa) e Cancelar subscrição, e por baixo as Compras da empresa. A renovação cobra o cartão da empresa.
• E-mails de cobrança: os e-mails de pagamento, recibo, falha, atraso, renovação, link de pagamento, reembolso e cancelamento de uma compra ou subscrição da empresa vão para o e-mail de faturação e para cada admin da empresa, uma vez por endereço, com a linha Empresa. O aviso de venda que a comunidade recebe mostra a empresa, o e-mail de faturação e Comprado por (o admin que fez o pedido).
• Nas listas da equipa: a compra da empresa aparece em Vendas com o nome da empresa como comprador, e a pesquisa de Vendas e de Gestão de subscrições encontra também pelo nome da empresa. A empresa nunca conta como membro.

#Os créditos da empresa

Os créditos dos planos e produtos que a empresa compra vão para a carteira da empresa, não para a de quem comprou. O proprietário e o administrador também atribuem e ajustam créditos da empresa (Atribuir créditos e Ajustar saldo, na secção Créditos da empresa do detalhe); o financeiro vê sem alterar.

• Quem usa: qualquer pessoa da equipa, ao reservar uma sala ou marcar um horário, escolhe em Pagar com entre Saldo da empresa e O meu saldo. Ver Reservas.
• Quem vê: o proprietário, o administrador, o financeiro e o admin da empresa (aba Créditos de A minha empresa). No extrato, cada uso em reserva mostra Usado por e o nome de quem reservou.
• Estorno: cancelar a reserva, marcar ausência ou libertar a sala por falta de check-in devolve os créditos a quem pagou: a empresa ou a pessoa.

#O que a equipa tem através da empresa

Em A minha empresa › Equipa, todos os funcionários (não só o admin) veem o cartão O que tem através da empresa: "Os planos e produtos que a empresa mantém ativos para toda a equipa, e os créditos dela que pode usar."

• Os planos e produtos ativos da empresa, cada um com o tipo (Plano ou o tipo do produto), os Espaços desbloqueados e os Conteúdos incluídos. Um plano que não desbloqueia nada específico mostra "Não desbloqueia espaços nem conteúdos específicos."
• Créditos da empresa: o saldo que a pessoa pode usar ao reservar, escolhendo pagar com a empresa, e o aviso de vencimento ("N créditos vencem em …") quando um lote está para vencer.
• Sem preços nem cobranças: valores, subscrições e pagamentos ficam nas abas do admin da empresa.
• Sem nada ativo, o cartão diz "Nada ativo através da empresa de momento". Com a empresa encerrada: "A empresa foi encerrada e já não dá acesso à equipa."

Na página Faturação, quem tem acesso através de uma empresa vê o cartão Através da sua empresa {nome}, com os planos da empresa logo abaixo (por exemplo Através da sua empresa Acme Tecnologia e Sala privativa mensal) e a ligação Ver a minha empresa. Assim ninguém subscreve por conta própria o que a empresa já paga.

#A equipa e o admin da empresa

A equipa de cada empresa mostra as pessoas com o selo Admin da empresa para quem é admin, e um selo de como entrou:

• Entrou pela empresa: a pessoa chegou à comunidade pelo convite da empresa.
• Já era membro da comunidade: a pessoa já estava na comunidade e só ganhou o vínculo com a empresa.

O proprietário ou o administrador marca um funcionário como admin da empresa com Tornar admin (e desfaz com Tirar admin). O admin da empresa convida colegas por e-mail e remove quem saiu. Ele não muda os dados da empresa nem marca outro admin.

#Convite com aceite

O convite funciona de dois jeitos, conforme quem convida:

Os convites do admin da empresa que ainda não foram respondidos aparecem em Convites pendentes (N), cada um com o e-mail e "Enviado a …". A lista mostra só o e-mail digitado, nunca se a pessoa já era da comunidade.

#Limites

• Uma pessoa fica numa empresa só. Quando o proprietário ou o administrador convida quem já está na equipa de outra empresa, o convite é recusado: "Esta pessoa já está na equipe de outra empresa." No convite do admin da empresa, a recusa só aparece para a própria pessoa, ao aceitar: "Já está na equipa de outra empresa; saia dela antes de aceitar este convite."
• O convite respeita o bloqueio da comunidade: se ela não está aceitando novos membros, o convite é recusado ("A comunidade não está aceitando novos membros agora.").
• O convite respeita quem recusou convites: quem pediu para não participar da comunidade não recebe o e-mail ("… pediu para não participar desta comunidade; o convite não foi enviado.").
• O admin da empresa envia até 30 convites por hora; acima disso, o ecrã pede para tentar mais tarde. O proprietário e o administrador da comunidade não têm esse limite.
• Uma empresa encerrada não aceita convites, e o admin dela não convida nem remove mais ninguém. O proprietário e o administrador da comunidade continuam podendo remover.

#Passo a passo

#Registar uma empresa

Proprietário ou administrador.

1. Abra Administração › Membros e clique em Nova empresa, no cabeçalho.
2. Em Dados gerais, preencha o Nome da empresa e, se só os administradores da empresa devem ser avisados das encomendas dela, ligue Avisar apenas os administradores da empresa sobre encomendas.
3. Se ela estiver no coworking, ligue o interruptor Coworking e escolha o Tipo de residência, os Planos e produtos que ela pode contratar e o Início. Os Dados de faturação e a Saída prevista são opcionais.
4. Clique em Registar. A empresa aparece na secção Empresas, ainda sem equipa.

Para mudar os dados depois, abra a empresa e use Editar.

#Enviar o link de compra

Proprietário, administrador ou financeiro.

1. Abra a empresa em Administração › Membros, secção Empresas.
2. No cartão Ofertas, clique em Copiar link de compra ("Link de compra copiado.").
3. Envie o link ao admin da empresa. Quem abre o link entra na comunidade (se ainda não tiver sessão iniciada) e chega a A minha empresa › Contratar.

Sem nenhuma oferta escolhida, o cartão avisa "Nenhuma oferta escolhida. Em Editar, escolha os planos e produtos que a empresa pode contratar."

#Contratar pela empresa

O admin da empresa.

1. Abra A minha empresa e a aba Contratar (ou o link de compra que a gestão enviou).
2. Escolha o plano (Subscrever) ou o produto (Contratar).
3. No checkout, confira os Dados da empresa (denominação social e CNPJ, obrigatório) e escolha a forma de pagamento.
4. Conclua. A subscrição aparece na aba Faturação, e toda a equipa passa a ter o acesso do plano.

Um funcionário que não é admin vê "Só o admin da empresa contrata planos e produtos para ela. Fale com o admin da sua empresa."; quem não está em nenhuma empresa vê que o link é para o admin de uma empresa. Com a empresa encerrada: "A empresa está encerrada: já não é possível contratar por ela."

#Pagar, mudar de plano ou cancelar

O admin da empresa.

1. Abra A minha empresa › Faturação.
2. Na subscrição, use Pagar agora (renovação em atraso), Mudar de plano, Adicionar extensão ou Cancelar subscrição. Tudo funciona como na página Faturação de um membro, mas a cobrança sai no CNPJ da empresa.

O cartão usado em Pagar agora passa a ser o cartão da empresa para as próximas renovações.

#Atribuir créditos à empresa

Proprietário ou administrador.

1. Abra a empresa e desça até Créditos da empresa.
2. Clique em Atribuir créditos (lote novo, com motivo e validade opcional) ou Ajustar saldo (somar ou remover, com motivo).

#Convidar para a equipa

Proprietário, administrador ou o admin da empresa.

1. Abra a empresa (em Administração › Membros, secção Empresas, ou em A minha empresa se for o admin dela) e clique em Convidar.
2. Informe o E-mail e, se a pessoa ainda não tem conta, o Nome.
3. O proprietário e o administrador podem marcar Admin da empresa já no convite.
4. Clique em Convidar.

Convidando como proprietário ou administrador, quem ainda não é membro entra na comunidade como membro e recebe o convite por e-mail; ele já aparece na equipa ("Convite enviado para …; a pessoa já está na equipa."). Quem já é membro só entra na equipa, sem e-mail ("… já era membro e entrou na equipa.").

Convidando como admin da empresa, o ecrã avisa "A pessoa recebe um convite por e-mail e só entra na equipa quando aceitar." e, ao enviar, "Convite enviado. A pessoa entra na equipa quando aceitar." O convite fica em Convites pendentes até a pessoa responder.

#Aceitar ou recusar um convite

A pessoa convidada pelo admin da empresa.

1. Abra o link do e-mail (Ver convite). Ele leva a A minha empresa; sem estar conectado, o ecrã pede "Inicie sessão para ver o seu convite".
2. O cartão mostra "Foi convidado para a empresa … por …", com "Só entra na equipa se aceitar."
3. Clique em Aceitar ou Recusar.

Aceitando, aparece "Entrou na equipa da empresa …" e a página passa a mostrar a empresa e a equipa. Recusando, "Convite da empresa … recusado.": a recusa é definitiva, e para entrar mais tarde é preciso um convite novo. Um convite já respondido, ou aberto com outra conta, mostra "Este convite já não está disponível: já foi respondido ou é de outra conta."

#Marcar o admin da empresa

Proprietário ou administrador.

1. Abra a empresa e encontre a pessoa em Equipe.
2. Clique em Tornar admin. Para desfazer, Tirar admin.

#Remover alguém da equipa

Proprietário, administrador ou o admin da empresa.

1. Na Equipe, clique em Remover ao lado da pessoa.
2. Leia o aviso e confirme.

O que acontece depende de como a pessoa entrou:

Quem entrou pela empresa mas depois ganhou outro papel na comunidade (moderador, por exemplo) continua na comunidade e só perde o vínculo. A empresa e o resto da equipa continuam como estão.

Ao remover alguém da equipa, a cobrança da pessoa removida fica suspensa; a subscrição continua registada até ser cancelada. Para encerrá-la de vez, cancele em Gestão de assinaturas.

#Encerrar uma empresa

Proprietário ou administrador.

1. Abra a empresa e clique em Encerrar.
2. A opção Remover todas as N pessoas da equipa vem marcada. Desmarcada, a equipa continua vinculada à empresa encerrada, e dá para remover cada pessoa depois.
3. Clique em Encerrar empresa.

A empresa deixa de aceitar convites, e o admin dela não convida nem remove mais ninguém. O registo e o bloco Coworking continuam registados, com a data em Encerrada em. Com a remoção marcada, vale a mesma regra de remover alguém: quem entrou pela empresa sai também da comunidade; quem já era membro só perde o vínculo. Não há como reabrir uma empresa encerrada; para a mesma empresa voltar, registe de novo. As encomendas que aguardavam a empresa continuam guardadas, com o selo Empresa encerrada, sem aviso por e-mail nem lembrete, e os funcionários deixam de as ver.

Com o coworking ligado, quando a Saída prevista passa, o ecrã avisa "O contrato terminou. Encerre a empresa para decidir o que acontece com a equipa.": a data sozinha não tira ninguém.

#Ver a sua empresa

Qualquer pessoa da equipa de uma empresa.

Clique na sua fotografia, no topo, e em A minha empresa. A página mostra a empresa, a equipa e o cartão O que tem através da empresa (planos, conteúdos e créditos da empresa; ver O que a equipa tem através da empresa). Se for o admin dela, aparece "É admin da empresa: pode convidar e remover pessoas da equipa.", com os botões para isso, os Convites pendentes e as abas Contratar, Faturação e Créditos ("Os créditos da empresa pagam reservas de qualquer pessoa da equipa. O extrato mostra quem usou cada um."). Com a empresa encerrada, a página mostra Empresa encerrada e "Já não é possível convidar nem remover pessoas da equipa."

Um convite pendente também aparece aqui, para a pessoa convidada aceitar ou recusar.

#Exemplos

Startup na sala privativa. O administrador regista Acme Tecnologia, liga o Coworking e escolhe Sala privativa, o plano Sala privativa mensal em Planos e produtos e o início em 1/11. Convida a sócia, [email protected], com Admin da empresa marcado, e envia-lhe o link de compra. A Maria entra, subscreve o plano em Contratar com o CNPJ da Acme e, em Equipa, convida os outros quatro funcionários. Cada um entra na equipa ao aceitar o convite e já tem o acesso do plano.

Sala de reuniões com os créditos da empresa. O plano da Acme dá 20 créditos por mês, que vão para a carteira da empresa. O João reserva a Sala 2 e escolhe Saldo da empresa em Pagar com. No extrato da empresa, o uso aparece com Usado por João; se ele cancelar dentro da janela, os créditos voltam para a empresa.

Funcionário que saiu. A Maria remove o João da equipa. Ele tinha entrado pelo convite da empresa, então sai também da comunidade e perde o acesso.

Fim do contrato. A Acme se muda no fim do ano. O administrador abre a empresa, clica em Encerrar com Remover todas as 5 pessoas da equipa marcado e confirma. O registo continua no histórico. A empresa encerrada deixa de ser cobrada e de dar acesso.

#Erros comuns e como resolver

#Perguntas frequentes

Escolher um plano ou um produto no registo cobra a empresa? Não. Só entra na lista do que a empresa pode contratar. A cobrança começa quando o admin da empresa contrata em A minha empresa › Contratar.

Cada funcionário precisa de subscrever? Não. O plano da empresa dá acesso a toda a equipa com vínculo ativo.

A empresa tem período de teste? Não. A cobrança da empresa começa no primeiro dia.

Minha comunidade não é um coworking. Posso usar empresas? Sim. Deixe o interruptor Coworking desligado: a empresa fica só com o nome e a equipa.

A empresa conta como membro? Não. Só as pessoas da equipa são membros.

O admin da empresa vê o que a empresa paga? Sim: em A minha empresa, as abas Contratar e Faturação mostram os preços, as subscrições e as compras. Os outros funcionários veem a equipa e o que têm através da empresa, sem preços.

Como é que o funcionário sabe o que tem através da empresa? Em A minha empresa › Equipa, no cartão O que tem através da empresa: os planos e produtos ativos, os espaços e conteúdos que desbloqueiam e os créditos da empresa. Na página Faturação, o cartão Através da sua empresa leva até lá.

Quem recebe os e-mails de cobrança? O e-mail de faturação da empresa e cada admin da empresa.

Uma pessoa pode trabalhar em duas empresas? Não. Cada pessoa fica numa empresa só.

Por que a pessoa que convidei não aparece na equipa? Porque o convite do admin da empresa depende do aceite. Até ela responder, o convite fica em Convites pendentes.

Dá para registar uma encomenda para a empresa? Sim. Na receção do espaço Encomendas, a pesquisa de destinatário mostra a empresa com o selo Empresa. Qualquer funcionário atual com acesso ao espaço vê a encomenda em As minhas encomendas ("Da empresa {nome}") e levanta-a; quem sai da empresa deixa de a ver.

Encerrar a empresa apaga o histórico? Não. O registo e o bloco Coworking continuam registados. A empresa encerrada deixa de dar acesso e de ser cobrada.

#Pelo assistente

São 14 ferramentas: a equipa da comunidade lista e lê as empresas (com as subscrições e o saldo de créditos); o proprietário e o administrador registam (com as ofertas e os dados de faturação), editam, encerram e marcam o admin da empresa; qualquer pessoa da equipa de uma empresa vê a própria, e o admin dela convida (com aceite) e remove colegas; a pessoa convidada vê, aceita e recusa os próprios convites. Encerrar, remover e recusar pedem confirmação. create_company e update_company aceitam parcel_notice_admins_only, para só os administradores da empresa receberem o aviso de encomenda. Para "o que tenho através da empresa?", o assistente usa get_my_company, que traz os planos, conteúdos e créditos da empresa. Ver Ferramentas · Empresas.

O admin da empresa também trata da cobrança pela conversa: vê as subscrições e as compras da empresa (list_my_subscriptions com company_id), paga uma renovação em atraso (pay_my_subscription_now), inclui um adicional, muda de plano e cancela, e lê a carteira de créditos (get_company_credit_balance). O que mexe em dinheiro pede confirmação, e pelo assistente só se paga com PIX ou boleto: a compra pela empresa e o cartão ficam na app.

#Na API

Com X-CommunityId no cabeçalho, a tag Companies reúne as rotas em /api/companies: listar e registar (GET e POST), a sua empresa (GET /mine), ler e editar uma (GET e PATCH /{id}), encerrar (POST /{id}/close), a equipa (GET e POST /{id}/members), marcar o admin (PATCH /{id}/members/{memberId}), remover (DELETE /{id}/members/{memberId}), os convites pendentes da empresa (GET /{id}/invitations), os seus convites (GET /invitations/mine) e aceitar ou recusar (POST /invitations/{invitationId}/accept e .../decline). A referência completa, gerada da API, está em Referência da API › Companies.

• Registo: POST e PATCH aceitam parcelNoticeAdminsOnly (verdadeiro ou falso, só proprietário e administrador; a empresa devolve o campo), offerProductIds (a lista substitui a anterior; só produtos digitais) e billing { legalName, taxId, email } (CNPJ só com dígitos, validado). A leitura traz offers, billing e purchaseLink; GET /mine traz offers, canPurchase, purchaseLink e, para o admin da empresa, billing. Os campos antigos planProductId, productId, monthlyValue, plan e product saíram: não são lidos nem devolvidos.
• Compra: POST /api/checkout e POST /api/checkout/calculate-price com companyId compram em nome da empresa (só o admin dela; CNPJ em customerData.document ou o já guardado).
• Cobrança: GET /api/subscriptions?companyId= e GET /api/purchases/me?companyId= listam o que é da empresa (só o admin dela); as rotas /api/subscriptions/{id}/… tratam o admin da empresa como subscritor. A equipa filtra com GET /api/manage/purchases?companyId=.
• Créditos: GET /api/credits/companies/{companyId} e /entries (com usedBy nos usos em reserva); POST /api/credits/grants e /adjustments aceitam companyId no lugar de memberId.
• O que a equipa tem: GET /api/companies/mine traz benefits para qualquer pessoa da equipa de uma empresa ativa: items (os planos e produtos ativos da empresa, com os spaces e contents que desbloqueiam) e credits (balance e expiringSoon), sem preços; com a empresa encerrada, null. GET /api/auth/me traz viaCompany (companyId, name, plans) ou null.
• Reservas: POST /api/bookings e POST /api/bookings/{id}/reschedule aceitam payWith (own ou company); a reserva traz creditPayer. Ver Reservas.

#Relacionados

• Papéis e permissões
• Convidar membros
• Política de convites
• Gerenciar membros
• Planos
• Créditos
• Checkout
• Gestão de assinaturas
• Encomendas