eBayAPI开发简介

NHibernate,Nhibernate简介,Nhibernate第一个DEMO,Nhibernate生命周期,NHibernate映射关系,Nhibernate查询语句,*,*,eBay API开发简介,Email:,1,eBay介绍,eBay是全球最大的网上交易平台,淘宝与其类似,卖家可以注册进入售卖,买家可以位于世界各地。,2,eBay站点,22个站点,大体是根据国家来分,有的国家有两种语言,可以有两个站点,其中比较特殊的是eBayMotors站点,主要售卖汽车/摩托车及其配件。,每个站点有一个唯一的ID,和Globel-ID,分别用于不同的API,每个站点有自己使用的币种,eBay子公司,Paypal 在线支付平台,S 区域交易平台,H 书籍、音乐、影片、游戏等交易平台,3,eBay售卖类型,售卖方法ListingType 主要有一口价和拍卖两种,eBay售卖叫做刊登,刊登上去的产品叫Item,每个Item有全球唯一的Item ID,不管拍卖、一口价,到期都会下架,刊登成功以后不能修改刊登状态,但可以修改时限,4,eBay一口价/固定价,FixedPriceItem/StoredFixedPrice（店铺,已经合并为FixedPriceItem）,有时间限制,一般分成3天、7天、15天、30天、GTC(Good Til Cancel)等,GTC比较特殊,每隔30天会自动Relist重登,重登后Item ID会改变,GTC在 数量=0 时自动下架,一口价与拍卖最主要的不同点：一口价支持Variation刊登,即多属性刊登,拍卖不支持,5,eBay拍卖,Auction,也有时间限制,一般分成3天、7天、15天等,在时限范围内出价最高者胜出,拍卖可以设置BestOffer议价（即还价,还价可以设置自动接受/拒绝的底价）,也可以设置一口价（允许买家拍卖、或直接一口价买下）,当被一口价买下立即下架,6,eBay Item状态,在线 Active,已售出 Completed,售出并不一定代表成功付款,已下线 Ended,每个Item一上线即被记录 StartTime,下架时记录 EndTime,7,eBay分类,每个站点的分类都不一样,在站点内,分类具有唯一ID,不同分类开启了不同的功能,比方是否支持Variation/Specification/BestOffer/Condition必填等,所有设置都是API返回,刊登时可以选择两个分类,所有功能设置以主分类为主。,8,eBay属性(Specification),属性=分类属性,即在该分类下产品都有的特性。属性的设置优化了eBay网站的精确筛选。,不同的分类有不同的属性,具体选项由API返回。,9,eBay多属性(Variation),多属性刊登=SellerCube里的POA设置,即一个产品拥有多种颜色、尺寸,可以由顾客选择购置。,Variation包括三局部：VariationSpecificsSet(VSS)、Variation(V)、Pictures(P）,VSS：所有属性的名值对,V：单个产品的所有属性,包括了SKU、数量、售价,P:所有图片,当在eBay网站切换属性时,图片会相应改变,10,eBay买家如何收款?,所有eBay站点必须使用Paypal收款,Paypal是全球最大的支付工具之一,Paypal是eBay子公司。,开通eBay账号后,必须绑定Paypal账号才能刊登产品,刊登后产生的费用和成功的费用都直接转入Paypal。,Paypal账号是一个邮件地址,11,eBay如何处理发货？,每个站点拥有一定数量的系统定义运输方式可选,运输方式分本地、国际,需由API定期同步。,顾客购置时先选择运输方式,生成交易/订单时会保存选择的运输方式。,12,eBay运输方式,运输方式拥有唯一代码,可以设置运费/免运费,还可以设置额外费用AdditionalCost,外乡运输方式有一个特殊的费用Surcharge,仅针对使用UPS/FedEx发往Alaska、Hawaii、Puerto Rico,要求是US站点或eBayMotors站点的Parts and Accessories分类下的产品。,国际运输方式还可以单独设置发往地,13,eBay限制发往地,发往地区 ShipToLocations,只发往选择内的地区,排除发往地区 ExcludeShipToLocation,限制发往选择内的地区,国际运输方式内的ShipToLocation,单独设置每个运输方式发往地区,14,eBay订单是怎样的?1/2,订单称为Order/交易Transaction,当有多条时称为Order,当只有单条时称为Transaction,不区分主单与明细,由TransactionID+ItemID来区分是否唯一,最新版本使用OrderLineItemID一个字段来表示,它合并了上面两个字段,顾客在哪个站点上购置 TransactionSiteID,购置数量 QuantityPurchased,付款时间 PaidTime,最近修改时间 LastTimeModified,15,eBay订单是怎样的?2/2,付款状态,CheckoutStatus,CheckoutComplete,付款完成,CheckoutIncomplete,付款未完成,BuyerRequestsTotal,买家要求合并订单,SellerResponded,卖家已回复,完成状态,CompleteStatus,Complete,已完成,Incomplete,未完成,Pending,等待中,支付状态,eBayPaymentStatus,NoPaymentFailure,无错误,BuyerCreditCardFailed,信用卡错误,BuyerECheckBounced,电子支票打回,BuyerFailedPaymentReportedBySeller,卖家拒绝,PaymentInProcess,处理中,PayPalPaymentInProcess Paypal,处理中,16,eBay名称解释1,SYI(Sell Your Item)=刊登,RYI(Revise Your Item)=修改,Relist=重登,ItemID=全球唯一Item ID,Transaction=订单/交易,Site=站点,Location=发货地(其实是Country,只是内部使用),真实发货地由Country/PostalCode/Location组成,17,eBay名称解释2,ListingType=刊登类型,Duration=刊登时间限制,ListingStatus=刊登状态,Relist=基于原来的Item,重新发布,原来的Item会注明RelisedItemID,新Item会带上RelistParentID,StartPrice=一口价时的售价,拍卖里的竞拍价,BuyItNowPrice(BIN)=拍卖时的一口价,ReservePrice=底价,18,eBay名称解释3,BestOffer=议价,Condition=物品状态（新/旧/.）,DispatchTimeMax=发货天数,即处理订单到发货的时间,发货信息必须回传到eBay,GetItFast=快速寄运=一天发货,Category=分类,有两个PrimaryCategory+SecondaryCategory,一般只填一个,StoreCategory=店铺分类,有两个,19,eBay名称解释4,HitCounter=点击计数器,HitCount=点击次数,Specification=属性,ListingEnhancement=推广/广告功能,如加粗字体,加框等,Quantity=刊登数量,QuantityAvailable=可用数量,刊登数量 已售出数量,Bidder=拍卖竞标,Markdown=PromotionalSale=折扣,20,eBay API平台概览,Finding API 搜索,Trading API 最根本,使用最多的API,Platform Notifications API 通知平台,Large Merchant Services 大批量操作,Best Match API 排名,Product Services,21,什么是eBay API,eBay提供API,可供开发者构建可与eBay平台整合的应用程序。开发者可根据自身需求,在符合eBay标准的根底上开发出符合自身需求的应用。例如:可自定义刊登规则,批量操作等等。,22,使用eBay API能够实现哪些功能？,在eBay上搜索及购置商品,刊登商品、商品管理及库存管理,管理销售订单,与卖家、买家进行沟通,查看eBay账户情况,进行站点设置,使用eBay API,你可以开发出一套几乎重现eBay所有功能的应用程序！,23,eBay API可以制作哪些应用程序？,24,Trading API,创立新的在线商品,获取在线商品信息,获取eBay Category结构,获取与商品相关的事件,获取指定商品相关交易信息,获取指定卖家交易信息,获取用户信息,沟通及纠纷处理,提供了平安的、需要认证的平台,用于操作及获取用户数据。,25,eBay API的调用方式,调用分,SOAP/XML,两种方式,上传图片时必须使用,XML,方式,SOAP,测试环境,生产环境,XML,测试环境,生产环境,26,eBay API开发步骤,开发者网站：,申请开发者账号,得到DevID/AppID/CertID,进入沙盒环境申请模拟账号,获取授权令牌Token,建立工程,链接eBay API Web service,访问Web Service调用API,API Test Tool=开发者后台测试工具,大局部API需传入SiteID,以指定要操作是哪个站点,1,2,3,4,DevID,AppID,CertID,Token,Web Service Schema,Web Service API Call,27,eBay API开发正式授权流程,GetSessionID获取Session ID,使用Session ID构造URL,转到此URL,让用户登陆,用户登陆完成,点击“I Agrees,返回到程序页面（由开发者网站后台设置返回URL,必须为SSL）,通过传递回来的Secret ID+Session ID得到Token,1,2,3,4,GetSessionID URL FetchToken,登陆,I Agree,28,eBay API本卷须知,DetailLevel 用于控制返回信息,返回信息可以是Always/Conditionally,Always会一定返回,Conditionally会视DetailLevel的设置而决定是否返回,OutputSelector 用于控制需要返回的具体字段,建议使用,数据量越小快速越快。,Ack=请求返回状态,Success 成功,PartialSuccess 局部成功,Warning 警告,Failure 失败,Error=错误消息,ErrorCode 错误代号,LongMessage 长消息,ShortMessage 短消息,29,eBay授权相关API,GetSessionID 获取Session ID,FetchToken 得到Token,GetTokenStatus 获取Token状态,RevokeToken 取消授权,30,eBay刊登涉及的API,AddItem,AddFixedPriceItem,VerifyAddItem 验证,VerifyAddFixedPriceItem,RelistItem 重登,RelistFixedPriceItem,VerifyRelistItem,31,eBay结束刊登API,EndItem 下架,EndFixedPriceItem,EndItems,32,eBay获取Item资料API,GetItem 获取详细资料,GetItemsAwaitingFeedback