纸质发票打印
对已开具成功的纸质发票发起打印，由开票员电脑上的打印机完成。仅纸质发票类型（增值税普通发票、增值税专用发票、数电普通发票、数电增值税专用发票、纸质二手车发票）可用。
POST
/invoice/print请求参数
请求体为 JSON，outOrderNos、numbers、ids 至少传一个，可以同时传。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appKey | string | 条件必填 | 服务密钥 Key，与 appSecret 成对使用；传了 accessToken 时可不传 |
| appSecret | string | 条件必填 | 服务密钥 Secret |
| accessToken | string | 条件必填 | 访问令牌，通过 获取访问令牌 接口获取；传了 accessToken 则无需 appKey / appSecret |
| taxNumber | string | 必填 | 企业纳税人识别号，指定本次操作的开票企业；必须是该密钥已关联的企业 |
| outOrderNos | array | 条件必填 | 外部订单号数组 |
| color | string | 选填 | 按外部订单号查找时的发票颜色，blue（默认）/ red |
| numbers | array | 条件必填 | 发票号码数组 |
| ids | array | 条件必填 | 发票 ID 数组，必须处于已开票状态 |
| chinaTaxMobile | string | 选填 | 指定执行打印的开票员手机号，不传使用默认开票员 |
{
"appKey": "你的appKey",
"appSecret": "你的appSecret",
"taxNumber": "91320211MA1WML8X6T",
"outOrderNos": ["ORDER20260101001"],
"chinaTaxMobile": "13600000000"
}
响应示例
{
"code": 1,
"message": "打印提交成功"
}
企业开启「是否测试环境」时，打印请求不会真正发送到打印机。
错误信息
| message | 说明 |
|---|---|
| xxx外部订单号不存在 / xxx发票号码不存在 | 发票不存在 |
| xxx外部订单号不是纸质发票 / xxx发票号码不是纸质发票 / 第n条不是纸质发票 | 电子发票不能打印 |
| xxx发票审核中无法打印 | 发票尚在审核 |
| 第n条当前状态不处于已开具状态 | 按 ID 打印时发票未开票成功 |
| 非法参数 | 发票不属于当前企业 |
| 无正确发票打印 | 没有可打印的发票 |