refund

package
v0.0.0-...-f648943 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 25, 2014 License: MIT Imports: 1 Imported by: 0

Documentation

Overview

提供了卖家接收退款,退款留言等功能 auto sdk from taobao ApiMetadata.xml version 20140725 auther: [email protected]

Index

Constants

View Source
const VersionNo = "20140725"

Variables

This section is empty.

Functions

This section is empty.

Types

type PicUrl

type PicUrl struct {
	Url string `json:"url"`
}

图片链接

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 RefundsApplyGetResponse struct {
	Refunds struct {
		Refund []*Refund `json:"refund"`
	} `json:"refunds"`
	TotalResults int `json:"total_results"`
}

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 RefundsReceiveGetResponse

type RefundsReceiveGetResponse struct {
	HasNext bool `json:"has_next"`
	Refunds struct {
		Refund []*Refund `json:"refund"`
	} `json:"refunds"`
	TotalResults int `json:"total_results"`
}

type RefundsReceiveGetResponseResult

type RefundsReceiveGetResponseResult struct {
	Response *RefundsReceiveGetResponse `json:"refunds_receive_get_response"`
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL