开具 NFS-e

路径参数

empresaId*

string

主体标识

* 必填字段

请求体

`id*`	string	请求标识
`ambienteEmissao*`	string	开票环境
`dataCompetencia`	string	服务发生月
	object	开票人
`*` `emitente.tipo` 不是 `Prestador` 时必填。	object	服务提供方
	object	接收方
	object	中介方
`*`	object	服务
	object	替代开票
`observacoes`	string	票面备注

* 必填字段

200

受理成功，无响应体。单据进入异步申报流程。

无响应体

主体须已审批通过且证书可用（10018004）。
主体须有 NFS-e 档案（序列号、Simples 归属、特殊税制），由注册主体的 emissaoNFSe 段提供或由运营维护；缺失 10018005。服务码、CNAE、NBS、ISS 税率与 PIS/COFINS、IBS/CBS 码没有主体级缺省，每张票都要传。
ambienteEmissao 须与主体当前环境一致。注册后主体处于 Homologacao，切生产由运营操作。
平台按主体所在市镇路由。圣保罗主体（padraoMunicipal 为 Paulistana）须有市政登记号 CCM；档案没有时平台在受理期按 CNPJ 查询，只有查不到才拒 10018005。该通道：只支持 emitente.tipo 为 Prestador，不支持 substituicao、折扣、pagamentosVinculados、NaoIncidencia，CNPJ 只能纯数字，codigoTributacaoMunicipal 为 5 位。ibsCbs 可选，由它决定市政布局：传 ibsCbs + codigoNbs 走布局 2（含 IBS/CBS），不传走布局 1（只有 ISS）；外籍收件人（NIF）只能走布局 2。
CNPJ 接收方：直传 servico.retencoes 扣缴额，或不传由平台按服务的官方扣缴分类与 cliente.orgaoPublico、cliente.optanteSimplesNacional 计算；缺信息时 10018023 一次列出全部缺项。ME/EPP 开票方的服务涉及 INSS 代扣时，在 servico.retencoes.anexoSimples 传本项服务所属的 Simples 附表。

一张普通票要填什么。不传 iss 即应税且不代扣、税率取市政参数；不传 pisCofins 即 CST 01 并按主体计税制度取税率；不传 cargaTributaria 时非 Simples 主体按 IBPT 近似税负申报，表未覆盖该服务时按算出的税额申报。

个人接收方

CPF 接收方：没有联邦扣缴。接收方地址可不传。

json

{
  "id": "PED-20260918-001",
  "ambienteEmissao": "Homologacao",
  "cliente": { "tipoPessoa": "F", "nome": "MARIA DA SILVA", "cpfCnpj": "88533234775" },
  "servico": {
    "descricao": "Servico de consultoria em tecnologia da informacao",
    "codigoTributacaoNacional": "010701",
    "valores": { "valorServico": 1000.00 }
  }
}

`id*`	string	请求标识
`ambienteEmissao*`	string	开票环境
`dataCompetencia`	string	服务发生月
`*`	object	接收方
`*`	object	服务

* 必填字段

法人接收方

CNPJ 接收方：在 retencoes 直传扣缴额，0 表示声明无扣缴；或不传金额，给出 cliente.orgaoPublico 与 cliente.optanteSimplesNacional 由平台计算。缺信息时 10018023 列出缺项。

json

{
  "id": "PED-20260918-002",
  "ambienteEmissao": "Homologacao",
  "dataCompetencia": "2026-09-01",
  "cliente": {
    "tipoPessoa": "J",
    "nome": "TOMADOR TESTE LTDA",
    "cpfCnpj": "66500544000120",
    "endereco": { "cidade": 3550308, "cep": "01021200", "uf": "SP", "logradouro": "RUA DO TOMADOR", "numero": "200", "bairro": "CENTRO" }
  },
  "servico": {
    "descricao": "Servico de consultoria em tecnologia da informacao",
    "codigoTributacaoNacional": "010701",
    "valores": { "valorServico": 1000.00 },
    "iss": { "aliquota": 2 },
    "retencoes": { "inss": 0, "irrf": 15.00, "csll": 0 }
  }
}

`id*`	string	请求标识
`ambienteEmissao*`	string	开票环境
`dataCompetencia`	string	服务发生月
`*`	object	接收方
`*`	object	服务

* 必填字段

无接收方

国家标准允许不传 cliente；没有接收方就没有联邦扣缴。

json

{
  "id": "PED-20260918-003",
  "ambienteEmissao": "Homologacao",
  "servico": {
    "descricao": "Servico de estacionamento",
    "codigoTributacaoNacional": "110101",
    "valores": { "valorServico": 25.00 }
  }
}

`id*`	string	请求标识
`ambienteEmissao*`	string	开票环境
`*`	object	服务

* 必填字段

PIS/COFINS 按主体计税制度：Lucro Real 非累积 1.65 与 7.6，但 Lei 10.833 art. 10 列举的服务仍按累积；其他制度累积 0.65 与 3。服务出口与 2027 年 1 月起的服务发生月不计 PIS/COFINS。税基 = valorServico − descontoIncondicionado；Simples 主体不算税额。扣缴只对 CNPJ 接收方：直传或由平台计算。

不代扣

传 CST，税率可选；tipoRetencao 为 0 声明三者均不代扣。CNPJ 接收方传了形态就须在 retencoes 同时传 0，否则拒 10018001；自然人或外籍接收方只传形态即可。

json

"pisCofins": { "situacaoTributaria": "01", "aliquotaPis": 0.65, "aliquotaCofins": 3, "tipoRetencao": 0 },
"retencoes": { "inss": 0, "irrf": 0, "csll": 0 }

*

object

服务

* 必填字段

三项均代扣

tipoRetencao 为 3；分项传 pis、cofins、csll 且三项都大于 0，或只在 csll 填三者之和，由平台按法定比例拆分。金额与形态不一致拒 10018001。irrf 与 inss 另填。

json

"pisCofins": { "situacaoTributaria": "01", "tipoRetencao": 3 },
"retencoes": { "csll": 46.50, "irrf": 15.00, "inss": 0 }

*

object

服务

* 必填字段

直传扣缴额

任一金额有值（含 0）即整组不再由平台判定；0 表示声明无扣缴。Simples Nacional 或 MEI 开票方的 irrf、csll、pis、cofins 大于 0 拒 10018001。

json

"retencoes": { "inss": 110.00, "irrf": 15.00, "csll": 10.00, "pis": 6.50, "cofins": 30.00 }

*

object

服务

* 必填字段

由平台计算扣缴

retencoes 不带金额、也不传 pisCofins.tipoRetencao 时，平台按服务的扣缴分类与接收方信息计算；传了 tipoRetencao 却不传金额拒 10018001。categoriaFederal 只在服务码判不了时传；modoContratacao、valorMateriais 与 contribuinteCprb 只在服务涉及 INSS 代扣时传，开票方是 ME/EPP 时再加 anexoSimples。缺信息时 10018023 一次列出全部缺项。

json

"cliente": { "tipoPessoa": "J", "nome": "TOMADOR TESTE LTDA", "cpfCnpj": "66500544000120", "orgaoPublico": "Nenhum", "optanteSimplesNacional": false },
"servico": {
  "retencoes": { "categoriaFederal": "LimpezaConservacao", "modoContratacao": "CessaoMaoDeObra", "valorMateriais": 200.00 }
}

`*`	object	接收方
`*`	object	服务

* 必填字段

扣减与 descontoIncondicionado 进 ISS 税基扣减，合计不得超过 valorServico。折扣在圣保罗通道拒收。

折扣

无条件折扣进税基扣减；有条件折扣只减净额。

json

"valores": { "valorServico": 1000.00, "descontoIncondicionado": 100.00, "descontoCondicionado": 50.00 }

*

object

服务

* 必填字段

按金额扣减

材料或分包从 ISS 税基扣掉。

json

"valores": { "valorServico": 1000.00, "deducoes": { "valor": 200.00 } }

*

object

服务

* 必填字段

按比例扣减

按 valorServico 折算；不与 valor 或 documentos 同传。

json

"valores": { "valorServico": 1000.00, "deducoes": { "percentual": 20 } }

*

object

服务

* 必填字段

扣减凭证为电子票密钥

每条凭证只有一种标识；扣减额改取 valorDeducao 合计。

json

"valores": {
  "valorServico": 100000.00,
  "deducoes": {
    "documentos": [
      { "chaveNfe": "35260840673061000134550010000001231000001235", "tipo": "2", "dataEmissao": "2026-08-15", "valorDedutivel": 30000.00, "valorDeducao": 30000.00,
        "fornecedor": { "tipoPessoa": "J", "nome": "FORNECEDOR DE MATERIAIS LTDA", "cpfCnpj": "40673061000134" } }
    ]
  }
}

*

object

服务

* 必填字段

扣减凭证为旧市政票

国家标准之前开的票，用市镇、票号与核验码标识。

json

"documentos": [
  { "nfseMunicipal": { "codigoMunicipio": 3550308, "numero": "123456", "codigoVerificacao": "AB12CD34" }, "tipo": "5", "dataEmissao": "2026-08-15", "valorDedutivel": 5000.00, "valorDeducao": 5000.00 }
]

*

object

服务

* 必填字段

扣减凭证为非电子票

纸质或其他型号的税务单据，给票号、型号与序列。

json

"documentos": [
  { "notaFiscal": { "numero": "1234567", "modelo": "1", "serie": "A1" }, "tipo": "2", "dataEmissao": "2026-08-15", "valorDedutivel": 800.00, "valorDeducao": 800.00 }
]

*

object

服务

* 必填字段

扣减凭证只有单据号

税务单据无密钥用 numeroDocumentoFiscal，非税务单据用 numeroDocumento；二选一。

json

"documentos": [
  { "numeroDocumento": "RECIBO-0099", "tipo": "99", "descricaoOutras": "Reembolso de despesas de viagem", "dataEmissao": "2026-08-15", "valorDedutivel": 300.00, "valorDeducao": 300.00 }
]

*

object

服务

* 必填字段

本组只做分类，IBS/CBS 税额由发行方计算。必须同传 servico.codigoNbs。当前环境与竞期尚未生效时传本组拒 10018001；圣保罗通道本组必填。

最小组

状态码、分类码与操作指示码，再加服务里的 NBS。

json

"servico": {
  "codigoNbs": "115011000",
  "ibsCbs": { "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301" }
}

*

object

服务

* 必填字段

实际受益方

只在与 cliente 不同时传 destinatario；须带证件与 nome。

json

"ibsCbs": {
  "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301",
  "destinatario": { "tipoPessoa": "J", "nome": "FILIAL DO ANUNCIANTE LTDA", "cpfCnpj": "66500544000201", "email": "fiscal@anunciante.com.br" }
}

