Painel da empresa › Configurações
Cadastrar empresa
POST/api/v1/settings/registered-companiesPede sessãoComo funciona
Cadastra uma empresa para quem o cliente presta serviço. O corpo traz os dados cadastrais: razão social (companyName), CNPJ, e-mail de contato, telefone e endereço (zipCode, street, number, complement, district, city, state).
O CNPJ precisa ter 14 dígitos e não pode repetir na mesma conta (409). Fica na trilha de auditoria. Pede a permissão de criar e editar configurações.
Só o super admin cadastra empresa nova, pelo "Entrar como cliente" (sessão de suporte): ele cadastra a empresa-mãe e as filhas, e o gestor entra com tudo pronto. Fora da sessão de suporte, 403. Editar e excluir seguem com o gestor.
Parâmetros
cityCorpo · stringCidade.cnpjCorpo · stringCNPJ, só dígitos.companyNameCorpo · stringRazão social da empresa.tradeNameCorpo · stringNome da empresa (nome fantasia), opcional, até 200 caracteres. É o nome do seletor de empresa do painel; vazio, vale a razão social.complementCorpo · stringComplemento.contactEmailCorpo · stringE-mail do contato.districtCorpo · stringBairro.numberCorpo · stringNúmero.ownCorpo · booleanO dado é da própria escala; falso quando é herdado da empresa.phoneCorpo · stringTelefone.scheduleIdCorpo · stringIdentificador da escala.scheduleNameCorpo · stringNome da escala.stateCorpo · stringEstado.streetCorpo · stringLogradouro.zipCodeCorpo · stringCEP, só dígitos.
Respostas
201 · id da empresa cadastrada.
idstring · Identificador do registro.
Corpo de exemplo
{
"id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e"
}