采购订单API为SAP Concur提供了利用外部数据来创建和更新批准的采购订单的能力。客户端可以建立与采购订单API的直接连接,该API将为要关联的发票创建采购订单。它还允许客户端在订单更改时更新创建的采购订单,需要关闭,或识别和解析PO发票上的匹配例外。

限制:此API在中国数据中心不提供。此API仅适用于具有现有SAP Confor客户端的直接集成。此API只能用于创建新的购买请求并获取创建的购买请求的详细信息。此API无法更新,编辑或删除购买请求。在将其发送到SAP Concur之后的所有编辑或处理购买请求,必须在SAP Confor中完成。

产品和版本

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

范围使用

所需的范围:

名称 描述 终点
invpo. 创建,更新和检索采购订单。 发布,放置,得到

依赖性

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

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

如果SAP Concur中的采购订单表格所需的自定义字段与列表相关联,则需要提供列表项的项目代码。你可以访问列出管理在SAP Confur查看您的列表项和列表项代码。如果您需要使用Web服务从SAP Confur获取此数据,则可以使用列出项目v3.api检索level1code.列表项的值。

访问令牌用法

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

创建新的采购订单

post /api/v3.0/invoice/purchaseorders.

创建或更新采购订单。使用采购订单API无法使用批处理。请使用导入作业进行批处理更新。

有效载荷

例子

{“billtoaddress”{“地址1”“Add1”“地址2”“Add2”“地址3”“Add3”“城市”“城市”“国家代码”“我们”“uperentID”“Billtoapi”“名称”“记账到”“邮政编码”“55426”“endicalprovines”“Mn”},“货币代码”“美元”“订购日期”“2011-08-12T20:17:46.384z”“ID”“api101”“istest”“错误的”“ischangeOrder”“错误的”“Ledgercode”“23”“LINEITEM”[{“分配”[{“数量”“106.74”“百分比”“100.00000000”“grossamount”“106.74”}],“创造”“2019-12-13 20:00:37.0”“描述”“第1行”“expensetype”“广告”“uperentID”“api100line1”“isreceiptrequired”“真的”“电话号码”“1”“presentorderreceipttype”“wqty”“数量”“1.00”“unitofmeasurecode”“DA”“单价”“106.74”}],“名称”“Poname”“policyexternalid”“宝”“订购单号码”“api101”“买入标记”“100001”“被要求”“deo,约翰”“船运”“0.00000000”“邮寄到地址”{“地址1”“Add1”“地址2”“Add2”“地址3”“Add3”“城市”“城市”“国家代码”“我们”“uperentID”“shiptoapi”“名称”“shiptoapi”“邮政编码”“55426”“endicalprovines”“Mn”},“地位”“传播”“税”“0.00000000”“URI”“http://www.concursolutions.com/api/v3.0/invoice/purchaseorders/purchaseorders/api101”“vendorcode”“ven1”“VendorAddressCode”“ven1addr1”}

响应

使用收据信息更新采购订单行项目

put /api/v3.0/invoice/purchaseorderreceipt.

有效载荷

响应

更新现有的采购订单

put /api/v3.0/invoice/purchaseorders.

有效载荷

响应

获取现有的采购订单

get /api/v3.0/invoice/purchaseorders/aid}

参数

名称 类型 格式 描述
ID 细绳 {ID} 采购订单的标识符。

输入

没有任何

响应

架构

采购订单

