Filial (Seller)

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

---

Onde a filial aparece

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)

Conta (Seller Group)

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.