费用分录

此API已弃用。

弃用日期:05/19/2016

不支持的日期:11/19/2016

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

详情请参阅API生命周期和弃用策略。

费用分录项目是对费用进行细分的费用分录的子条目。分类的一个常见用例是在酒店账单上，它可以有房间价格、房间税和服务(如洗衣或迷你吧)的单独分类。

URI

https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {reportId} / / {entryId} /详细登录/ {itemizationId}

费用分录

为指定的费用分录创建或更新分项记录。

请注意：发布费用报告信息是一个多级过程。有关发布新费用报告和条目所需的步骤，请参阅“费用报告Web服务”页面的进程部分。

请求

请求参数

参数

参数 必需的/可选 描述
{_reportId_} 要求 费用报告的唯一标识符。
{_entryId_} /详细登录 要求 费用条目和Itemization关键字的唯一标识符。
{_itemizationID_} 可选 项目分类的唯一标识符。

例子:

https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ / {entryId} / {reportId} /条目详细登录https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {reportId} / {entryId} /详细登录/ /条目{itemizationId}

URI来源

  • reporttid值由Get List of Reports函数返回，并且作为Report-Details-Url元素的Post Expense Report Header函数。
  • 属性中返回entryId值RpeKey元素的获取报告详细信息功能。
  • 对象的一部分返回itemizationIdItemization-Url该函数返回的值。

头

  • 对于有效的Concur用户，授权头带有OAuth令牌。必需的。

OAuth Consumer必须具有以下角色之一，才能在他们不拥有的报告中发布费用的明细:Professional的Web Services Admin，或者Standard的Can administrative。

内容类型的头

应用程序/ xml

有效载荷

此请求包含一个ExpenseItemizations带有详细登录每个所包含的项的父元素。的详细登录父元素有以下子元素。

详细登录元素
元素 必须(必须包含值)? 描述
ExpKey Y 费用的费用类型键。中返回的费用类型键ExpKey元素的获取费用组配置端点。当更新费用条目时，费用类型键不能被修改。
描述 取决于配置 费用的描述。
TransactionAmount Y 以原始货币计项的总金额，最多小数点后三位。例如:123.654
PostedAmount 取决于配置 在用户的报销货币中，条目的数量，最多有三个小数点。例如:123.654。如果某些费用被标记为个人费用或已被兑换成另一种货币，则可能因交易金额而异。看到笔记为更多的信息。
通过Custom20 Custom1 取决于配置 费用输入表单自定义字段。itemitems是费用条目的子条目，它们共享自定义字段。根据配置可能需要。请参阅流程，后费用报告数据部分以了解收集所需字段信息所需的步骤。
请注意:如果任何自定义字段被配置为包含列表值，请参阅发布自定义列表项页面，以获得如何正确提交列表项值的信息。
IsPersonal N 费用分录是否为个人费用。个人费用不在“同时费用”中报销。个人费用不能分项列示。格式:N
评论 取决于配置 详细登录发表评论。

注:

  • 更新请求必须包含ExpKey和TransactionAmount字段。所有其他字段只有在更新时才需要包含。
  • 更新请求不能更改ExpKey对于已存在的条目。
  • 在办理外币业务时CrnCode和TransactionAmount值应显示原始交易金额和货币。的PostedAmount价值应包含转换成投寄货币(用户的报销货币)的交易金额。Concur将根据这两个字段计算费用的汇率。

回复

有效载荷

这个请求将返回一个ItemizationStatusList带有ItemizationStatus子元素。的ItemizationStatus元素将包含以下子元素。

ItemizationStatus元素

元素 描述
指数 条目在请求中的顺序。
状态 请求的状态。可能的值是:
200:条目保存成功。
请求包含一个错误，如语法错误或缺少必需的元素。
404: Itemization URI语法正确，但是系统找不到Itemization。可能已经从系统中删除了。
请求具有正确的语法，并引用了现有的条目，但由于系统冲突，系统无法保存。
Itemization-Url 获取itemization详细信息的URI。

例子

XML示例请求

文章https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzsQ6SKJFjLNs4OWBErcJ8yX美元/entry/nE0avYnILNNi9qkVyS3lYPuv4Mop4QmVs/Itemization HTTP/1.1授权:OAuth｛访问令牌｝内容类型:应用程序/ xml
< ExpenseItemizationsxmlns =“http://www.concursolutions.com/api/expense/expensereport/2011/03”><详细登录>< ExpKey >DINNR< / ExpKey ><描述>晚餐> < /描述< TransactionAmount >56.00< / TransactionAmount >< PostedAmount >56.00< / PostedAmount ><评论>晚餐< Custom1 >晚餐< / Custom1 >< Custom2 >客房服务< / Custom2 >< Custom5 >去餐馆太晚了< / Custom5 >< IsPersonal >N< / IsPersonal >< /详细登录><详细登录>< ExpKey >午餐< / ExpKey ><描述>午餐> < /描述< TransactionAmount >24.64< / TransactionAmount >< PostedAmount >24.64< / PostedAmount ><评论>午餐< IsPersonal >N< / IsPersonal >< /详细登录><详细登录>< ExpKey >BRKFT< / ExpKey ><描述>早餐> < /描述< TransactionAmount >15.34< / TransactionAmount >< PostedAmount >15.34< / PostedAmount ><评论>早餐< IsPersonal >N< / IsPersonal >< /详细登录>< / ExpenseItemizations >

XML示例响应

HTTP/1.1 200 OK内容类型:application/xml
< ItemizationStatusListxmlns =“http://www.concursolutions.com/api/expense/expensereport/2011/03”xmlns:我=“http://www.w3.org/2001/xmlschema-instance”>< ItemizationStatus ><指数>1> < /索引< >状态成功> < /状态< ItemizedEntry-Details-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRk puJLmXp25RsAwp美元/条目/ nE0avYnILNNi9qkVyS3lYPuv4Mop4QmVs /详细登录/ nE0avYnILN69JgpJGuSCy5qqirEfFcds4< / ItemizedEntry-Details-Url >< / ItemizationStatus >< ItemizationStatus ><指数>2> < /索引< >状态成功> < /状态< ItemizedEntry-Details-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRk puJLmXp25RsAwp美元/条目/ nE0avYnILNNi9qkVyS3lYPuv4Mop4QmVs /详细登录/ nE0avYnILN65lGE4Zka1YOp608re6ASJb< / ItemizedEntry-Details-Url >< / ItemizationStatus >< ItemizationStatus ><指数>3.> < /索引< >状态成功> < /状态< ItemizedEntry-Details-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRk puJLmXp25RsAwp美元/条目/ nE0avYnILNNi9qkVyS3lYPuv4Mop4QmVs /详细登录/ nE0avYnILN6nw6Hi0jhAuYXAXiXNej7zb< / ItemizedEntry-Details-Url >< / ItemizationStatus >< / ItemizationStatusList >