获取单据打印文件
接口: /report/form/pdf POST JSON
说明
- 该接口采用异步生成打印文件,客户端需要轮询查看打印进度,当接口返回printStatus=COMPLETED时,表示打印完成,客户取得fileDownloadUrl中对应链接进行下载。
- 同一个单据1小时内不会重复打印(取上一次结果)
- 打印模板将会在用途内搜寻。模板用途 ARCHIVE 为档案用户专用,若未在"设置 -> 单据与流程 -> 打印模板"处配置归档模板,请勿设置此参数,可能会导致打印失败。
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 | |
---|---|---|---|---|---|---|
formType | string | Y | Y | 单据类型:REIMBURSE(对私)、CORP_REIMBURSE(对公)、PRECONSUME(申请单)、CORP_REPAYMENT(对公收款)、CORP_CONTRACT(合同)、REPAYMENT(还款) | ||
businessCode | string | Y | Y | 单据编号 | ||
templateName | string | N | N | 模板名称 | 指定打印的中文模板,默认使用单据下启用的中文模板。若需查看单据下的模板列表,请在页面端,设置 -> 单据与流程 -> 打印模板,查看。 | |
purpose | string | N | Y | N | 模板用途 | 用途类型:COST_CONTROL(费控內打印模版) 、ARCHIVE(归档专用打印模版)。默认值为 COST_CONTROL |
返回数据
参数 | 类型 | 描述 |
---|---|---|
printStatus | string | 打印进度:SUBMITTED(排队中)、PROCESSING(进行中)、COMPLETED(已完成)、ERROR(发生错误) |
fileDownloadUrl | string | 文件下载链接,有效期2天 |
errorMsg | string | 错误信息 |
示例:
请求数据
{
"formType": "REIMBURSE",
"businessCode": "MK1200700334"
}
返回数据(打印任务完成)
{
"code": "ACK",
"message": "",
"data": {
"printStatus": "COMPLETED",
"fileDownloadUrl": "XXXX",
"errorMsg": null
},
"args": null,
"linkDetail": false,
"nonBizError": false
}
返回数据(打印任务正在进行中)
{
"code": "ACK",
"message": "",
"data": {
"printStatus": "PROCESSING"
"errorMsg": null
},
"args": null,
"linkDetail": false,
"nonBizError": false
}
返回数据(打印任务出错)
{
"code": "ACK",
"message": "",
"data": {
"printStatus": "ERROR"
"errorMsg": "pdf生成错误"
},
"args": null,
"linkDetail": false,
"nonBizError": false
}