Profile Server API
Manual do usuário

Organizações

Cadastro de cooperativas e organizações, com endereços, contatos e documentos.

Menu: Organizações (/organizations)

Uma organização é uma cooperativa ou entidade operacional — quem de fato envia documentos para a plataforma.

Ação varia por perfil

O perfil visualizador só consulta organizações — os botões de cadastrar, editar e excluir ficam desabilitados. Veja Permissões.

A tela

Lista as organizações. Clicar em uma abre a página de detalhe, com os dados cadastrais e os painéis Endereços, Contatos e Documentos — mais o painel Tenants, que só o perfil global enxerga.

Criar uma organização

Clique em Nova organização:

CampoObrigatórioObservações
CPF / CNPJSimSomente números.
Razão socialSimNome oficial.
Nome fantasiaNãoNome de exibição.
Inscrição estadualNão
Inscrição municipalNão
AtivaOrganizações inativas saem da operação.
ListadaControla se a organização aparece nas listagens públicas dos apps. Quando desligada, o detalhe mostra o selo "Não listada".

Endereços

No painel Endereços do detalhe:

CampoObrigatórioObservações
CEPSimSomente números.
LogradouroSimRua/avenida.
NúmeroSim
ComplementoNãoSala, bloco etc.
BairroNão
EstadoSimUF — selecione primeiro para carregar as cidades.
CidadeSimBusca pelo nome, dentro do estado escolhido.

O endereço em uso aparece com o selo "Vigente".

Contatos

No painel Contatos:

CampoObrigatórioObservações
TipoSimTelefone, E-mail ou Site / URL.
ValorSimO telefone, e-mail ou endereço do site.
DescriçãoNãoRótulo livre (ex.: "Comercial").
Contato principalMarque o contato preferencial da organização.

Tenants

O painel Tenants mostra a quais tenants esta organização está vinculada. É o vínculo que define quem enxerga a organização: só os usuários dos tenants listados aqui veem os dados e os documentos dela.

  • Vincular tenant — selecione um tenant e clique em Adicionar. Tenants já vinculados não aparecem na lista de seleção.
  • Desvincular — o ícone de lixeira na linha do tenant. Aquele tenant deixa de alcançar esta organização.

É o mesmo painel Organizações da página do tenant, visto do outro lado — vincular aqui ou lá tem exatamente o mesmo efeito.

Desvincular também apaga os escopos por usuário

Se algum usuário daquele tenant tinha o acesso restrito a um conjunto de organizações que incluía esta, ela sai desse conjunto. Um usuário cujo acesso estava restrito a esta organização fica sem nenhuma organização naquele tenant — reveja o acesso dele na página do usuário.

Só o perfil global vê este painel

Definir o alcance de um tenant é atribuição do perfil global — nos demais perfis o painel Tenants não aparece na página da organização.

Documentos da organização

O painel Documentos mostra os documentos enviados por esta organização, com os mesmos status e ações da página Documentos — inclusive o envio de um documento novo já com a organização pré-selecionada.