MIDDAG Account

Portugues

English

Portugues

English

Appearance

Integrar uma Nova Organização ​

Esta receita cria um novo cliente B2B do zero: configurando a Organização, preenchendo os dados empresariais, executando a verificação, adicionando o colaborador proprietário e convidando membros da equipe.

Pré-requisitos ​

  • Acesso de admin ao WordPress.
  • Plugin MIDDAG Account instalado e ativado.
  • Saber o nome legal do cliente, identificação fiscal (CNPJ para BR, EIN/VAT para internacional) e endereço de faturamento.

Passos ​

Parte A: Criar a Organização ​

Passo 1. Vá em MIDDAG Account > Organizations na barra lateral do admin do WordPress.

Passo 2. Clique em New Organization.

Passo 3. Preencha o Organization name (nome fantasia que o cliente usa no dia a dia).

Passo 4. Selecione a Billing Entity:

  • MIDDAG BR -- para clientes brasileiros que pagam em BRL.
  • MIDDAG GLOBAL -- para clientes internacionais que pagam em USD.

Isso determina qual conta Stripe, portal HubSpot e regras fiscais se aplicam. Veja Operações Multi-Entidade para detalhes.

Passo 5. Clique em Save. A Organização é criada com status pending.

Parte B: Preencher os dados empresariais ​

Passo 6. Na página de detalhes da Organização, abra a aba Business Data.

Passo 7. Preencha:

  • Legal name -- a razão social oficial da empresa.
  • Tax ID -- CNPJ (BR) ou EIN/VAT (internacional). Para organizações brasileiras, o formato do CNPJ é validado automaticamente.
  • Address -- rua, cidade, estado, CEP, país.
  • Tax regime (apenas BR) -- selecione o regime tributário aplicável (ex.: Simples Nacional, Lucro Presumido).
  • Primary activity (apenas BR) -- o código de atividade principal da empresa.

Passo 8. Clique em Save.

Parte C: Configurar integrações externas ​

Passo 9. Abra a aba Integrations na página de detalhes da Organização.

Passo 10. Vincule o Stripe Customer ID:

  • Se o cliente já existe no Stripe, cole o ID do cliente (ex.: cus_abc123).
  • Se não, você pode criar o cliente no Stripe depois, quando o primeiro pagamento for processado -- o sistema vincula automaticamente.

Passo 11. Vincule o HubSpot Company ID:

  • Cole o ID da empresa no HubSpot se o cliente já existir no HubSpot.
  • Se a sincronização vier do HubSpot, esse campo é preenchido automaticamente via webhook.

Passo 12. Clique em Save.

Parte D: Verificação ​

Passo 13. A Organização começa com status pending. Para movê-la para verified:

  • Solicite que o cliente envie documentos de verificação (normalmente registro empresarial, contrato social ou comprovante de endereço).
  • Quando os documentos forem recebidos, vá à página de detalhes da Organização e altere o status para under_review.

Passo 14. Revise os documentos enviados. Se tudo estiver correto, clique em Verify Organization. O status transita para verified.

Passo 15. Se os documentos forem insuficientes, clique em Reject e insira um motivo. O cliente é notificado e pode reenviar.

Nota: Organizações não verificadas podem visualizar dados no portal, mas não podem aceitar propostas comerciais nem gerenciar colaboradores.

Parte E: Adicionar o colaborador proprietário ​

Passo 16. Abra a aba Team na página de detalhes da Organização.

Passo 17. Clique em Add Collaborator.

Passo 18. Insira o endereço de e-mail do proprietário.

Passo 19. Defina o Role como owner. Deve haver exatamente um proprietário por Organização.

Passo 20. Os escopos são definidos automaticamente como todos os escopos para o papel de proprietário.

Passo 21. Clique em Send Invite. O sistema envia um e-mail de convite com um link de token (válido por 7 dias).

Passo 22. O proprietário recebe o e-mail, clica no link, define uma senha e obtém acesso ao portal.

Parte F: Convidar membros da equipe (opcional) ​

Passo 23. Ainda na aba Team, clique em Add Collaborator novamente para cada membro da equipe.

Passo 24. Insira o e-mail do membro, selecione um papel (admin, member ou guest) e escolha os escopos apropriados. Veja Convidar Colaboradores para a receita completa de convite.

Passo 25. Clique em Send Invite para cada um.

Resultado esperado ​

  • Um novo registro de Organização existe com status verified.
  • Os dados empresariais (razão social, identificação fiscal, endereço) estão completos e validados.
  • A entidade de faturamento está definida, direcionando todas as transações financeiras futuras corretamente.
  • IDs de integrações externas (Stripe, HubSpot) estão vinculados.
  • O colaborador proprietário aceitou o convite e pode fazer login no portal.
  • Quaisquer membros adicionais da equipe foram convidados.

Leitura complementar ​