版本

4.0

创建新的购买请求

根据提供的标题和行项目详细信息创建购买请求。如果请求有效，它会创建购买请求并返回唯一标识符以获取购买请求详细信息。

范围

购买quest.write.- 请参阅范围使用有关详细信息。

要求

Uri.

模板
发布/购买咨询/ v4 /购买询问
参数

没有任何

标题

有效载荷

回复

状态代码

标题

有效载荷

例子

要求

这是一组样本集。您的实体所需的字段和值将根据您的Concur发票和表单和字段配置而异。此示例包括常用的字段。

发布/购买咨询/ v4 /买主查询授权：持票人{令牌}内容类型：应用程序/ JSON
{“描述”：“新办公用品”那“UserLoginid”：“john.deo@concur”那“policyexternalid”：“po-interfact-id”那“货币代码”：“美元”那“noteStosupplier”：“办公空间请求阶段1”那“评论”：“办公用品请求”那“custom1”：“advt”那“shiptoaddresscode”：“SHIP15139”那“billtoaddresscode”：“mnslp129”那“LINEITEMS”：[{“购买键”：“服务”那“vendorcode”：“ven1”那“VendorAddresscode”：“addr1”那“描述”：“监视器”那“数量”：“20”那“单价”：“154.4”那“expensetype”：“1250”那“probipttype”：“没有任何”那“resertbydate”：“2018-06-28”那“uomcode”：“da”那“运输”：“13.5”那“税”：“11”那“SupplierPartid”：“daqt1”那“URL”：[“http://officesupplies.com/monitor”]，“notestovendor”：“第1阶段请求监视器”那“评论”：“第1阶段请求监视器的新员工”那“custom2”：“lgvt1”}，{“购买键”：“商品”那“vendorcode”：“ven1”那“VendorAddresscode”：“addr1”那“描述”：“办公椅”那“数量”：“20”那“单价”：“346.2”那“expensetype”：“1251”那“probipttype”：“stayers_receipt”那“resertbydate”：“2018-06-28”那“uomcode”：“da”那“运输”：“15”那“税”：“17.5”那“SupplierPartid”：“daqt2”那“URL”：[“http://officesupplies.com/officechair”]，“notestovendor”：“第1阶段请求办公椅”那“评论”：“第1阶段请求办公椅的新员工”那“custom3”：“部门”那“custom4”：“销售量”}]}

回复

http / 1.1 202接受的内容类型：应用程序/ JSON日期：日期请求的内容长度：1000同意相关性：1234abcd-12ab-34cd-56ef-123456abcdef
{“ID”：“B1E22581-FF4A-48E9-981B-2F5065579096”那“URI”：“http://us.api.concursolutions.com/purchaseRquest/v4/purchaseRequests/b1e22581-ff4a-48e9-981b-2f5065579096?mode=媒体}

获取购买请求详细信息

获取购买请求详细信息。支持的模式紧凑，其返回关于购买请求的基本信息以及任何异常。

范围

购买quest.read.read.read.- 请参阅范围使用有关详细信息。

要求

Uri.

模板
GET /购买request / v4 /购买询问/{ID}？模式=袖珍的
参数
名称 类型 格式 描述
模式 细绳 - 必需的：指定获取购买请求详细信息的模式。支持的价值：紧凑

标题

有效载荷

没有任何

回复

状态代码

标题

有效载荷

例子

要求

GET /购买机构/ v4 / purchaseRquests / de9c0894-b807-6943-8e3f-49a707da3456？模式=紧凑授权：持票人{令牌}内容类型：应用程序/ JSON

回复

HTTP / 1.1 200 OK内容类型：应用程序/ JSON日期：日期请求的内容长度：1000同意相关性：1234ABCD-12AB-34CD-56EF-123456ABCDEF
{“购买Questid”：“DE9C0894-B807-6943-8E3F-49A707DA3456”那“买入标记”：“100000”那“购买代码曲率”：“创造”那“purchaserequestworkflowstatus”：“得到正式认可的”那“购买requestExceptions”：[{“信息”：“线项数量不匹配”那“eventCode”：“purch_detail_item_save”那“异常代码”：“0070071”那“少清”：错误的那“prexceptionid”：“FE636831-43A1-9540-BF86-32E2C19400AF”}]，“订单”：[{“订购单号码”：“po10001”}]}

架构

创建购买请求模式

名称 类型 格式 描述
用户身份 细绳 - 必需的：要求物品的员工。这是员工的UUID。任何一个用户身份要么UserEmail.要么UserLoginid.需要识别员工。
UserEmail. 细绳 - 必需的：要求物品的员工。这是员工的电子邮件。任何一个用户身份要么UserEmail.要么UserLoginid.需要识别员工。
UserLoginid. 细绳 - 必需的：要求物品的员工。这是员工的登录ID。任何一个用户身份要么UserEmail.要么UserLoginid.需要识别员工。
描述 细绳 - 购买请求的描述。
positalexternalid. 细绳 - 应与购买请求相关联的策略的外部标识符。如果没有提供，API将使用为已分配给请求员工的用户组设置的默认策略。这是外部ID从发票策略配置中。如果需要为组默认值分配策略，因此需要从SAP Concur联系人中获取这些ID。
货币代码 细绳 - 必需的：与购买请求相关联的货币的3字母ISO 4217货币代码。此代码将用于此请求上的所有项目。示例：usd.
noteStosupplier 细绳 - 在发送到供应商的传输采购订单上打印的注释。
评论 细绳 - 与此记录相关的内部评论。
Custom1到Custom24. 细绳 - 使用的每个自定义字段都应该在消息中具有自己的行。如果字段与已连接的列表相关联，则接受值是为SAP Confur中的列表配置的列表项代码。
shiptoaddresscode. 细绳 - 购买请求的送货地址。接受的值是Shipto记录的地址代码。如果没有提供，API将使用请求用户的默认送货地址。
Billtoaddresscode. 细绳 - 用于发票的购买请求的结算地址。接受的值是来自票据记录的地址代码。如果没有提供API将使用该策略的默认BillTo地址。
LINEITEMS. 大批 LINEITEM 必需的：请求与此购买请求相关的物品或服务。

LINEITEM

名称 类型 格式 描述
购买键 细绳 - 必需的：物品类型，商品或服务。显示为类型在同意发票。支持的价值观：商品，服务。
vendorcode. 细绳 - 必需的：标识供应商的代码。该值可以在供应商管理器的供应商信息形式中找到。这是使用的供应商地址代码确定特定的供应商记录。
VendorAddresscode. 细绳 - 必需的：标识供应商地址的代码。该值可以在供应商管理器的供应商信息形式中找到，并标记为地址会计码。这是使用的供应商代码确定特定的供应商记录。
描述 细绳 - 必需的：线项的描述。
数量 十进制 - 必需的：与行项相关的数量。
单价 十进制 - 必需的：线项的单价。
expensetype. 细绳 - 将分配给行项的费用类型的宠物代码。如果没有提供，它将默认为在用于该项目的供应商配置文件上设置的费用类型。客户需要从SAP Confur联系人中获取这些宠物代码。
收据 细绳 - 收据类型。如果没有提供，API将使用购买键将此字段设置为None for Services，Or StyleS_ReCeipt用于商品。如果您使用的是SAP Confur接收并且需要对由此产生的PO行输入货物收据，请使用styite_receipt。支持的值：stomeTy_receipt，none。
不过 日期 yyyy-mm-dd 购买订单必须满足的日期。示例：2018-03-23
uomcode. 细绳 - 购买请求项目的衡量单位（UOM）代码。被接受的值是在Concor发票中的测量配置单元中设置的UOM代码。如果没有提供，API将根据商品和服务的默认值默认UOM。
运输 十进制 - 物品的总运费。
税 十进制 - 与行项相关的税金。
Supplierd. 细绳 - 有助于识别行项的ID值。这可能是诸如供应商的部件号或制造商编号之类的价值。
URL. 大批 - 与项目相关的URL。您可以使用每个项目的多个URL，用引号和逗号分隔。
notestovendor 细绳 - 与在传输的采购订单PDF上显示给供应商的项目相关的注释。
评论 细绳 - 与此记录相关的内部评论。
Custom1到Custom20. 细绳 - 使用的每个自定义字段都应该在消息中具有自己的行。如果字段与已连接的列表相关联，则接受值是为SAP Confur中的列表配置的列表项代码。

创建购买请求响应架构

名称 类型 格式 描述
错误 大批 错误 一系列错误，指示验证失败的字段。
ID 细绳 - 唯一购买请求参考ID如果请求已通过所有验证。将需要此参考ID来查找购买请求的详细信息。
Uri. 细绳 - 查找新创建的购买请求的详细信息的URI。

获取购买请求响应架构

名称 类型 格式 描述
购买Questid 细绳 - 唯一购买请求参考ID。由创建购买请求API调用返回。
购买requestnumber. 细绳 - 独特的购买请求标识符可用于在SAP Concur产品中唯一标识购买请求。
购买QuestQueuestatus 细绳 - 购买请求的创建状态。可能的值为：pending_creation，创建，create_failed。
purchaseRequestWorkFlowStatus. 细绳 - 购买请求的工作流状态。可能的价值观是：批准，待批准，待成本对象批准，送回员工，未提交，提交，待处理者审查，供应商批准，批准时间过期。
订单 大批 订单 如果已批准购买请求和生成的采购订单，则此阵列包含采购订单详细信息。如果为空，则不会返回此元素。
购买requestExceptions. 大批 购买requestExceptions. 如果在购买请求上存在，则为一系列例外情况。如果为空，则不会返回此元素。

订单

名称 类型 格式 描述
订购单号码 细绳 - 采购订单号。

购买requestExceptions.

名称 类型 格式 描述
evencode. 细绳 - 例外的事件代码。示例：purd_detail_submit.
例外码 细绳 - 唯一的异常代码。
是清楚的 布尔基 - 除了例外是否已被清除。
prexcepionid. 细绳 - 购买请求的唯一异常ID。
信息 细绳 - 简介例外消息。

错误

名称 类型 格式 描述
错误代码 细绳 - 指示字段验证失败的原因错误代码。
错误信息 细绳 - 错误的描述。
DataPath. 细绳 - 具有错误消息的请求数据的路径。

HTTP状态代码为4xx时错误代码

错误代码 错误信息
遗漏QuestBody 缺少请求身体。
InvalidRequestBody. 传递的请求身体无效。
MisseSerInfo. 任何一个用户身份要么UserEmail.要么UserLoginid.是必须的。
InvalidUserInfo. 任何一个用户身份要么UserEmail.要么UserLoginid.是无效的，或者用户无法访问此资源。
提供了一个人的信息 任何一个用户身份要么UserEmail.要么UserLoginid.是必须的。
MissCurencyCode. 货币代码不见了。
InvalidCurrengyCode. 货币代码是无效的。
InvalidPolicyInformation. 无法找到提供的采购订单策略positalexternalid.。
SISKLINEITEMS. LINEITEMS.缺失。
InvalidPurchAseType. 购买键是无效的。
缺少purchaseType. 购买键是必须的。
MissingVendorAddresscode. VendorAddresscode.是必须的。
MissingVendorcode. vendorcode.是必须的。
InvalidVendor. 供应商/地址代码组合无效。
遗漏 线项描述是必须的。
失踪 线项数量是必须的。
无效 线项数量是无效的。
MissingUnitPrice. 单价是必须的。
InvalidUnitPrice. 单价是无效的。
InvalidDateFormat. 预计yyyy-mm-dd格式的日期。