NFS-e

进项 NFS-e 表态

对收到的 NFS-e 登记官方确认或拒绝表态；异步，200 回受理回执。

POST/openapi/v2/empresas/{empresaId}/nfse/recebidas/{chaveAcesso}/manifestar

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

本主体作为接收方或中介方，对收到的 NFS-e 正式表态：tipo 在 Confirmacao 与 Rejeicao 之间二选一，拒绝时请求体再带官方原因码。受理是异步的，结果经 nfse.inbound.manifested / nfse.inbound.manifest_failed 回调获知，这两个事件需显式订阅，也可查进项详情的 manifestacao 块。一张票每方只能表态一次：已确认、已拒绝或默示确认后再调返回 10018042。

路径参数

`empresaId*`	string	主体标识
`chaveAcesso*`	string	访问密钥

* 必填字段

请求体

`tipo*`	string	表态类型
`codigoMotivo*` 拒绝时必填。	string	拒绝原因码
`motivo`	string	拒绝说明

* 必填字段

200

表态已受理：受理回执。结果经 nfse.inbound.manifested / nfse.inbound.manifest_failed 回调获知，也可查进项详情的 manifestacao 块。

`nfseTaskId`	int	平台任务 id
`status`	int	任务状态
`reused`	bool	是否复用原任务
`createTime`	string	受理时刻

平台按票上本主体的角色自动选事件码，调用方不传事件码：接收方确认用 203202、拒绝用 203206；中介方确认用 204203、拒绝用 204207。事件登记在国家发行器，经全国分发回流到票上各方。

确认

只传 tipo。同时带 codigoMotivo 或 motivo 直接拒 10018001。

json

{ "tipo": "Confirmacao" }

tipo*

string

表态类型

* 必填字段

拒绝

tipo 加官方原因码；说明可选。

json

{
  "tipo": "Rejeicao",
  "codigoMotivo": "3",
  "motivo": "Servico nao prestado ao tomador"
}

`tipo*`	string	表态类型
`codigoMotivo*`	string	拒绝原因码
`motivo`	string	拒绝说明

* 必填字段

HTTP 200 只是受理回执；原任务仍在途时对同一票重复提交会返回 reused=true。结果经 nfse.inbound.manifested / nfse.inbound.manifest_failed 回调获知，这两个事件需在[注册 Webhook](/docs/webhooks/register/)显式订阅，也可查进项详情的 manifestacao 块。失败不能忽视：期限内未表态会被市镇登记默示确认，请在期限前重新表态。

登记成功：nfse.inbound.manifested

载荷为统一事件体，data 见下。确认与拒绝走同一事件，由 tipo 区分。

json

{
  "version": "1.0",
  "event_id": "1950000000000004",
  "event_type": "nfse.inbound.manifested",
  "occurred_at": "2026-09-21T14:00:05Z",
  "data": {
    "inbound_id": "1950000000000777",
    "chave": "35503082406730610001340000000000000000000000000077",
    "tipo": "Rejeicao",
    "evento": "203206",
    "codigo_motivo": "3",
    "motivo": "Servico nao prestado ao tomador",
    "protocolo": "3550308000000000000000000000000000000000000000000001"
  }
}

`inbound_id*`	string	进项票平台 id
`chave*`	string	访问密钥
`tipo*`	string	登记的表态类型
`evento*`	string	登记的事件官方码
`codigo_motivo`	string	拒绝原因码
`motivo`	string	拒绝说明
`protocolo*`	string	发行方登记号

* 必填字段

登记失败：nfse.inbound.manifest_failed

发行方拒绝了事件，或报文不符合官方格式（10018064）。manifestacao 块仍为 null；请在期限前重新表态。

json

{
  "version": "1.0",
  "event_id": "1950000000000006",
  "event_type": "nfse.inbound.manifest_failed",
  "occurred_at": "2026-09-21T14:00:05Z",
  "data": {
    "chave": "35503082406730610001340000000000000000000000000077",
    "tipo": "Rejeicao",
    "codigo": "E0231",
    "motivo": "Evento nao permitido para o tipo de autor"
  }
}

`chave*`	string	访问密钥
`tipo*`	string	尝试的表态类型
`codigo`	string	失败码
`motivo*`	string	失败原因

* 必填字段

详情里的 manifestacao 块

详情与列表项结构相同，未表态时为 null。

json

{
  "manifestacao": {
    "status": "Confirmada",
    "codigoEvento": "203202",
    "codigoMotivo": null,
    "motivo": null,
    "protocolo": "3550308000000000000000000000000000000000000000000001",
    "data": "2026-09-21T14:00:00-03:00",
    "linkXml": "https://api.v2.tffiscal.com/openapi/files/xml/9102?token=..."
  }
}

`status*`	string	表态状态
`codigoEvento`	string	表态事件官方码
`codigoMotivo`	string	拒绝原因码
`motivo`	string	拒绝原因说明
`protocolo`	string	发行方登记号
`data`	string	登记时刻
`linkXml`	string	表态报文下载链接

* 必填字段

`tipo`表态类型

取值	含义
Confirmacao	确认该票；事件 203202（接收方）或 204203（中介方）
Rejeicao	拒绝该票并给原因码；事件 203206（接收方）或 204207（中介方）

`codigoMotivo`拒绝原因码

tipo=Rejeicao 时必填；tipo=Confirmacao 时不得传。

取值	含义
1	票重复
2	接收方已自行开票
3	应税事实未发生，服务没有提供
4	责任方错误
5	金额或数据错误
9	其他，在 `motivo` 里说明

`status`任务状态

取值	含义
0	待处理
1	处理中
2	成功
3	失败

`manifestacao.status`表态状态

字段为 null 表示未表态；列表过滤时这一情形用 Pendente。

取值	含义
Confirmada	本方已确认（203202 / 204203）；终态
Rejeitada	本方已拒绝（203206 / 204207）；市镇仍可作废
ConfirmacaoTacita	期限内未表态，市镇默示确认（205204）；终态
RejeicaoAnulada	市镇作废了本方的拒绝（205208）；终态

`manifestacao.codigoEvento`表态事件码

取值	含义
203202	接收方确认
204203	中介方确认
203206	接收方拒绝
204207	中介方拒绝
205204	市镇默示确认
205208	市镇作废拒绝

错误码	HTTP
10018001	400	受理期参数拒绝：`tipo` 不在 `Confirmacao` / `Rejeicao` 之内，拒绝时缺 `codigoMotivo` 或不在枚举内，确认时带了 `codigoMotivo` / `motivo`，或 `motivo` 不在 15 到 255 个字符之内。消息说明具体原因。
10018003	404	单据不存在：该密钥不在本主体的进项里。核对 `chaveAcesso` 与 `empresaId`。
10018042	400	当前状态不允许表态：票已取消或已被替代，本主体已有表态（已确认、已拒绝或默示确认），或本主体既非接收方也非中介方。

进项 NFS-e 表态

参数

路径参数

请求体

响应

请求体的两种形态2 块

确认

拒绝

受理与结果3 块

登记成功：nfse.inbound.manifested

登记失败：nfse.inbound.manifest_failed

详情里的 manifestacao 块

表态状态机

枚举5 张表

tipo表态类型

codigoMotivo拒绝原因码

status任务状态

manifestacao.status表态状态

manifestacao.codigoEvento表态事件码

错误3 条

`tipo`表态类型

`codigoMotivo`拒绝原因码

`status`任务状态

`manifestacao.status`表态状态

`manifestacao.codigoEvento`表态事件码