Empresas

Atualizar Empresa PUT

Atualiza os dados de um contribuinte já cadastrado.

PUT https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}

Mesmo corpo do cadastro (razao_social, regime_tributario, inscricao_estadual etc.). {contribuinte_id} aceita UUID ou documento, igual à consulta.

⚠️

documento e tipo_documento não são alteráveis por este endpoint -- mesmo se você enviar valores diferentes no corpo, os valores atuais são mantidos. Pra trocar o CNPJ/CPF de um contribuinte, cadastre um novo.

💡

Campos de endereco omitidos aqui não apagam o valor já salvo -- só sobrescreve o que vier preenchido no corpo. Pra apagar um campo de endereço de fato, é preciso editar pelo painel (Área do Cliente → Contribuinte).

curl -X PUT https://areacliente.centralfiscal.com.br/v1/contribuintes/04478515000152 \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "razao_social": "Central Fiscal Comercio Ltda",
    "inscricao_estadual": "0947850080",
    "uf": "RS"
  }'

404 se o contribuinte não existir no seu contrato.

Suspender e reativar

Além de atualizar dados, dá pra desativar temporariamente um contribuinte sem excluir o cadastro:

Endpoint	Efeito
`POST /v1/contribuintes/{id}/suspender`	Status vira `SUSPENDED` -- emissões em nome desse contribuinte param de funcionar até reativar.
`POST /v1/contribuintes/{id}/reativar`	Volta pra `ACTIVE` -- sujeito às mesmas checagens de conflito/cota do cadastro (ver Cadastrar Empresa).