ERP方提供给华阳的接口规则.docxVIP

文档编号 Mega_Software_ Design _001 v1.0 修订记录 日期 版本 描述 修改者 2016-07-2 草版 建立 罗琨 2016-07-12 0.1 增加订单推送示例，订单添加字段 徐科 TOC \o "1-3" \h \u 文档编号 1 修订记录 1 1. 文档介绍 4 1.1文档目的 4 1.2读者对象 4 1. 接口规范 4 2.1通信方式 4 2.2接口参数和格式 5 2.3响应格式 5 2.4时间戳验证 6 2.5签名验证 6 文档介绍 1.1文档目的 本文档规定华阳ERP对接技术标准和规范，可做双方对接的标准文档。 1.2读者对象 与华阳进行ERP对接的业务人员、技术人员和其它相关人员。 接口规范 2.1通信方式 接口通讯协议统一使用HTTP协议 字符集使用UTF-8 接口方法统一使用POST 返回格式JSON ERP方接口请求地址： http://xxx.xxx.xxx/xxx（由CRM方定义后提供给华阳）  2.2接口参数和格式 序号 参数 参考值 备注 1 appKey 1234567890 应用key(由第三方提供) 2 jsonData {} 发送的具体的数据,json格式字符串 3 method syncOrder 接口方法 格式示例： ?method=syncOrder&appKey=appkey&jsonData={} 2.3响应格式 序号 标签 格式 说明 1 state 1表示成功，0其它失败 返回的状态 2 msg 成功 响应信息描述 3 code null 预留备用 4 jsonData {} 返回的json格式数据字符串 格式示例： {“state”:1, “msg”:”成功”,”jsonData”:”{}”,code:null} 同步订单 11.1接口调用请求 11.1.1参数说明 参数 类型 参考值 备注 method String 方法名syncOrder 请求方法 jsonData String {} 具体的请求数据，json格式字符串 erpHost String 请求主机url 11.1.2请求的jsonData实体数据说明 示例： 字段 名称 类型 备注 erpStoreCode erp店铺编号 String erpStoreDisCode String deleted 删除标识 Boolean 0未删除 1已删除 orderNo 订单编号 String shopId 商家id String buyerName 购买人昵称 String buyerPhone 购买人的电话 String consignee 收货人名称 string takePhone 收货人电话 String takeAddress 收货人地址 String delivery 配送方式 Integer 1，快递配送，2 用户到店，3商家配送 deliveryString 配送方式对应的文字描述 String tradeDate 支付时间 Date yyyy-MM-dd HH:mm:ss totalPrice 订单总价 Double 订单总消费金额 （goodsAmount + freight） payWay 支付方式 Integer 1 支付宝，2 微信支付，3 用户到店，4 货到付款，5 余额支付，6 线上抵扣 payWayString 支付方式对应的文字描述 String goodsAmount 商品总价 Double freight 运费 Double modifyFreight 加减的运费 Double amount 订单实付金额 Double prepaid 余额支付的金额 Double payAmount 支付的金额 Double discount 折扣金额 Double exchang 积分抵扣的金额 Double redpack 红包抵扣的金额 Double cashcoupon 现金券抵扣的金额 Double reducePrice 减价金额 Double setMealDiscountFee 套餐优惠金额 Double manJianFee 满减优惠的金额 Double createTime Date userName 购买时订单输入的用户名称 String nick 购买用户的昵称 String userTelphone 购买时订单输入的用户电话 String status 订单状态 Integer 0 未付款，1 ，用户取消 ，2已支付 ，3已发货，4 ，交易完成，5 ，商家取消，6，7,8 申请退款中，9退款完成，10 超时取消 11,已付定金 statusString 订单