购买请求API使SAP Confor客户能够利用外部数据来创建购买请求,以便预授权采购订单。客户端可以建立与购买请求API的直接连接,这将创建新的购买请求并自动将其提交到预授权工作流程中。一旦批准,购买请求会导致可以从SAP Confor传输到供应商的采购订单。

用例

许多Concur发票客户端都有外部系统,其中包含具有定价的部分或服务列表。如果使用SAP Concur使用购买请求进行预授权,则必须使用外部系统的数据手动输入购买请求购物车,并提交请求员工的批准。使用此API和客户端构建的集成,请求者可以使用数量和所需的其他详细信息从外部系统中浏览和选择项目,然后将数据发送到SAP同意。将创建购买请求并提交到工作流程中。API返回具有记录标识符(URI)的响应消息,可与获取购买请求详细信息方法一起使用,以获取创建的购买请求的基本详细信息:同意购买请求编号,工作流状态,例外,并批准一次,结果SAP同意采购订单号。

限制

该API在中国数据中心不提供。此API仅适用于具有现有SAP Confor客户端的直接集成。如果您是使用此API构建App Center应用程序的合作伙伴,请访问您的SAP同意代表。此API只能用于创建新的购买请求并获取创建的购买请求的详细信息。此API无法更新,编辑或删除购买请求。在将其发送到SAP Concur之后的所有编辑或处理购买请求,必须在SAP Confor中完成。

区域可用性

https://us.api.concursolutions.com/purchaseRequest/v4/
https://emea.api.concursolutions.com/purchaseRequest/v4/

产品和版本

  • Concur发票专业版
  • Concur发票标准版

范围使用

名称 描述 终点
购买quest.write. 允许您创建新的购买请求 邮政
购买quest.read.read.read. 允许您检索购买请求 得到

依赖性

SAP Confor客户必须购买Concur发票,同意和Concur Web服务以便使用此API。必须在使用此API之前配置具有同意购买的Concur发票。

要创建购买请求,您需要提供供应商代码和供应商地址代码。你可以访问供应商经理同时发票以查看这些值。如果您需要使用Web服务从SAP Confur获取此数据,则可以使用供应商v3API。

如果SAP Concur中的购买请求表格所需的自定义字段与列表相关联,则需要提供列表项的项目代码,或者将它们配置为从员工等其他来源复制下来。你可以访问列出管理在SAP Confur查看您的列表项和列表项代码。如果您需要使用Web服务从SAP Confur获取此数据,则可以使用列出项目v3.api检索level1code.列表项的值。

访问令牌用法

此API将与两家公司或用户访问令牌合作,但如果集成将为多个请求者创建购买请求,则需要公司访问令牌。使用用户访问令牌创建购买请求的结果导致购买请求被分配给生成用户访问令牌的用户,而不是在有效载荷中设置的用户。用户访问令牌可用于测试目的。

检索公司访问令牌

连接到此API的客户端将接收有关如何从Convur技术启用资源生成Company Access令牌或公司Refresh令牌的客户凭据和信息。

检索用户访问令牌

此API支持用户访问令牌,但使用用户访问令牌创建的任何购买请求都将仅创建/分配给生成用户访问令牌的用户的这些请求。在提出购买请求API的请求之前,您必须从身份验证获取访问令牌API。

响应将包括一个Access_Token.字段,包含您的访问令牌。对于后续调用,您需要在此访问令牌中包含此访问令牌授权您的电话标题。一个id_token.也将包含在响应中。为了检索用户的唯一ID,您必须解码此内容id_token.jwt.io.。您需要此ID才能发布购买请求。