在费用报告中的费用分录
注意:你可以找到3.0版本在这里
https://www.concursolutions.com/api/expense/expensereport/v1.1/report/ {reportId} / {entryId} /条目
检索指定费用条目的详细信息
应用程序/ xml
查询参数 | 描述 |
---|---|
{_reportId_} |
罢运费用报告的唯一标识符。 |
{_entryId_} |
费用分录的唯一标识符。 |
得到https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz3zHJBCRksaas23dsfs/entry/n7We3qWw99u1KoWTMaLhSCpXBYzQ1UDhn美元HTTP / 1.1授权:OAuth{访问令牌}
这个请求将返回一个ExpenseEntry带有以下子元素的父元素:
元素 | 描述 |
---|---|
ApprovedAmount | 用户报销货币中已批准的条目金额。中的Get Report Details函数返回报表货币,即用户的报销货币CrnCode元素。 |
Attendee-Url | 条目的参与者列表的URL。 |
Allocation-Url | 条目的分配列表的URL。 |
BusinessPurpose | 报表标题中的业务用途字段。 |
EreceiptId | 附上电子收据的ID(如果可用)。 |
ExchangeRate | 适用于条目的汇率。 |
ExpenseKey | 条目的费用类型键。使用Get Expense Group Configuration端点获取费用类型的完整列表。 |
ExpenseName | 分录的费用类型。 |
SpendCategory | 为该支出类型指定的支出类别。不同的客户端,用于报告。 |
HasAllocation | 定义为费用分配的金额。取值为:P(部分分配)、F(全部分配)、N(不分配)。 |
HasAttendees | 费用是否有参会者。 |
HasComments | 费用是否有评论。 |
HasExceptions | 费用是否有例外。 |
HasVat | 费用是否有增值税数据。 |
ImageRequired | 输入是否需要接收图像。 |
IsCreditCardCharge | 费用是否来自信用卡。 |
IsItemized | 费用是否有分项记录。 |
Itemizations-Url | 条目列表的URL。 |
IsPersonal | 是否个人费用。 |
IsPersonalCardCharge | 费用是否来自个人刷卡。 |
LastModified | 最后修改条目时的UTC日期。 |
LocationName | 报销的地点,通常是城市名称。 |
通过OrgUnit6 OrgUnit1 | 来自Org Unit自定义字段的详细信息。它们可能没有数据,这取决于配置。 |
PaymentTypeKey | 条目的支付类型的键。使用Get Expense Group Configuration函数将支付类型键映射到支付类型名称。 |
PostedAmount | 费用分录的金额在用户的报销货币中。中的Get Report Details函数返回报表货币,即用户的报销货币CrnCode元素。 |
ReceiptImageId | 附加到条目的收据图像的ID。 |
ReceiptRequired | 入境时是否需要收据正本。 |
ReportEntryID | 报告条目的ID。 |
ReportID | 该条目所在的报告的唯一键。 |
TransactionAmount | 以原始交易货币记帐的费用数额。 |
TransactionCurrencyName | 费用分录交易金额的货币名称。 |
TransactionDate | 费用分录日期。 |
VendorDescription | 费用条目的供应商名称,可以由用户手工输入,也可以从信用卡交易的Merchant name字段导入。 |
X_UserID | 与条目关联的用户ID。 |
通过Custom40 Custom1 | 来自自定义字段的详细信息。它们可能没有数据,这取决于配置。如果自定义字段是列表字段,数据将返回为:(列表项短代码)列表项名称。字段列表的例子: |
HTTP/1.1 200 OK内容类型:application/xml
< ExpenseEntryxmlns =“http://www.concursolutions.com/api/expense/expensereport/2011/03”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>< ApprovedAmount >40.00000000< / ApprovedAmount >< Attendee-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nYO0ck05r5fATbnjrMBf0d sCIBqX8WQYw美元/条目/ nbmTPob9qSUJWKttTEr6MLaXaPKYYPv7U /参与者< / Attendee-Url >< Allocation-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nYO0ck05r5fATbnjrMBf0d $ sCIBqX8WQYw /条目/ nbmTPob9qSUJWKttTEr6MLaXaPKYYPv7U /分配< / Allocation-Url >< BusinessPurpose/>< EreceiptId/>ExchangeRate < >1.00000000000000ExchangeRate < / >< ExpenseKey >BUSML< / ExpenseKey >< ExpenseName >其他< / ExpenseName >< SpendCategory >杂项< / SpendCategory >< HasAllocation >N< / HasAllocation >< HasAttendees >Y< / HasAttendees >< HasComments >N< / HasComments >< HasExceptions >N< / HasExceptions >< HasVat >N< / HasVat >< ImageRequired >N< / ImageRequired >< IsCreditCardCharge >N< / IsCreditCardCharge >< IsItemized >N< / IsItemized >< Itemizations-Url >/ nbmTPob9qSUJWKttTEr6MLaXaPKYYPv7U /详细登录https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nYO0ck05r5fATbnjrMBf0d sCIBqX8WQYw美元/条目< / Itemizations-Url >< IsPersonal >N< / IsPersonal >< IsPersonalCardCharge >N< / IsPersonalCardCharge >< LastModified >2011 - 06 - 18岁t16:03:31< / LastModified >< LocationName/>< PaymentTypeKey >现金< / PaymentTypeKey >< PostedAmount >40.00000000< / PostedAmount >< ReceiptImageId/>< ReceiptRequired >N< / ReceiptRequired >< ReportEntryID >nbmTPob9qSUJWKttTEr6MLaXaPKYYPv7U< / ReportEntryID >< ReportID >nYO0ck05r5fATbnjrMBf0d sCIBqX8WQYw美元< / ReportID >< TransactionAmount >40.00000000< / TransactionAmount >< TransactionCurrencyName >我们,美元< / TransactionCurrencyName >< TransactionDate >2011 - 06 - 15 - t00:00:00< / TransactionDate >< VendorDescription/>< X_UserID >cmiller@example.com< / X_UserID >< OrgUnit1/>< OrgUnit2/>< OrgUnit3/>< OrgUnit4/>< OrgUnit5/>< OrgUnit6/>< Custom1 >价值< / Custom1 >< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>< Custom10/>< Custom11/>< Custom12/>< Custom13/>< Custom14/>< Custom15/>< Custom16/>< Custom17/>< Custom18/>< Custom19/>< Custom20/>< Custom21/>< Custom22/>< Custom23/>< Custom24/>< Custom25/>< Custom26/>< Custom27/>< Custom28/>< Custom29/>< Custom30/>< Custom31/>< Custom32/>< Custom33/>< Custom34/>< Custom35/>< Custom36/>< Custom37/>< Custom38/>< Custom39/>< Custom40/>< / ExpenseEntry >
为指定的报告提交费用报告分录。使用Post Expense Report Header函数创建报表,然后使用此端点创建费用行项目。您可以使用此端点更新现有的费用条目。
请注意:提交新的费用报告是一个多阶段的过程。请参阅费用报告Web服务页面的流程部分,了解提交新的费用报告和条目所需的步骤。
请注意Concur建议您在每个请求中发布一个费用条目。此端点的未来版本将需要此行为。
应用程序/ xml
查询参数-必选 | 查询参数—可选 |
---|---|
{_reportId_} /条目 |
要求费用报告和条目关键字的唯一标识符。例子:https://www.concursolutions.com/api/expense/expensereport/v1.1/report/_ {reportId} _ /条目 .URI源:在ReportID元素的Get List of Reports函数,并作为Report-Details-Url元素的Post Expense Report Header函数。 |
{_entryId_} |
费用分录的唯一标识符。例子:https://www.concursolutions.com/api/expense/expensereport/v1.1/report/_ {reportId} / {_entryId_} _ /条目 .URI源:在RpeKey元素的费用报告详细内容v1.1函数,并作为Report-Entry-Details-Url该函数返回的值。 |
这个请求应该包含一个ReportEntries带有费用每个被包含条目的父元素。的费用元素包含以下子元素:
元素 | 必须(必须包含值)? | 描述 |
---|---|---|
CrnCode | Y | 费用交易金额的3个字母ISO 4217货币代码。例如:美元。 |
ExpKey | Y | 费用的费用类型键。新建或更新条目所需。中返回的费用类型键ExpKey元素的Get Expense Group Configuration函数。当更新费用条目时,费用类型键不能被修改。 |
描述 | 取决于配置 | 费用的描述,也称为业务目的。该信息在BusinessPurpose元素的Get Report Details函数。请参见Processes >后费用报告数据部分以了解收集所需字段信息所需的步骤。 |
TransactionDate | Y表示新条目 | 费用发生的日期。格式:YYYY-MM-DD |
TransactionAmount | Y | 以原始货币计算的费用总额,小数点后有三位。例如:123.654 |
LocationID | 取决于配置 | 代码的位置。如果需要City字段,则可能是必需的。使用Get Location函数检索该字段的有效值。请参见Processes >后费用报告数据部分以了解收集所需字段信息所需的步骤。 |
通过OrgUnit6 OrgUnit1 | 取决于配置 | 费用输入表单组织单元字段。根据配置可能需要。请参见Processes >后费用报告数据部分以了解收集所需字段信息所需的步骤。 |
通过Custom40 Custom1 | 取决于配置 | 费用输入表单自定义字段。根据配置可能需要。请参见Processes >后费用报告数据部分以了解收集所需字段信息所需的步骤。请注意:如果任何自定义字段被配置为包含列表值,请参阅发布自定义列表项页面,以获得如何正确提交列表项值的信息。 |
ExchangeRate | N | 交易金额与公布金额之间的汇率。通常不提供此元素。如果对于使用不同于用户报销货币的交易,该元素为空,则Expense将使用公司配置的汇率来确定交易的已公布金额。如果系统无法确定汇率,请求将返回一个HTTP 500错误。 |
评论 | 取决于配置 | 费用分录注释。最大长度:2000。请参见Processes >后费用报告数据部分以了解收集所需字段信息所需的步骤。 |
VendorDescription | N,但推荐用于沙箱 | 此元素包含条目供应商的描述性文本。这个字段不是成功发布条目所必需的,但是这个字段是开发人员沙箱中的费用条目所必需的字段。如果沙箱没有提供此字段,您将在用户界面中看到一个异常,说明缺少一个必需的字段。 |
IsPersonal | N | 费用分录是否为个人费用。个人费用不在“同时费用”中报销。格式:Y / N |
PaymentTypeID | N | 费用条目的支付类型的唯一标识符。使用PaymentTypeID获取费用组配置端点的值。如果不提供此值,则支付类型默认为Cash。支持的支付类型代码是:现金和公司支付。如果客户已将其公司配置为使用Pending Card Transaction系统支付类型,则还支持该支付类型。 |
笔记
文章https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROzsQ6SKJFjLNs4OWBErcJ8yX美元/entry/ HTTP/1.1授权:OAuth{访问令牌}内容类型:应用程序/ xml
< ReportEntriesxmlns =“http://www.concursolutions.com/api/expense/expensereport/2011/03”>< >为代价< CrnCode >美元< / CrnCode >< ExpKey >BUSPR< / ExpKey ><描述>商业促销活动> < /描述< TransactionDate >2011-01-12< / TransactionDate >< TransactionAmount >29.23< / TransactionAmount >< >的评论小册子样本> < /评论< VendorDescription >照相馆< / VendorDescription >< IsPersonal >N< / IsPersonal >< / >为代价< >为代价< CrnCode >美元< / CrnCode >< ExpKey >BRKFT< / ExpKey ><描述>描述> < /描述< TransactionDate >2011-01-12< / TransactionDate >< TransactionAmount >15.54< / TransactionAmount >< >的评论早餐会议> < /评论< VendorDescription >星巴克< / VendorDescription >< IsPersonal >N< / IsPersonal >< / >为代价< / ReportEntries >
应用程序/ xml
这个请求将返回一个ReportEntryStatusList父元素的ReportEntryStatus子元素。的ReportEntryStatus元素将包含以下子元素:
元素 | 描述 |
---|---|
指数 | 条目在请求中的顺序。 |
状态 | 请求的状态。 |
消息 | 当状态为FAILED时,失败的详细信息将出现在此元素中。 |
Report-Entry-Details-Url | 获取费用条目详细信息的URI。 |
HTTP/1.1 200 OK内容类型:application/xml
< ReportEntryStatusListxmlns =“http://www.concursolutions.com/api/expense/expensereport/2011/03”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>< ReportEntryStatus ><指数>1> < /索引< >状态成功> < /状态< Report-Entry-Details-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz sQ6SKJFjLNs4OWBErcJ8yX /条目/ nE0avYnILN9mHdTErNSd2pH45udFoNQ阿宝美元< / Report-Entry-Details-Url >< / ReportEntryStatus >< ReportEntryStatus ><指数>2> < /索引< >状态成功> < /状态< Report-Entry-Details-Url >https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz sQ6SKJFjLNs4OWBErcJ8yX /条目/ awEDvYnILN9g s6lCFX0jFBWmHAiTYYf9C美元< / Report-Entry-Details-Url >< / ReportEntryStatus >< / ReportEntryStatusList >