Empresas
Registrar empresa automáticamente
Solo CNPJ, certificado A1 y contraseña: la plataforma crea la empresa, vincula el certificado y lista lo que falte.
/openapi/v2/empresas/cadastro-automaticotoken, timestamp y sign, vea Autenticación.Una llamada sustituye Registrar empresa + Vincular certificado digital. El certificado acredita la titularidad; razón social, dirección y CNAE salen de los datos registrales públicos del CNPJ; la inscripción estatal sale del registro de contribuyentes de la SEFAZ, consultado con el propio certificado; el régimen cruza ese registro con la opción por el Simples Nacional y el MEI de los datos públicos.
Con el registro completo la empresa entra directamente en análisis. Si falta algo, se crea como borrador con el certificado vinculado, los campos se listan en camposPendentes y nada se rellena por suposición: la emisión sigue bloqueada hasta que usted complete con Registrar empresa (cuerpo con id). Siga la empresa con Consultar empresa.
Cabeceras
Content-Type* | string | Tipo del cuerpo |
* Campo obligatorio
Cuerpo de la petición
cnpj* | string | CNPJ de la empresa |
senha* | string | Contraseña del certificado |
arquivoBase64* | string | Certificado en Base64 |
* Campo obligatorio
status y camposPendentes para saber si ya está en análisis.empresaId | string | Identificador de la empresa |
cnpj | string | CNPJ de la empresa |
status | string | Estado de la empresa |
camposPendentes | array | Campos pendientes |
razaoSocial | string | Razón social |
nomeFantasia | string | Nombre comercial |
inscricaoEstadual | string | Inscripción estatal |
optanteSimplesNacional | bool | Optante del Simples |
mei | bool | MEI |
email | string | Correo registral |
telefoneComercial | string | Teléfono registral |
| object | Dirección usada en el registro |
| Campo | Origen | Si no se obtiene |
|---|---|---|
| CNPJ | Solicitud, comparado con el certificado | Rechazo 10003010 |
| Razón social | Datos públicos del CNPJ; si no, registro de la SEFAZ; si no, nombre del certificado | Siempre se obtiene |
| Nombre comercial, correo, teléfono | Datos públicos del CNPJ (nombre comercial también de la SEFAZ) | Queda vacío, no bloquea |
| CNAE principal | Datos públicos del CNPJ; si no, SEFAZ | Queda vacío, no bloquea |
| Estado y municipio | Código IBGE de la SEFAZ; si no, estado y nombre del municipio de los datos públicos | Rechazo 10003053 |
| Dirección (calle, número, complemento, barrio, código postal) | Bloque entero de la inscripción estatal activa de la SEFAZ cuando está completo; si no, bloque entero de los datos públicos, sin mezclar fuentes | Borrador, listado en camposPendentes; un valor por encima del límite de la NF-e (60 caracteres, número 16) queda vacío, sin cortar |
| Inscripción estatal | SEFAZ, solo la inscripción activa del mismo CNPJ | Borrador, listado en camposPendentes |
| Régimen tributario | Régimen de apuración de la inscripción estatal activa (SEFAZ) cruzado con la opción por el Simples y el MEI de los datos públicos | Borrador con régimen pendiente; optanteSimplesNacional y mei en camposPendentes |
| Numeración de NF-e | No se crea, igual que Registrar empresa sin emissaoNFeProduto | Créela con Registrar empresa con id y emissaoNFeProduto |
| Ambiente | Homologación, igual que Registrar empresa | — |
La plataforma toma un resultado de cada fuente y solo acepta resultados inequívocos.
Registro estatal (régimen de apuración de la inscripción estatal activa de la SEFAZ):
| Registro estatal | Resultado |
|---|---|
| Contiene SIMEI | MEI |
| Empieza con NORMAL | Régimen normal |
| Contiene SIMPLES, vacío, otro valor, solo inscripción inactiva, varias activas o la SEFAZ no respondió | Sin resultado |
Datos públicos del CNPJ (los mismos opcaoSimples y opcaoMei de Consulta de CNPJ):
| Opción por el Simples | Opción por el MEI | Resultado |
|---|---|---|
| Cualquiera | Sí | MEI |
| No | Cualquiera | Régimen normal |
| Sí | No | Simples Nacional |
| Sí | No informada | Sin resultado |
Combinación: si solo una fuente tiene resultado, vale esa; si las dos coinciden, vale ese resultado; si difieren, el régimen queda indeterminado. El exceso de sublímite (CRT 2) no puede determinarse con los datos oficiales públicos: en el formato oficial de la consulta de registro estatal el régimen de apuración es texto libre, sin tabla de valores; el registro de la SEFAZ solo distingue Simples de Regime Normal; y si los ingresos pasaron el sublímite no es público. Por eso «adherida al Simples y no MEI» siempre se deduce como Simples Nacional (CRT 1), y el CRT 2 nunca se deduce. El caso típico de divergencia, registro estatal NORMAL con opción por el Simples, suele ser justamente el exceso de sublímite.
Indeterminado no impide el registro: la empresa queda en borrador con el régimen pendiente de confirmación (optanteSimplesNacional y mei vienen null) y no puede ir a análisis ni emitir documentos nuevos (10003052) hasta que envíe optanteSimplesNacional y mei en Registrar empresa con id. Cancelación, carta de corrección y demás eventos de documentos ya emitidos no se bloquean. Con exceso de sublímite, deducida como Simples Nacional o pendiente por divergencia, cambie el régimen a CRT 2 en la consola, en «Datos tributarios», lo que también cierra la confirmación pendiente: la actualización con id solo guarda CRT 1, 3 o 4, y solo con el régimen pendiente. Vea «Régimen tributario» en Empresas.
- Completar: llame a Registrar empresa con
id=empresaId. Si la empresa aún no tiene inscripción estatal, se guardainscricaoEstadual; con el régimen pendiente,optanteSimplesNacionalymeidefinen el régimen (CRT 2 solo por la consola); dirección y contactos siguen las reglas normales de actualización. Con los datos completos, la empresa en borrador entra en análisis automáticamente; la rechazada solo vuelve a análisis (manual) cuando la actualización completa un campo que estaba pendiente. La inscripción estatal solo se guarda en borrador o rechazada. - Seguir: Consultar empresa devuelve
status,motivoStatusy, en borrador o rechazada,camposPendentes. - Certificado: ya queda vinculado; para cambiarlo use Vincular certificado digital.
- Numeración de NF-e: no se crea aquí. Antes de emitir NF-e, llame a Registrar empresa con
idyemissaoNFeProduto(serie y próximo número); vea «Definir la numeración de NF-e». - La SEFAZ de algunos estados no ofrece la consulta de registro, o no responde a tiempo; entonces la inscripción estatal viene en
camposPendentes.
Envíe Content-Type: multipart/form-data con los tres campos siguientes. En la firma el cuerpo es la cadena vacía: 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 del formulario
cnpj* | text | CNPJ de la empresa |
senha* | text | Contraseña del certificado |
arquivo* | file | Archivo del certificado |
* Campo obligatorio
statusEstado de la empresa
Justo después del registro solo aparecen Rascunho (faltan campos, o falló el envío a análisis con camposPendentes vacío: llame a Registrar empresa con id para reenviar), AguardandoAprovacao y Ativa.
| Valores | Significado |
|---|---|
| Rascunho | Guardada y todavía no enviada a análisis; camposPendentes lista lo que falta |
| AguardandoAprovacao | En análisis por la plataforma; todavía no puede emitir |
| Ativa | Aprobada; puede emitir cuando haya un certificado válido |
| Rejeitada | Rechazada en el análisis; motivoStatus trae el motivo. Corrija y reenvíe por la consola; si tenía campos en camposPendentes, completarlos con Registrar empresa (cuerpo con id) la devuelve a análisis manual |
| Inativa | Desactivada; no emite hasta reactivarse en la consola |
camposPendentesCampos pendientes
Solo aparece con status Rascunho o Rejeitada. Los nombres aparecen en este orden.
| Valores | Significado |
|---|---|
| inscricaoEstadual | Falta la inscripción estatal. No se exige a la empresa que solo emite NFS-e (perfil NFS-e sin serie de NF-e) |
| optanteSimplesNacional | Régimen tributario pendiente de confirmación; siempre viene junto con mei. Envíe los dos para definir el régimen |
| mei | Régimen tributario pendiente de confirmación; siempre viene junto con optanteSimplesNacional |
| endereco.logradouro | Falta la calle de la dirección |
| endereco.numero | Falta el número de la dirección |
| endereco.bairro | Falta el barrio de la dirección |
| endereco.cep | Falta el código postal de la dirección |
| Código | HTTP | |
|---|---|---|
| 10001001 | 400 | Campo inválido; mensagem indica cuál. |
| 10003001 | 400 | CNPJ inválido. |
| 10003002 | 400 | Esta aplicación ya tiene una empresa con este CNPJ. Use el empresaId existente. |
| 10003008 | 400 | La contraseña del certificado no coincide. |
| 10003009 | 400 | El archivo no es un certificado A1 válido con clave privada. |
| 10003010 | 400 | El CNPJ del certificado difiere del cnpj enviado. |
| 10003011 | 400 | Certificado expirado. |
| 10003035 | 400 | Base64 inválido o archivo mayor de 1MB. Solo forma JSON. |
| 10003038 | 400 | Cuenta de cliente directo con datos incompletos: no se crea nada; mensagem lista lo que falta. Registre por la consola. |
| 10003050 | 400 | CNPJ no encontrado en los datos registrales públicos. No se crea nada. |
| 10003051 | 503 | Datos registrales públicos no disponibles por ahora. No se crea nada; repita la misma solicitud más tarde. |
| 10003053 | 400 | Estado o municipio de la dirección registral no identificado. No se crea nada; use Registrar empresa. |
