Criar empresa

POST 
/v1/companies

Cria uma empresa (matriz ou filial). Para criar uma filial, informe parent_company_id — o CNPJ deve compartilhar o mesmo prefixo da matriz. Apenas empresas com CNPJ podem ter filiais. A primeira empresa criada na organização é marcada como is_default automaticamente.

Request

Responses

201

Empresa criada.

400

Corpo da requisição falhou na validação.

401

Token bearer ausente ou inválido.

403

Token válido, porém sem permissão para esta operação. Com code insufficient_scope, details.required traz o único conjunto mínimo de escopos que, somados a details.granted, deixaria a requisição passar: o escopo do recurso (billing/{recurso}, ou billing/all fora do catálogo) e depois o verbo puro — por exemplo ["billing/customers", "delete"].

404

Recurso não encontrado na organização atual.

422

Corpo da requisição falhou na validação.

429

Limite de requisições excedido.

500

Erro inesperado no servidor.