SAP Concur Developer Center | List Item Web Service v1 -发布新的列表项

此API已弃用。

使用已弃用API的合作伙伴和客户应该联系SAP Concur，并讨论如何转移到最新版本。

在中了解更多信息API生命周期和弃用策略。

此资源支持以下POST操作：

发布新列表项
列表项更新
后列表项删除

发布新列表项

描述

将列表项添加到现有列表中。

发布新的列表项目请求

请求参数

｛listID｝必需的。所需列表的标识符。
批处理?类型＝｛类型｝必修的。要完成的批处理操作的类型。应该是创造．

例子：https://www.concursolutions.com/api/expense/list/v1.0/ {_listID_} /批吗? =创建类型

标题

授权头

必修的。具有有效Concur用户的OAuth令牌的授权标头。OAuth使用者在Concur中必须具有以下用户角色之一：专业版的公司管理员或Web服务管理员，或标准版的Can管理员。这些角色允许用户管理整个公司的数据。

Accept标头

应用程序/xml

根元素

这个函数的参数是a列表项批次包含列表项要添加的每个项的子元素。的列表项元素可以包含以下子元素。

列表项的子元素

元素	必须(必须包含值)?	描述
的名字	Y	在用户界面中显示的列表项的名称。最多64个字符。
levelxcode	Y，表示每个列表级别	每个列表级别必须有一个元素。一个三级列表将需要以下元素:级别1代码，二级代码和level3code．每个级别最多32个字符。此字段中不允许使用连字符。注：列表项的级别代码用于唯一标识列表项。创建列表项后，无法更新级别代码。提到更改列表项级别代码为更多的信息。
开始日期	N	当列表项应该被激活时的有效日期。格式:YYYY-MM-DD。
结束日期	N	该列表项目应停止活动的生效日期。格式:YYYY-MM-DD。

单级列表的XML示例请求

         POST / api /费用/列表/ v1.0 / / I8pq1l$rdSmdrEW23deOjPjyr4Wso0Wq$a/批处理?类型＝创建HTTPS/1.1主机：www.concursolutions.com授权：OAuth｛访问令牌｝内容类型：application/xml
        

         <列表项批次xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”><列表项><名称>线轴SL< / level1code ><开始日期>2010-04-01< /要求上班日期><结束日期>2010-09-30< /列表项><列表项><名称>车轮WH< / level1code ><开始日期>2010-04-01< /要求上班日期><结束日期>2010-09-30< /列表项>
        

多级列表的XML示例请求

         POST/api/expense/list/v1.0/list/uiT738IEfhI223Kjd1美元!jfHus美元/批处理?类型＝创建HTTPS/1.1主机：www.concursolutions.com授权：OAuth｛访问令牌｝内容类型：application/xml
        

         <列表项批次xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”><列表项><名称>饮料饮料< / level1code >< /列表项><列表项><名称>一餐食物< / level1code >< /列表项><列表项><名称>不含酒精的饮料< / level1code >支持< /列表项><列表项><名称>含酒精的饮料< / level1code >ALC< /列表项><列表项><名称>软饮料饮料< / level1code >支持< level3code >苏打水< / level3code >< /列表项><列表项><名称>果汁饮料< / level1code >支持< level3code >果汁< / level3code >< /列表项><列表项><名称>苹果汁饮料< / level1code >支持< level3code >果汁< / level3code >< level4code >APL< /列表项><列表项><名称>可口可乐还是百事可乐饮料< / level1code >支持< level3code >苏打水< / level3code >< level4code >可乐< /列表项>
        

发布新列表项响应

HTTP响应

内容类型

应用程序/xml

响应体根元素

此请求将返回一个列表项批处理结果具有以下子元素的父元素。

列表项批处理结果子元素

元素	描述
records-succeeded	成功添加的已处理记录数。
records-failed	未成功添加的已处理记录的数量。
错误	这将包含一个错误每个记录失败的父元素。看到错误的子元素有关子元素的信息见下表

错误的子元素

元素	描述
代码	与错误相关的代码。指反应和错误获取可能的错误代码的完整列表。
列表项代码	失败记录的级别代码。
消息	错误消息。

成功响应的XML示例

HTTPS/1.1 200 OK内容类型：应用程序/xml

         <列表项批处理结果xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”xmlns:我="http://www.w3.org/2001/XMLSchema-instance">< records-succeeded >8< / records-succeeded ><记录失败>0< / records-failed >
        

发布列表项目更新

描述

更新指定列表的现有列表项。

发布列表项更新请求

请求参数

