Empresas

Cadastrar Empresa POST

Cadastra (ou atualiza, se já existir) o contribuinte em nome de quem os documentos fiscais serão emitidos -- é o primeiro passo antes de qualquer emissão.

Endpoint

POST https://areacliente.centralfiscal.com.br/v1/contribuintes

Corpo da requisição

Campo	Tipo	Obrigatório	Observação
`documento`	string	Sim	CNPJ (14 -- raiz alfanumérica + 6 dígitos) ou CPF (11 dígitos).
`tipo_documento`	string	Não	`CNPJ` (padrão) ou `CPF`.
`razao_social`	string	Sim
`nome_fantasia`	string	Não
`regime_tributario`	string	Não	Texto livre, salvo em maiúsculas -- use `SIMPLES_NACIONAL`/`LUCRO_PRESUMIDO`/`LUCRO_REAL`/`MEI` (ver Enums).
`inscricao_estadual`	string	Não
`inscricao_municipal`	string	Não
`municipio_ibge`	string	Não	Código IBGE de 7 dígitos, se informado.
`uf`	string	Não	2 letras, se informado.
`endereco.logradouro`	string	Não	Aceita também `logradouro` solto na raiz do payload, fora de `endereco`.
`endereco.numero`	string	Não	Idem -- aceita `numero` na raiz.
`endereco.complemento`	string	Não	Idem -- aceita `complemento` na raiz.
`endereco.bairro`	string	Não	Idem -- aceita `bairro` na raiz.
`endereco.cep`	string	Não	Só dígitos, 8 caracteres. Idem -- aceita `cep` na raiz.
`logo`	object	Não	Atalho pra não precisar de uma chamada extra em `POST /v1/contribuintes/{id}/logo` -- objeto `{arquivo_base64, content_type}`, mesmo formato dessa rota.
`nfce_csc`	array	Não	Atalho pra CSC de NFC-e -- lista de `{ambiente, id_token, codigo}`, um item por ambiente.
`distribuicao_nsu`	array	Não	Atalho pra Checkpoint NSU -- lista de `{product_code, ambiente, last_nsu}`.

✅

logo, nfce_csc e distribuicao_nsu são opcionais e existem só pra evitar 2-3 chamadas extras logo depois de cadastrar -- as rotas dedicadas (CSC de NFC-e, Checkpoint NSU, logo) continuam funcionando normalmente pra alteração pontual depois. Tudo roda na mesma transação do cadastro: se algum desses três vier inválido, o cadastro inteiro falha (nenhuma empresa é criada pela metade).

💡

Preencha o endereço aqui se puder. A emissão de NF-e exige emitente.endereco completo -- se o contribuinte já tiver endereço salvo no cadastro (por aqui), a emissão usa esse valor automaticamente como fallback quando o payload de emissão não traz endereco explícito. Sem isso, toda emissão precisa informar o endereço do emitente manualmente em cada chamada.

curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "documento": "12345678000190",
    "razao_social": "Central Fiscal Comercio Ltda",
    "regime_tributario": "SIMPLES_NACIONAL",
    "inscricao_estadual": "0947850080",
    "municipio_ibge": "4314902",
    "uf": "RS",
    "endereco": {
      "logradouro": "Rua dos Andradas",
      "numero": "500",
      "bairro": "Centro Historico",
      "cep": "90020007"
    }
  }'

Semântica de upsert

Não existe um "já existe" simples aqui -- reenviar o mesmo documento atualiza o cadastro em vez de dar erro, com duas exceções pensadas pra multi-contrato:

Situação	Resultado
Documento novo para o seu contrato	Cria o contribuinte, status `ACTIVE`.
Documento já cadastrado no seu contrato	Atualiza os campos em vigor, status volta pra `ACTIVE`.
Documento ativo em outro contrato CentralFiscal	`409` -- "Este contribuinte ja esta ativo em outro contrato."
Contrato com cota de contribuintes autorizados atingida	`409` -- "Limite contratado de contribuintes autorizados atingido."

✅

Depois de cadastrar, o próximo passo obrigatório é enviar o certificado digital A1 -- ver Certificados · Upload. Nenhuma emissão funciona sem os dois passos.

Resposta

{
  "ambiente": "PRODUCTION",
  "contribuinte": {
    "contribuinte_id": "3d390cff-...",
    "contribuinte_contrato_id": "9a21...",
    "tipo_documento": "CNPJ",
    "documento": "12345678000190",
    "razao_social": "Central Fiscal Comercio Ltda",
    "nome_fantasia": "",
    "regime_tributario": "SIMPLES_NACIONAL",
    "inscricao_estadual": "0947850080",
    "inscricao_municipal": "",
    "municipio_ibge": "4314902",
    "uf": "RS",
    "endereco": {
      "logradouro": "Rua dos Andradas",
      "numero": "500",
      "complemento": "",
      "bairro": "Centro Historico",
      "cep": "90020007"
    },
    "status": "ACTIVE",
    "logo": null,
    "nfce_csc": {"homologacao": null, "producao": null},
    "distribuicao_nsu": []
  }
}