付款批次

支付批处理文件web服务为希望管理其支付批处理并收集其批处理文件的客户提供了自动化解决方案。

工艺流程

付款批处理流程

产品与版本

Concur费用标准版

笔记：对于Concur Expense专业版，请使用摘录v1api

检索付款批次列表

检索具有可选请求状态的付款批次列表。

GET/api/expense/paymentbatch/v1.1/batchlist/

参数

名称	类型	总体安排	描述
`批处理列表`	`一串`	-	必修的。batchlist关键字。
`地位`	`布尔值`	-	批次的状态。可以是打开或关闭。

检索付款批次响应模式

名称	类型	总体安排	描述
`批名称`	`一串`	-	“付款管理器”中显示的批次名称。
`BatchID`	`一串`	-	批处理的唯一标识符。
`批次总数`	`十进制的`	-	批次的总数量。
`通货`	`一串`	-	这个三字母ISO 4217货币代码这批货。
`计数`	`一串`	-	批次中的付款请求数。
`类型`	`一串`	-	批次的收款人。员工或卡程序。
`付款方式`	`一串`	-	批次的报销方法。通过SAP Concur、公司支票（通过应付账款）、ADP（通过EPP文件）或其他报销方式支付费用。
`批处理URL`	`一串`	-	用作其他操作（如关闭批处理）基础的URL。

异步关闭付款批处理

版本1.2

此异步请求计划关闭指定批次，防止任何新费用进入该批次。批次关闭后，您可以使用Close Payment batch v1.1获取文件Url下载包含费用交易信息的文件。

笔记：您可以使用“检索付款批次列表”方法检查批次状态。

POST/api/expense/paymentbatch/v1.2/batch/{BatchID}/close

参数

名称	类型	总体安排	描述
`BatchID`	`一串`	-	必修的。批处理的唯一标识符。
`关`	`一串`	-	必修的。关闭关键字。

异步关闭支付批处理响应模式

名称	类型	总体安排	描述
`地位`	`一串`	-	关闭批处理的请求的状态。
`JobQueueKey`	`一串`	-	批处理作业的唯一标识符。

同步关闭付款批次

版本1.1

此请求同步关闭批次，防止任何新费用进入。批次关闭后，SAP Concur将创建包含费用交易信息的批次文件。如果发送了已关闭批次的批次ID，SAP Concur将为指定批次重新生成批次文件。

此同步调用有一个时间限制，可以由关闭批处理所需的时间取代。建议您使用异步关闭付款批次（v1.2）来关闭批次，然后在批次关闭后使用此请求来获取付款文件Url需要下载包含费用交易信息的文件。

笔记：您可以使用“检索付款批次列表”方法检查批次状态。

POST/api/expense/paymentbatch/v1.1/batch/{BatchID}/close

参数

名称	类型	总体安排	描述
`BatchID`	`一串`	-	必修的。批处理的唯一标识符。
`关`	`一串`	-	必修的。关闭关键字。

关闭付款批同步响应模式

名称	类型	总体安排	描述
`批次状态`	`一串`	-	指定批次的当前状态。
`文件Url`	`一串`	-	用于检索批处理关闭时生成的一个或多个提取文件的URL，其ID为加密的。
`地位`	`一串`	-	关闭批处理的请求的状态。

检索付款批处理文件

请求指定付款批次的费用交易记录数据。

GET/api/expense/paymentbatch/v1.1/batch/{JobRunKey}/file

参数

名称	类型	总体安排	描述
`JobRunKey`	`一串`	-	必修的。这个`文件Url`Close Batch 1.1 API响应返回的元素包含加密的JobRunKey。实际上，您可以使用`文件Url`下载文件的全部值。

检索付款批处理文件响应架构

如果生成了单个文件，则此请求将以文本/csv格式返回费用交易数据；如果批次配置为生成多个文件，则此请求将以zip存档的形式返回费用交易数据。将接收多个文件的客户机的一个示例是使用QuickBooks的客户机，该客户机在.ZIP文件中接收一个格式为导入QuickBooks（.IIF扩展名）的文件，以及一个用于总账（.CSV扩展名）的文件。

错误消息

错误号	描述
`500`	您试图关闭的批不包含任何报告。如果您最近批准了付款报告，请等待30分钟，然后重试。

企业资源规划集成

开始之前，需要关闭Payment Manager批处理，以便使用此API检索文件。要求您的客户不要通过用户界面手动关闭批处理。

使用获取客户批次的列表获取批处理列表
使用关闭所需批次关闭付款批
通过使用检索所需的文件检索付款批处理文件