# CRM打通方案 CRM订单打通场景方案 ## CRM门店打通流程 API名称：创建三方门店 youzan.scrm.subshop.modify.1.0.0 https://doc.youzanyun.com/detail/API/0/2705 CRM相关其他接口参考： https://doc.youzanyun.com/list/API/1315 ## 商品打通流程 通用商品打通流程，可参考有赞云文档： https://doc.youzanyun.com/resource/doc/3318 https://doc.youzanyun.com/resource/solution/27031/27091 https://doc.youzanyun.com/resource/doc/3377 https://doc.youzanyun.com/resource/doc/3318 ## CRM订单打通流程 ### 整体流程 ![img](https://img01.yzcdn.cn/upload_files/2022/04/22/Fspfm6q4oaB3ZA3aUbeXBw55rCqV.png) ### 接口清单 | 接口序号 | 接口名称 | api | 接口文档 | | -------- | --------------------------- | --------------------------------------------------------- | ------------------------------------------- | | API 1 | 查询三方门店 | youzan.scrm.subshop.get.1.0.0 | https://doc.youzanyun.com/detail/API/0/2734 | | API 2 | 用户查询接口 | youzan.users.info.query.1.0.0 | https://doc.youzanyun.com/detail/API/0/2193 | | API 3 | 外部订单开单接口 | youzan.trade.order.out.create.3.0.0 | https://doc.youzanyun.com/detail/API/0/3007 | | API 4 | 查询单笔交易详情接口 | youzan.trade.get.4.0.1 | https://doc.youzanyun.com/detail/API/0/3400 | | API 5 | 商家主动退货退款 | youzan.trade.refund.seller.return.create.1.0.0 | https://doc.youzanyun.com/detail/API/0/2876 | | API 6 | 批量查询店铺下商品列表 | youzan.item.common.search.1.0.0 | https://doc.youzanyun.com/detail/API/0/3561 | | API 7 | 查询单商品明细接口-推荐使用 | youzan.item.detail.get.1.0.0 | https://doc.youzanyun.com/detail/API/0/2783 | | API 8 | 商家主动换货接口 | youzan.trade.refund.seller.exchange.create.1.0.0 | https://doc.youzanyun.com/detail/API/0/2893 | ### 创建订单 订单部分，包含存量和增量数据的同步。存量是否使用CRM现有的订单导入功能来完成？需要按照excel模板。 #### 订单主信息 ```Plain%20Text main_info.open_source.trade_channel.common_channel="POS" main_info.order_status="SUCCESS" main_info.biz_identity="CRM" main_info.is_online_order=false main_info.create_time=订单创建时间 main_info.pay_time=订单支付时间 main_info.out_biz_no=外部订单号 ``` #### 价格相关 ```Plain%20Text 举例：一个商品原价10元，活动价7元，我买了两件，并且使用了1元优惠券，运费是2元，实付15 入参： 商品级金额： tradeItems.originPrice（商品原始价格） = 1000 tradeItems.currentPrice（商品当前价格） = 700 tradeItems.num = 2 订单级金额字段： openOrderPrice.originPrice（订单原价） = 1400 openOrderPrice.currentPrice（订单现价） = 1300 openOrderPrice.postage = 200 openOrderPrice.totalprice（实付总价） = 1500 openOrderPrice.promotionAmount（优惠金额） = 100 商品当前价格 * 数量 = 订单原价 订单原价 - 订单优惠金额 = 订单现价 订单现价 + 邮费 = 订单实付总价 tradeItems.currentPrice * tradeItems.num = openOrderPrice.originPrice openOrderPrice.originPrice - openOrderPrice.promotionAmount = openOrderPrice.currentPrice openOrderPrice.currentPrice + openOrderPrice.postage = openOrderPrice.totalPrice 也即：在没有运费（postage）的情况下，currentPrice = totalPrice 以上金额相关字段，建议按照规范必填 ``` #### 卖家信息 ```Plain%20Text seller.out_kdt_id=外部店铺id seller.kdt_id=有赞店铺id（【API 1】通过crm门店接口查询，批量情况下，可以做缓存） ``` #### 收货信息 ```Plain%20Text receiver.logistics_type="NONE"，使用无物流方式 ``` #### 买家信息 ```Plain%20Text buyer.yz_open_id=通过用户查询接口【API 2】 buyer.buyer_name=买家姓名 buyer.tel=买家手机号 ``` #### CRM相关扩展信息 ```Plain%20Text order_extra.crm_extension order_extra.crm_extension.last_org_order_no， 非等价换货场景下：新换的商品走正向单流程，然后该正向单需要记录一下三方原单对应的有赞订单 举例：比如E001买了一瓶矿泉水，发生非等价换货，换成了一瓶可乐，此时商品可乐生成正向单E002，E002的last_org_order_no=E001，关联上之前的矿泉水。 order_extra.crm_extension.is_history_order，是否为历史订单，0-否，1-是，历史订单传1，增量订单传0 ``` #### 订单条目 ```Plain%20Text trade_items.item_id = 有赞商品id，需打通 trade_items.sku_id = 有赞商品skuId，需打通 trade_items.goods_info.extension.out_order_item_info 外部商品信息 trade_items.goods_info.extension.out_order_item_info.out_order_item_id = 外部商品在订单中生成的唯一id，即订单条目id；(外部可以使用拼接的逻辑构造，如：P20093_389450459) trade_items.goods_info.extension.out_order_item_info.out_item_id = 外部商品id trade_items.goods_info.extension.out_order_item_info.out_sku_id = 外部规格id trade_items.goods_info.attachment_url = 商品图片url trade_items.goods_info.title = 商品名称 trade_items.goods_info.goods_no = 商品编码 trade_items.goods_info.sku_no = 规格编码 ``` ### 退货退款 ```Plain%20Text 如果是非等价换货，创建上一个订单的商品退货单 extension.crm_non_equivalent_exchange = 1 ``` ### 换货 #### 等价换货 直接调用换货接口 #### 非等价换货 需要走先退后买流程，上一笔订单退款后，新商品再创建正向单。 业务特殊处理，需要校验上一笔单子是否退款完成。 ### 补充信息 #### 生成的有赞订单默认不推送积分 积分规则目前支持配置化，如果需要配置白名单，需要联系运营同学配置。 不配置白名单情况下，历史订单【新订单、退换货】不触发积分规则，增量订单【新订单、退换货】不触发积分规则。 配置白名单情况，历史订单【新订单、退换货】不触发积分规则，增量订单【新订单、退换货】根据白名单的配置触发积分规则。