Onboarding da Organização
Quando um novo cliente B2B está pronto para fazer negócios, o primeiro passo é criar uma Organização. Esta página explica o processo de onboarding: o que é automatizado, o que requer ação manual e como as integrações externas são configuradas.
Visão geral
Uma Organização é a fronteira de tenant no MIDDAG Account. Cada dado do cliente -- entitlements, faturas, licenças, contratos -- pertence a uma Organização. O onboarding configura essa fundação corretamente para que todas as operações downstream funcionem sem atrito.
O fluxo de onboarding
Passo 1: Criar a Organização
Organizações podem ser criadas de duas formas:
- Pelo admin no painel admin do WordPress. O admin preenche o nome da organização, seleciona a entidade de faturamento e salva.
- Via sync do HubSpot. Quando uma empresa é criada ou atualizada no HubSpot, um webhook pode acionar a criação da organização no MIDDAG Account. O sistema mapeia os campos da empresa do HubSpot para os campos da organização automaticamente.
Ambos os caminhos produzem o mesmo resultado: um novo registro de Organização vinculado à entidade BR ou US.
Passo 2: Inserir dados empresariais
O registro da Organização contém informações empresariais:
- Razão social e nome fantasia
- Identificação fiscal (CNPJ para BR, EIN/VAT para US/internacional)
- Endereço completo (rua, cidade, estado, CEP, país)
- Regime tributário e atividade econômica principal (específico para BR)
Para organizações brasileiras, o CNPJ é validado quanto ao formato e dígitos verificadores. Organizações internacionais utilizam seu identificador fiscal local.
Passo 3: Definir entidade de faturamento
Toda Organização é associada a uma entidade de faturamento: MIDDAG BR ou MIDDAG GLOBAL (LLC). Isso determina:
- Qual conta Stripe processa os pagamentos
- Qual portal HubSpot acompanha o relacionamento
- Quais regras tributárias se aplicam (NFSe para BR, sem NFSe para US)
- Qual moeda é primária (BRL ou USD)
A entidade de faturamento é definida durante o onboarding e pode ser alterada posteriormente por um admin. Veja Operações Multi-Entidade para detalhes completos.
Passo 4: Fluxo de verificação
As Organizações passam por um fluxo de verificação antes de poder transacionar:
| Status | Significado |
|---|---|
pending | Recém-criada, nenhuma documentação enviada |
under_review | Documentação enviada, admin está analisando |
verified | Aprovada -- organização pode transacionar livremente |
rejected | Documentação rejeitada, com motivo declarado |
- O proprietário envia documentos de verificação (tipicamente registro empresarial).
- O admin analisa e aprova ou rejeita com justificativa.
- Organizações rejeitadas podem reenviar a documentação.
- O status de verificação e timestamps são registrados para auditoria.
Organizações não verificadas podem visualizar dados, mas não podem aceitar cotações ou gerenciar colaboradores.
Passo 5: Adicionar o primeiro colaborador (proprietário)
Toda Organização deve ter exatamente um proprietário. O proprietário é o primeiro colaborador adicionado durante o onboarding. Esta pessoa:
- Tem acesso total a todos os escopos
- Pode convidar outros colaboradores
- Pode transferir a propriedade para outro colaborador
- É o contato principal para notificações
Se a Organização foi criada pelo admin, o admin atribui o proprietário por e-mail. O proprietário recebe um e-mail de convite, define uma senha e obtém acesso ao portal.
Veja Gestão de Colaboradores para o fluxo de convite e a hierarquia de papéis.
Passo 6: Configurar integrações
Após a criação da Organização, o admin vincula identificadores externos:
- Stripe Customer ID -- Um para BR, um para US (ou ambos). Isso permite que o MIDDAG Account associe faturas e pagamentos do Stripe à Organização.
- HubSpot Company ID -- Um para cada portal HubSpot (BR, GLOBAL). Isso habilita a sincronização de negociações, cotações e dados de contato.
Esses vínculos são configurados na tela de detalhes da Organização no painel admin. Uma vez definidos, webhooks do Stripe e HubSpot roteiam dados automaticamente para a Organização correta.
O que é automatizado vs. manual
| Passo | Automatizado | Manual |
|---|---|---|
| Criação da organização | Via webhook do HubSpot (se configurado) | Admin cria diretamente |
| Inserção de dados empresariais | Parcial (sync do HubSpot) | Admin completa campos faltantes |
| Seleção da entidade de faturamento | Inferida pelo identificador fiscal | Admin confirma ou sobrescreve |
| Verificação | Transições de status são rastreadas | Admin analisa e aprova |
| Atribuição de proprietário | E-mail de convite enviado automaticamente | Admin insere e-mail do proprietário |
| Vinculação Stripe/HubSpot | -- | Admin insere IDs externos |
Após o onboarding
Assim que a Organização estiver verificada e o proprietário tiver aceito o convite, o cliente está pronto para:
- Receber e aceitar cotações
- Realizar compras
- Gerenciar sua equipe (convidar colaboradores)
- Visualizar entitlements, faturas e contratos no portal
O próximo passo no ciclo de vida é tipicamente a primeira compra.