开票主体

注册开票主体

登记开票主体（请求体带 `id` 时为更新），返回后续所有端点使用的 `empresaId`。

POST/openapi/v2/empresas

需要 token、timestamp、sign 三个签名头，参见认证与签名。

提交卖家企业资料，响应返回 empresaId，即后续所有端点的路径变量。emissaoNFeProduto、emissaoNFeConsumidor、emissaoDCe 与 emissaoNFSe 四个配置块各自可选、至少传一个：开哪种票传哪块；全都缺返回 400 10001001。请求体带 id 即按更新处理，见下文对应小节。

请求体

`id*` 更新时必填。	string	主体标识
`cnpj*`	string	主体 CNPJ
`inscricaoMunicipal`	string	市政登记号
`inscricaoEstadual*` 开 NF-e / NFC-e / DC-e 必填。	string	州注册号 IE
`razaoSocial*`	string	法定名称
`nomeFantasia`	string	商号
`optanteSimplesNacional*`	bool	是否选 Simples
`mei*`	bool	是否 MEI
`email*`	string	联系邮箱
`telefoneComercial*`	string	商务电话
`*`	object	主体地址
`*` emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe 至少传一个。	object	NF-e 开票配置
`*` emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe 至少传一个。	object	NFC-e 开票配置
`*` emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe 至少传一个。	object	DC-e 发行配置
`*` emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe 至少传一个。	object	NFS-e 发行配置

* 必填字段

200

注册已受理并进入审核队列（或更新已生效）。两种情况的响应结构相同。

`empresaId`	string	主体标识
`dceHabilitado`	bool	是否开通 DC-e
`nfseHabilitado`	bool	是否开通 NFS-e
`nfceHabilitado`	bool	是否开通 NFC-e

注册接口把主体提交到平台审核队列；运营审批通过、且证书关联成功后（关联证书）主体方可开票。审批前开票会收到 10004004（NF-e）或 10019004（DC-e）。审批进度请与平台运营确认。
注册后主体处于认证测试环境：联调请传 ambienteEmissao=Homologacao（NF-e）/ ambiente=Homologacao（DC-e）。切生产由运营操作、不开 API；切换前传 Producao 会收到 10004030（NF-e）或 10019012（DC-e）。参见环境。
税制由 mei 与 optanteSimplesNacional 推导，没有单独字段。

开哪种票就传哪个配置块。主体资料每个场景都一样，下面只列变化的部分。

只开 NF-e

最常见的情形。inscricaoEstadual 必填。

json

{
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "10" } }
}

`inscricaoEstadual*`	string	州注册号 IE
`*`	object	NF-e 开票配置

* 必填字段

同时开 NF-e 与 NFC-e

既做门店零售、也给企业开票的商家。NFC-e 系列号与 NF-e 系列号分开。inscricaoEstadual 必填。

json

{
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "10" } },
  "emissaoNFeConsumidor": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "1" } }
}

`inscricaoEstadual*`	string	州注册号 IE
`*`	object	NFC-e 开票配置

* 必填字段

只开 NFS-e

没有州注册号的服务企业。inscricaoMunicipal 是市政登记号；圣保罗即 CCM。

json

{
  "cnpj": "14422279000106",
  "inscricaoMunicipal": "999999",
  "razaoSocial": "Servicos teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "servicos-teste@exemplo.com.br",
  "telefoneComercial": "1133334444",
  "endereco": { "pais": "Brasil", "uf": "SP", "cidade": "Sao Paulo", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" },
  "emissaoNFSe": { "serieDps": "1", "sequencialDps": 1, "regimeApuracaoSn": 1 }
}

`inscricaoMunicipal`	string	市政登记号
`*`	object	NFS-e 发行配置

* 必填字段

同时开 NF-e 与 DC-e 的平台

代第三方发 DC-e 的电商平台。siteMarketplace 必填；Carrier 可登记但不能发行。

json

{
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "10" } },
  "emissaoDCe": { "ambienteProducao": { "tipoEmitente": "Marketplace", "sequencialDCe": 1, "serieDCe": "1", "siteMarketplace": "https://loja.exemplo.com.br" } }
}

*

object

DC-e 发行配置

* 必填字段

同一接口、请求体带 id 即为更新：直接重传注册报文并加上 id，其余字段仍按注册规则校验。不更新 cnpj、razaoSocial、inscricaoEstadual、inscricaoMunicipal、税制与环境；emissaoNFeProduto 被忽略。换市政（uf / cidade）返回 400 10001001，须经运营。更新不重新提交审核、不改主体状态；响应与注册相同。

补开 DC-e

注册时没传 emissaoDCe 的主体。尚无启用的 DC-e 号段时，按 sequencialDCe / serieDCe 新建。

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoDCe": { "ambienteProducao": { "tipoEmitente": "OwnIssuer", "sequencialDCe": 1, "serieDCe": "1" } }
}

`id*`	string	主体标识
`*`	object	DC-e 发行配置

