Upsert empresa por CNPJ

PUT 
/api/integrations/v1/companies/by-cnpj/:cnpj

Cria a empresa se o CNPJ ainda não existir na organização; caso contrário, atualiza a existente. Ideal para sincronização contínua a partir de um sistema-fonte (ERP/RH) onde o CNPJ é a chave natural.

Retorna 201 quando cria e 200 quando atualiza.

Request

Responses

200

Empresa existente atualizada.

201

Empresa criada (CNPJ ainda não existia).

400

Requisição inválida (validação ou conflito de idempotência com payload diferente).

401

Credencial ausente, inválida, revogada ou expirada.

Response Headers

WWW-Authenticate

403

IP fora da allowlist ou escopo insuficiente (insufficient_scope).

429

Limite de taxa por chave excedido.