名称 类型 格式 描述
AmountWithoutVat 细绳 - 采购订单的净额(不包括增值税)。
Billtoaddress. 目的 Billtoaddress. 要求客户的账单地址,这是供应商应发送账单的地方。
货币代码 细绳 - 要求与采购订单相关的货币的3个字母ISO 4217货币代码。
Custom1到Custom24. 细绳 - 可以应用于自定义字段的值,该字段是采购订单标头表单的一部分。
描述 细绳 - 采购订单的描述。
折扣植物中心 细绳 - 如果符合折扣条款,供应商的折扣。
DiscountTerms 细绳 - 折扣适用时供应商提供的净折扣条款。
ID 细绳 - 资源的唯一标识符。
坚持 细绳 真的/错误的 如果购买订单是测试。
ischangeOrder. 细绳 真的/错误的 如果采购订单有变更顺序。
Ledgercode. 细绳 - 指示该公司日志分配了哪些公司日志的代码。
LineItem 数组 LineItem 要求采购订单中的行项目。
名称 细绳 - 要求购买订单的名称。
NeededByDate 细绳 yyyy-mm-dd 购买订单必须满足的日期。
向数据库 细绳 yyyy-mm-dd 要求订购货物的日期。
付款条件 细绳 - 已与供应商建立的净付款条件。
positalexternalid. 细绳 - 要求应与采购订单相关联的策略的外部标识符。外部ID是策略配置屏幕的属性。如果使用专业版,客户需要从实施团队中获取这些ID。对于标准版本,始终是值
povendortaxid. 细绳 - 供应商税号。
省塔克西德 细绳 - 供应商省级税号。
订购单号码 细绳 - 采购订单号。
购买requestnumber. 细绳 - 生成采购订单的相关购买请求号。
收据 细绳 - 采购订单收据类型(已弃用)。使用presentorderreceipttype.在线项目级别。
RequestedBy 细绳 - 在采购订单中索取货物的人。
RequestedDeliveryDate 细绳 yyyy-mm-dd 采购订单指示供应商提供货物的日期。
船运 细绳 - 购买订单的总运费成本。
送货入住 细绳 - 描述购买订单中货物将如何发货的描述。例如,通过联邦快递。
ShippingMethodkey. 细绳 - 代表供应商使用的运输方法的代码。最大长度:10个字符
chinesstermskey. 细绳 - 代表供应商提供的运输条款的代码。最大长度:10个字符
邮寄到地址 目的 邮寄到地址 要求客户的送货地址,这是供应商应运输货物的地方。
地位 细绳 - 采购订单的当前状态。默认:传输。支持的值:关闭传输
细绳 - 采购订单的总税。
Uri. 细绳 - 资源的URI。
vatamoserone. 细绳 - 该字段尚未通过购买请求实现。此字段中的任何数据都将被忽略。
vatamounttwo. 细绳 - 该字段尚未通过购买请求实现。此字段中的任何数据都将被忽略。
Vatrateone. 细绳 - 该字段尚未通过购买请求实现。此字段中的任何数据都将被忽略。
vatratetwo. 细绳 - 该字段尚未通过购买请求实现。此字段中的任何数据都将被忽略。
VendorAccountNumber. 细绳 - 供应商帐号。
VendorAddresscode. 细绳 - 要求标识购买订单的供应商汇率汇率地址的代码。
vendorcode. 细绳 - 要求标识购买订单供应商的代码。

Billtoaddress.

名称 类型 格式 描述
地址1 细绳 - 要求结算地址的地址行1。
地址2 细绳 - 结算地址的地址行2。
地址3 细绳 - 结算地址的地址行3。
城市 细绳 - 要求账单地址的城市。
国家代码 细绳 - 要求账单地址的国家代码。
ExternalID 细绳 - 要求客户提供的唯一值,以识别特定的计费地址。
名称 细绳 - 可以给予帐单地址的可选名称。
PostalCode 细绳 - 要求账单地址的邮政编码。
atalitalprovince. 细绳 - 要求账单地址的州或省。

LineItem

名称 类型 格式 描述
AccountCode. 细绳 - 行项的帐户代码。必须为任何一种值提供值expensetype.要么AccountCode.,但不是两者。如果是,则需要该字段expensetype.不提供价值。
分配 数组 分配 与行项关联的分配列表。可以在同一行项中重复分配元素以表示多个分配。
AmountWithoutVat 细绳 - 线项的净额(不包括增值税)。
创造 细绳 yyyy-mm-dd 行项目创建的日期。
Custom1到Custom20. 细绳 - 可以应用于自定义字段1的值,这是购买订单行项目表单的一部分。
描述 细绳 - 线项的描述。
expensetype. 细绳 - 行项目的费用类型。必须为任何一种值提供值expensetype.要么AccountCode.,但不是两者。如果是,则需要该字段AccountCode.不提供价值。
ExternalID 细绳 - 要求客户提供的值,可以唯一地标识采购订单中的行项目。
IsReceiptRequired. 细绳 真的/错误的 指示行项目是否需要收据。
电话号码 细绳 - 要求采购订单中的行项目编号。
数量 细绳 - 要求与线项相关的数量。
presentorderreceipttype. 细绳 - 采购订单收据线项。如果您使用Concur接收并需要对由此产生的PO线使用输入货物收据QUANTITY_RECEIPT。默认:没有任何。支持的值:QUANTITY_RECEIPT没有任何
RequestedBy 细绳 - 要求货物在采购订单的行项目中的人员。
RequestedDeliveryDate 细绳 yyyy-mm-dd 购买订单的行项目指示供应商提供货物的日期。
Supplierd. 细绳 - 任何可能有助于识别行项目的数字。这可能是诸如供应商的部件号甚至制造商编号的价值。
细绳 - 任何与行项相关的税。
unitofmeasurecode. 细绳 - 衡量线项代码的单位。
单价 细绳 - 要求线项的每个项目的价格。
vatamount. 细绳 - 该字段尚未通过购买请求实现。此字段中的任何数据都将被忽略。
vatrate. 细绳 - 该字段尚未通过购买请求实现。此字段中的任何数据都将被忽略。

