Documentation ¶
Overview ¶
提供了卖家接收退款,退款留言等功能 auto sdk from taobao ApiMetadata.xml version 20140725 auther: [email protected]
Index ¶
- Constants
- type PicUrl
- type Refund
- type RefundGetRequest
- type RefundGetResponse
- type RefundGetResponseResult
- type RefundMessage
- type RefundMessageAddRequest
- type RefundMessageAddResponse
- type RefundMessageAddResponseResult
- type RefundMessagesGetRequest
- func (r *RefundMessagesGetRequest) GetResponse(accessToken string) (*RefundMessagesGetResponse, []byte, error)
- func (r *RefundMessagesGetRequest) SetFields(value string)
- func (r *RefundMessagesGetRequest) SetPageNo(value string)
- func (r *RefundMessagesGetRequest) SetPageSize(value string)
- func (r *RefundMessagesGetRequest) SetRefundId(value string)
- type RefundMessagesGetResponse
- type RefundMessagesGetResponseResult
- type RefundRefuseRequest
- func (r *RefundRefuseRequest) GetResponse(accessToken string) (*RefundRefuseResponse, []byte, error)
- func (r *RefundRefuseRequest) SetOid(value string)
- func (r *RefundRefuseRequest) SetRefundId(value string)
- func (r *RefundRefuseRequest) SetRefuseMessage(value string)
- func (r *RefundRefuseRequest) SetRefuseProof(value string)
- func (r *RefundRefuseRequest) SetTid(value string)
- type RefundRefuseResponse
- type RefundRefuseResponseResult
- type RefundRemindTimeout
- type RefundsApplyGetRequest
- func (r *RefundsApplyGetRequest) GetResponse(accessToken string) (*RefundsApplyGetResponse, []byte, error)
- func (r *RefundsApplyGetRequest) SetFields(value string)
- func (r *RefundsApplyGetRequest) SetPageNo(value string)
- func (r *RefundsApplyGetRequest) SetPageSize(value string)
- func (r *RefundsApplyGetRequest) SetSellerNick(value string)
- func (r *RefundsApplyGetRequest) SetStatus(value string)
- func (r *RefundsApplyGetRequest) SetType(value string)
- type RefundsApplyGetResponse
- type RefundsApplyGetResponseResult
- type RefundsReceiveGetRequest
- func (r *RefundsReceiveGetRequest) GetResponse(accessToken string) (*RefundsReceiveGetResponse, []byte, error)
- func (r *RefundsReceiveGetRequest) SetBuyerNick(value string)
- func (r *RefundsReceiveGetRequest) SetEndModified(value string)
- func (r *RefundsReceiveGetRequest) SetFields(value string)
- func (r *RefundsReceiveGetRequest) SetPageNo(value string)
- func (r *RefundsReceiveGetRequest) SetPageSize(value string)
- func (r *RefundsReceiveGetRequest) SetStartModified(value string)
- func (r *RefundsReceiveGetRequest) SetStatus(value string)
- func (r *RefundsReceiveGetRequest) SetType(value string)
- func (r *RefundsReceiveGetRequest) SetUseHasNext(value string)
- type RefundsReceiveGetResponse
- type RefundsReceiveGetResponseResult
Constants ¶
const VersionNo = "20140725"
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Refund ¶
type Refund struct { Address string `json:"address"` AdvanceStatus int `json:"advance_status"` AlipayNo string `json:"alipay_no"` BuyerNick string `json:"buyer_nick"` CompanyName string `json:"company_name"` Created string `json:"created"` CsStatus int `json:"cs_status"` Desc string `json:"desc"` GoodReturnTime string `json:"good_return_time"` GoodStatus string `json:"good_status"` HasGoodReturn bool `json:"has_good_return"` Iid string `json:"iid"` Modified string `json:"modified"` Num int `json:"num"` NumIid int `json:"num_iid"` Oid int `json:"oid"` OrderStatus string `json:"order_status"` Payment string `json:"payment"` Price string `json:"price"` Reason string `json:"reason"` RefundFee string `json:"refund_fee"` RefundId int `json:"refund_id"` RefundRemindTimeout *RefundRemindTimeout `json:"refund_remind_timeout"` SellerNick string `json:"seller_nick"` ShippingType string `json:"shipping_type"` Sid string `json:"sid"` SplitSellerFee string `json:"split_seller_fee"` SplitTaobaoFee string `json:"split_taobao_fee"` Status string `json:"status"` Tid int `json:"tid"` Title string `json:"title"` TotalFee string `json:"total_fee"` }
退款结构
type RefundGetRequest ¶
type RefundGetRequest struct {
open_taobao.TaobaoMethodRequest
}
获取单笔退款详情
func (*RefundGetRequest) GetResponse ¶
func (r *RefundGetRequest) GetResponse(accessToken string) (*RefundGetResponse, []byte, error)
func (*RefundGetRequest) SetFields ¶
func (r *RefundGetRequest) SetFields(value string)
需要返回的字段。目前支持有:refund_id, alipay_no, tid, oid, buyer_nick, seller_nick, total_fee, status, created, refund_fee, good_status, has_good_return, payment, reason, desc, num_iid, title, price, num, good_return_time, company_name, sid, address, shipping_type, refund_remind_timeout
func (*RefundGetRequest) SetRefundId ¶
func (r *RefundGetRequest) SetRefundId(value string)
退款单号<br /> 支持最大值为:9223372036854775807<br /> 支持最小值为:1
type RefundGetResponse ¶
type RefundGetResponse struct {
Refund *Refund `json:"refund"`
}
type RefundGetResponseResult ¶
type RefundGetResponseResult struct {
Response *RefundGetResponse `json:"refund_get_response"`
}
type RefundMessage ¶
type RefundMessage struct { Content string `json:"content"` Created string `json:"created"` Id int `json:"id"` MessageType string `json:"message_type"` OwnerId int `json:"owner_id"` OwnerNick string `json:"owner_nick"` OwnerRole string `json:"owner_role"` PicUrls struct { PicUrl []*PicUrl `json:"pic_url"` } `json:"pic_urls"` RefundId int `json:"refund_id"` }
留言/凭证数据结构
type RefundMessageAddRequest ¶
type RefundMessageAddRequest struct {
open_taobao.TaobaoMethodRequest
}
创建退款留言/凭证
func (*RefundMessageAddRequest) GetResponse ¶
func (r *RefundMessageAddRequest) GetResponse(accessToken string) (*RefundMessageAddResponse, []byte, error)
func (*RefundMessageAddRequest) SetContent ¶
func (r *RefundMessageAddRequest) SetContent(value string)
留言内容。最大长度: 400个字节
func (*RefundMessageAddRequest) SetImage ¶
func (r *RefundMessageAddRequest) SetImage(value string)
图片(凭证)。类型: JPG,GIF,PNG;最大为: 500K
func (*RefundMessageAddRequest) SetRefundId ¶
func (r *RefundMessageAddRequest) SetRefundId(value string)
退款编号。
type RefundMessageAddResponse ¶
type RefundMessageAddResponse struct {
RefundMessage *RefundMessage `json:"refund_message"`
}
type RefundMessageAddResponseResult ¶
type RefundMessageAddResponseResult struct {
Response *RefundMessageAddResponse `json:"refund_message_add_response"`
}
type RefundMessagesGetRequest ¶
type RefundMessagesGetRequest struct {
open_taobao.TaobaoMethodRequest
}
单笔退款详情
func (*RefundMessagesGetRequest) GetResponse ¶
func (r *RefundMessagesGetRequest) GetResponse(accessToken string) (*RefundMessagesGetResponse, []byte, error)
func (*RefundMessagesGetRequest) SetFields ¶
func (r *RefundMessagesGetRequest) SetFields(value string)
需返回的字段列表。可选值:RefundMessage结构体中的所有字段,以半角逗号(,)分隔。
func (*RefundMessagesGetRequest) SetPageNo ¶
func (r *RefundMessagesGetRequest) SetPageNo(value string)
页码。取值范围:大于零的整数; 默认值:1<br /> 支持最小值为:1
func (*RefundMessagesGetRequest) SetPageSize ¶
func (r *RefundMessagesGetRequest) SetPageSize(value string)
每页条数。取值范围:大于零的整数; 默认值:40;最大值:100<br /> 支持最大值为:100<br /> 支持最小值为:1
func (*RefundMessagesGetRequest) SetRefundId ¶
func (r *RefundMessagesGetRequest) SetRefundId(value string)
退款单号
type RefundMessagesGetResponse ¶
type RefundMessagesGetResponse struct { RefundMessages struct { RefundMessage []*RefundMessage `json:"refund_message"` } `json:"refund_messages"` TotalResults int `json:"total_results"` }
type RefundMessagesGetResponseResult ¶
type RefundMessagesGetResponseResult struct {
Response *RefundMessagesGetResponse `json:"refund_messages_get_response"`
}
type RefundRefuseRequest ¶
type RefundRefuseRequest struct {
open_taobao.TaobaoMethodRequest
}
卖家拒绝单笔退款(包含退款和退款退货)交易,要求如下:
1. 传入的refund_id和相应的tid, oid必须匹配 2. 如果一笔订单只有一笔子订单,则tid必须与oid相同 3. 只有卖家才能执行拒绝退款操作 4. 以下三种情况不能退款:卖家未发货;7天无理由退换货;网游订单
func (*RefundRefuseRequest) GetResponse ¶
func (r *RefundRefuseRequest) GetResponse(accessToken string) (*RefundRefuseResponse, []byte, error)
func (*RefundRefuseRequest) SetOid ¶
func (r *RefundRefuseRequest) SetOid(value string)
退款记录对应的交易子订单号
func (*RefundRefuseRequest) SetRefundId ¶
func (r *RefundRefuseRequest) SetRefundId(value string)
退款单号
func (*RefundRefuseRequest) SetRefuseMessage ¶
func (r *RefundRefuseRequest) SetRefuseMessage(value string)
拒绝退款时的说明信息,长度2-200<br /> 支持最大长度为:200<br /> 支持的最大列表长度为:200
func (*RefundRefuseRequest) SetRefuseProof ¶
func (r *RefundRefuseRequest) SetRefuseProof(value string)
拒绝退款时的退款凭证,一般是卖家拒绝退款时使用的发货凭证,最大长度130000字节,支持的图片格式:GIF, JPG, PNG<br /> 支持的文件类型为:gif,jpg,png<br /> 支持的最大列表长度为:130000
func (*RefundRefuseRequest) SetTid ¶
func (r *RefundRefuseRequest) SetTid(value string)
退款记录对应的交易订单号
type RefundRefuseResponse ¶
type RefundRefuseResponse struct {
Refund *Refund `json:"refund"`
}
type RefundRefuseResponseResult ¶
type RefundRefuseResponseResult struct {
Response *RefundRefuseResponse `json:"refund_refuse_response"`
}
type RefundRemindTimeout ¶
type RefundRemindTimeout struct { ExistTimeout bool `json:"exist_timeout"` RemindType int `json:"remind_type"` Timeout string `json:"timeout"` }
退款超时结构
type RefundsApplyGetRequest ¶
type RefundsApplyGetRequest struct {
open_taobao.TaobaoMethodRequest
}
查询买家申请的退款列表,且查询外店的退款列表时需要指定交易类型
func (*RefundsApplyGetRequest) GetResponse ¶
func (r *RefundsApplyGetRequest) GetResponse(accessToken string) (*RefundsApplyGetResponse, []byte, error)
func (*RefundsApplyGetRequest) SetFields ¶
func (r *RefundsApplyGetRequest) SetFields(value string)
需要返回的字段。目前支持有:refund_id, tid, title, buyer_nick, seller_nick, total_fee, status, created, refund_fee
func (*RefundsApplyGetRequest) SetPageNo ¶
func (r *RefundsApplyGetRequest) SetPageNo(value string)
页码。传入值为 1 代表第一页,传入值为 2 代表第二页,依此类推。默认返回的数据是从第一页开始<br /> 支持最小值为:1
func (*RefundsApplyGetRequest) SetPageSize ¶
func (r *RefundsApplyGetRequest) SetPageSize(value string)
每页条数。取值范围:大于零的整数; 默认值:40;最大值:100<br /> 支持最大值为:100<br /> 支持最小值为:1
func (*RefundsApplyGetRequest) SetSellerNick ¶
func (r *RefundsApplyGetRequest) SetSellerNick(value string)
卖家昵称
func (*RefundsApplyGetRequest) SetStatus ¶
func (r *RefundsApplyGetRequest) SetStatus(value string)
退款状态,默认查询所有退款状态的数据,除了默认值外每次只能查询一种状态。
WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
func (*RefundsApplyGetRequest) SetType ¶
func (r *RefundsApplyGetRequest) SetType(value string)
交易类型列表,一次查询多种类型可用半角逗号分隔,默认同时查询guarantee_trade, auto_delivery的2种类型的数据。
fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) auto_delivery(自动发货) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)
type RefundsApplyGetResponse ¶
type RefundsApplyGetResponseResult ¶
type RefundsApplyGetResponseResult struct {
Response *RefundsApplyGetResponse `json:"refunds_apply_get_response"`
}
type RefundsReceiveGetRequest ¶
type RefundsReceiveGetRequest struct {
open_taobao.TaobaoMethodRequest
}
查询卖家收到的退款列表,查询外店的退款列表时需要指定交易类型
func (*RefundsReceiveGetRequest) GetResponse ¶
func (r *RefundsReceiveGetRequest) GetResponse(accessToken string) (*RefundsReceiveGetResponse, []byte, error)
func (*RefundsReceiveGetRequest) SetBuyerNick ¶
func (r *RefundsReceiveGetRequest) SetBuyerNick(value string)
买家昵称
func (*RefundsReceiveGetRequest) SetEndModified ¶
func (r *RefundsReceiveGetRequest) SetEndModified(value string)
查询修改时间结束。格式: yyyy-MM-dd HH:mm:ss
func (*RefundsReceiveGetRequest) SetFields ¶
func (r *RefundsReceiveGetRequest) SetFields(value string)
需要返回的字段。目前支持有:refund_id, tid, title, buyer_nick, seller_nick, total_fee, status, created, refund_fee, oid, good_status, company_name, sid, payment, reason, desc, has_good_return, modified, order_status
func (*RefundsReceiveGetRequest) SetPageNo ¶
func (r *RefundsReceiveGetRequest) SetPageNo(value string)
页码。取值范围:大于零的整数; 默认值:1<br /> 支持最小值为:1
func (*RefundsReceiveGetRequest) SetPageSize ¶
func (r *RefundsReceiveGetRequest) SetPageSize(value string)
每页条数。取值范围:大于零的整数; 默认值:40;最大值:100<br /> 支持最大值为:100<br /> 支持最小值为:1
func (*RefundsReceiveGetRequest) SetStartModified ¶
func (r *RefundsReceiveGetRequest) SetStartModified(value string)
查询修改时间开始。格式: yyyy-MM-dd HH:mm:ss
func (*RefundsReceiveGetRequest) SetStatus ¶
func (r *RefundsReceiveGetRequest) SetStatus(value string)
退款状态,默认查询所有退款状态的数据,除了默认值外每次只能查询一种状态。
WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
func (*RefundsReceiveGetRequest) SetType ¶
func (r *RefundsReceiveGetRequest) SetType(value string)
交易类型列表,一次查询多种类型可用半角逗号分隔,默认同时查询guarantee_trade, auto_delivery的2种类型的数据。
fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) auto_delivery(自动发货) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)
func (*RefundsReceiveGetRequest) SetUseHasNext ¶
func (r *RefundsReceiveGetRequest) SetUseHasNext(value string)
是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量退款,接口调用成功率在原有的基础上有所提升。
type RefundsReceiveGetResponseResult ¶
type RefundsReceiveGetResponseResult struct {
Response *RefundsReceiveGetResponse `json:"refunds_receive_get_response"`
}