欧珀莱麒麟CRM对外接口


P18-订单推送

<p><strong>简要描述:</strong> </p> <ul> <li>订单同步</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li>环境地址:<code>https://kylinapi.aupres.com.cn/openapi/v2/order/save</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>请求参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">channelType</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">渠道类型 POS</td> <td>string</td> </tr> <tr> <td style="text-align: left;">couponFee</td> <td style="text-align: left;">N</td> <td style="text-align: left;">优惠劵金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">couponNo</td> <td style="text-align: left;">N</td> <td style="text-align: left;">优惠劵码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">coupons</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单优惠券</td> <td>array</td> </tr> <tr> <td style="text-align: left;">customerNo</td> <td style="text-align: left;">N</td> <td style="text-align: left;">客户编号(单渠道唯一标识)</td> <td>string</td> </tr> <tr> <td style="text-align: left;">description</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单备注</td> <td>string</td> </tr> <tr> <td style="text-align: left;">discountFee</td> <td style="text-align: left;">N</td> <td style="text-align: left;">折扣金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">discountRate</td> <td style="text-align: left;">N</td> <td style="text-align: left;">折扣率 &lt;=1</td> <td>number</td> </tr> <tr> <td style="text-align: left;">exchangeTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单换货时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">freight</td> <td style="text-align: left;">N</td> <td style="text-align: left;">运费</td> <td>number</td> </tr> <tr> <td style="text-align: left;">guideCode</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单对应导购</td> <td>string</td> </tr> <tr> <td style="text-align: left;">isInternal</td> <td style="text-align: left;">N</td> <td style="text-align: left;">是否是内部订单. Y:否 N:是 . 默认为N</td> <td>string</td> </tr> <tr> <td style="text-align: left;">isSend</td> <td style="text-align: left;">N</td> <td style="text-align: left;">isSend, 默认为N</td> <td>string</td> </tr> <tr> <td style="text-align: left;">memberId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">会员ID</td> <td>string</td> </tr> <tr> <td style="text-align: left;">memberType</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">会员类型 传固定值aupres</td> <td>string</td> </tr> <tr> <td style="text-align: left;">orderId</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">订单ID</td> <td>string(主订单表唯一主键字段)</td> </tr> <tr> <td style="text-align: left;">orderItems</td> <td style="text-align: left;">N</td> <td style="text-align: left;">子订单列表</td> <td>array</td> </tr> <tr> <td style="text-align: left;">orderStatus</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">订单状态 订单状态: 下单 CREATED 订单取消 CANCELLED 已发货 DELIVERED 卖家已确认CONFIRMED 订单完成 FINISHED 退款开始 REFUND_START 退款中 REFUNDING 退款完成REFUND_FINISHED 退款取消 REFUND_CANCEL</td> <td>string</td> </tr> <tr> <td style="text-align: left;">orderTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">下单时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">orderType</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">订单类型:正常单-NORMAL,退单-REFUND</td> <td>string</td> </tr> <tr> <td style="text-align: left;">originOrderId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">原始订单ID, 退单时传</td> <td>string</td> </tr> <tr> <td style="text-align: left;">payTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单付款时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>date</td> </tr> <tr> <td style="text-align: left;">payment</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">正常单时,代表实付金额;退单时,代表退款金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">pays</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单支付方式</td> <td>array</td> </tr> <tr> <td style="text-align: left;">pointFlag</td> <td style="text-align: left;">N</td> <td style="text-align: left;">是否计算积分. 0-不计算积分, 1- 计算积分</td> <td>int</td> </tr> <tr> <td style="text-align: left;">receiveTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单发货时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">receiverProvince</td> <td style="text-align: left;">N</td> <td style="text-align: left;">省</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverCity</td> <td style="text-align: left;">N</td> <td style="text-align: left;">市</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverDistrict</td> <td style="text-align: left;">N</td> <td style="text-align: left;">区/县</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverAddress</td> <td style="text-align: left;">N</td> <td style="text-align: left;">收货人地址</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverMobile</td> <td style="text-align: left;">N</td> <td style="text-align: left;">收货人手机号</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverName</td> <td style="text-align: left;">N</td> <td style="text-align: left;">收货人姓名</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverTelephone</td> <td style="text-align: left;">N</td> <td style="text-align: left;">收货人固定电话</td> <td>string</td> </tr> <tr> <td style="text-align: left;">receiverZipCode</td> <td style="text-align: left;">N</td> <td style="text-align: left;">邮编</td> <td>string</td> </tr> <tr> <td style="text-align: left;">refundTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单退货时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">shippingTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单收货时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">shopCode</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">消费门店code</td> <td>string</td> </tr> <tr> <td style="text-align: left;">shopName</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">消费门店名称</td> <td>string</td> </tr> <tr> <td style="text-align: left;">shopTypeCode</td> <td style="text-align: left;">N</td> <td style="text-align: left;">消费门店类型code</td> <td>string</td> </tr> <tr> <td style="text-align: left;">totalFee</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">应付金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">totalQuantity</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">商品总数</td> <td>int</td> </tr> <tr> <td style="text-align: left;">customizedProperties</td> <td style="text-align: left;">N</td> <td style="text-align: left;">扩展字段</td> <td>map</td> </tr> </tbody> </table> <p><strong>coupons说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">couponFee</td> <td style="text-align: left;">N</td> <td style="text-align: left;">优惠金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">couponNo</td> <td style="text-align: left;">N</td> <td style="text-align: left;">优惠券码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">instanceId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">权益实例id</td> <td>string</td> </tr> <tr> <td style="text-align: left;">orderItemId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">子订单号</td> <td>string</td> </tr> <tr> <td style="text-align: left;">projectId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">权益项目id</td> <td>string</td> </tr> <tr> <td style="text-align: left;">projectName</td> <td style="text-align: left;">N</td> <td style="text-align: left;">权益项目名称</td> <td>string</td> </tr> </tbody> </table> <p><strong>orderItems说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">channelType</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">渠道</td> <td>string</td> </tr> <tr> <td style="text-align: left;">discountFee</td> <td style="text-align: left;">N</td> <td style="text-align: left;">折扣金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">discountRate</td> <td style="text-align: left;">N</td> <td style="text-align: left;">折扣率 &lt;=1</td> <td>number</td> </tr> <tr> <td style="text-align: left;">finishTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单完成时间, 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">orderItemId</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">子订单ID</td> <td>string(子订单表唯一主键字段)</td> </tr> <tr> <td style="text-align: left;">orderTime</td> <td style="text-align: left;">N</td> <td style="text-align: left;">下单时间 格式: yyyy-MM-dd HH:mm:ss</td> <td>DataTime</td> </tr> <tr> <td style="text-align: left;">orderType</td> <td style="text-align: left;">N</td> <td style="text-align: left;">子订单类型:正常单 - NORMAL, 退单 - REFUND</td> <td>string</td> </tr> <tr> <td style="text-align: left;">originOrderItemId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">原始子订单ID, 退单时传</td> <td>string</td> </tr> <tr> <td style="text-align: left;">payment</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">实付金额</td> </tr> <tr> <td style="text-align: left;">picture</td> <td style="text-align: left;">N</td> <td style="text-align: left;">商品图片url</td> <td>array</td> </tr> <tr> <td style="text-align: left;">productCode</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">商品Code</td> <td>string</td> </tr> <tr> <td style="text-align: left;">productName</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">商品名称</td> <td>string</td> </tr> <tr> <td style="text-align: left;">quantity</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">订单数量</td> <td>int</td> </tr> <tr> <td style="text-align: left;">retailPrice</td> <td style="text-align: left;">N</td> <td style="text-align: left;">零售价</td> <td>number</td> </tr> <tr> <td style="text-align: left;">shopTypeCod</td> <td style="text-align: left;">N</td> <td style="text-align: left;">注册门店类型code</td> <td>string</td> </tr> <tr> <td style="text-align: left;">skuId</td> <td style="text-align: left;">N</td> <td style="text-align: left;">商品批次编码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">子订单状态</td> <td>string</td> </tr> <tr> <td style="text-align: left;">tagPrice</td> <td style="text-align: left;">N</td> <td style="text-align: left;">吊牌价</td> <td>number</td> </tr> <tr> <td style="text-align: left;">totalFee</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">应付金额</td> <td>number</td> </tr> <tr> <td style="text-align: left;">customizedProperties</td> <td style="text-align: left;">N</td> <td style="text-align: left;">扩展字段</td> <td>map</td> </tr> </tbody> </table> <p><strong>customizedProperties说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">saleType</td> <td style="text-align: left;">N</td> <td style="text-align: left;">销售区分 (零售、团购)</td> <td>String</td> </tr> <tr> <td style="text-align: left;">orderResource</td> <td style="text-align: left;">N</td> <td style="text-align: left;">订单来源 (ZGXS-专柜、SWP-微信群、ECXS-EC销售、ECZB-EC直播)</td> <td>String</td> </tr> </tbody> </table> <p><strong>pays说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">payWayCode</td> <td style="text-align: left;">N</td> <td style="text-align: left;">支付方式编码</td> <td>string</td> </tr> <tr> <td style="text-align: left;">payWayName</td> <td style="text-align: left;">N</td> <td style="text-align: left;">支付方式名称</td> <td>string</td> </tr> <tr> <td style="text-align: left;">payment</td> <td style="text-align: left;">N</td> <td style="text-align: left;">支付金额</td> <td>number</td> </tr> </tbody> </table> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">HTTP Code</th> <th style="text-align: left;">Description</th> <th>Schema</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">OK</td> <td>No Content</td> </tr> <tr> <td style="text-align: left;">201</td> <td style="text-align: left;">Created</td> <td>No Content</td> </tr> <tr> <td style="text-align: left;">401</td> <td style="text-align: left;">Unauthorized</td> <td>No Content</td> </tr> <tr> <td style="text-align: left;">403</td> <td style="text-align: left;">Forbidden</td> <td>No Content</td> </tr> <tr> <td style="text-align: left;">404</td> <td style="text-align: left;">Not Found</td> <td>No Content</td> </tr> </tbody> </table> <p><strong>请求参数示例</strong></p> <pre><code>{ "shopTypeCode": "TAOBAO", "channelType": "pos", "totalFee": 85, "payment": 85, "discountRate": 0.85, "discountFee": 15, "customizedProperties": { "saleType": "零售" }, "memberType": "aupres", "customerNo": "T000001", "orderId": "087989aaf6af4e58897794d18axxxxx", "originOrderId": "087989aaf6af4e58897794d18axxxxx", "shopCode": "SHOP001", "shopName": "SHOP001", "memberId": "1c25f18ad274493882d01660e3exxxxx", "totalQuantity": 1, "orderType": "NORMAL", "orderStatus": "FINISHED", "freight": 10, "receiverName": "abc", "receiverMobile": "18900000000", "receiverTelephone": "18900000000", "receiverProvince": "上海", "receiverCity": "上海", "receiverDistrict": "浦东新区", "receiverAddress": "南京东路100号", "receiverZipCode": "200000", "couponNo": "C123456", "couponFee": 15, "guideCode": "001", "description": "无", "pointFlag": 1, "isInternal": "N", "isSend": "N", "coupons": [ { "orderItemId": "XJLO00001", "projectId": "string", "projectName": "全品类8折券", "instanceId": "string", "couponNo": "O1JH200D", "couponFee": 9.99 } ], "pays": [ { "payWayCode": "1", "payWayName": "现金", "payment": 1 } ], "payTime": "2021-11-10 09:52:03", "receiveTime": "2021-11-10 09:52:03", "shippingTime": "2021-11-10 09:52:03", "exchangeTime": "2021-11-10 09:52:03", "refundTime": "2021-11-10 09:52:03", "orderTime": "2021-11-10 09:52:03", "orderItems": [ { "shopTypeCode": "TAOBAO", "channelType": "TAOBAO", "totalFee": 85, "payment": 85, "discountRate": 0.85, "discountFee": 15, "customizedProperties": { "saleType": "零售", "orderResource":"ZGXS" }, "orderItemId": "bf3a654f1afa4859bb5c0e8846bxxxxx", "originOrderItemId": "bf3a654f1afa4859bb5c0e8846bxxxxx", "productCode": "P001", "productName": "P001", "quantity": 1, "status": "FINISHED", "skuId": "S001", "tagPrice": 100, "retailPrice": 100, "orderType": "NORMAL", "picture": [ "https://allpro.saas.top/FsB-uzzX4WtCzpDu-Vuwqp2OdNbQ?e=1547742055&amp;token=yNjhOp7gnH4St9yP72OlwuQ6JUNQf49pxAuGWYFt:1eZIUjRKIekGuMGG-c-s7UqNF1Y=;" ], "finishTime": "2021-11-10 09:52:03", "orderTime": "2021-11-10 09:52:03" } ], "internal": "string", "send": "string" }</code></pre>

页面列表

ITEM_HTML