开票主体
自动注册主体
只需 CNPJ、A1 证书与密码:平台自动建档、挂好证书,并列出取不到的字段。
/openapi/v2/empresas/cadastro-automaticotoken、timestamp、sign 三个签名头,参见认证与签名。请求头
Content-Type* | string | 请求体类型 |
* 必填字段
请求体
cnpj* | string | 主体 CNPJ |
senha* | string | 证书密码 |
arquivoBase64* | string | 证书文件 Base64 |
* 必填字段
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) | 留空,不影响开票 |
| 主营 CNAE | CNPJ 公开登记数据;其次 SEFAZ | 留空,不影响开票 |
| 州与城市 | SEFAZ 登记的 IBGE 码;其次公开登记数据的州与城市名 | 拒绝 10003053 |
| 地址(街道、门牌号、补充、街区、邮编) | SEFAZ 在用登记的地址齐全时整块取它;否则整块取公开登记数据,两路不混拼 | 草稿,列入 camposPendentes;超出 NF-e 长度上限(60 字符,门牌号 16)的留空,不截断 |
| 州注册号 | SEFAZ,只取同一 CNPJ 的在用登记 | 草稿,列入 camposPendentes |
| 税制 | SEFAZ 在用州登记的计税方式,与公开登记数据的 Simples、MEI 选项交叉判定 | 草稿,税制待确认;optanteSimplesNacional 与 mei 列入 camposPendentes |
| NF-e 号段 | 不建,与注册主体不传 emissaoNFeProduto 时一致 | 带 id 调注册主体并传 emissaoNFeProduto 建出 |
| 环境 | 认证测试,与注册主体一致 | — |
两个来源各推一个结果,只认确定的结果。
州登记(SEFAZ 在用州登记里的计税方式):
| 州登记计税方式 | 结果 |
|---|---|
| 含 SIMEI | MEI |
| 以 NORMAL 开头 | 一般税制 |
| 含 SIMPLES、为空、其他取值、只有停用登记、多条在用登记,或 SEFAZ 没有应答 | 无结果 |
CNPJ 公开登记数据(即 CNPJ 查询返回的 opcaoSimples 与 opcaoMei):
| 是否加入 Simples | 是否 MEI | 结果 |
|---|---|---|
| 任意 | 是 | MEI |
| 否 | 任意 | 一般税制 |
| 是 | 否 | Simples Nacional |
| 是 | 未提供 | 无结果 |
合并: 只有一边有结果就用它;两边一致就用这个结果;两边不一致即无法确定。超出分项限额(CRT 2)用官方公开数据判断不了:州登记查询的官方格式里,计税方式只是自由文本,没有取值表;SEFAZ 登记只区分 Simples 与 Regime Normal;营业收入是否超限不公开。所以「加入 Simples 且不是 MEI」一律推成 Simples Nacional(CRT 1),平台从不推出 CRT 2。最常见的两边不一致,即州登记为 NORMAL、公开数据为加入 Simples,通常正是超出分项限额。
无法确定也照常建档:主体留草稿、税制待确认(optanteSimplesNacional 与 mei 为 null),在用注册主体带 id 传 optanteSimplesNacional 与 mei 之前,不能进入审核,开新票返回 10003052。已开单据的作废、更正函等事件不受影响。超出分项限额的主体,不论推成了 Simples Nacional 还是因两边不一致而待确认,都在控制台「税务补录」里改为 CRT 2,这也会清除待确认标记;带 id 的更新只能写入 CRT 1、3、4,且只在税制待确认时生效。见开票主体的「税收制度」。
- 补全:调注册主体,
id传empresaId。主体还没有州注册号时写入inscricaoEstadual;税制待确认时按optanteSimplesNacional与mei写入税制(CRT 2 只能在控制台设置);地址与联系方式按原有更新规则。资料补齐后,草稿主体自动进入审核;已驳回主体只有本次更新补齐了此前缺的字段才重新进入审核(人工)。州注册号只对草稿或已驳回主体写入。 - 跟踪:查询主体返回
status、motivoStatus,草稿或已驳回时另带camposPendentes。 - 证书:已经挂好;要更换用关联数字证书。
- NF-e 号段:这里不建。开 NF-e 前带
id调注册主体并传emissaoNFeProduto(系列与下一张号)建出,见「设定 NF-e 号段」。 - 部分州的 SEFAZ 不提供纳税人查询,或没能及时应答,这时州注册号会出现在
camposPendentes。
以 Content-Type: multipart/form-data 发送下列三个表单字段。签名时 body 按空字符串: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"
表单字段
cnpj* | text | 主体 CNPJ |
senha* | text | 证书密码 |
arquivo* | file | 证书文件 |
* 必填字段
status主体状态
建档后只会出现 Rascunho(有缺项;或 camposPendentes 为空,表示提交审核失败,带 id 调注册主体重新提交)、AguardandoAprovacao 与 Ativa。
| 取值 | 含义 |
|---|---|
| Rascunho | 已建档、尚未提交审核;camposPendentes 列出缺项 |
| AguardandoAprovacao | 平台审核中,暂不能开票 |
| Ativa | 审核通过;有有效证书即可开票 |
| Rejeitada | 审核被驳回,motivoStatus 为原因。在控制台修正后重新提交;若原有 camposPendentes,带 id 调注册主体补齐后转人工重新审核 |
| Inativa | 已停用;在控制台重新启用前不能开票 |
camposPendentes待补全字段
只在 status 为 Rascunho 或 Rejeitada 时出现;按下表顺序输出。
| 取值 | 含义 |
|---|---|
| inscricaoEstadual | 缺州注册号。只开 NFS-e 的主体不要求:已配置 NFS-e、且没有 NF-e 号段 |
| optanteSimplesNacional | 税制待确认,总与 mei 同时出现;两项一起传才能确定税制 |
| mei | 税制待确认,总与 optanteSimplesNacional 同时出现 |
| endereco.logradouro | 缺地址街道 |
| endereco.numero | 缺地址门牌号 |
| endereco.bairro | 缺地址街区 |
| endereco.cep | 缺地址邮编 |
| 错误码 | HTTP | |
|---|---|---|
| 10001001 | 400 | 字段校验失败,mensagem 点名字段。 |
| 10003001 | 400 | CNPJ 校验位不正确。 |
| 10003002 | 400 | 本应用下已有该 CNPJ 的主体。直接使用原 empresaId。 |
| 10003008 | 400 | 证书密码不符。 |
| 10003009 | 400 | 文件不是带私钥的有效 A1 证书。 |
| 10003010 | 400 | 证书 CNPJ 与请求的 cnpj 不一致。 |
| 10003011 | 400 | 证书已过期。 |
| 10003035 | 400 | Base64 非法或文件超过 1MB。仅 JSON 形态。 |
| 10003038 | 400 | 直客账号资料不完整:不建档,mensagem 列出缺项。请在控制台建档。 |
| 10003050 | 400 | 公开登记数据中查不到该 CNPJ。不建档。 |
| 10003051 | 503 | 公开登记数据暂不可用。不建档;稍后原样重试。 |
| 10003053 | 400 | 登记地址的州或城市无法识别。不建档;改用注册主体。 |
