API联通手册.pdf

ECstore 联通 API 手 册 《ECstore 联通 API 手册》版权归属于上海商派网络科 技有限公司，所有事先未经上海商派网络科技有限公司 的书面准许不得将本手册的任何部分以任何形式、采用 任何手段(电子或机械的，包括照相复制或录制)、或为 任何目的，进行复制或扩散。 一、概述3 接口服务概述3 名词解释3 二、接口描述3 1. 通信方式 3 2. 后端接口相关描述（只支持矩阵通信方式） 5 订单区间查询接口（b2c.order.search ）5 订单明细接口（b2c.order.detail ）6 订单创建 （b2c.order.create ） 13 修改订单状态（b2c.order.status_update ） 14 添加订单支付单 （b2c.payment.create ） 14 添加订单退款单（b2c.refund.create ） 15 添加退货单（b2c.reship.create ） 15 添加售后申请（b2c.aftersale.create ） 16 修改售后申请（b2c.aftersale.update ） 17 创建发货单（b2c.delivery.create ） 18 订单编辑 iframe 界面(b2c.order.iframe_url) 19 3. 接口示意图 19 3.1 订单创建 19 3.2 订单编辑 19 3.3 订单编辑增加金额 20 3.4 订单编辑减少金额 21 3.5 售后申请 21 3.6 售后退货 22 3.7 库存更新 22 一、概述 接口服务概述 ECstore联通API手册用于描述ECstore系统是如何后端系统OCS/套管ERP进行接口交互的 （注：只描述ECstore开放的访问的接口）。ECstore联通API接口分2种，直连接口以及通 过矩阵的方式，都采用HTTP POST方式接受请求。本文档的撰写主要用于描述ECstore是 如何通过矩阵将业务数据传递到OCS系统的。 名词解释 ECstore: ShopEx 公司提供电子商务 B2C 商城系统 OCS: ShopEx 公司提供的运营协同套件 二、接口描述 1. 通信方式 通过 ShopEx 矩阵通信方式 a) 接口地址: b) API 系统级输入参数  数据格式 utf-8  HTTP 请求 content-type:application/x-www-form-urlencoded  数据格式为 datetime(如:)  数据返回格式（json ） 参数 类型 是否必须 描述 app_id String Y APP ID 号, 例如:b2c Method String Y 指定调用 api 的 service 和 mehtod. 例如:method 设为 b2c.payment.create 那么 service:api.b2c.payment, method:create Date String Y 时间戳，格式为 yyyy-MM-dd hh:mm:ss ，例如： 2008-01-25 20:23:30 Format String N 可选，指定响应格式。默认 json certi_id int N shopex 分配给相关应用的证书号 V int Y API 协议