[TOC] ## 請求綁定客易達 ~~~[api] post:/abacus/bind *string:name=小算盤#小算盤系統名稱 *string:alias=v9988#小算盤系統標識 *string:link=https://abacus.52jiewang.com/v9988/#小算盤系統地址 <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]綁定客易達反饋 ~~~[api] post:/Keeda/bind *string:alias=v9988#客易達系統標識 *string:appid=wx288393432222#客易達綁定的微信公眾號ID *int:apply=1#是否同意綁定 0-拒絕，1-同意 <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 同步門店數據 ~~~[api] post:/abacus/shop *string:list=[]#門店列表，json格式 [{"id":"門店Id", "shop_name":"門店名稱", "phone":"聯系電話", "address":"門店地址"} ] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 同步員工數據 ~~~[api] post:/abacus/user *string:list=[]#員工列表，json格式 [{"id":"員工Id", "name":"員工名稱", "phone":"聯系電話", "entry_date":"入職日期", "shop_id":"歸屬店", "is_admin":"是否管理員"} ] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 同步商品分類數據 ~~~[api] post:/abacus/goodstype *string:list=[]#分類列表，json格式 [{"id":"分類Id", "title":"分類名稱"}]<<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 同步商品品牌數據 ~~~[api] post:/abacus/goodsbrand *string:list=[]#品牌列表，json格式 [{"id":"品牌Id", "title":"品牌名稱"} ] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 同步商品數據 ~~~[api] post:/abacus/goods *string:list=[]#商品列表，json格式 [{"id":"商品Id", "title":"商品名稱", "brand_id":"品牌", "type_id":"分類", "price":"零售價", "sn":"商品碼"}] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 合并商品 ~~~[api] post:/abacus/mergegoods *int:goods_id=1001#保留的商品ID *int:del_id=1000#被合并刪除的商品ID <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]新增訂單 ~~~[api] post:/Keeda/addOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#創建人ID *int:seller_id=1000#銷售員ID *int:owner_id=1000#會員歸屬員工ID *int:shop_id=1000#銷售門店ID *string:create_date=2019-04-22#銷售日期 *int:member_id=1000#會員ID *string:member_name=張三#會員姓名 *string:member_phone=13388996677#會員電話 *string:remark=備注#訂單備注 *string:pay_info=[]#付款信息，json格式 [{"kind_id":"分類ID"},{"payment_id":"支付方式ID", "money": "金額"}] *string:goods=[]#商品列表，json格式 [{"goods_id":"商品Id", "state":"類型 -3-退運營商業務贈品，-2-退贈品，-1-退貨，1-售出，2-贈送"，3-運營商業務贈送, "count":"數量", "price":"零售價(實際售價)", "gid":"商品唯一ID","owner_id":"贈品歸屬唯一ID"} ] *string:mobiles=[]#運營商業務列表，json格式 [{"mid":"業務唯一編碼","mobile_id":"業務Id","eid_id":"工號Id", "phone":"業務手機號", "sn":"業務身份證號", "money":"酬金", "state":"類型 -1-退貨，1-售出", "price":"零售價(實際售價)"} ] <<< success { "code": 0, "info": "成功", "data": [ "review": 0, "mobile": { "業務唯一編碼":"小算盤業務編碼" } ] } ~~~ ## [小算盤]編輯訂單 ~~~[api] post:/Keeda/editOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#創建人ID *int:seller_id=1000#銷售員ID *int:owner_id=1000#會員歸屬員工ID *int:shop_id=1000#銷售門店ID *string:create_date=2019-04-22#銷售日期 *int:member_id=1000#會員ID *string:member_name=張三#會員姓名 *string:member_phone=13388996677#會員電話 *string:remark=備注#訂單備注 *string:pay_info=[]#付款信息，json格式 [{"kind_id":"分類ID"},{"payment_id":"支付方式ID", "money": "金額"}] *string:goods=[]#商品列表，json格式 [{"goods_id":"商品Id", "state":"類型 -3-退運營商業務贈品，-2-退贈品，-1-退貨，1-售出，2-贈送"，3-運營商業務贈送, "count":"數量", "price":"零售價(實際售價)", "gid":"商品唯一ID","owner_id":"贈品歸屬唯一ID"} ] *string:mobiles=[]#運營商業務列表，json格式 [{"mid":"業務唯一編碼","mobile_id":"業務Id","eid_id":"工號Id", "phone":"業務手機號", "sn":"業務身份證號", "money":"酬金", "state":"類型 -1-退貨，1-售出", "price":"零售價(實際售價)"} ] <<< success { "code": 0, "info": "成功", "data": [ "review": 0, "mobile": { "業務唯一編碼":"小算盤業務編碼" } ] } ~~~ ## [小算盤]撤銷訂單 ~~~[api] post:/Keeda/delOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#操作人ID <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]銷售訂單跳轉小算盤 ~~~[api] get:/Keeda/keedaOrder *int:id=10000#訂單ID <<< success 無 ~~~ ## 小算盤微信自動登錄 小算盤綁定客易達后，通過客易達的微信授權實現微信中自動登錄 ### 第一步：跳轉平臺授權 重定向方式請求 ~~~[api] get:https://weopen.52jiewang.com/api/v1/wechat/authorize *string:redirect_uri=...#客易達回調地址[客易達地址/api/v1/wechat/abacus] *string:appid=wx20989049421#客易達綁定的微信公眾號ID <<< success 無 ~~~ ### 第二步：回跳小算盤 ~~~[api] get:/Keeda/auth *string:alias=v9988#客易達系統標識 *string:hash=ab67acss2321321321#(sha1(user_id+keeda)的前16位)+(sha1(keeda+user_id)的后16位) *int:user_id=1000#用戶ID，0表示無 <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## 發送模板消息 ~~~[api] post:/abacus/template *string:list=[]#消息列表，json格式 [{"user_id":"接收消息的用戶Id", "type":"模板類型 report-日報，system-系統消息", "url":"消息鏈接", "data":"消息數據"} ] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]查詢商品信息 ~~~[api] post:/Keeda/fetchGoods *string:alias=v9988#客易達系統標識 *string:sn=8689097168273223#串碼 *int:type=1#銷售類型 1-售出，2-退貨 *int:search=1#查詢方式 1-掃碼，2-模糊查找 *int:shop_id=1000#銷售門店ID <<< success { "code": 0, "info": "成功", "data": [{ "goods_id":"商品ID", "goods_name":"商品名稱", "goods_sn":"商品碼", "price":"零售價", "type_id":"分類ID", "type_name":"分類名稱", "brand_id":"品牌ID", "brand_name":"品牌名稱", "sn":"小算盤首選串碼", "gid":"小算盤商品ID", "owner_id":"退贈品時歸屬id" }] } ~~~ ## [小算盤]新增會員卡訂單/同步會員卡訂單 ~~~[api] post:/Keeda/addCardOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#創建人ID *int:seller_id=1000#銷售員ID *int:owner_id=1000#會員歸屬員工ID *int:shop_id=1000#銷售門店ID *string:create_date=2019-04-22#銷售日期 *int:member_id=1000#會員ID *string:member_name=張三#會員姓名 *string:member_phone=13388996677#會員電話 *string:remark=備注#訂單備注 *string:pay_info=[]#付款信息，json格式 [{"kind_id":"分類ID"},{"payment_id":"支付方式ID", "money": "金額"}] *string:cards=[]#會員卡信息，json格式 [{"card_id":"會員卡Id", "card_name":"會員卡名稱", "state":"類型 -1-退貨，1-售出", "price":"零售價(實際售價)"} ] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]撤銷會員卡訂單 ~~~[api] post:/Keeda/delCardOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#操作人ID <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]會員卡訂單跳轉小算盤 ~~~[api] get:/Keeda/keedaCardOrder *int:id=10000#訂單ID <<< success 無 ~~~ ## [小算盤]獲取支付方式 ~~~[api] post:/Keeda/fetchPayment *string:alias=v9988#客易達系統標識 *int:shop_id=100#門店ID *int:user_id=1000#操作人ID *int:scene=1#場景 1-銷售下單，2-會員卡業務 <<< success { "code": 0, "info": "成功", "data": [{ "kind_id":"分類ID", "kind_name":"分類名稱", "payments":[{ "payment_id":"支付方式ID", "payment_name":"支付方式名稱" }] }] } ~~~ > 特殊約定的支付方式 > > * 積分抵扣 1 > * 余額支付 2 > * 現金券抵扣 3 > * 欠賬 4 ## [小算盤]獲取欠賬人信息 ~~~[api] post:/Keeda/fetchDebt *string:alias=v9988#客易達系統標識 *int:shop_id=100#門店ID *int:user_id=1000#操作人ID *int:scene=1#場景 1-銷售下單，2-會員卡業務 <<< success { "code": 0, "info": "成功", "data": [{ "payment_id":"欠賬人ID", "payment_name":"欠賬人名稱" }] } ~~~ ## [客e達]獲取會員等級接口 ~~~[api] post:/abacus/memberlevel <<< success { "code": 0, "info": "成功", "data": [{ "id": 1, "name": "普通會員", "sort": 1, "discount": 90, "price": "0.00" }, { "id": 22, "name": "白銀會員", "sort": 11, "discount": 98, "price": "66.0" }], } <<< error ~~~ ## [客e達]分潤提交到客e達 ~~~[api] post:/abacus/profit *string:list=[]#支付列表，json格式 [{"id":"記錄Id", "user_id":"員工id", "remark":"描述", "type":"-1刪除記錄，1主動收益，2被動收益", "money":"金額","is_pay":"1立即支付，0不支付"}] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]分潤支付狀態回報 ~~~[api] post:/Keeda/profitPay *string:list=[]#支付列表，json格式 [{"id":"記錄Id", "pay_about":"微信支付返回狀態或支付失敗原因", "pay_date":"支付時間", "pay_status":"0未支付，1支付成功，2支付失敗", "pay_type":"0為客e達支付系統，1.為客戶自己的支付系統","keeda_profit_id":"客e達記錄id","money":"實際支付金額"}] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]獲取當前分潤信息 ~~~[api] post:/Keeda/fetchUserProfit *string:alias=v9988#客易達系統標識 *int:user_id=1000#要查詢的用戶ID <<< success { "code": 0, "info": "成功", "data": { "user_id":"用戶ID", "day_profit":"今日分潤", "month_profit":"本月分潤" } } ~~~ ## [小算盤]獲取分潤記錄 ~~~[api] post:/Keeda/fetchUserProfitRecord *string:alias=v9988#客易達系統標識 *int:user_id=1000#要查詢的用戶ID *string:begin_date=2019-08-01#起始日期 *string:end_date=2019-08-08#結束日期 *int:limit=10#每頁數量 *int:page=1#第幾頁 <<< success { "code": 0, "info": "成功", "data": { "user_id":"用戶ID", "count":"總數量", "info":{ "all":10, "allmoney":100, "zhu":7, "zhumoney":70, "bei":3, "beimoney":30 }, "list":[{ "user_id":1000, "money":10, "create_date":"2019-08-01", "type":1, "remark":"描述" }] } } ~~~ ## [客e達]會員信息查詢 ~~~[api] post:/abacus/fetchMember *int:type=0手機號或卡號或id，1會員id,2會員卡號,3手機號#類型 *array:list=[]#列表 <<< success { "code": 0, "info": "成功", "data": [{ "id": 98, "phone": "", "member_name": "藝商阿良", "member_card": 80000122, "score": 0, "total_score": 0, "join_date": "2018-04-26", "user_id": 1010, "shop_id": 1, "sex": 1, "birthday": null, "sn": "", "flag": 1, "flag_time": 1547603587, "wechat_user_id": 98, "wechat_card": 0, "state": 0, "level": 1, "balance": 0, "set_phone": "", "set_name": "", "set_birthday": null, "set_sex": 0, "set_sn": "", "come": 3, "level_end_time": 0, "one_openid": "orXc50mCrGHQNBRQK7PvBvDxgsBs", "is_new": 1, "abacus_user_id": 1000 }], "ver": "1.3.5" } ~~~ ## [小算盤]獲取運營商業務列表 ~~~[api] post:/Keeda/fetchMobileList *string:alias=v9988#客易達系統標識 <<< success { "code": 0, "info": "成功", "data": { "mobiles":[{ "name":"飛享38(中國移動/新入網)", "mobile_id":100, "money_type":1// 1-固定酬金，2-自填酬金 }], "eids":[{ "eid_id":1000, "name":"EE409872(中國移動/一店移動)" }] } } ~~~ ## [小算盤]獲取退貨運營商業務 ~~~[api] post:/Keeda/fetchBackMobile *string:alias=v9988#客易達系統標識 *string:shop_id=100#門店ID *string:mid=1290#業務ID，0表示獲取最近一周業務 <<< success { "code": 0, "info": "成功", "data": [{ "mid":1290, "mobile_name":"飛享38(中國移動/新入網)", "mobile_id":100, "eid_name":"EE409872(中國移動/一店移動)", "eid_id":100, "phone":"13468821993", "sn":"610521198002091290", "out_price":100 }] } ~~~ ## [客e達]同步訂單審核狀態 ~~~[api] post:/api/v1/abacus/orderVerify *string:orders=[]#訂單列表，json格式 [{"id":"訂單Id", "abacus_verify":"1-已審核，0-未審核"} ] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]收/退會員預付款 ~~~[api] post:/Keeda/addBalanceOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#創建人ID *int:shop_id=1000#銷售門店ID *string:create_date=2019-04-22#銷售日期 *int:type=1#類型，1-收，2-退 *int:money=1000#預付款金額 *int:member_id=1000#會員ID *string:member_name=張三#會員姓名 *string:member_phone=13388996677#會員電話 *string:remark=備注#訂單備注 *string:pay_info=[]#付款信息，json格式 [{"kind_id":"分類ID"},{"payment_id":"支付方式ID", "money": "金額"}] <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]撤銷預付款訂單 ~~~[api] post:/Keeda/delBalanceOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#操作人ID <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [客e達]同步預付款 ~~~[api] post:/api/v1/abacus/synBalance *string:list=[]#訂單列表，json格式 [{"phone":"會員手機號", "balance":"預付款金額"} ] <<< success { "code": 0, "info": "成功", "data": [{"phone":"會員手機號", "balance":"預付款金額"} ] } ~~~ ## [小算盤]新增兌換券核銷訂單 ~~~[api] post:/Keeda/addCouponOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#創建人ID *int:seller_id=1000#銷售員ID *int:shop_id=1000#銷售門店ID *string:create_date=2019-04-22#銷售日期 *int:member_id=1000#會員ID *string:member_name=張三#會員姓名 *string:member_phone=13388996677#會員電話 *string:remark=備注#訂單備注 *int:goods_id=1000#商品ID *string:coupon_info=[]#券信息，json格式{"id":"券ID", "name": "券名稱"} <<< success { "code": 0, "info": "成功", "data": [] } ~~~ ## [小算盤]撤銷兌換券核銷訂單 ~~~[api] post:/Keeda/delCouponOrder *string:alias=v9988#客易達系統標識 *int:order_id=10001#訂單ID *int:user_id=1000#操作人ID <<< success { "code": 0, "info": "成功", "data": [] } ~~~