分配

名称 类型 格式 描述
数量 细绳 - 要求分配的总金额。
Custom1到Custom20. 细绳 - 可以应用于属于分配表单的自定义字段1的值。
grossamount. 细绳 - 要求分配总金额。
百分比 细绳 - 要求分配百分比。

邮寄到地址

名称 类型 格式 描述
地址1 细绳 - 要求地址第1行的送货地址。
地址2 细绳 - 送货地址的地址第2行。
地址3 细绳 - 送货地址的地址第3行。
城市 细绳 - 要求收货地址所在城市。
国家代码 细绳 - 要求送货地址的国家代码。
ExternalID 细绳 - 要求客户提供的独特价值,以识别特定的送货地址。
名称 细绳 - 可以提供给送货地址的可选名称。
PostalCode 细绳 - 要求送货地址的邮政编码。
atalitalprovince. 细绳 - 要求送货地址的州或省。

响应架构

名称 类型 格式 描述
错误代码 细绳 - 一个代码,指示未成功处理采购订单的原因。
错误信息 细绳 - 错误的描述。
FieldCode. 细绳 - 指示引起问题的代码。仅当对表单类型的字段验证字段时,此代码才会出现。格式:级别代码。可能的水平是:标题运送到记账到LineItem分配
LineItemexternalid. 细绳 - 导致错误的行项的外部ID。如果错误与分配相关,则该字段表示分配与之相关的行项的外部ID,并且还指示导致错误的分配。
消息 细绳 -
订购单号码 细绳 - 采购订单号。
地位 细绳 成功/失败 处理采购订单的结果。

收据架构

名称 类型 格式 描述
isroceived 细绳 - 要求指示是否收到了行项。
LineItemexternalid. 细绳 - 要求客户提供的值,可以唯一地标识采购订单中的行项目。
订购单号码 细绳 - 要求采购订单号。
收到的日期 细绳 yyyy-mm-dd 订单项目的日期。
接受Quantity. 细绳 - 收到的项目数量。

错误代码

即使批次中的每个项目都无法创建,更新或删除,Web服务也不会返回批量操作的4xx HTTP响应代码。客户必须检查响应,以查找单个批量项目的警告或错误。

代码 描述
1000 PO号码缺失或无效。
2000年 没有找到供应商代码和供应商地址代码的供应商。
3000. 货币代码丢失或无效。
4000. 没有找到匹配提供的外部ID的策略。
4001. 该政策不支持采购订单。
4002 策略无法在采购订单上更改。
5000 采购订单不包含任何行项目。
5001. 行项必须包含费用类型或帐户代码,但不是两者。
5002. 行项目费用类型无效。
5003. 行项帐户代码无效。
5004. 该线项税和单价必须匹配正面或负面。
5500. 行项包含分配,但未定义分配表单。
5501 行项分配金额超出行项。
5502 行项的分布金额必须与数字金额为正或负数。
5503 行项的分布金额不能为零。
5600. 行项的外部ID在采购订单中不是唯一的。
6000. 船舶到地址丢失或无效。
6001 地址账单缺失或无效。
8000. 缺少必填字段。
8001 字段的值超过允许的最大长度。
8002 字段的值不是正确的数据类型。
8003 字段的值是无效列表项。
8004 字段的值是无效的连接列表项。
8005 国家代码丢失或无效。
8006. 为非表格部分的领域提供了一个值。
9999 一个意料之外的问题发生了。