Empresa

Estas rotas devolvem os dados cadastrais da empresa dona da credencial: razão social, nome fantasia, CNPJ, inscrições, contato e endereço, e os locais que ela cadastrou. Servem para preencher cabeçalho de documentos e conferir o cadastro em outro sistema.

Escopo exigido: company:read. Sem ele, as rotas respondem scope_missing.

São dados da própria empresa, não de terceiros, e por isso têm rota e escopo próprios: GET /v1/me nunca traz CNPJ nem endereço. Não saem o responsável pela conta (nome, documento e e-mail), o plano nem a assinatura. Só a empresa da credencial: filiais e matriz não entram.

Testar na referência interativa

Dados da empresa

GET /v1/company

Campos: id (o mesmo workspaceId de /v1/me), tradeName, legalName, taxIdType e taxId (CNPJ ou CPF, só dígitos), stateRegistration, cityRegistration, phone, email, commercialEmail, website, instagram, facebook, o endereço (street, number, complement, neighborhood, postalCode, city, state) e updatedAt. Traz ETag.

Locais

GET /v1/company/addresses

Lista os locais cadastrados (matriz, salão, depósito): label, isDefault e o endereço. Lista curta, devolvida inteira (nextCursor nulo), com o local padrão primeiro.