广东政府采购网上商城

广东省政府采购网上商城
对接标准
一.接口概述
API（Application Programming Interface，应用编程接口），简单来说就是把不同的系统通过统一的接口协同一起来完成需求任务，就像像USB数据线一样不管两端连的是什么，都就可以使用。

二.具体接口
以下接口服务需广东省政府采购网上商城中标电商提供，广东省政府采购网上商城调用。

2.1 接口约定
所有请求方式均为：POST。

所有返回为JSON型字符串。

所有返回基本结构如下：
{"success": 布尔类型, "desc" : "描述","result" : json或数组}
注意：返回体中不要带换行符等容易影响解析的特殊字符。

2.2 授权获取Access Token
除此之外的所有接口均需提供有效的access_token参数，以便进行身份验证。

注：请设置token失效时间12个小时。

如果所有的接口请求的token失效了，返回结果desc必须包含“token_expired”英文文字标识。

方便确定是否需要重新获取token。

2.3 获取品目池接口
广东省政府采购会提供品目清单，需要按照品目清单建立对应的商品池。

同步频率：每日同步一次。

2.4 获取商品编号SKU接口
SKU是指商品的唯一编码，根据2.3接口接口返回的商品池，通过商品池要能获取该商品池下的所有商品SKU。

同步频率：每日同步一次。

2.5 商品详情接口
批量获取SKU后，可以根据单个接口要能获取到商品详情，包括：商品编号、商品链接、品牌、型号、主图地址、上下架状态、商品名称、产地、条形码、计量单位、类别、售后服务、详细介绍、规格参数等商品详细信息。

要求商品推送数据必须完整有效。

否则广东省政府采购网上商城不会对外显示。

同步频率：每日同步一次，自动同步最新商品。

2.6 上下架状态接口
商品有上下架状态，广东省政府采购网上商城有校验状态，需要先同步电商的上下架状态，再进行业务规则校验。

要求能批量同步商品的上下架状态。

同步频率：每日同步一次；商品浏览实时同步。

2.7 图片接口
在商品详细信息接口中有个主图地址，是作为商品列表页面显示的主要图片，图片接口则是商品详情页面滚动展示所用到的。

图片地址必须外网独立链接存在，可以直接访问到。

要能根据SKU批量返回图片地址。

同步频率：每日同步一次；
2.8 商品好评度接口
要能根据SKU批量返回每个商品在其官网的评价情况，包括商品评分5分制，以及好评度、中评度、差评度。

2.9 价格接口
价格包括协议优惠价和市场价。

要求能根据SKU批量获取价格。

注意协议优惠价不能高于市场价，否则不予展示给采购单位。

同步频率：每日同步一次；商品浏览实时同步。

2.10 地址接口
收货地址体现看是否有货、及下单推送收货地区等。

可以根据省、市、区县三层地区进行详细返回。

根据区县中文名做匹配。

同步频率：第一次同步。

2.11 库存接口
采购人在浏览商品的时候以及更改购买数量的时候，会实时请求库存接口，以便采购单位购买成功。

要求能根据地区编码和批量的商品SKU获取库存情况。

同步频率：商品浏览实时同步。

2.12 订单接口
2.12.1 预下订单接口
采购人在广东省政府采购网上商城下单成功后，会在广东省政府采购网上商城先生成订单号及合同信息。

再进行订单信息推送给电商，电商接收到订单信息需要对价格进行校验，校验通过后返回成功标识。

此时是预下单应该预占库存，为【待确认】状态，需要2.12.2接口进行确认，才能发货。

所有订单默认开明细发票
下单推送信息主要包括：广东省网上商城订单编号、SKU的价格及数量集合、收货人、收货地区、详细地址、收货人联系方式、发票抬头、税号、支付方式(货到付款、账期支付、支票支付等)。

2.12.2 确认订单接口
下单成功后，广东省政府采购网上商城会调用确认订单接口，如果确认成功，返回标识，然后进入发货流程。

如果订单没有被调用确认订单接口，不能进入发货流程，如果超过3个工作日订单未确认的情况下可以联系广东省网上商城技术支持。

2.12.3 取消订单接口
当预下单成功后，还没进行订单确认调用的时候，采购人可能因为某种原因而需要取消订单，则会调用取消订单的接口，如果订单已经确认了，则需要返回取消失败，货
物可能已经派件，该种情况下，可让采购人进行拒收。

2.13 查询订单信息接口
订单在完成配送，采购人收到货后，需要对订单的状态进行【已完成】的处理；
如果订单被拒收，需要对订单的状态进行【已取消】的处理。

同步频率：针对等待收货的订单进行每隔1个小时的同步状态。

2.14 退换货接口
下单后，订单完成后，针对有可能退换货的情况，需要通过接口推送给电商，推送订单编号，以及对应的退换货的数量。

2.15 物流接口
下单后，要对订单按照时间节点进行记录订单的商品物流情况，根据订单编号能获取到订单的详细物流信息，包括操作时间、操作内容项、操作人。

同步频率：采购人浏览订单详情的时候，实时获取物流信息。

2.16 配件服务接口
针对部分商品比如空调、电视等一般都包含有配件或者安装服务等，要求能根据SKU获取到商品包含的配件及服务信息。

2.17 账期接口
账期支付是指，采购人在授信额度内下单后不用付款就可以采购货物，在确认收货后的支付账期到期前按时完成支付的交易方式。

业务流程描述
订单付款方式为账期支付。

采购人收到货物时，订单状态变为待付款状态。

采购人在规定的付款时期，通过银行转账给供应商，并在网上录入转账信息。

供应商收到转账信息并校对，返回相应信息。

采购人可查询处理结果。

账期接口包括：汇款信息提交接口，账期信息查询接口。

2.18查询商品延保服务接口
商品延保服务，例如保修服务年限，针对特定的SKU有特定的延保服务，要求能根据SKU及地区获取到延保服务的信息，包括服务内容、价格等。

2.19 商品扩展接口
商品扩展接口是对商品附加属性的丰富，体现在商品团体采购、特惠专区、阶梯优惠价等。

能针对不同的采购模式，提供不同的价格。

2.20电子发票接口
采购人下单增值税普通发票要能支持提供电子发票，具体表现为下单后开具电子发票，广东省政府采购网上商城通过电商订单编号获取电子发票链接，提供给采购单位下载。