广东省政府采购网上商城.docVIP

广东省政府采购网上商城 对接标准  接口概述 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