Criar empresa

Cria uma empresa na conta e devolve 201 com o registro criado.

POST https://app.salos.com.br/api/companies companies:write

Corpo de exemplo

{
  "name": "Aurora Esquadrias",
  "cnpj": "11.222.333/0001-81",
  "legal_name": "Aurora Esquadrias Ltda",
  "segment": "Indústria",
  "size": "Média",
  "phone": "+55 11 3333-4444",
  "email": "contato@auroraesquadrias.com.br",
  "website": "https://auroraesquadrias.com.br",
  "zip_code": "01310-100",
  "street": "Av. Paulista",
  "street_number": "1000",
  "complement": "sala 12",
  "neighborhood": "Bela Vista",
  "city": "São Paulo",
  "state": "SP"
}

Campos

Campo Tipo Criar Regras
name texto obrigatório 1–200 caracteres (nome fantasia)
notes texto | null opcional até 5000
cnpj texto | null opcional com ou sem máscara; validado por dígito verificador
legal_name texto | null opcional razão social, até 200
segment texto | null opcional segmento/setor, texto livre, até 120
size texto | null opcional MEI, Micro, Pequena, Média ou Grande — exatamente assim, com acento e caixa
phone texto | null opcional até 40
email texto | null opcional até 200
website texto | null opcional até 200
zip_code texto | null opcional CEP, até 9
street texto | null opcional logradouro, até 200
street_number texto | null opcional até 20
complement texto | null opcional até 100
neighborhood texto | null opcional bairro, até 120
city texto | null opcional até 120
state texto | null opcional UF, 2 letras
tag_ids lista de uuid opcional vincula etiquetas já na criação — cada uma precisa existir nesta conta e se aplicar a empresa. Uma etiqueta ruim (de outra conta, ou que não se aplica) recusa a chamada inteira: nenhuma empresa é criada
external_id texto | null opcional até 255. O id desta empresa no seu sistema. Já usado por outra empresa: 409 com o existing_id
custom_fields objeto opcional {"<key ou uuid>": valor} dos campos personalizados de empresa. Chave inexistente ou valor de tipo errado é 400 nomeando a chave

CNPJ duplicado não é validation_error

Empresa com o mesmo CNPJ já cadastrado nesta conta devolve 409 com o código cnpj_conflict e existing_id no corpo do erro — o id de quem já detém aquele CNPJ. Um script de migração usa esse id pra confirmar que o registro já existe, em vez de tentar criar de novo.

CNPJ fora do formato (dígito verificador não bate) devolve 400, e a empresa não é criada.

Não crie a mesma empresa duas vezes

Mande o cabeçalho Idempotency-Key com um valor seu. Se a mesma chave chegar de novo — retentativa automática da sua ferramenta, timeout de proxy — a resposta é a mesma de antes, e nada é duplicado.