tbtrade

Documentation

Overview

Package tbtrade 包含淘宝交易API,相关方法

https://open.taobao.com/API.htm?docType=2&docId=62880

Index

• func TaobaoFulfillmentOrderAssemble(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopOaidClientDecrypt(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopOaidDecrypt(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopOaidMerge(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopOnceTokenGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopSecretAppkeyBillDetail(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopSecretBillDetail(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTopSecretExtend(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeAmountGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeClose(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeConfirmfeeGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeFullinfoGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeInvoiceAmountGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeMemoAdd(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeMemoUpdate(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeOrderskuUpdate(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradePostageUpdate(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeReceivetimeDelay(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradeShippingaddressUpdate(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradesSoldGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradesSoldIncrementGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradesSoldIncrementvGet(ctx context.Context, clt *core.SDKClient, ...) error
• func TaobaoTradesSoldQuery(ctx context.Context, clt *core.SDKClient, ...) error

Functions

func TaobaoFulfillmentOrderAssemble

func TaobaoFulfillmentOrderAssemble(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoFulfillmentOrderAssembleAPIRequest, resp *tbtrade.TaobaoFulfillmentOrderAssembleAPIResponse, session string) error

TaobaoFulfillmentOrderAssemble 拆合单结果回传接口 taobao.fulfillment.order.assemble

拆合单结果回传接口

func TaobaoTopOaidClientDecrypt

func TaobaoTopOaidClientDecrypt(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopOaidClientDecryptAPIRequest, resp *tbtrade.TaobaoTopOaidClientDecryptAPIResponse, session string) error

TaobaoTopOaidClientDecrypt 端侧OAID解密 taobao.top.oaid.client.decrypt

解码OAID(Open Addressee ID)，返回收件人信息。该接口用于客户端直接查看订单隐私数据，解密数据不经过ISV服务器，且包含风控等安全检测。

func TaobaoTopOaidDecrypt

func TaobaoTopOaidDecrypt(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopOaidDecryptAPIRequest, resp *tbtrade.TaobaoTopOaidDecryptAPIResponse, session string) error

TaobaoTopOaidDecrypt OAID解密 taobao.top.oaid.decrypt

解码OAID(Open Addressee ID)，返回收件人信息。

func TaobaoTopOaidMerge

func TaobaoTopOaidMerge(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopOaidMergeAPIRequest, resp *tbtrade.TaobaoTopOaidMergeAPIResponse, session string) error

TaobaoTopOaidMerge OAID订单合并 taobao.top.oaid.merge

基于OAID（收件人ID， Open Addressee ID)做订单合并，确保相同收件人信息的订单合并到相同组。

func TaobaoTopOnceTokenGet

func TaobaoTopOnceTokenGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopOnceTokenGetAPIRequest, resp *tbtrade.TaobaoTopOnceTokenGetAPIResponse, session string) error

TaobaoTopOnceTokenGet 网关一次性token获取 taobao.top.once.token.get

网关一次性token获取，对接文档:

func TaobaoTopSecretAppkeyBillDetail

func TaobaoTopSecretAppkeyBillDetail(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopSecretAppkeyBillDetailAPIRequest, resp *tbtrade.TaobaoTopSecretAppkeyBillDetailAPIResponse, session string) error

TaobaoTopSecretAppkeyBillDetail 服务商解密账单查询 taobao.top.secret.appkey.bill.detail

服务商解密账单查询,分页返回所有店铺的账单，每个店铺每天仅包含两条数据，当天产生的号租费 和 当天产生的通话费，仅对90天内的账单提供SLA保障。查询账单详情请使用taobao.top.secret.bill.detail接口。

func TaobaoTopSecretBillDetail

func TaobaoTopSecretBillDetail(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopSecretBillDetailAPIRequest, resp *tbtrade.TaobaoTopSecretBillDetailAPIResponse, session string) error

TaobaoTopSecretBillDetail 服务商的商家解密账单详情查询 taobao.top.secret.bill.detail

服务商的商家解密账单详情查询，仅对90天内的账单提供SLA保障。

func TaobaoTopSecretExtend

func TaobaoTopSecretExtend(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTopSecretExtendAPIRequest, resp *tbtrade.TaobaoTopSecretExtendAPIResponse, session string) error

TaobaoTopSecretExtend 虚拟号延期 taobao.top.secret.extend

虚拟号延期

func TaobaoTradeAmountGet

func TaobaoTradeAmountGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeAmountGetAPIRequest, resp *tbtrade.TaobaoTradeAmountGetAPIResponse, session string) error

TaobaoTradeAmountGet 交易帐务查询 taobao.trade.amount.get

卖家查询该笔交易的资金帐务相关的数据； 1. 只供卖家使用，买家不可使用 2. 可查询所有的状态的交易，但不同状态时交易的相关数据可能会有不同

func TaobaoTradeClose

func TaobaoTradeClose(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeCloseAPIRequest, resp *tbtrade.TaobaoTradeCloseAPIResponse, session string) error

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

关闭一笔订单，可以是主订单或子订单。当订单从创建到关闭时间小于10s的时候，会报“CLOSE_TRADE_TOO_FAST”错误。

func TaobaoTradeConfirmfeeGet

func TaobaoTradeConfirmfeeGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeConfirmfeeGetAPIRequest, resp *tbtrade.TaobaoTradeConfirmfeeGetAPIResponse, session string) error

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

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

func TaobaoTradeFullinfoGet

func TaobaoTradeFullinfoGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeFullinfoGetAPIRequest, resp *tbtrade.TaobaoTradeFullinfoGetAPIResponse, session string) error

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

获取单笔交易的详细信息 <br/>1. 只有单笔订单的情况下Trade数据结构中才包含商品相关的信息 <br/>2. 获取到的Order中的payment字段在单笔子订单时包含物流费用，多笔子订单时不包含物流费用 <br/>3. 获取红包金额使用字段：tmall_coupon_fee（天猫商家订单使用的红包金额） <br/>4. 请按需获取字段，减少TOP系统的压力 <br/><strong><a href="https://console.open.taobao.com/dingWeb.htm?from=tradeapi" target="_blank">点击查看更多交易API说明</a></strong>

func TaobaoTradeInvoiceAmountGet

func TaobaoTradeInvoiceAmountGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeInvoiceAmountGetAPIRequest, resp *tbtrade.TaobaoTradeInvoiceAmountGetAPIResponse, session string) error

TaobaoTradeInvoiceAmountGet 获取订单应开票金额 taobao.trade.invoice.amount.get

订单应开票金额计算

func TaobaoTradeMemoAdd

func TaobaoTradeMemoAdd(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeMemoAddAPIRequest, resp *tbtrade.TaobaoTradeMemoAddAPIResponse, session string) error

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

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

func TaobaoTradeMemoUpdate

func TaobaoTradeMemoUpdate(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeMemoUpdateAPIRequest, resp *tbtrade.TaobaoTradeMemoUpdateAPIResponse, session string) error

TaobaoTradeMemoUpdate 修改交易备注 taobao.trade.memo.update

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

func TaobaoTradeOrderskuUpdate

func TaobaoTradeOrderskuUpdate(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeOrderskuUpdateAPIRequest, resp *tbtrade.TaobaoTradeOrderskuUpdateAPIResponse, session string) error

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

只能更新发货前子订单的销售属性 <br/>只能更新价格相同的销售属性。对于拍下减库存的交易会同步更新销售属性的库存量。对于旺店的交易，要使用商品扩展信息中的SKU价格来比较。 <br/>必须使用sku_id或sku_props中的一个参数来更新，如果两个都传的话，sku_id优先

func TaobaoTradePostageUpdate

func TaobaoTradePostageUpdate(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradePostageUpdateAPIRequest, resp *tbtrade.TaobaoTradePostageUpdateAPIResponse, session string) error

TaobaoTradePostageUpdate 修改交易邮费价格 taobao.trade.postage.update

修改订单邮费接口，通过传入订单编号和邮费价格，修改订单的邮费，返回修改时间modified,邮费post_fee,总费用total_fee。 <br/> <span style="color:red"> API取消加邮费功能通知：http://open.taobao.com/support/announcement_detail.htm?tid=24750</span>

func TaobaoTradeReceivetimeDelay

func TaobaoTradeReceivetimeDelay(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeReceivetimeDelayAPIRequest, resp *tbtrade.TaobaoTradeReceivetimeDelayAPIResponse, session string) error

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

延长交易收货时间

func TaobaoTradeShippingaddressUpdate

func TaobaoTradeShippingaddressUpdate(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradeShippingaddressUpdateAPIRequest, resp *tbtrade.TaobaoTradeShippingaddressUpdateAPIResponse, session string) error

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

只能更新一笔交易里面的买家收货地址 <br/>只能更新发货前（即买家已付款，等待卖家发货状态）的交易的买家收货地址 <br/>更新后的发货地址可以通过taobao.trade.fullinfo.get查到 <br/>参数中所说的字节为GBK编码的（英文和数字占1字节，中文占2字节）

func TaobaoTradesSoldGet

func TaobaoTradesSoldGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradesSoldGetAPIRequest, resp *tbtrade.TaobaoTradesSoldGetAPIResponse, session string) error

TaobaoTradesSoldGet 查询卖家已卖出的交易数据（根据创建时间） taobao.trades.sold.get

搜索当前会话用户作为卖家已卖出的交易数据（只能获取到三个月以内的交易信息） <br/>1. 返回的数据结果是以订单的创建时间倒序排列的。 <br/>2. 返回的数据结果只包含了订单的部分数据，可通过taobao.trade.fullinfo.get获取订单详情。 <br/>注意：type字段的说明，如果该字段不传，接口默认只查4种类型订单，非默认查询的订单是不返回。遇到订单查不到的情况的，解决办法就是type加上订单类型就可正常返回了。 <br/><strong><a href="https://console.open.taobao.com/dingWeb.htm?from=tradeapi" target="_blank">点击查看更多交易API说明</a></strong>

func TaobaoTradesSoldIncrementGet

func TaobaoTradesSoldIncrementGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradesSoldIncrementGetAPIRequest, resp *tbtrade.TaobaoTradesSoldIncrementGetAPIResponse, session string) error

TaobaoTradesSoldIncrementGet 查询卖家已卖出的增量交易数据（根据修改时间） taobao.trades.sold.increment.get

搜索当前会话用户作为卖家已卖出的增量交易数据（只能获取到三个月以内的交易信息） <br/>1. 一次请求只能查询时间跨度为一天的增量交易记录，即end_modified - start_modified <= 1天。 <br/>2. 返回的数据结果是以订单的修改时间倒序排列的，通过从后往前翻页的方式可以避免漏单问题。 <br/>3. 返回的数据结果只包含了订单的部分数据，可通过taobao.trade.fullinfo.get获取订单详情。 <br/><strong><a href="https://console.open.taobao.com/dingWeb.htm?from=tradeapi" target="_blank">点击查看更多交易API说明</a></strong>

func TaobaoTradesSoldIncrementvGet

func TaobaoTradesSoldIncrementvGet(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradesSoldIncrementvGetAPIRequest, resp *tbtrade.TaobaoTradesSoldIncrementvGetAPIResponse, session string) error

TaobaoTradesSoldIncrementvGet 查询卖家已卖出的增量交易数据（根据入库时间） taobao.trades.sold.incrementv.get

搜索当前会话用户作为卖家已卖出的增量交易数据（只能获取到三个月以内的交易信息） <br/>1. 一次请求只能查询时间跨度为一天的增量交易记录，即end_create - start_create <= 1天。 <br/>2. 返回的数据结果是以订单入库时间的倒序排列的(该时间和订单修改时间不同)，通过从后往前翻页的方式可以避免漏单问题。 <br/>3. 返回的数据结果只包含了订单的部分数据，可通过taobao.trade.fullinfo.get获取订单详情。 <br/><strong><a href="https://console.open.taobao.com/dingWeb.htm?from=tradeapi" target="_blank">点击查看更多交易API说明</a></strong>

func TaobaoTradesSoldQuery

func TaobaoTradesSoldQuery(ctx context.Context, clt *core.SDKClient, req *tbtrade.TaobaoTradesSoldQueryAPIRequest, resp *tbtrade.TaobaoTradesSoldQueryAPIResponse, session string) error

TaobaoTradesSoldQuery 根据收件人信息查询交易单号 taobao.trades.sold.query

根据收件人信息查询交易单号。