Plantonizei

Painel da empresa › Configurações

Cadastrar empresa

POST/api/v1/settings/registered-companiesPede sessão

Como 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"
}