Organizações
Uma Organização é o inquilino de nível mais alto no MIDDAG Account. Ela representa uma empresa, instituição ou pessoa jurídica que é seu cliente. Todo dado no sistema — entitlements, colaboradores, faturas, contratos, licenças, pedidos, serviços — pertence a uma Organização.
Se você está acostumado com o WooCommerce tratando cada comprador como um usuário individual, aqui está a mudança: o MIDDAG Account trata cada comprador como uma empresa. Pessoas pertencem a empresas. Empresas compram produtos. Produtos geram entitlements.
O que uma Organização contém
Ao abrir uma Organização na interface admin, você vê tudo sobre aquele relacionamento com o cliente em um só lugar:
- Colaboradores — as pessoas que pertencem à organização, cada uma com seu próprio papel e permissões
- Entitlements — o que a organização tem acesso (licenças de software, ambientes gerenciados, serviços, cursos)
- Pedidos — histórico de compras, incluindo assinaturas
- Faturas — registros financeiros e status de pagamento
- Propostas — propostas comerciais, aceitas ou pendentes
- Contratos — acordos de serviço com termos e SLA
- Licenças — licenças de software com detalhes de ativação
- Ambientes — instalações de hospedagem gerenciada
- Serviços — trabalho contínuo ou baseado em projetos
- Documentos — arquivos compartilhados, certificados, relatórios
Sem necessidade de verificar o Stripe para pagamentos, o HubSpot para contatos e o WooCommerce para pedidos separadamente. A Organização é a visão única.
Campos da Organização
Toda Organização possui as seguintes informações:
| Campo | Finalidade |
|---|---|
| Nome | O nome fantasia (como você se refere ao cliente no dia a dia) |
| Razão social | O nome oficial registrado (aparece em faturas e documentos fiscais) |
| Identificação fiscal | CNPJ (Brasil), EIN (EUA), número de VAT ou equivalente — o rótulo se adapta por país |
| Endereço | Endereço completo: rua, cidade, estado, CEP, país |
| País | Determina moeda padrão, regras fiscais e roteamento da entidade de cobrança |
| Moeda | Moeda preferida (BRL ou USD) — usada em propostas e faturas |
| Entidade de cobrança | Qual entidade MIDDAG fatura este cliente: middag_br ou middag_global |
| IDs do Stripe | IDs de cliente Stripe separados para as contas BR e GLOBAL |
| IDs do HubSpot | IDs de empresa HubSpot separados para as contas BR e GLOBAL |
Os IDs duais do Stripe e do HubSpot existem porque a MIDDAG opera como duas entidades legais (Brasil e EUA). Cada Organização é roteada para a entidade correta de cobrança e CRM. Administradores podem sobrescrever isso por transação, se necessário.
Estados de verificação
Antes de uma Organização poder realizar compras, aceitar propostas ou receber documentos fiscais, ela precisa ser verificada. A verificação confirma que a empresa é real e que sua identificação fiscal é válida.
| Estado | O que significa |
|---|---|
| pending | A organização acabou de ser criada. Nenhuma documentação enviada ainda. |
| under_review | O cliente enviou a documentação. Aguardando análise do admin. |
| verified | Admin aprovou. A organização pode comprar, aceitar propostas e receber faturas. |
| rejected | Admin rejeitou. O cliente pode reenviar a documentação. |
A verificação automática é suportada para algumas identificações fiscais. Por exemplo, um CNPJ brasileiro pode ser validado contra a API da Receita Federal. Se a válidação for aprovada, a organização vai diretamente para verified sem análise manual.
Quando uma organização se torna verificada, o MIDDAG Account dispara um hook que sincroniza os dados com o HubSpot e envia um e-mail de boas-vindas.
Organizações pai-filho
Organizações podem ser organizadas em hierarquia: uma holding no topo, com subsidiárias abaixo. Isso suporta estruturas corporativas em que uma entidade-mãe gerencia várias empresas filhas.
Regras:
- A hierarquia suporta até 3 níveis de profundidade (holding, subsidiária, filial).
- Cada nível precisa ser uma entidade faturável com sua própria identificação fiscal.
- A profundidade não é recursiva — o máximo é fixo e configurável pelo admin.
- Uma subsidiária só pode pertencer a uma matriz por vez.
Roteamento multi-entidade
A MIDDAG opera duas entidades legais: MIDDAG BR (Brasil) e MIDDAG GLOBAL (LLC nos EUA). Toda transação — pedido, fatura, proposta — é automaticamente roteada para a entidade correta com base em:
- O tipo de identificação fiscal da Organização (CNPJ roteia para BR, EIN/VAT roteia para GLOBAL)
- A configuração de entidade de cobrança da Organização
- A tag de entidade do produto
- A moeda preferida como fallback
Administradores podem sobrescrever o roteamento para qualquer transação individual. O roteamento determina qual conta Stripe processa o pagamento, qual conta HubSpot registra o negócio e quais regras fiscais se aplicam.
Quando criar uma Organização
Crie uma Organização quando:
- Um novo cliente se cadastra pelo portal (autoatendimento)
- O time comercial fecha um negócio e precisa fazer o onboarding do cliente
- Um admin configura manualmente um cliente pelo WordPress admin
- Um negócio é sincronizado do HubSpot e requer um registro de Organização correspondente
Não crie uma Organização para consumidores individuais comprando um único produto. Para cenários B2C, o MIDDAG Account suporta entitlements independentes que não estão vinculados a nenhuma Organização (veja Entitlements para detalhes sobre entitlements soberanos).
O que os admins veem
No WordPress admin, a listagem de Organizações mostra:
- Nome da organização e razão social
- Identificação fiscal
- Status de verificação (com indicadores de cor)
- Número de colaboradores
- Número de entitlements ativos
- Entidade de cobrança (BR ou GLOBAL)
- Data de criação
Admins podem filtrar por status de verificação, entidade de cobrança ou intervalo de datas. Clicar em uma Organização abre sua visão detalhada com abas para colaboradores, entitlements, pedidos, faturas e todos os outros registros relacionados.
Admins também podem:
- Aprovar ou rejeitar a verificação (com nota de justificativa obrigatória)
- Suspender uma Organização (bloqueia o acesso ao portal para todos os membros sem excluir dados)
- Vincular ou desvincular IDs do Stripe e HubSpot manualmente
- Configurar relacionamentos pai-filho
- Criar Organizações diretamente para clientes que não se cadastraram
- Mesclar Organizações duplicadas que representam a mesma pessoa jurídica
Isolamento de dados
Os dados da Organização são estritamente isolados. Toda consulta no sistema filtra por organization_id. Dados de uma Organização nunca vazam para a visão de outra Organização — nem na interface admin, nem na API REST, nem em exportações. Isso é aplicado no nível de middleware, não apenas no nível de interface.
Páginas relacionadas
- Colaboradores — as pessoas dentro de uma Organização
- Entitlements — o que uma Organização tem acesso
- Pedidos — como as compras são conectadas a uma Organização
- Como os Conceitos se Conectam — o diagrama completo de relacionamentos