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.