TF Fiscal
Documentação

Empresas

Cadastrar empresa automaticamente

Basta CNPJ, certificado A1 e senha: a plataforma cria a empresa, vincula o certificado e lista o que faltar.

POST/openapi/v2/empresas/cadastro-automatico
Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Uma chamada substitui Registrar empresa + Vincular certificado digital. O certificado comprova a titularidade; razão social, endereço e CNAE vêm dos dados cadastrais públicos do CNPJ; a inscrição estadual vem do cadastro de contribuintes da SEFAZ, consultado com o próprio certificado; o regime cruza esse cadastro com a opção pelo Simples Nacional e pelo MEI dos dados públicos.

Com o cadastro completo a empresa já entra em análise. Faltando algo, ela é criada como rascunho com o certificado vinculado, os campos aparecem em camposPendentes e nada é preenchido por suposição: a emissão continua bloqueada até você completar com Registrar empresa (corpo com id). Acompanhe a empresa com Consultar empresa.

Cabeçalhos

Content-Type*
stringTipo do corpo

* Campo obrigatório

Corpo da requisição

cnpj*
stringCNPJ da empresa
senha*
stringSenha do certificado
arquivoBase64*
stringCertificado em Base64

* Campo obrigatório

200
Empresa criada e certificado vinculado. Veja status e camposPendentes para saber se já está em análise.
empresaId
stringIdentificador da empresa
cnpj
stringCNPJ da empresa
status
stringSituação da empresa
camposPendentes
arrayCampos pendentes
razaoSocial
stringRazão social
nomeFantasia
stringNome fantasia
inscricaoEstadual
stringInscrição estadual
optanteSimplesNacional
boolOptante do Simples
mei
boolMEI
email
stringE-mail cadastral
telefoneComercial
stringTelefone cadastral
objectEndereço usado no cadastro

CampoOrigemSe não for obtido
CNPJRequisição, conferido com o certificadoRecusa 10003010
Razão socialDados públicos do CNPJ; senão cadastro da SEFAZ; senão nome do certificadoSempre obtido
Nome fantasia, e-mail, telefoneDados públicos do CNPJ (nome fantasia também da SEFAZ)Fica vazio, não bloqueia
CNAE principalDados públicos do CNPJ; senão SEFAZFica vazio, não bloqueia
Estado e municípioCódigo IBGE da SEFAZ; senão estado e nome do município dos dados públicosRecusa 10003053
Endereço (logradouro, número, complemento, bairro, CEP)Bloco inteiro da inscrição estadual ativa da SEFAZ quando completo; senão bloco inteiro dos dados públicos, sem misturar as duas fontesRascunho, listado em camposPendentes; valor acima do limite da NF-e (60 caracteres, número 16) fica vazio, sem corte
Inscrição estadualSEFAZ, só a inscrição ativa do mesmo CNPJRascunho, listado em camposPendentes
Regime tributárioRegime de apuração da inscrição estadual ativa (SEFAZ) cruzado com a opção pelo Simples e pelo MEI dos dados públicosRascunho com regime pendente; optanteSimplesNacional e mei em camposPendentes
Numeração de NF-eNão é criada, como em Registrar empresa sem emissaoNFeProdutoCrie com Registrar empresa com id e emissaoNFeProduto
AmbienteHomologação, como em Registrar empresa—