Empresas
Cadastrar empresa automaticamente
Basta CNPJ, certificado A1 e senha: a plataforma cria a empresa, vincula o certificado e lista o que faltar.
/openapi/v2/empresas/cadastro-automaticotoken, 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* | string | Tipo do corpo |
* Campo obrigatório
Corpo da requisição
cnpj* | string | CNPJ da empresa |
senha* | string | Senha do certificado |
arquivoBase64* | string | Certificado em Base64 |
* Campo obrigatório
status e camposPendentes para saber se já está em análise.empresaId | string | Identificador da empresa |
cnpj | string | CNPJ da empresa |
status | string | Situação da empresa |
camposPendentes | array | Campos pendentes |
razaoSocial | string | Razão social |
nomeFantasia | string | Nome fantasia |
inscricaoEstadual | string | Inscrição estadual |
optanteSimplesNacional | bool | Optante do Simples |
mei | bool | MEI |
email | string | E-mail cadastral |
telefoneComercial | string | Telefone cadastral |
| object | Endereço usado no cadastro |
| Campo | Origem | Se não for obtido |
|---|---|---|
| CNPJ | Requisição, conferido com o certificado | Recusa 10003010 |
| Razão social | Dados públicos do CNPJ; senão cadastro da SEFAZ; senão nome do certificado | Sempre obtido |
| Nome fantasia, e-mail, telefone | Dados públicos do CNPJ (nome fantasia também da SEFAZ) | Fica vazio, não bloqueia |
| CNAE principal | Dados públicos do CNPJ; senão SEFAZ | Fica vazio, não bloqueia |
| Estado e município | Código IBGE da SEFAZ; senão estado e nome do município dos dados públicos | Recusa 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 fontes | Rascunho, listado em camposPendentes; valor acima do limite da NF-e (60 caracteres, número 16) fica vazio, sem corte |
| Inscrição estadual | SEFAZ, só a inscrição ativa do mesmo CNPJ | Rascunho, listado em camposPendentes |
| Regime tributário | Regime de apuração da inscrição estadual ativa (SEFAZ) cruzado com a opção pelo Simples e pelo MEI dos dados públicos | Rascunho com regime pendente; optanteSimplesNacional e mei em camposPendentes |
| Numeração de NF-e | Não é criada, como em Registrar empresa sem emissaoNFeProduto | Crie com Registrar empresa com id e emissaoNFeProduto |
| Ambiente | Homologação, como em Registrar empresa | — |
A plataforma tira um resultado de cada fonte e só aceita resultados inequívocos.
Cadastro estadual (regime de apuração da inscrição estadual ativa da SEFAZ):
| Cadastro estadual | Resultado |
|---|---|
| Contém SIMEI | MEI |
| Começa com NORMAL | Regime normal |
| Contém SIMPLES, vazio, outro valor, só inscrição inativa, várias ativas ou SEFAZ sem resposta | Sem resultado |
Dados públicos do CNPJ (os mesmos opcaoSimples e opcaoMei de Consulta de CNPJ):
| Opção pelo Simples | Opção pelo MEI | Resultado |
|---|---|---|
| Qualquer | Sim | MEI |
| Não | Qualquer | Regime normal |
| Sim | Não | Simples Nacional |
| Sim | Não informada | Sem resultado |
Combinação: só uma fonte com resultado, vale ela; as duas iguais, vale o resultado; as duas diferentes, indeterminado. O excesso de sublimite (CRT 2) não pode ser determinado pelos dados oficiais públicos: no leiaute oficial da consulta de cadastro estadual o regime de apuração é texto livre, sem tabela de valores; o cadastro da SEFAZ só distingue Simples de Regime Normal; e se a receita passou do sublimite não é público. Por isso «optante do Simples e não MEI» é sempre deduzido como Simples Nacional (CRT 1), e o CRT 2 nunca é deduzido. O caso típico de divergência, cadastro estadual NORMAL com opção pelo Simples, costuma ser justamente o excesso de sublimite.
Indeterminado não impede o cadastro: a empresa fica em rascunho com o regime pendente de confirmação (optanteSimplesNacional e mei vêm null) e não pode ir para análise nem emitir novos documentos (10003052) até você enviar optanteSimplesNacional e mei em Registrar empresa com id. Cancelamento, carta de correção e demais eventos de documentos já emitidos não são bloqueados. Com excesso de sublimite, deduzida como Simples Nacional ou pendente por divergência, mude o regime para CRT 2 no console, em «Dados tributários», o que também encerra a pendência: a atualização com id só grava CRT 1, 3 ou 4, e só com o regime pendente. Veja «Regime tributário» em Empresas.
- Completar: chame Registrar empresa com
id=empresaId. Se a empresa ainda não tem inscrição estadual,inscricaoEstadualé gravada; com o regime pendente,optanteSimplesNacionalemeidefinem o regime (CRT 2 só pelo console); endereço e contatos seguem as regras normais de atualização. Com os dados completos, a empresa em rascunho entra em análise automaticamente; a rejeitada só volta para análise (manual) quando a atualização completa um campo que estava pendente. A inscrição estadual só é gravada em rascunho ou rejeitada. - Acompanhar: Consultar empresa devolve
status,motivoStatuse, em rascunho ou rejeitada,camposPendentes. - Certificado: já fica vinculado; para trocar use Vincular certificado digital.
- Numeração de NF-e: não é criada aqui. Antes de emitir NF-e, chame Registrar empresa com
ideemissaoNFeProduto(série e próximo número); veja «Definir a numeração de NF-e». - A SEFAZ de alguns estados não oferece a consulta de cadastro, ou não responde a tempo; nesses casos a inscrição estadual vem em
camposPendentes.
Envie Content-Type: multipart/form-data com os três campos abaixo. Na assinatura o corpo é a string vazia: sign = MD5(token + path + timestamp).
APP_SECRET="sk_live_9f8e7d6c5b4a"P="/openapi/v2/empresas/cadastro-automatico"TS=$(date +%s)SIGN=$(printf '%s' "${APP_SECRET}${P}${TS}" | md5sum | cut -d' ' -f1)curl -X POST "https://api.v2.tffiscal.com${P}" \-H "token: ${APP_SECRET}" -H "timestamp: ${TS}" -H "sign: ${SIGN}" \-F "cnpj=14422279000106" -F "senha=certpass123" -F "arquivo=@empresa.pfx"
Campos do formulário
cnpj* | text | CNPJ da empresa |
senha* | text | Senha do certificado |
arquivo* | file | Arquivo do certificado |
* Campo obrigatório
statusStatus da empresa
Logo após o cadastro só aparecem Rascunho (faltam campos, ou o envio para análise falhou com camposPendentes vazio: chame Registrar empresa com id para reenviar), AguardandoAprovacao e Ativa.
| Valores | Significado |
|---|---|
| Rascunho | Cadastro salvo e ainda não enviado para análise; camposPendentes lista o que falta |
| AguardandoAprovacao | Em análise pela plataforma; ainda não pode emitir |
| Ativa | Aprovada; pode emitir quando houver certificado válido |
| Rejeitada | Recusada na análise; motivoStatus traz o motivo. Corrija pelo console e reenvie; se ela tinha campos em camposPendentes, completá-los com Registrar empresa (corpo com id) a devolve para análise manual |
| Inativa | Desativada; não emite até ser reativada no console |
camposPendentesCampos pendentes
Só aparece com status Rascunho ou Rejeitada. Os nomes aparecem nesta ordem.
| Valores | Significado |
|---|---|
| inscricaoEstadual | Inscrição estadual ausente. Não é cobrada da empresa que só emite NFS-e (perfil NFS-e sem série de NF-e) |
| optanteSimplesNacional | Regime tributário pendente de confirmação; sempre vem junto com mei. Envie os dois para definir o regime |
| mei | Regime tributário pendente de confirmação; sempre vem junto com optanteSimplesNacional |
| endereco.logradouro | Logradouro do endereço ausente |
| endereco.numero | Número do endereço ausente |
| endereco.bairro | Bairro do endereço ausente |
| endereco.cep | CEP do endereço ausente |
| Código | HTTP | |
|---|---|---|
| 10001001 | 400 | Campo inválido; a mensagem indica qual. |
| 10003001 | 400 | CNPJ inválido. |
| 10003002 | 400 | Esta aplicação já tem uma empresa com este CNPJ. Use o empresaId existente. |
| 10003008 | 400 | Senha do certificado não confere. |
| 10003009 | 400 | Arquivo não é um certificado A1 válido com chave privada. |
| 10003010 | 400 | CNPJ do certificado diferente do cnpj enviado. |
| 10003011 | 400 | Certificado expirado. |
| 10003035 | 400 | Base64 inválido ou arquivo acima de 1MB. Só na forma JSON. |
| 10003038 | 400 | Conta de cliente direto com dados incompletos: nada é criado; a mensagem lista o que falta. Cadastre pelo console. |
| 10003050 | 400 | CNPJ não encontrado nos dados cadastrais públicos. Nada é criado. |
| 10003051 | 503 | Dados cadastrais públicos indisponíveis no momento. Nada é criado; repita a mesma requisição mais tarde. |
| 10003053 | 400 | Estado ou município do endereço cadastral não identificado. Nada é criado; use Registrar empresa. |