｛listID｝必需的。所需列表的标识符。
批处理?类型= {类型｝必修的。要完成的批处理操作的类型。应该是更新．

例子：https://www.concursolutions.com/api/expense/list/v1.0/_ {listID_} /批处理? type =更新

标题

授权头

Accept标头

应用程序/xml

根元素

请求包括列表项批次包含列表项要更新的每个项的子元素。的列表项元素可以包含以下子元素。

列表项的子元素

元素	必须(必须包含值)?	描述
的名字	Y	在用户界面中显示的列表项的名称。最多64个字符。
levelxcode	Y，表示每个列表级别	每个列表级别必须有一个元素。一个三级列表将需要以下元素:级别1代码，二级代码和level3code．每个级别最多32个字符。此字段中不允许使用连字符。注：列表项的级别代码用于唯一标识列表项。创建列表项后，无法更新级别代码。提到更改列表项级别代码为更多的信息。
开始日期	N	当列表项应该被激活时的有效日期。格式:YYYY-MM-DD。
结束日期	N	该列表项目应停止活动的生效日期。格式:YYYY-MM-DD。

XML示例请求

         POST / api /费用/ / v1.0 / I8pq1l列表$rdSmdrEW23deOjPjyr4Wso0Wq$a/批处理?类型＝更新HTTPS/1.1主机:www.concursolutions.com授权:OAuth｛访问令牌｝内容类型：application/xml
        

         <列表项批次xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”><列表项><名称>大链轮SP< / level1code ><开始日期>2012-06-15< /要求上班日期><结束日期>2012-12-31< /列表项><列表项><名称>衬套，硫化内套部< / level1code ><开始日期>2012-06-15< /要求上班日期><结束日期>2012-12-31< /列表项>
        

发布列表项更新响应

HTTP响应

内容类型

应用程序/xml

响应体根元素

此请求将返回一个列表项批处理结果具有以下子元素的父元素。

列表项批处理结果子元素

元素	描述
records-succeeded	成功添加的已处理记录数。
records-failed	未成功添加的已处理记录的数量。
错误	这将包含一个错误每个记录失败的父元素。看到错误的子元素有关子元素的信息见下表。

错误的子元素

元素	描述
代码	与错误相关的代码。指反应和错误获取可能的错误代码的完整列表。
列表项代码	失败记录的级别代码。
消息	错误消息。

成功响应的XML示例

HTTPS/1.1 200 OK内容类型：应用程序/xml

         <列表项批处理结果xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”xmlns:我="http://www.w3.org/2001/XMLSchema-instance">< records-succeeded >2< / records-succeeded ><记录失败>0< / records-failed >
        

失败响应的XML示例

HTTPS/1.1 200 OK内容类型：应用程序/xml

         <列表项批处理结果xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”xmlns:我="http://www.w3.org/2001/XMLSchema-instance">< records-succeeded >1< / records-succeeded ><记录失败>1< / records-failed >< >错误< >错误1< list-item-code >部< / list-item-code ><消息>列表项名称太长
        

后列表项删除

描述

删除指定列表的现有列表项。

发布列表项删除请求

请求参数

｛listID｝必需的。所需列表的标识符。
批处理?类型= {类型｝必修的。要完成的批处理操作的类型。应该是删除．

例子：https://www.concursolutions.com/api/expense/list/v1.0/_{listID}/batch？type=delete

标题

授权头

Accept标头

应用程序/xml

根元素

请求包括列表项批次包含列表项要更新的每个项的子元素。的列表项元素可以包含以下子元素。

列表项的子元素

元素	必须(必须包含值)?	描述
的名字	N	在用户界面中显示的列表项的名称。最多64个字符。
levelxcode	Y，表示每个列表级别	每个列表级别必须有一个元素。一个三级列表将需要以下元素:级别1代码，二级代码和level3code．每个级别最多32个字符。此字段中不允许使用连字符。注：列表项的级别代码用于唯一标识列表项。创建列表项后，无法更新级别代码。提到更改列表项级别代码为更多的信息。

XML示例请求

         POST / api /费用/列表/ v1.0 / / I8pq1l$rdSmdrEW23deOjPjyr4Wso0Wq$a/批处理?类型＝删除HTTPS/1.1主机：www.concursolutions.com授权：OAuth｛访问令牌｝内容类型：application/xml
        

         <列表项批次xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”><列表项>部< / level1code >< /列表项><列表项>WH< / level1code >< /列表项>
        

发布列表项删除响应

HTTP响应

内容类型

应用程序/xml

响应体根元素

此请求将返回一个列表项批处理结果具有以下子元素的父元素。

列表项批处理结果子元素

元素	描述
records-succeeded	成功添加的已处理记录数。
records-failed	未成功添加的已处理记录的数量。
错误	这将包含一个错误每个记录失败的父元素。看到错误的子元素有关子元素的信息见下表。

错误的子元素

元素	描述
代码	与错误相关的代码。指反应和错误获取可能的错误代码的完整列表。
列表项代码	失败记录的级别代码。
消息	错误消息。

成功响应的XML示例

HTTPS/1.1 200 OK内容类型：应用程序/xml

         <列表项批处理结果xmlns=“http://www.concursolutions.com/api/expense/list/2010/02”xmlns:我="http://www.w3.org/2001/XMLSchema-instance">< records-succeeded >2< / records-succeeded ><记录失败>0< / records-failed >
        