Overview
A criação de uma organização prepara a estrutura inicial da operação. Dependendo doOrganizationType, o resultado inclui a extensão necessária, uma role admin de ambiente compatível com o tipo da organização e o Invite do owner.
O onboarding não cadastra o User do owner. O owner só passa a existir na conta quando aceita o Invite — veja Invitation Flow.
Cascade Flow
Habilitações por tipo
A Organization habilita Cooperative ou Company conforme otype:
| Tipo | Cooperative | Company | Requisito adicional |
|---|---|---|---|
COOPERATIVE | Sim | — | Nenhum |
COMPANY | — | Sim | cooperativeId de uma Cooperative ativa |
address é opcional na criação e gera um OrganizationAddress quando informado.
Para type=COMPANY, a criação também define a afiliação administrativa da empresa. O cooperativeId informado deve apontar para uma Cooperative existente, ativa e não removida.
Admin Setup
Após a Organization e suas habilitações:- Role Admin — Uma Role
ENVIRONMENTcom o conjunto de permissions padrão compatível com o tipo da organização. - Invite do owner — Um Invite
type=MEMBERé emitido para o telefone/email do owner, com a Role Admin. No aceite, o owner define sua senha e recebe a MembershipACTIVEna nova organização; o Profile passa a derivaraccess:ops.
O owner é o primeiro membro e recebe a Role Admin no escopo da nova organização. Ele pode então convidar outros membros com roles
ENVIRONMENT ou roles customizadas da própria organização.Validações
| Validação | Erro |
|---|---|
| Documento (CNPJ) único | organization.document_already_exists |
cooperativeId obrigatório para type=COMPANY | organization.cooperative_required |
cooperativeId inexistente, inativo ou removido | organization.cooperative_not_found |