某宝开放平台(Taobao Open Platform)是基于各类电子商务业务的开放平台,提供外部合作伙伴参与服务用户的各类原材料,如业务API、账号体系、数据推送,奇门网关等。它是大电子商务基础服务的重要开放途径,将推动各行各业定制、创新、进化,并最终促成新商业文明生态圈的建立。我们的使命是把某宝网的商品、用户、交易、物流等一系列电子商务基础服务,像水、电、煤一样输送给有需要的商家、开发者、社区媒体和各行各业。
很多电商系统的需求场景,都面临某宝开放平台的接入,但这也是让不少开发者头疼的问题。
那么,如何快速接入呢?我的对接经验相信可以帮到不少开发者,快速接入、少走弯路。
首先,某宝开放平台的API分几个大的版块,核心版块如"交易API"、"物流API"等能力,最常用的接口能力如下:
交易API
taobao.trades.sold.get( 查询卖家已卖出的交易数据(根据创建时间) )
taobao.trade.get( 获取单笔交易的部分信息(性能高) )
taobao.trade.memo.add( 对一笔交易添加备注 )
taobao.trade.memo.update( 修改交易备注 )……
物流API
taobao.areas.get( 查询地址区域 )
taobao.logistics.companies.get( 查询物流公司信息 )
taobao.logistics.address.search( 查询卖家地址库 )
taobao.logistics.offline.send( 自己联系物流(线下物流)发货 )……
评价API
taobao.traderates.get( 搜索评价信息 )
taobao.traderate.add( 新增单个评价 )……
2.其次,结合自己的业务的实际情况,需要哪些对口API
从官方文档来看,不少接口/能力需要“用户授权”。很多开发者/公司也尝试申请ISV服务商应用,也卡在这个环节。其实,阿里开放平台早已关闭ISV R2及以上的申请接入。不少开发者,在这个上面浪费了巨大的时间、精力。
最后,以某宝订单数据代码结尾
{"trades_sold_get_response":{"total_results":100,"trades":{"trade":[{"seller_nick":"我在测试","buyer_open_uid":"AAHk5d-EAAeGwJedwSFu0XXX","title":"麦包包","type":"fixed(一口价)","created":"2000-01-01 00:00:00","tid":2231958349,"acookie_id":"1a11a0987628772c002ec7d0eec2a352","sid":"NP1021246146","seller_rate":true,"buyer_rate":true,"status":"TRADE_NO_CREATE_PAY","payment":"200.07","discount_fee":"200.07","adjust_fee":"200.07","post_fee":"200.07","total_fee":"200.07","pay_time":"2000-01-01 00:00:00","end_time":"2000-01-01 00:00:00","modified":"2000-01-01 00:00:00","async_modified":"2000-01-01 00:00:00","consign_time":"2000-01-01 00:00:00","received_payment":"200.07","commission_fee":"200.07","alipay_no":"2009112081173831","alipay_id":2011082299567459,"buyer_area":"浙江省杭州市","nut_feature":";buyernick:tester;card:123;buyerArea:杭州","pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg","num_iid":3424234,"price":"200.07","cod_fee":"12.07","cod_status":"EW_CREATED(订单已创建)","shipping_type":"free","num":1,"point_fee":0,"real_point_fee":0,"buyer_obtain_point_fee":0,"receiver_name":"****东方","receiver_state":"浙江省","receiver_city":"杭州市","receiver_district":"西湖区","receiver_town":"三墎镇","receiver_address":"****淘宝城","receiver_zip":"223700","receiver_mobile":"****1826","receiver_phone":"****5372","seller_flag":1,"is_lgtype":true,"lg_aging_type":"次日达","lg_aging":"2012-06-19 15:16:14","is_brand_sale":true,"is_force_wlb":true,"has_buyer_message":true,"credit_card_fee":"30.5","trade_from":"WAP,JHS","step_trade_status":"FRONT_NOPAID_FINAL_NOPAID","step_paid_fee":"525.70","mark_desc":"该订单需要延长收货时间","has_yfx":true,"yfx_fee":"0.50","yfx_id":"135751716473138","yfx_type":"taojinbi","trade_source":"ownshop","send_time":"2000-01-01","seller_can_rate":true,"is_part_consign":true,"is_wt":true,"is_daixiao":true,"o2o":"crm","o2o_guide_id":"123456","o2o_guide_name":"西湖门店导购员1","o2o_shop_id":"123456","o2o_shop_name":"西湖门店","o2o_delivery":"inshop","o2o_out_trade_id":"123456","orders":{"order":[{"title":"山寨版测试机器","pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg","price":"200.07","num_iid":2342344,"sku_id":"5937146","outer_iid":"152e442aefe88dd41cb0879232c0dcb0","outer_sku_id":"81893848","refund_status":"SUCCESS(退款成功)","status":"TRADE_NO_CREATE_PAY","oid":2231958349,"total_fee":"200.07","payment":"200.07","discount_fee":"200.07","adjust_fee":"1.01","divide_order_fee":"21.00","part_mjz_discount":"21.00","sku_properties_name":"颜色:桔色;尺码:M","item_meal_id":2564854632,"item_meal_name":"M8原装电池:便携支架:M8专用座充:莫凡保护袋","num":1,"buyer_rate":true,"seller_rate":true,"refund_id":"2231958349","seller_type":"B(商城商家)","cid":123456,"end_time":"2012-04-07 00:00:00","consign_time":"2013-01-13 15:23:00","shipping_type":"post","logistics_company":"顺风快递","invoice_no":"05432465","bind_oid":23194074143138,"is_daixiao":true,"ticket_outer_id":"123456abcd","ticket_expdate_key":"100FFFFFF02374020000002001020304000A","is_www":true,"store_code":"南京QDHEWL-0004","tmser_spu_code":"家装干支装服务","sub_order_tax_fee":"0","sub_order_tax_rate":"0","zhengji_status":"1","md_qualification":"true_access","md_fee":"999","sub_order_tax_promotion_fee":"0","tax_free":true,"tax_coupon_discount":"0","special_refund_type":"priceProtect","is_devalue_fee":true,"is_idle":"1","promise_collect_time":"2000-01-01 00:00:00","is_force_dc":true,"shp_info":{"ship_info":[{"transport_type":"express,seller,instant等"}]}}]},"service_orders":{"service_order":[{"oid":110770592823138,"item_oid":110770592803138,"service_id":2342344,"service_detail_url":"http:\/\/wt.taobao.com\/plan.htm?plan_id=planId","num":1,"price":"39.09","payment":"29.98","title":"滚筒洗衣机","total_fee":"39.09","buyer_nick":"小倩2005","refund_id":"2231958349","seller_nick":"麦包包","pic_path":"http:\/\/img08.taobao.com\/bao\/upload\/i8\/T1jVXXXePb_a0908.jpg","tmser_spu_code":"家装干支装服务"}]},"zero_purchase":true,"receiver_country":"中国","order_tax_fee":"0","shop_pick":"1","rx_audit_status":"0","post_gate_declare":true,"cross_bonded_declare":true,"order_tax_promotion_fee":"0","service_type":"timedd,jiaju","is_o2o_passport":true,"tmall_delivery":true,"threepl_timing":true,"cn_service":"84_50","cutoff_minutes":"660","es_time":"4","delivery_time":"2018-06-09 12:13:14","collect_time":"2018-06-09 12:13:14","dispatch_time":"2018-06-09 12:13:14","sign_time":"2018-06-09 12:13:14","delivery_cps":"STO","es_range":"09:00-12:00","es_date":"2018-06-09","os_range":"09:00-12:00","os_date":"2018-06-09","asdp_biz_type":"logistics_upgrade","asdp_ads":"201","drug_register":"1","promise_sign_time":"2000-01-01 00:00:00","oaid":"2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc","scenario_group":"TXD_B2C_FRESH_HALFDAY","is_force_dc":true,"buyer_nick":"我在测试"}]},"has_next":true}
















