Filial (Seller)

Unidade de negócio do embarcador: loja, restaurante ou ponto que emite pedidos e configura integrações

Filial é a unidade de negócio do embarcador: cada loja, restaurante ou ponto que emite pedidos e usa o sistema. No código e na API aparece como seller.

O que compõe uma filial

Identificação

Campo	Descrição
`id`	Identificador interno
`identifier`	Identificador externo/customizado
`trading_name`	Nome fantasia
`company_name`	Razão social

Documento

document_type / document_number — tipo e número do documento (CNPJ, CPF etc.)
state_registration — inscrição estadual

Contato e endereço

email / phone
address — dados completos do endereço da filial

Configuração

timezone — fuso horário da filial
country — país
active — se está ativa
operation_hours — horários de funcionamento

Conta (Seller Group)

seller_group_id — a conta à qual a filial pertence. Toda filial está vinculada a uma única conta

White label

Aparência/identidade (logo, cores) quando o painel é white label

Contexto	Relação
Pedido	Todo pedido pertence a uma filial (`order.seller`)
Envio	Todo envio está ligado a um pedido e, portanto, à filial desse pedido
Integração de transportadora	Configurada por filial (`seller_id`) — saiba mais
Integração de pedido	Configurada por filial (`seller_id`) — saiba mais
Relatórios	É comum selecionar quais filiais entram no escopo (ex.: relatório de pedidos por filial)

Uma conta pode ter dezenas de filiais. Cada filial tem suas próprias integrações, horários e configurações, mas compartilha o mesmo painel e usuários da conta. Operacionalmente, tudo acontece a nível de filial.