API: empresa

Dados da empresa autenticada e listagem de empresas do usuário.

GET/api/public/v1/meAuth: API key

Retorna os dados da empresa associada à API key e o tipo (embarcador/transportadora).

json

{
  "company": {
    "id": "uuid",
    "name": "Acme Logística",
    "cnpj": "12345678000199",
    "type": "carrier",
    "plan": "pro"
  },
  "api_key": {
    "name": "ERP produção",
    "scopes": ["read", "write"]
  }
}

Minhas empresas (multi-empresa)

Um mesmo usuário pode ter papel ativo em várias empresas. Pelo app, essa lista alimenta o seletor de escopo do topo. A listagem é exposta via server function autenticada getMyCompanies, retornando as empresas em que o usuário logado possui um membership ativo.

json

[
  {
    "id": "uuid",
    "name": "Acme Logística — Matriz SP",
    "cnpj": "12345678000199",
    "role": "admin"
  },
  {
    "id": "uuid",
    "name": "Acme Logística — Filial RJ",
    "cnpj": "12345678000272",
    "role": "operador"
  }
]

Escopo ativo

O escopo ativo do usuário (uma empresa específica ou Todas) é mantido em sessão e filtra todas as demais respostas da API quando a chamada é feita em nome do usuário. API keys de servidor sempre atuam no contexto da empresa dona da chave.

Criar uma nova empresa

A criação de empresas adicionais é hoje feita exclusivamente pelo app, por usuários com papel admin em alguma empresa. Veja o guia de multi-empresa para o passo a passo. A exposição via API pública está prevista, mas ainda não está disponível.