TF Fiscal
开发文档

开票主体

自动注册主体

只需 CNPJ、A1 证书与密码:平台自动建档、挂好证书,并列出取不到的字段。

POST/openapi/v2/empresas/cadastro-automatico
需要 token、timestamp、sign 三个签名头,参见认证与签名。

一次调用代替注册主体 + 关联数字证书。证书用于确权;企业名称、地址与 CNAE 取自 CNPJ 公开登记数据;州注册号取自 SEFAZ 纳税人登记,用本次上传的证书查询;税制由这份州登记与公开登记数据里的 Simples、MEI 选项交叉判定。

资料齐全即进入审核。缺了什么,主体照样建好并挂上证书,以草稿状态返回,缺的字段列在 camposPendentes 里;平台不会用猜测值填补,用注册主体带 id 补全之前开票会被拒绝。主体状态用查询主体跟踪。

请求头

Content-Type*
string请求体类型

* 必填字段

请求体

cnpj*
string主体 CNPJ
senha*
string证书密码
arquivoBase64*
string证书文件 Base64

* 必填字段

200
主体已建档并挂好证书。看 status 与 camposPendentes 判断是否已进入审核。
empresaId
string主体标识
cnpj
string主体 CNPJ
status
string主体状态
camposPendentes
array待补全字段
razaoSocial
string企业法定名称
nomeFantasia
string商号
inscricaoEstadual
string州注册号
optanteSimplesNacional
bool是否 Simples
mei
bool是否 MEI
email
string登记邮箱
telefoneComercial
string登记电话
object建档地址

字段来源取不到时
CNPJ请求,并与证书比对拒绝 10003010
企业名称CNPJ 公开登记数据;其次 SEFAZ 登记;最后用证书上的名称总能取到
商号、邮箱、电话CNPJ 公开登记数据(商号也可来自 SEFAZ)留空,不影响开票
主营 CNAECNPJ 公开登记数据;其次 SEFAZ留空,不影响开票
州与城市SEFAZ 登记的 IBGE 码;其次公开登记数据的州与城市名拒绝 10003053
地址(街道、门牌号、补充、街区、邮编)SEFAZ 在用登记的地址齐全时整块取它;否则整块取公开登记数据,两路不混拼草稿,列入 camposPendentes;超出 NF-e 长度上限(60 字符,门牌号 16)的留空,不截断
州注册号SEFAZ,只取同一 CNPJ 的在用登记草稿,列入 camposPendentes
税制SEFAZ 在用州登记的计税方式,与公开登记数据的 Simples、MEI 选项交叉判定草稿,税制待确认;optanteSimplesNacional 与 mei 列入 camposPendentes
NF-e 号段不建,与注册主体不传 emissaoNFeProduto 时一致带 id 调注册主体并传 emissaoNFeProduto 建出
环境认证测试,与注册主体一致—