*

object

服务

* 必填字段

不动产服务按登记码

indicadorOperacao 为 02xxxx 且无 obra 时须传 imovel；这里用 codigoCib 标识。

json

"ibsCbs": {
  "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "020101",
  "imovel": { "codigoCib": "AB123456", "inscricaoImobiliaria": "IPTU-000123" }
}

*

object

服务

* 必填字段

不动产服务按地址

简式地址，不含 cidade；国内传 8 位 cep。

json

"ibsCbs": {
  "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "020101",
  "imovel": { "endereco": { "cep": "01310100", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA" } }
}

*

object

服务

* 必填字段

政府实体交易

tipoOperacao 说明收款时点；tipoEnteGovernamental 说明政府层级。

json

"ibsCbs": {
  "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301",
  "tipoOperacao": "1", "tipoEnteGovernamental": "4"
}

*

object

服务

* 必填字段

减率并申报常规口径

本组填减率分类；tributacaoRegular 说明不享受优惠时的口径，两项同传。

json

"ibsCbs": {
  "situacaoTributaria": "200", "classificacaoTributaria": "200052", "indicadorOperacao": "100301",
  "tributacaoRegular": { "situacaoTributaria": "000", "classificacaoTributaria": "000001" }
}

*

object

服务

* 必填字段

递延

状态码 510 或 515；三项比例同传。

json

"ibsCbs": {
  "situacaoTributaria": "510", "classificacaoTributaria": "510001", "indicadorOperacao": "100301",
  "diferimento": { "percentualUf": 100, "percentualMunicipio": 100, "percentualCbs": 100 }
}

*

object

服务

* 必填字段

报销凭证为电子密钥

chaveDfe 配 tipoChaveDfe；金额不计入 ISS、IBS 与 CBS 税基。

json

"reembolsos": [
  { "chaveDfe": "35260840673061000134550010000001231000001235", "tipoChaveDfe": "2",
    "fornecedor": { "tipoPessoa": "J", "nome": "VEICULO DE MIDIA LTDA", "cpfCnpj": "40673061000134" },
    "dataEmissao": "2026-08-20", "dataCompetencia": "2026-08-01", "tipo": "04", "valor": 3000.00 }
]

*

object

服务

* 必填字段

报销凭证为无密钥税务单据

documentoFiscal 给开具市镇、单据号与说明。

json

"reembolsos": [
  { "documentoFiscal": { "codigoMunicipio": 3550308, "numero": "778899", "descricao": "Nota de servico municipal" },
    "dataEmissao": "2026-08-20", "dataCompetencia": "2026-08-01", "tipo": "02", "valor": 1500.00 }
]

*

object

服务

* 必填字段

报销凭证为非税务单据

documentoOutro 给单据号与说明；tipo 为 99 时须传 descricaoTipo。

json

"reembolsos": [
  { "documentoOutro": { "numero": "RECIBO-0099", "descricao": "Recibo de despesas" },
    "dataEmissao": "2026-08-20", "dataCompetencia": "2026-08-01", "tipo": "99", "descricaoTipo": "Reembolso de despesas pagas por conta do cliente", "valor": 250.00 }
]

*

object

服务

* 必填字段

支付关联

把票与结算它的付款接起来。平台校验并在查询里回显，尚未随票发出；圣保罗通道拒收。

json

"pagamentosVinculados": [
  { "sequencia": 1, "idTransacao": "E1234567820260918120000abcdef01", "meioPagamento": 17, "cnpjRecebedor": "40673061000134", "cnpjBasePsp": "18236120" }
]

*

object

服务

* 必填字段

引用票与其他标记

互不依赖的可选项：引用的 NFS-e 密钥、usoConsumoPessoal 与推定抵扣码。

json

"ibsCbs": {
  "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301",
  "notasReferenciadas": ["35503082406730610001340000000000000000000000000077"],
  "usoConsumoPessoal": false,
  "creditoPresumido": "01"
}

*

object

服务

* 必填字段

`ambienteEmissao`开票环境

取值	含义
Homologacao	测试环境，票无法律效力
Producao	正式环境

`emitente.tipo`开票人角色

不传即 Prestador。圣保罗通道只接受 Prestador。

取值	含义
Prestador	本主体是服务提供方并自行开票
Tomador	本主体是接收方并代提供方开票；须传 `prestador` 与 `motivo`，不传 `cliente`
Intermediario	本主体是中介方并代提供方开票；须传 `prestador` 与 `motivo`，不传 `intermediario`

`emitente.motivo`代开事由

取值	含义
1	服务进口
2	市政法规要求接收方或中介方开票
3	服务提供方拒绝开票
4	提供方开的票被拒收，传 `chaveAcessoRejeitada`

`substituicao.codigoMotivo`替代原因码

取值	含义
01	原票脱离 Simples Nacional
02	原票纳入 Simples Nacional
03	追溯纳入豁免或免税
04	追溯取消豁免或免税
05	负责缴税的接收方或中介方拒收原票
99	其他

`cliente.tipoPessoa`参与方类型

同样适用于 cliente、intermediario、prestador、servico.ibsCbs.destinatario 与各凭证的 fornecedor。不传时：cpfCnpj 11 位算 F，14 位算 J，只有 nif 算 E。

取值	含义
F	自然人，证件是 CPF
J	法人，证件是 CNPJ
E	外籍，传 `nif` 或 `motivoSemNif`

`cliente.motivoSemNif`无 NIF 事由

只对无 nif 的外籍参与方；所有参与方通用。

取值	含义
NaoInformado	未提供 NIF
Dispensado	免于提供 NIF
NaoExigido	所在国不要求 NIF

`cliente.orgaoPublico`接收方公共机构层级

只用于 cliente，供平台判定联邦扣缴。国有企业与混合所有制企业按 Nenhum；依赖联邦预算的国企须直传扣缴额。

取值	含义
Nenhum	私营法人
Federal	联邦机关、自治机构或公共基金会；代扣所得税与 PIS、COFINS、CSLL
Estadual	州或联邦区机关、自治机构、公共基金会；只代扣所得税
Municipal	市机关、自治机构、公共基金会；只代扣所得税

`cliente.endereco.uf`国内地址的州

只在 pais 为 BR 时；境外地址填州、省或地区名的自由文本。所有地址通用。

取值	含义
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

`servico.valores.deducoes.documentos[].tipo`扣减类型

取值	含义
1	餐饮或小冰箱
2	材料
3	外部制作
4	费用报销
5	联合体转付
6	医疗计划转付
7	服务
8	劳务分包
9	合作专业人员
99	其他扣减，须传 `descricaoOutras`

`servico.iss.tributacao`ISS 课税形态

不传即 Tributavel。

取值	含义
Tributavel	正常应税，可传 `aliquota`
Imunidade	豁免，可传 `tipoImunidade`
Exportacao	服务出口不征 ISS，须传 `paisPrestacao` 或外籍接收方
NaoIncidencia	不征，圣保罗通道拒收

`servico.iss.retencao`ISS 代扣方

不传即 NaoRetido。

取值	含义
NaoRetido	提供方自缴
RetidoTomador	接收方代扣代缴
RetidoIntermediario	中介方代扣代缴

`servico.iss.tipoImunidade`ISS 豁免类型

只在 tributacao 为 Imunidade 时传。

取值	含义
0	豁免，未注明类型
1	政府实体之间的财产、收入或服务
2	各类宗教场所
3	政党、工会与非营利教育或社会救助机构
4	书籍、报纸、期刊及其印刷用纸
5	巴西制作的音乐录音与影像制品

`servico.iss.exigibilidadeSuspensa.tipo`暂缓征收途径

取值	含义
Judicial	法院裁定暂缓
Administrativa	行政程序暂缓

`servico.pisCofins.situacaoTributaria`PIS/COFINS 税码

不传即 01。

取值	含义
00	无
01	基本税率征税
02	差别税率征税
03	按计量单位征税
04	单相制转售零税率
05	代收征税
06	零税率
07	免税
08	不征
09	暂缓
49	其他销项操作
50	有抵扣权，仅对应国内应税收入
51	有抵扣权，仅对应国内非应税收入
52	有抵扣权，仅对应出口收入
53	有抵扣权，对应国内应税与非应税收入
54	有抵扣权，对应国内应税与出口收入
55	有抵扣权，对应国内非应税与出口收入
56	有抵扣权，对应国内应税、非应税与出口收入
60	推定抵扣，采购仅对应国内应税收入
61	推定抵扣，采购仅对应国内非应税收入
62	推定抵扣，采购仅对应出口收入
63	推定抵扣，采购对应国内应税与非应税收入
64	推定抵扣，采购对应国内应税与出口收入
65	推定抵扣，采购对应国内非应税与出口收入
66	推定抵扣，采购对应国内应税、非应税与出口收入
67	推定抵扣，其他情形
70	采购无抵扣权
71	采购免税
72	采购暂缓
73	采购零税率
74	采购不征
75	采购代收
98	其他进项操作
99	其他操作

`servico.pisCofins.retencao`PIS/COFINS 旧版代扣标记

传了 tipoRetencao 即忽略。

取值	含义
Retido	PIS 与 COFINS 被代扣，等于 `tipoRetencao` `1`
NaoRetido	PIS 与 COFINS 不代扣，等于 `tipoRetencao` `2`

`servico.pisCofins.tipoRetencao`PIS、COFINS 与 CSLL 代扣形态

1 与 2 是官方将删除的过渡值；优先用 0 与 3 到 9。

取值	含义
0	三者均不代扣
1	PIS 与 COFINS 代扣
2	PIS 与 COFINS 不代扣
3	三者均代扣
4	PIS 与 COFINS 代扣，CSLL 不代扣
5	仅 PIS 代扣
6	仅 COFINS 代扣
7	COFINS 与 CSLL 代扣，PIS 不代扣
8	仅 CSLL 代扣
9	PIS 与 CSLL 代扣，COFINS 不代扣

`servico.retencoes.categoriaFederal`联邦扣缴分类

只在平台自行判定扣缴时使用。MonitoramentoEletronico 与 TransporteValoresReb 须在 retencoes 直传扣缴额。

取值	含义
ServicoProfissional	所得税法列举的专业服务，如律师、工程、咨询
Treinamento	教育培训
OrganizacaoEventos	会展与活动组织
LimpezaConservacao	清洁与保全
Manutencao	持续维护；代扣 PIS、COFINS、CSLL，不扣所得税
SegurancaVigilancia	安保与警卫
LocacaoMaoDeObra	劳务派遣
AssessoriaCredito	信用咨询与应收应付管理
ComissaoCorretagem	佣金、经纪与商业代理；只扣所得税
ComissaoAutoRetencao	由收款方自行缴所得税的佣金；接收方不扣
AgenciaPropaganda	广告代理；代理自行缴所得税
CooperativaTrabalho	劳动合作社；代扣 PIS 与 COFINS，不扣 CSLL
AssociacaoProfissionais	专业人士协会
ServicoHospitalar	医院类服务
ConstrucaoCivil	土建工程
TransporteCargas	货物运输；不代扣 INSS
TransportePassageiros	客运
Hospedagem	住宿
MonitoramentoEletronico	电子监控；不代扣 INSS，平台不自动算，须直传扣缴额
LicenciamentoSoftware	软件许可
LocacaoBens	资产租赁
FornecimentoBens	货物供应
ServicoRural	农业类劳务
ServicoIndustrial	工业加工类劳务
ApoioAdministrativo	行政与作业支持
TransporteValoresReb	国际押运或 REB 船厂；平台不自动算，须直传扣缴额
SemRetencaoFederal	不在任何联邦扣缴清单内

`servico.retencoes.modoContratacao`合同形态

只影响 INSS 代扣。

取值	含义
CessaoMaoDeObra	劳务外包：人员在接收方场所或其指定处听其调度
Empreitada	承包或分包：按约定成果交付，在接收方场所施工
EmpreitadaTotal	整体承包；不代扣 INSS
Resultado	按结果交付，既非劳务外包也非承包；不代扣 INSS

`servico.retencoes.anexoSimples`Simples 附表

只对 ME/EPP 开票方，按本项服务收入填。只有附表 IV 被接收方代扣 INSS。

取值	含义
1	附表 I，商业
2	附表 II，工业
3	附表 III，服务
4	附表 IV，建筑、安保、清洁、律师等服务
5	附表 V，按工资占比计税的服务

`servico.comercioExterior.modoPrestacao`服务提供模式

取值	含义
0	未知，原票未注明
1	跨境提供
2	在巴西境内消费
3	境外商业存在
4	自然人临时流动

`servico.comercioExterior.vinculoPartes`双方关联关系

取值	含义
0	无关联
1	子公司
2	母公司
3	关联公司
4	总部
5	分支机构
6	其他关联
9	未知，原票未注明

`servico.comercioExterior.mecanismoApoioPrestador`提供方外贸支持机制

取值	含义
00	未知，原票未注明
01	无
02	ACC 外汇合同预付款，所得税与 IOF 降为零
03	ACE 已交单外汇预付款，所得税与 IOF 降为零
04	BNDES-Exim 装运后融资，服务
05	BNDES-Exim 装运前融资，服务
06	FGE 出口担保基金
07	PROEX 利率平衡
08	PROEX 融资

`servico.comercioExterior.mecanismoApoioTomador`接收方外贸支持机制

取值	含义
00	未知，原票未注明
01	无
02	政府机关与国际代表机构
03	机器、设备、船舶与飞机的租赁
04	向公共航空运输企业出租飞机
05	出口时付给境外代理的佣金
06	境外仓储、搬运与货运费用
07	FIFA 赛事，子公司
08	FIFA 赛事
09	运费、船舶或飞机租赁及其他
10	航空材料
11	在境外推广商品
12	推广巴西旅游目的地
13	在境外推广巴西
14	在境外推广服务
15	RECINE 影院激励制度
16	RECOPA 世界杯激励制度
17	商标、专利与植物品种的注册与维持
18	REICOMP 教育电脑激励制度
19	REIDI 基础设施激励制度
20	REPENEC 石化基础设施激励制度
21	REPES 软件出口激励制度
22	RETAERO 航空工业激励制度
23	RETID 国防工业激励制度
24	特许权使用费、技术或科学援助及类似
25	与世贸组织协定相关的合格评定服务
26	ZPE 出口加工区

`servico.comercioExterior.movimentacaoTemporariaBens`货物临时进出

取值	含义
0	未知，原票未注明
1	无关联
2	关联进口申报
3	关联出口申报

`servico.ibsCbs.situacaoTributaria`IBS/CBS 状态码

servico.ibsCbs.tributacaoRegular.situacaoTributaria 用同一张表。

取值	含义
000	全额征税
010	统一税率征税
011	统一减率征税
200	减率
220	固定税额
221	按比例固定税额
222	税基缩减
400	免税
410	豁免与不征
510	递延
515	递延加减率
550	暂停征收
620	单相征税
800	抵扣转移
810	马瑙斯自贸区 IBS 调整
811	调整
820	在专门单据里征税
830	税基排除

`servico.ibsCbs.classificacaoTributaria`IBS/CBS 分类码

前 3 位就是状态码。servico.ibsCbs.tributacaoRegular.classificacaoTributaria 用同一张表。

取值	含义
000001	IBS 与 CBS 全额征税的一般情形
000002	道路特许经营
000003	汽车业激励项目（第 311 条）
000004	汽车业激励项目（第 312 条）
000005	本应与 A 类汽油调和的无水乙醇改作他用
010001	非联邦储蓄银行办理的 FGTS 业务
010002	金融服务业务
011001	殡葬服务计划
011002	医疗保险计划
011003	医疗保险计划的中介
011004	彩票与竞猜
011005	宠物医疗计划
200001	运往出口加工区及自出口加工区出口的货物运输
200002	供给非纳税人农业生产者或独立货运司机
200003	人类食用产品销售（附件一）
200004	医疗器械供给（附件十二）
200005	向政府机关与免税医疗机构供给医疗器械（附件四）
200006	政府认定的公共卫生紧急状态
200007	残障人士无障碍器具供给（附件十三）
200008	政府机关采购的残障人士无障碍器具（附件五）
200009	Anvisa 注册药品供给
200010	政府机关采购的 Anvisa 注册药品
200011	政府机关采购的肠内与肠外营养制剂（附件六）
200012	政府认定的公共卫生紧急状态
200013	卫生棉条与卫生巾供给
200014	蔬菜、水果与鸡蛋（附件十五）
200015	职业司机或残障人士购买的国产乘用车
200016	科技创新机构提供的研发服务
200017	与 FGTS 相关的业务
200018	再保险与转分保业务
200019	作为纳税人的金融服务进口方
200020	选择 IBS/CBS 特定制度的合作社的交易
200021	铁路与水路公共客运
200022	自贸区外向马瑙斯自贸区内纳税人发送工业品
200023	马瑙斯自贸区激励工业之间的中间品供给
200024	自由贸易区外向区内纳税人发送货物
200025	Prouni 全民大学计划相关的教育服务
200026	位于复兴区的不动产租赁
200027	不动产的租赁、有偿转让与融资租赁
200028	教育服务（附件二）
200029	人类医疗健康服务（附件三）
200030	医疗器械销售（附件四）
200031	残障人士无障碍器具（附件五）
200032	Anvisa 注册药品或配制药品，零税率药品除外
200033	肠内与肠外营养制剂（附件六）
200034	人类食用食品（附件七）
200035	个人卫生与清洁用品（附件八）
200036	未加工的农、渔、林与植物采集产品
200037	原生植被保护或恢复的环境服务
200038	农业与水产养殖投入品（附件九）
200039	国内艺术、文化、活动、新闻与影视制作相关供给（附件十）
200040	向政府提供的机构传播服务
200041	体育教育服务（第 141 条 I）
200042	体育管理与经营服务（第 141 条 II）
200043	向政府供给的主权与安全相关商品和服务（附件十一）
200044	有巴西股东的公司提供的信息安全与网络安全服务（附件十一）
200045	历史城区与城市更新重点区域的复兴项目
200046	不动产交易
200047	酒吧与餐厅
200048	酒店、游乐园与主题公园
200049	公路、铁路与水路集体客运
200050	区域航空集体客运或货运
200051	旅行社
200052	智力型职业服务
200053	Anvisa 注册的血清或疫苗类药品
200054	农业合作社向非正规制度社员供给货物
220001	适用特别税制的房地产开发
220002	适用特别税制的房地产开发
220003	土地分割形成的不动产出售
221001	按毛收入计税的不动产租赁、有偿转让或融资租赁
221002	适用特别税制的房地产开发
221003	适用特别税制的房地产开发
221004	土地分割形成的不动产出售
222001	往返程一并销售的国际客运
400001	公路与地铁公共客运
400002	按行驶公里计费的公路与地铁公共客运
410001	票面注明且不依赖后续事件的赠品
410002	同一纳税人各分支之间的调拨
410003	捐赠人不取得对价的捐赠
410004	商品与服务出口
410005	联邦、州、联邦区与市政府的供给
410006	宗教团体与各类教堂的供给
410007	政党、工会与教育或社会救助机构的供给
410008	书籍、报纸、期刊及其印刷用纸
410009	巴西制作的音乐录音与音乐影像
410010	免费公开接收的广播与电视传播服务
410011	法律认定为金融资产或外汇工具的黄金
410012	未选正规制度的物业小区的供给
410013	燃油出口
410014	非纳税人农业生产者的供给
410015	非纳税人个体运输者的供给
410016	固体废弃物的供给或采购
410017	带附条件推定抵扣的动产采购，须转售
410018	担保基金与公共政策执行基金的业务
410019	餐饮供给中小费不计入税基
410020	餐饮供给中平台佣金不计入税基
410021	联邦宪法第 149-A 条规定的缴款
410022	债权人取得担保物所有权
410023	非纳税人担保人所提供担保物的处置
410024	消费联合体取得担保物所有权
410025	非纳税人担保人所提供担保物的出售
410026	需冲销抵扣的捐赠
410027	服务或无形商品出口
410028	非纳税人自然人的不动产交易
410029	只涉及 ICMS 的交易
410030	因腐坏、变质、被盗或遗失冲销抵扣
410031	IBS 与 CBS 生效前的供给
410032	交易所涉但不计入 IBS/CBS 税基的税款
410033	房地产投资基金与农业产业链投资基金的业务
410034	投资基金的业务
410035	微型创业者的供给
410036	无条件折扣
410037	不征 IBS 与 CBS 的有形商品进口
410999	其他无对价且不征税的交易
510001	电力的进口、发电、销售、配电与输电，递延
515001	农业与水产养殖投入品，递延（附件九）
550001	有形商品出口
550002	过境制度
550003	仓储制度（第 85 条）
550004	仓储制度（第 87 条）
550005	仓储制度（第 87 条单款）
550006	暂时进境制度
550007	加工贸易制度
550008	Repetro 临时进口制度下的货物进口
550009	GNL 临时制度
550010	Repetro 永久制度
550011	Repetro 工业化制度
550012	Repetro 国产制度
550013	Repetro 保税仓制度
550014	出口加工区
550015	港口现代化与扩建激励税制
550016	基础设施发展特别激励制度
550017	造船业激励税制
550018	资本品采购减负
550019	激励工业为在马瑙斯自贸区使用而进口货物
550020	自由贸易区
550021	出口导向的加工
550022	低碳氢生产特别激励制度
550023	石油或天然气来源的非燃料液态烃，含石脑油
550024	造船业激励税制 Renaval（第 107 条 II）
550025	造船业激励税制 Renaval（第 107 条 III）
620001	燃油单相征税
620002	燃油单相征税并负责代扣
620003	燃油单相征税，由第三方代扣
620004	乙醇与 A 类汽油调和比例高于法定值的单相征税
620005	乙醇与 A 类汽油调和比例低于法定值的单相征税
620006	燃油单相征税，前环节已征
620007	单相制度下的腐坏、变质、被盗或遗失
800001	合并、分立或吸收
800002	社员的抵扣转移，含基层合作社
810001	自马瑙斯自贸区发出的供给的推定抵扣
811001	免税或免征销项的抵扣冲销
811002	未纳入核算的发票税额补记
811003	退出 Simples Nacional
820001	申报 LC 214 第 234 条所列医疗保险计划服务的单据
820002	申报殡葬服务计划的单据
820003	申报宠物医疗计划服务的单据
820004	申报彩票与竞猜服务的单据
820005	申报不动产出售的单据
820006	申报道路特许经营服务的单据
820007	申报金融服务的单据
820008	申报已在前期账单计税的持续性服务的单据
820009	对已在其他单据申报的供给的收款
830001	将配电公司向用电户供电排除出 IBS/CBS 税基的单据

`servico.ibsCbs.indicadorOperacao`操作指示码

前 2 位是操作大类。一般服务用 100301；02xxxx 且没有 obra 时须传 imovel。

取值	含义
020101	不动产相关操作
020201	不动产相关操作
020301	不动产相关操作
030101	对人提供的服务
030102	对人提供的服务
030103	对人提供的服务
030104	对人提供的服务
040101	会展与活动
050101	动产相关操作
050102	动产相关操作
050103	动产相关操作
050104	动产相关操作
050201	动产相关操作
060101	客运
070101	货运
070102	货运
080101	道路相关操作
100101	其他供给，含一般服务
100102	其他供给，含一般服务
100201	其他供给，含一般服务
100301	其他供给，含一般服务
100302	其他供给，含一般服务
100401	其他供给，含一般服务
100501	其他供给，含一般服务
100502	其他供给，含一般服务
100601	其他供给，含一般服务

`servico.ibsCbs.finalidade`开票目的

不传即 0。

取值	含义
0	常规 NFS-e

`servico.ibsCbs.tipoOperacao`交易类型

取值	含义
1	先供应后收款
2	供应已完成后的收款
3	已收款的供应
4	先收款后供应
5	供应与收款同时

`servico.ibsCbs.tipoEnteGovernamental`政府实体类型

取值	含义
1	联邦
2	州
3	联邦区
4	市镇

`servico.ibsCbs.reembolsos[].tipoChaveDfe`密钥单据类型

取值	含义
1	NFS-e
2	NF-e
3	CT-e
9	其他，须传 `descricaoTipoChave`

`servico.ibsCbs.reembolsos[].tipo`报销金额性质

取值	含义
01	房产中介佣金转付给其他经纪人
02	旅行社转付给供应商的款项
03	广告代理代第三方支付的外部制作服务报销
04	广告代理代第三方支付的媒体服务报销
99	其他代第三方支付的报销，须传 `descricaoTipo`

`servico.ibsCbs.pagamentosVinculados[].meioPagamento`支付方式

取值	含义
15	Boleto 银行单
17	PIX 动态二维码
18	TED 电子转账
20	PIX 键或静态二维码
23	PIX 自动扣款
24	TEF 行内转账

错误码	HTTP
10018001	400	受理期参数校验拒绝；消息点名字段与原因。含 `ibsCbs` 规则：未生效即传、码值不在官方表、缺 `codigoNbs`、组内缺项，以及圣保罗通道限制。也含 Simples Nacional 或 MEI 开票方直传 `irrf`、`csll`、`pis`、`cofins` 大于 0，以及 CNPJ 接收方传了 `pisCofins.tipoRetencao` 却没在 `servico.retencoes` 直传金额，或形态与金额不一致。
10018004	400	主体不可开票：停用或证书不可用。检查主体状态与证书。
10018005	400	主体缺 NFS-e 档案；消息说明缺什么。先用注册主体带 `emissaoNFSe` 段建档案。
10018010	400	市镇的 NFS-e 标准尚未支持。该市镇暂不可开，联系平台。
10018012	400	服务码缺失或不在 LC 116 清单。核对 `servico.codigoTributacaoNacional`。
10018013	400	接收方证件不合法。核对 CPF、CNPJ 或 NIF。
10018014	400	服务出口缺出境国。补 `servico.paisPrestacao` 或外籍接收方。
10018015	400	被替代票不可替代。核对被替代票状态。
10018020	400	无法确定 ISS 税率。传 `servico.iss.aliquota` 或正确的 `servico.codigoTributacaoMunicipal`。
10018022	400	Simples 主体不得直传 ISS 税率。去掉 `servico.iss.aliquota`。
10018023	400	判定联邦源泉扣缴还缺信息；消息一次列出全部缺的字段路径：`servico.retencoes.categoriaFederal`、`cliente.orgaoPublico`、`cliente.optanteSimplesNacional`、`servico.retencoes.modoContratacao`、`servico.retencoes.anexoSimples` 或 `servico.retencoes.inss/irrf/csll/pis/cofins`。补齐缺项，或在 `servico.retencoes` 直传扣缴额；最后一项只能直传扣缴额，出现于服务分类要求人工判定、或本主体以接收方或中介方身份开票时。
10018065	400	本票需要的 NFS-e 计税基础数据尚未导入，一律在受理时同步拒绝。只在请求没给、须由平台查的那一项用到未就绪的数据时出现；消息按「业务项 -> 可改传的请求字段」列出：`retencao-federal -> servico.retencoes.inss/irrf/csll/pis/cofins`、`pis-cofins -> servico.pisCofins.aliquotaPis/aliquotaCofins`、`iss-local-incidencia -> servico.iss.municipioIncidencia.codigoIbge`。在请求里直接传箭头后的字段，或联系平台确认基础数据已导入。`iss-local-incidencia` 出现于服务发生地与开票方不同城时，传 `servico.iss.municipioIncidencia` 即可。
10018030	400	同一请求正在处理中。稍后重试。
10018031	400	该单号已开票，或同 `id` 不同内容。换单号或核对内容。
10018041	400	该票已被替代，不可再操作。
10018063	400	申报报文不符合官方架构；明细含行号、列号与错误键。常见原因：文本含 Latin-1 以外字符、地址不完整、码值不在官方码表。

参数

路径参数

请求体

响应

发行前提

最简请求3 块

个人接收方

法人接收方

无接收方

接收方与中介方3 块

境外接收方带税号

境外接收方无税号

带中介方的票

服务发生地与出口2 块

服务发生在其他市镇

服务出口

ISS 课税形态7 块

应税并直传税率

接收方代扣 ISS

豁免

不征

暂缓征收

市政优惠

Simples 主体

PIS/COFINS 与联邦扣缴4 块

不代扣

三项均代扣

直传扣缴额

由平台计算扣缴

金额与扣减7 块

折扣

按金额扣减

按比例扣减

扣减凭证为电子票密钥

扣减凭证为旧市政票

扣减凭证为非电子票

扣减凭证只有单据号

税负透明4 块

按金额

按比例

Simples 比例

明示不申报

工程与活动5 块

工程按登记号

工程按不动产登记码

工程按地址

活动按市政活动码

活动按地址

订单与补充信息1 块

订单行与备注

IBS/CBS 分类12 块

最小组

实际受益方

不动产服务按登记码

不动产服务按地址

政府实体交易

减率并申报常规口径

递延

报销凭证为电子密钥

报销凭证为无密钥税务单据

报销凭证为非税务单据

支付关联

引用票与其他标记

接收方或中介方代开2 块

接收方代开

中介方代开

替代开票1 块

替代已授权的票

文本字符集

平台代算的部分

枚举33 张表

ambienteEmissao开票环境

emitente.tipo开票人角色

emitente.motivo代开事由

substituicao.codigoMotivo替代原因码

cliente.tipoPessoa参与方类型

cliente.motivoSemNif无 NIF 事由

cliente.orgaoPublico接收方公共机构层级

cliente.endereco.uf国内地址的州

`ambienteEmissao`开票环境

`emitente.tipo`开票人角色

`emitente.motivo`代开事由

`substituicao.codigoMotivo`替代原因码

`cliente.tipoPessoa`参与方类型

`cliente.motivoSemNif`无 NIF 事由

`cliente.orgaoPublico`接收方公共机构层级

`cliente.endereco.uf`国内地址的州

`servico.valores.deducoes.documentos[].tipo`扣减类型

`servico.iss.tributacao`ISS 课税形态

`servico.iss.retencao`ISS 代扣方

`servico.iss.tipoImunidade`ISS 豁免类型

`servico.iss.exigibilidadeSuspensa.tipo`暂缓征收途径

`servico.pisCofins.situacaoTributaria`PIS/COFINS 税码

`servico.pisCofins.retencao`PIS/COFINS 旧版代扣标记

`servico.pisCofins.tipoRetencao`PIS、COFINS 与 CSLL 代扣形态

`servico.retencoes.categoriaFederal`联邦扣缴分类

`servico.retencoes.modoContratacao`合同形态

`servico.retencoes.anexoSimples`Simples 附表

`servico.comercioExterior.modoPrestacao`服务提供模式

`servico.comercioExterior.vinculoPartes`双方关联关系

`servico.comercioExterior.mecanismoApoioPrestador`提供方外贸支持机制

`servico.comercioExterior.mecanismoApoioTomador`接收方外贸支持机制

`servico.comercioExterior.movimentacaoTemporariaBens`货物临时进出

`servico.ibsCbs.situacaoTributaria`IBS/CBS 状态码

`servico.ibsCbs.classificacaoTributaria`IBS/CBS 分类码

`servico.ibsCbs.indicadorOperacao`操作指示码

`servico.ibsCbs.finalidade`开票目的

`servico.ibsCbs.tipoOperacao`交易类型

`servico.ibsCbs.tipoEnteGovernamental`政府实体类型

`servico.ibsCbs.reembolsos[].tipoChaveDfe`密钥单据类型

`servico.ibsCbs.reembolsos[].tipo`报销金额性质

`servico.ibsCbs.pagamentosVinculados[].meioPagamento`支付方式