项费用V3
费用条目API用于管理SAP Concur解决方案中的费用报告及其条目。它允许与内部系统和报告模块同步和协调与费用相关的信息。
1.1文档准备在这里。
检索所有费用分录
版本2.0,涵盖了更广泛的合作伙伴情景,并建议作为第一步。但是,根据所需的条目,应使用版本2.0和版本3.0的组合来检索。要查看示例,请查看增值税回收集成指南。
创建新的费用条目
POST /api/v3.0/expense/entries
参数
姓名 |
类型 |
格式 |
描述 |
内容 |
身体 |
- |
要求费用条目对象创建。 |
用户 |
细绳 |
询问 |
拥有条目的用户的登录ID。 |
请求URL
https://www.concursolutions.com/api/v3.0/expense/entries.
json一个成功响应的例子
{“ID”:“gWidFO7ikXV647DRpQmvCXeFNA4VPTOczCg”那“URI”:“https://www.concursolutions.com/api/v3.0/expense/entries/gWidFO7ikXV647DRpQmvCXeFNA4VPTOczCg”}
更新费用分录
put /api/v3.0/expense/entries/以上}
参数
姓名 |
类型 |
格式 |
描述 |
ID |
细绳 |
小路 |
要求费用分录ID。 |
内容 |
身体 |
- |
要求部分或全部费用条目对象进行更新。 |
请求URL
https://www.concursolutions.com/api/v3.0/expense/entries/gWidFO7ikXV66iSvqtG6Yd0wZ%24s4ftzvzTCg
删除费用分录
删除/api/v3.0/expense/entries/(}
参数
姓名 |
类型 |
格式 |
描述 |
ID |
细绳 |
小路 |
要求要删除的费用条目的ID。 |
用户 |
细绳 |
询问 |
拥有条目的用户的登录ID。 |
请求URL
https://www.concursolutions.com/api/v3.0/expense/entries/gWidFO7ikXV66iSvqtG6Yd0wZ%24s4ftzvzTCg
架构
参赛作品
姓名 |
类型 |
格式 |
描述 |
项目 |
数组 |
入口 |
结果集合。 |
下一页 |
细绳 |
- |
结果的下一页,如果任何的URI。 |
入口
姓名 |
类型 |
格式 |
描述 |
AllocationType |
细绳 |
- |
费用拨款的类型。支持的值:P. - 部分分配,F ——完整的分配,N - 没有分配。使用GET /支出/分配功能,以获取有关此项的分配的信息。 |
赞美amount. |
十进制 |
- |
批准的费用分录金额,以报告货币表示。 |
CompanyCardTransactionID |
细绳 |
- |
与此费用相关联的公司卡事务的唯一标识符。同意费用使用信用卡导入作业来导入公司卡交易。使用Get CompanycardTransactions函数获取有关这些卡事务的信息。当没有与此费用相关的公司卡交易时,此元素为NULL。 |
自定义1至Custom40 |
的CustomField |
- |
自定义字段中的详细信息。这些领域可能没有数据,根据配置。 |
评论 |
细绳 |
- |
描述费用条目的注释。最大长度:500个字符 |
描述 |
细绳 |
- |
费用的描述。最大长度:64个字符 |
ElectronicReceiptID |
细绳 |
- |
与此费用相关联的eReceipt的唯一标识符。使用GET eReceipts函数获取关于这个eReceipt的信息。当没有与此费用相关的eReceipt时,此元素为空。 |
EmployeeBankAccountID |
细绳 |
- |
与此费用相关的员工银行帐户的唯一标识符。通常,当费用偿还员工以获得此费用时使用此元素。使用Get BankAccounts函数获取有关此银行帐户的信息。 |
汇率 |
十进制 |
- |
该转换也就是在交易货币为张贴的量是报告货币交易金额的货币转换率。通常不提供这个元素。如果此元素为空,在比用户的报销货币的货币不同的交易,费用将使用该公司的配置汇率,以确定交易金额发布。如果系统不能确定兑换率,将使用的1.0的值。 |
ExpenseTypeCode |
细绳 |
- |
要求费用类型的代码。使用Get / Expense / ExpenseGroupConfigations来学习为此报告策略为活动的费用类型的费用类型代码。 |
ExpenseTypeName |
细绳 |
- |
费用类型的名称,本地化为用户的语言。 |
FormID |
细绳 |
- |
此费用分录使用的表格的ID。 |
hasappliedcashaptance. |
布尔 |
真的 /错误的 |
项目是否有现金预支。 |
哈丁人 |
布尔 |
真的 /错误的 |
表示费用是否有参与者。使用GET /expense/ entryattendeassociations函数来获取关于这个条目的参与者的信息。 |
HasComments |
布尔 |
真的 /错误的 |
无论费用条目有意见。 |
hasexceptions. |
布尔 |
真的 /错误的 |
无论代价有例外。使用GET ExpenseEntryExceptions功能,以获取有关此项的异常的信息。 |
HasImage |
布尔 |
真的 /错误的 |
指示是否有条目图像附加到条目。使用GET Entry Images函数获取该入口图像。 |
HasItemizations |
布尔 |
真的 /错误的 |
指明费用是否有itemizations。使用GET /费用/ itemizations函数来获取有关此项的itemizations信息。 |
哈维特 |
布尔 |
真的 /错误的 |
指示条目是否具有增值税数据。 |
ID |
细绳 |
- |
资源的唯一标识符。 |
可炸 |
布尔 |
真的 /错误的 |
表示费用是否可计入。 |
IsImageRequired |
布尔 |
真的 /错误的 |
指示条目是否需要一个条目图像。 |
IsPaidByExpensePay |
布尔 |
真的 /错误的 |
是否使用“费用支付”服务支付条目。如果报告已到达Processing Payment工作流步骤,则此元素有一个值,因为Concur Expense在此阶段确定是否将由Expense Pay支付。 |
IsPersonal |
布尔 |
真的 /错误的 |
表示费用是个人(即无偿)。 |
ispersonalcardcharge. |
布尔 |
真的 /错误的 |
指示费用条目是否从个人卡提要导入。Concur Expense使用Yodlee API导入这些卡片事务。 |
旅行 |
旅行 |
- |
旅行的数据。当条目是里程费用时使用此元素。对于费用代码为Company Car或Personal Car的费用类型,需要Journey子元素。此元素不应用于费用类型,费用代码既不是Company Car也不是Personal Car。 |
最后修改 |
约会时间 |
- |
utc日期最后修改条目时。 |
LocationCountry |
细绳 |
- |
2个字母的ISO 3166-1国家代码,其中的费用招致。 |
LocationID |
细绳 |
- |
的唯一标识符,其中费用发生之位置。使用GET /普通/位置函数来得到这个位置信息。 |
地点名称 |
细绳 |
- |
在费用发生之位置,一般的城市名称。 |
LocationSubdivision |
细绳 |
- |
ISO 3166-2:2007国家细分州、省或其他发生费用的国家细分。 |
orgunit1通过orgunit6. |
的CustomField |
- |
从组织单位字段中的细节。这些领域可能没有数据,根据配置。 |
Payalytypeid. |
细绳 |
- |
要求条目的支付类型的ID。使用GET /expense/expensegroupconfigurations了解该报告的费用组中处于活动状态的支付类型的支付类型ID。对于里程费用,使用现金支付类型。对于使用事务金额而不是距离的费用代码的费用类型,需要此元素。此元素不应用于带有Company Car或Personal Car费用代码的费用类型,因为这两个费用代码总是使用Cash payment类型。 |
PaymentTypeName |
细绳 |
- |
支付类型的名称,定位于用户的语言。 |
PostedAmount |
十进制 |
- |
报告货币中的费用条目金额。 |
ReceiptReceived |
布尔 |
真的 /错误的 |
指示该条目是否已被处理器审查。格式:true或false |
ReportID |
细绳 |
- |
要求将添加条目的报告的报告ID。 |
ReportOwnerID |
细绳 |
- |
报告所有者的登录ID。使用Get用户信息功能来学习有关此用户的详细信息。 |
花样码 |
细绳 |
- |
为此费用条目指定的支出类别的ID。 |
SpendCategoryName |
细绳 |
- |
为此费用条目指定的支出类别的名称,本地化为用户的语言。 |
TaxReceiptType |
细绳 |
- |
收据类型此条目。支持的值:T. - 税票,R. - 定期收据,N - 没有收据 |
TransactionAmount |
十进制 |
- |
要求支付给供应商的交易货币的费用条目金额。 |
TransactionCurrencyCode |
细绳 |
- |
要求3字母ISO 4217货币代码,用于费用输入交易金额。这是供应商已支付的货币。对于使用事务金额而不是距离的费用代码的费用类型,需要此元素。此元素不应用于公司汽车或个人汽车费用代码的费用类型,因为对于这两项费用代码,货币始终是报告货币。 |
交易日期 |
约会时间 |
yyyy-mm-dd |
要求提供了与此费用条目相关的良好或服务的日期。 |
三鼎 |
细绳 |
- |
行程服务中的唯一标识符包括与此费用相关的旅行预订。使用Get ItIneraryDetails获取有关此次旅行的信息和旅行预订。当没有与费用相关联的旅行时,此元素为null。 |
Uri. |
细绳 |
- |
资源的URI。 |
Vendordescription. |
细绳 |
- |
供应商的费用条目的名称。最大长度:64个字符 |
VendorListItemID |
细绳 |
- |
供应商列表项的唯一标识符。使用GET /common/lists函数获取关于这个列表项的信息。 |
VendorListItemName |
细绳 |
- |
从供应商列表中的项目的名称。 |
CustomField
姓名 |
类型 |
格式 |
描述 |
代码 |
细绳 |
- |
对于列表域,这是列表项的代码。 |
listinemid. |
细绳 |
- |
对于列表域,这是列表项ID。 |
类型 |
细绳 |
- |
自定义字段类型。支持的值:数量 那布尔 那连接列表 那日期 那整数 那列表 那数字 那文本 |
价值 |
细绳 |
- |
在组织单位或自定义字段中的值。对于列表域,这是列表项的名称。最大长度:48个字符 |
旅行
姓名 |
类型 |
格式 |
描述 |
BusinessDistance |
INT32. |
- |
业务使用之旅的部分,在报告所有者的距离计量单位中。这个要素是必需的,以便在没有的情况下发布个人汽车里程费用入场,或者在没有的情况下发布公司汽车里程费用个人竞争 价值。当使用里程计元素时,求和个人竞争 和BusinessDistance 必须等于之间的差odomersend. 和OdometerStart 。 |
EndLocation所 |
细绳 |
- |
要求指示旅程的终点。这也被称为“定位”。最大长度:100个字符 |
NumberOfPassengers |
INT32. |
- |
在旅途中车内的人数。用于可变费率,个人或公司汽车。 |
odomersend. |
INT32. |
- |
旅程结束时里程表上的读数。该值必须大于OdometerStart 价值。该元件使用可变速率和公司用车配置类型。 |
OdometerStart |
INT32. |
- |
里程表读数在旅程的开始。该元件使用可变速率和公司用车配置类型。 |
个人竞争 |
INT32. |
- |
旅途自用的部分。此元素是必需的,以发布公司的车行驶里程的费用时,有没有BusinessDistance 价值。当使用里程计元素时,求和个人竞争 和BusinessDistance 必须等于之间的差odomersend. 和OdometerStart 。使用公司的汽车配置类型。 |
启动分配 |
细绳 |
- |
要求指示旅程的起点。这也被称为“从位置”。最大长度:100个字符 |
测量单位 |
细绳 |
- |
要求测量的距离和里程表值的单位。支持的值:m 英里,K. - 公里 |
笔记:具有包含可变速率或自定义里程费用类型代码的汽车配置的客户端不受支持。我们只支持包括个人汽车单速定义的汽车配置,使用默认的里程费用类型代码(MILG),其中Google Maps未设置为强制性。