* 必填字段

抬高 DC-e 起始号

同一系列，sequencialDCe 大于当前下一号。等于当前不变；小于返回 400 10001001。跳过的号不会再发。旧系列仍启用时换 serieDCe 同样返回 400 10001001。

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoDCe": { "ambienteProducao": { "tipoEmitente": "OwnIssuer", "sequencialDCe": 500, "serieDCe": "1" } }
}

`id*`	string	主体标识
`*`	object	DC-e 发行配置

* 必填字段

修正联系信息与地址

只更新 nomeFantasia、email、telefoneComercial 和同一市政内的地址字段。空值不会清掉已存的值。

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "nomeFantasia": "Loja Teste",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "financeiro@exemplo.com.br",
  "telefoneComercial": "3133334444",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Nova", "numero": "10", "complemento": "Sala 2", "bairro": "Centro", "cep": "30110000" }
}

`id*`	string	主体标识
`nomeFantasia`	string	商号
`email`	string	联系邮箱
`telefoneComercial`	string	商务电话
`*`	object	主体地址

* 必填字段

新建或覆盖 NFS-e 档案

传 emissaoNFSe 即整份覆盖档案，没传的项回到缺省。已建的号段不会改：sequencialDps 只在号段尚不存在时生效。

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFSe": { "serieDps": "1", "sequencialDps": 120, "regimeApuracaoSn": 1, "regimeEspecialTributacao": 0 }
}

`id*`	string	主体标识
`*`	object	NFS-e 发行配置

* 必填字段

`endereco.uf`主体所在州

取值	含义
AC	Acre
AL	Alagoas
AP	Amapá
AM	Amazonas
BA	Bahia
CE	Ceará
DF	Distrito Federal
ES	Espírito Santo
GO	Goiás
MA	Maranhão
MT	Mato Grosso
MS	Mato Grosso do Sul
MG	Minas Gerais
PA	Pará
PB	Paraíba
PR	Paraná
PE	Pernambuco
PI	Piauí
RJ	Rio de Janeiro
RN	Rio Grande do Norte
RS	Rio Grande do Sul
RO	Rondônia
RR	Roraima
SC	Santa Catarina
SP	São Paulo
SE	Sergipe
TO	Tocantins

`emissaoDCe.ambienteProducao.tipoEmitente`DC-e 发行方类型

不区分大小写。

取值	含义
Marketplace	代第三方发行的电商平台；须传 `siteMarketplace`
OwnIssuer	企业自发
EmissorProprio	同 `OwnIssuer`
Carrier	承运商；可登记，发行被 `10019013` 拒
Transportadora	同 `Carrier`

`emissaoNFSe.regimeApuracaoSn`Simples 计税口径

只对 ME/EPP：optanteSimplesNacional=true 且 mei=false。

取值	含义
1	联邦税与市政 ISS 均按 Simples 计
2	联邦税按 Simples 计，ISS 按市政固定额
3	联邦税按 Simples 计，ISS 按市政常规税率

`emissaoNFSe.regimeEspecialTributacao`特殊税制

不传即 0。

取值	含义
0	无
1	合作社行为
2	核定征收
3	市政微型企业
4	公证登记
5	自由职业者
6	专业人士合伙

错误码	HTTP
10003002	400	CNPJ 已注册。该主体已存在，直接使用原 `empresaId` 或带 `id` 更新。
10003000	404	更新：`id` 不存在或非本应用名下。
10003006	400	缺必填资料：开 NF-e / DC-e 的主体缺 `inscricaoEstadual`，或 `tipoEmitente=Marketplace` 缺 `siteMarketplace`。消息点名字段。
10003004	400	城市与州解析不到 IBGE 码。核对 `endereco.uf` 与 `endereco.cidade`。
10001001	400	请求字段校验失败（每字段一条），或契约错误：没有配置块、`tipoEmitente` 不合法、更新改 `cnpj` 或换市政、`sequencialDCe` 低于当前、换系列。按 `mensagem` 修正。

注册开票主体

参数

请求体

响应

注册规则

注册场景4 块

只开 NF-e

同时开 NF-e 与 NFC-e

只开 NFS-e

同时开 NF-e 与 DC-e 的平台

更新（请求体带 id）4 块

补开 DC-e

抬高 DC-e 起始号

修正联系信息与地址

新建或覆盖 NFS-e 档案

枚举4 张表

endereco.uf主体所在州

emissaoDCe.ambienteProducao.tipoEmitenteDC-e 发行方类型

emissaoNFSe.regimeApuracaoSnSimples 计税口径

emissaoNFSe.regimeEspecialTributacao特殊税制

错误5 条

`endereco.uf`主体所在州

`emissaoDCe.ambienteProducao.tipoEmitente`DC-e 发行方类型

`emissaoNFSe.regimeApuracaoSn`Simples 计税口径

`emissaoNFSe.regimeEspecialTributacao`特殊税制