交易 API

提供了订单下载，修改收货地址、修改交易备注等功能

class pyTOP.trade.PromotionDetail(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

交易的优惠信息详情

class pyTOP.trade.OrderAmount(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

子订单的帐务数据结构

class pyTOP.trade.Order(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

订单结构

ordersku_update(oid, sku_id=None, sku_props=None)

taobao.trade.ordersku.update 更新交易订单的销售属性

需要商家或以上权限才可调用此接口，可重复调用本接口更新交易备注，本接口同时具有添加备注的功能

class pyTOP.trade.TradeAmount(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

交易订单的帐务信息详情

get(tid, session, fields=[])

taobao.trade.amount.get 交易订单帐务查询

卖家查询该笔交易订单的资金帐务相关的数据

• 1. 只供卖家使用，买家不可使用
• 2. 可查询所有的状态的订单，但不同状态时订单的相关数据可能会有不同

class pyTOP.trade.TradeAccountDetail(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

淘宝卖家绑定的支付宝账户的财务明细

class pyTOP.trade.Task(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

批量异步任务结果

accountreport_get(start_created, end_created, session, fields=[])

taobao.topats.trade.accountreport.get 异步获取淘宝卖家绑定的支付宝账户的财务明细

• 1.提供异步下载用户支付宝对账信息接口
• 2.一次调用最多支持下载3个月的对账信息
• 3.仅能获取2010年6月10日以后的信息
• 4.提交任务会进行初步任务校验，如果成功会返回任务号和创建时间，如果失败就报错
• 5.可以接收淘宝发出的任务完成消息，也可以过一段时间来取结果。获取结果接口为taobao.topats.result.get
• 6.支付宝证书签名方法见文档：“http://open.taobao.com/dev/index.php/如何数字证书签名”
• 7.此api执行完成发送的通知消息格式为{“task”:{“task_id”:123456,”created”:”2010-8-19”}}
• 8.此任务是大数据任务，获取任务结果时只能得到下载url
• 9.子任务结果解析见TradeAccountDetail结构体说明
• 10.此接口执行任务时间段为：00:00:00-09:30:00;11:00:00-14:00:00;17:00:00-20:00:00;22:30:00-23:59:59，只有在这段时间内才能返回查询结果

fullinfo_get(tids, session, fields=[])

taobao.topats.trades.fullinfo.get 异步批量获取交易订单详情api

使用指南：http://open.taobao.com/dev/index.php/ATS%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97 - 1.提供异步批量获取订单详情功能 - 2.一次调用最多支持40个订单 - 3.提交任务会进行初步任务校验，如果成功会返回任务号和创建时间，如果失败就报错 - 4.可以接收淘宝发出的任务完成消息，也可以过一段时间来取结果。获取结果接口为taobao.topats.result.get - 5.此api执行完成发送的通知消息格式为{“task”:{“task_id”:123456,”created”:”2010-8-19”}}果

get(task_id)

taobao.topats.result.get 获取异步任务结果

使用指南：http://open.taobao.com/doc/detail.htm?id=30

• 1.此接口用于获取异步任务处理的结果，传入的task_id必需属于当前的appKey才可以
• 2.此接口只返回执行完成的任务结果，未执行完的返回结果里面不包含任务结果，只有任务id，执行状态
• 3.执行完成的每个task的子任务结果内容与单个任务的结果结构一致。如：taobao.topats.trades.fullinfo.get返回的子任务结果就会是Trade的结构体。

class pyTOP.trade.Trade(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

交易结构

close(tid, close_reason, session)

taobao.trade.close 卖家关闭一笔交易

关闭一笔订单，可以是主订单或子订单。

fullinfo_get(tid, session, fields=[])

taobao.trade.fullinfo.get 获取单笔交易的详细信息

获取单笔交易的详细信息

• 1.只有在交易成功的状态下才能取到交易佣金，其它状态下取到的都是零或空值
• 2.只有单笔订单的情况下Trade数据结构中才包含商品相关的信息
• 3.获取到的Order中的payment字段在单笔子订单时包含物流费用，多笔子订单时不包含物流费用 注：包含以下字段的返回会增加TOP的后台压力，请仅在确实需要的情况下才去获取：commission_fee, buyer_alipay_no, seller_alipay_no, buyer_email, seller_mobile, seller_phone, seller_name, seller_email, timeout_action_time, item_memo, trade_memo, title, available_confirm_fee

get(tid, session, fields=[])

taobao.trade.get 获取单笔交易的部分信息(性能高)

获取单笔交易的部分信息

memo_add(tid, memo, session, flag=None)

taobao.trade.memo.add 对一笔交易添加备注

根据登录用户的身份（买家或卖家），自动添加相应的交易备注,不能重复调用些接口添加备注，需要更新备注请用taobao.trade.memo.update

memo_update(tid, session, memo=None, flag=None, reset=None)

taobao.trade.memo.update 修改一笔交易备注

需要商家或以上权限才可调用此接口，可重复调用本接口更新交易备注，本接口同时具有添加备注的功能

postage_update(tid, post_fee, session)

taobao.trade.postage.update 修改订单邮费价格

修改订单邮费接口，通过传入订单编号和邮费价格，修改订单的邮费，返回修改时间modified,邮费post_fee,总费用total_fee。

receivetime_delay(tid, days, session)

taobao.trade.receivetime.delay 延长交易收货时间

延长交易收货时间

shippingaddress_update(tid, session, **kwargs)

taobao.trade.shippingaddress.update 更改交易的收货地址

snapshot_get(tid, session, fields=['snapshot'])

taobao.trade.snapshot.get 交易快照查询

交易快照查询 目前只支持类型为“旺店标准版(600)”或“旺店入门版(610)”的交易 对于“旺店标准版”类型的交易，返回的snapshot字段为交易快照编号 对于“旺店入门版”类型的交易，返回的snapshot字段为JSON结构的数据(其中的shopPromotion包含了优惠，积分等信息）

class pyTOP.trade.Trades(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

批量异步任务的子任务结果

bought_get(session, fields=[], **kwargs)

taobao.trades.bought.get 搜索当前会话用户作为买家达成的交易记录

搜索当前会话用户作为买家达成的交易记录(目前只能查询三个月以内的订单)

sold_get(session, fields=[], **kwargs)

taobao.trades.sold.get 搜索当前会话用户作为卖家已卖出的交易数据

搜索当前会话用户作为卖家已卖出的交易数据(只能获取到三个月以内的交易信息)

sold_increment_get(session, fields=[], **kwargs)

taobao.trades.sold.increment.get 搜索当前会话用户作为卖家已卖出的增量交易数据

• 1. 搜索当前会话用户作为卖家已卖出的增量交易数据
• 2. 只能查询时间跨度为一天的增量交易记录：start_modified：2011-7-1 16:00:00 end_modified： 2011-7-2 15:59:59（注意不能写成16:00:00）
• 3. 返回数据结果为创建订单时间的倒序
• 4. 只能查询3个月内修改过的数据，超过这个时间的数据无法通过taobao.trade.fullinfo.get获取详情。

class pyTOP.trade.Subtask(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

批量异步任务的子任务结果

class pyTOP.trade.TradeConfirmFee(API_KEY=None, APP_SECRET=None, ENVIRONMENT=None)

确认收货费用结构

get(tid, is_detail, session)

taobao.trade.confirmfee.get 获取交易确认收货费用

获取交易确认收货费用 可以获取主订单或子订单的确认收货费用

---

• Index
• Module Index
• Search Page