物流 API

提供了发货，物流单详情，区域地址和物流公司信息查询功能

class logistics.TransitStepInfo(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

物流跟踪信息的一条

class logistics.Area(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

地址区域结构

class logistics.DeliveryTemplate(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

运费模板对象

add(name, assumer, valuation, template_types, template_dests, template_start_standards, template_start_fees, template_add_standards, template_add_fees, session)

taobao.delivery.template.add 新增运费模板

新增运费模板

delete(template_id, session)

taobao.delivery.template.delete 删除运费模板

根据用户指定的模板ID删除指定的模板

get(template_ids, session, fields=[])

taobao.delivery.template.get 获取用户指定运费模板信息

获取用户指定运费模板信息

update(template_id, assumer, template_types, template_dests, template_start_standards, template_start_fees, template_add_standards, template_add_fees, session, name=None)

taobao.delivery.template.update 修改运费模板

修改运费模板

class logistics.DeliveryTemplates(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

运费模板对象

get(session)

taobao.delivery.templates.get 获取用户下所有模板

根据用户ID获取用户下所有模板

class logistics.PartnerDetail(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

物流公司详细信息

class logistics.LogisticsCompany(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

物流公司基础数据结构

class logistics.LogisticsCompanies(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

get(session, is_recommended=None, order_mode=None, fields=[])

taobao.logistics.companies.get 查询物流公司信息

查询淘宝网合作的物流公司信息，用于发货接口。

class logistics.PostageMode(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

运费方式模板收费方式

class logistics.Shipping(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

物流数据结构

class logistics.TopFee(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

运费模板中运费信息对象

class logistics.Postage(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

运费模板结构

add(name, session, **kwargs)

taobao.postage.add 添加邮费模板

添加邮费模板

新增的邮费模板属于当前会话用户

postage_mode_types、postage_mode_dests、postage_mode_prices、 postage_mode_increases四个字段组合起来表示邮费的子模板列表。每个邮费子模板都包含了type（邮费类型，有post、 express、ems可以选择）、dest（邮费模板应用地区，每个模板可以使用于多个地区，每个地区填入他的代码，地区与地区之间用半角逗号分隔）、 price（邮费基价）、increment（邮费增价）四个部分。如果有多个子模板，则将他们的4个部分分别组合，之间用半角分号隔开（注意每个模板的每个部分的位置要一样。即，子模板1号的type、dest、price、increment都要排在这四个参数的第一位；子模板2号要排在第二位……以此类推）

delete(postage_id, session)

taobao.postage.delete 删除单个运费模板

删除单个邮费模板 postage_id对应的邮费模板要属于当前会话用户

get(postage_id, nick, fields=[])

taobao.postage.get 获取单个运费模板

获取单个邮费模板

postage_id对应的邮费模板要属于nick所对应的用户

• Q：是否必须是模板所有者才能够使用这个接口?
• A： 不是的,只要给出了邮费模板id和创建者的昵称就可以使用

update(postage_id, session, **kwargs)

taobao.postage.update 修改邮费模板

• 修改邮费模板
• 修改的邮费模板属于当前会话用户
• 修改的邮费子模板要传入子模板id，否则作为添加子模板处理。postage_mode_types、 postage_mode_dests、postage_mode_prices、postage_mode_increases四个字段的处理逻辑见 taobao.postage.add中的描述

class logistics.Postages(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

get(session, fields=[])

taobao.postages.get 获取卖家的运费模板

获得当前会话用户的所有邮费模板

class logistics.AddressResult(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

地址库返回数据信息

class logistics.LogisticsPartner(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

查询揽送范围之内的物流公司信息

class logistics.LogisticsPartners(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

查询揽送范围之内的物流公司信息

get(service_type, source_id=None, target_id=None, goods_value=None)

taobao.logistics.partners.get 查询支持起始地到目的地范围的物流公司

查询物流公司信息（可以查询目的地可不可达情况）

class logistics.LogisticsAddress(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

add(contact_name, province, city, addr, session, **kwargs)

taobao.logistics.address.add 卖家地址库新增接口

通过此接口新增卖家地址库,卖家最多可添加5条地址库,新增第一条卖家地址，将会自动设为默认地址库

modify(contact_id, contact_name, province, city, addr, session, **kwargs)

taobao.logistics.address.modify 卖家地址库修改

卖家地址库修改

remove(contact_id, session)

taobao.logistics.address.remove 删除卖家地址库

用此接口删除卖家地址库

search(session, rdef=None)

taobao.logistics.address.search 查询卖家地址库

通过此接口查询卖家地址库，

class logistics.LogisticsDummy(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

send(tid, session, feature=None)

taobao.logistics.dummy.send 无需物流（虚拟）发货处理

用户调用该接口可实现无需物流（虚拟）发货,使用该接口发货，交易订单状态会直接变成卖家已发货

class logistics.LogisticsOffline(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

send(tid, out_sid, company_code, session, sender_id=None, cancel_id=None, feature=None)

taobao.logistics.offline.send 自己联系物流（线下物流）发货

用户调用该接口可实现自己联系发货（线下物流），使用该接口发货，交易订单状态会直接变成卖家已发货。不支持货到付款、在线下单类型的订单。

class logistics.LogisticsOnline(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

cancel(tid, session)

taobao.logistics.online.cancel 取消物流订单接口

调此接口取消发货的订单，重新选择物流公司发货。前提是物流公司未揽收货物。对未发货和已经被物流公司揽收的物流订单，是不能取消的。

confirm(tid, out_sid, session)

taobao.logistics.online.confirm 确认发货通知接口

确认发货的目的是让交易流程继承走下去，确认发货后交易状态会由【买家已付款】变为【卖家已发货】，然后买家才可以确认收货，货款打入卖家账号。货到付款的订单除外

send(tid, company_code, session, **kwargs)

taobao.logistics.online.send 在线订单发货处理（支持货到付款）

• 用户调用该接口可实现在线订单发货（支持货到付款）
• 调用该接口实现在线下单发货，有两种情况：
• 如果不输入运单号的情况：交易状态不会改变，需要调用taobao.logistics.online.confirm确认发货后交易状态才会变成卖家已发货。
• 如果输入运单号的情况发货：交易订单状态会直接变成卖家已发货 。

class logistics.Orders(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

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

taobao.logistics.orders.detail.get 批量查询物流订单,返回详细信息

查询物流订单的详细信息，涉及用户隐私字段。（注：该API主要是提供给卖家查询物流订单使用，买家查询物流订单，建议使用taobao.logistics.trace.search）

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

taobao.logistics.orders.get 批量查询物流订单

批量查询物流订单。（注：该API主要是提供给卖家查询物流订单使用，买家查询物流订单，建议使用taobao.logistics.trace.search）

class logistics.LogisticsTrace(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

search(tid, seller_nick)

taobao.logistics.trace.search 物流流转信息查询

用户根据淘宝交易号查询物流流转信息，如2010-8-10 15：23：00到达杭州集散地

class logistics.TopatsDelivery(API_KEY=None, APP_SECRET=None, ENVIRONMENT='sandbox')

运费模板结构

send(tids, session, **kwargs)

taobao.topats.delivery.send 异步批量物流发货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”}}

---

• Index
• Module Index
• Search Page