Conta (Seller Group)

Entidade de mais alto nível: representa um cliente Abbiamo que agrupa filiais, usuários e configurações globais

Seller Group (grupo de embarcadores) é a entidade de mais alto nível no painel — representa a conta de um cliente Abbiamo. Uma conta pode ter várias filiais e vários usuários atuando sobre essas filiais.

No código e na API aparece como SellerGroup ou seller_group.

Conta vs. Filial

A conta (seller group) é o nível global: usuários, permissões e tema. Porém, operacionalmente, tudo acontece a nível de filial — pedidos, envios e integrações são sempre vinculados a uma filial específica.

O que compõe uma conta

Identificação

Campo	Descrição
`id`	Identificador interno
`name`	Nome da conta
`description`	Descrição (opcional)

Configurações globais

default_theme_id — tema padrão (logo, cores) aplicado quando não há configuração específica por filial
default_notification_preferences_id — preferências de notificação padrão

Usuários e permissões

Cada usuário pertence a uma conta e tem uma role (papel) com permissões granulares
O usuário pode ser admin, master ou read-only — algumas páginas e ações só ficam disponíveis para admin ou master

Filiais e contexto de uso

O usuário "enxerga" apenas as filiais da sua conta
No painel, o usuário pode selecionar todas as filiais ou algumas filiais. Essa escolha define o escopo dos dados em várias páginas (pedidos, envios, relatórios, integrações)
O tema (logo, cores) exibido no painel pode vir da primeira filial selecionada (white label), quando aplicável

Como se relaciona com as outras entidades

Entidade	Relação com a conta
Filial	Pertence a uma conta; é a unidade operacional
Usuário	Pertence a uma conta; tem role, permissões e lista de filiais acessíveis
Pedido	Pertence a uma filial, que pertence à conta
Envio	Pertence a um pedido → filial → conta
Integrações	Configuradas por filial dentro da conta