trade

package
v1.0.6 Latest Latest
Warning

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

Go to latest
Published: Jan 17, 2023 License: GPL-3.0 Imports: 6 Imported by: 0

Documentation

Overview

Package trade 交易相关API

Index

Constants

View Source
const (
	NAMESPACE = "com.alibaba.trade"
)

Variables

This section is empty.

Functions

func AlipayUrlGet

func AlipayUrlGet(client *go1688.Client, req *AlipayUrlGetRequest, accessToken string) (string, error)

AlipayUrlGet 批量获取订单的支付链接

func Cancel

func Cancel(client *go1688.Client, req *CancelRequest, accessToken string) error

Cancel 取消交易

func CreateRefund

func CreateRefund(client *go1688.Client, req *CreateRefundRequest, accessToken string) (string, error)

CreateRefund 创建退款退货申请

func OrderMemoAdd

func OrderMemoAdd(client *go1688.Client, req *OrderMemoAddRequest, accessToken string) error

OrderMemoAdd 修改订单备忘

func PayProtocolPay

func PayProtocolPay(client *go1688.Client, req *PayProtocolPayRequest, accessToken string) error

PayProtocolPay 支付宝协议代扣支付

func RefundReturnGoods

func RefundReturnGoods(client *go1688.Client, req *RefundReturnGoodsRequest, accessToken string) error

RefundReturnGoods 买家提交退款货信息

Types

type APIWebsite

type APIWebsite = string

APIWebsite 站点信息,指定调用的API是属于国际站(alibaba)还是1688网站(1688)

const (
	// API_ALIBABA alibaba
	API_ALIBABA APIWebsite = "alibaba"
	// API_1688 1688
	API_1688 APIWebsite = "1688"
)

type Address

type Address struct {
	// ID 收货地址id
	ID uint64 `json:"addressId,omitempty"`
	// FullName 收货人姓名
	FullName string `json:"fullName,omitempty"`
	// Mobile 手机
	Mobile string `json:"mobile,omitempty"`
	// Phone 电话
	Phone string `json:"phone,omitempty"`
	// PostCode 邮编
	PostCode string `json:"postCode,omitempty"`
	// CityText 市文本
	CityText string `json:"cityText,omitempty"`
	// ProvinceText 省份文本
	ProvinceText string `json:"provinceText,omitempty"`
	// AreaText 区文本
	AreaText string `json:"areaText,omitempty"`
	// TownText 镇文本
	TownText string `json:"townText,omitempty"`
	// Address 街道地址
	Address string `json:"address,omitempty"`
	// DistrictCode 地址编码
	DistrictCode string `json:"districtCode,omitempty"`
}

Address 收货地址信息

type AddressCodeGetRequest

type AddressCodeGetRequest struct {
	//  AreaCode 地址code码
	AreaCode string `json:"areaCode,omitempty"`
	// Website 站点信息,指定调用的API是属于国际站(alibaba)还是1688网站(1688)
	Website APIWebsite `json:"webSite,omitempty"`
}

AddressCodeGetRequest 获取交易地址代码表详情 API Request

func (AddressCodeGetRequest) Map

func (r AddressCodeGetRequest) Map() map[string]string

Map implement RequestData interface

func (AddressCodeGetRequest) Name

func (r AddressCodeGetRequest) Name() string

Name implement RequestData interface

type AddressCodeGetResponse

type AddressCodeGetResponse struct {
	go1688.BaseResponse
	// Result 地区信息
	Result *TradeAddressCode `json:"result,omitempty"`
}

AddressCodeGetResponse 获取交易地址代码表详情 API Response

type AddressCodeParseRequest

type AddressCodeParseRequest struct {
	// AddressInfo 地址信息
	AddressInfo string `json:"addressInfo"`
}

AddressCodeParseRequest 根据地址解析地区码 API Request

func (*AddressCodeParseRequest) Map

func (r *AddressCodeParseRequest) Map() map[string]string

Map implement RequestData interface

func (*AddressCodeParseRequest) Name

func (r *AddressCodeParseRequest) Name() string

Name implement RequestData interface

type AddressCodeParseResponse

type AddressCodeParseResponse struct {
	go1688.BaseResponse
	// Result 获地址
	Result *ReceiveAddress `json:"result,omitempty"`
}

AddressCodeParseResponse 根据地址解析地区码 API Response

type AlipayUrlGetRequest

type AlipayUrlGetRequest struct {
	// OrderIDs 订单Id列表,最多批量30个订单,订单过多会导致超时,建议一次10个订单
	OrderIDs []uint64 `json:"orderIdList"`
}

AlipayUrlGetRequest 批量获取订单的支付链接 API Request

func (AlipayUrlGetRequest) Map

func (r AlipayUrlGetRequest) Map() map[string]string

Map implement RequestData interface

func (AlipayUrlGetRequest) Name

func (r AlipayUrlGetRequest) Name() string

Name implement RequestData interface

type AlipayUrlGetResponse

type AlipayUrlGetResponse struct {
	go1688.BaseResponse
	// PayURL 支付链接
	PayURL string `json:"payUrl,omitempty"`
}

AlipayUrlGetResponse 批量获取订单的支付链接 API Response

type BusinessType

type BusinessType = string

BusinessType 业务类型

const (
	// TA_BT 国际站 - 信保
	TA_BT BusinessType = "ta"
	// WHOLESALE_BT 国际站 - 在线批发
	WHOLESALE_BT BusinessType = "wholesale"
	// CN_BT 普通订单类型
	CN_BT BusinessType = "cn"
	// WS_BT 大额批发订单类型
	WS_BT BusinessType = "ws"
	// YP_BT 普通拿样订单类型
	YP_BT BusinessType = "yp"
	// YF_BT 一分钱拿样订单类型
	YF_BT BusinessType = "yf"
	// FS_BT 倒批(限时折扣)订单类型
	FS_BT BusinessType = "fs"
	// CZ_BT 加工定制订单类型
	CZ_BT BusinessType = "cz"
	// AG_BT 协议采购订单类型
	AG_BT BusinessType = "ag"
	// HP_BT 伙拼订单类型
	HP_BT BusinessType = "hp"
	// SUPPLY_BT 供销订单类型
	SUPPLY_BT BusinessType = "supply"
	// FACTORY_BT 淘工厂订单
	FACTORY_BT BusinessType = "factory"
	// QUICK_BT 快订下单
	QUICK_BT BusinessType = "quick"
	// XIANGPIN_BT 享拼订单
	XIANGPIN_BT BusinessType = "xiangpin"
	// F2F_BT 当面付
	F2F_BT BusinessType = "f2f"
	// CYFW_BT 存样服务
	CYFW_BT BusinessType = "cyfw"
	// SP_BT 代销订单
	SP_BT BusinessType = "sp"
	// WG_BT 微供订单
	WG_BT BusinessType = "wg"
	// LST_BT 零售通
	LST_BT BusinessType = "lst"
	// CB_BT 跨境
	CB_BT BusinessType = "cb"
	// DISTRIBUTION_BT 分销
	DISTRIBUTION_BT BusinessType = "distribution"
	// CAB_BT 采源宝
	CAB_BT BusinessType = "cab"
	// MANUFACT_BT 加工定制
	MANUFACT_BT BusinessType = "manufact"
)

type CaigouQuoteInfo

type CaigouQuoteInfo struct {
	// ProductQuoteName 供应单项的名称
	ProductQuoteName string `json:"productQuoteName,omitempty"`
	// Price 价格,单位:元
	Price decimal.Decimal `json:"price,omitempty"`
	// Count 购买数量
	Count float64 `json:"count,omitempty"`
}

CaigouQuoteInfo 采购单详情

type CancelReason

type CancelReason = string

CancelReason 原因描述

const (
	// BUYER_CANCEL 买家取消订单
	BUYER_CANCEL CancelReason = "buyerCancel"
	// SELLER_GOODS_LACK 卖家库存不足
	SELLER_GOODS_LACK CancelReason = "sellerGoodsLack"
	// OTHER_REASON 其它
	OTHER_REASON CancelReason = "other"
)

type CancelRequest

type CancelRequest struct {
	// Website 站点信息,指定调用的API是属于国际站(alibaba)还是1688网站(1688)
	Website APIWebsite `json:"webSite,omitempty"`
	// TradeID 交易id,订单号
	TradeID uint64 `json:"tradeID,omitempty"`
	// Reason 原因描述;buyerCancel:买家取消订单;sellerGoodsLack:卖家库存不足;other:其它
	Reason CancelReason `json:"cancelReason,omitempty"`
	// Remark 备注
	Remark string `json:"remark,omitempty"`
}

CancelRequest 取消交易 API Request

func (CancelRequest) Map

func (r CancelRequest) Map() map[string]string

Map implement RequestData interface

func (CancelRequest) Name

func (r CancelRequest) Name() string

Name implement RequestData interface

type Cargo

type Cargo struct {
	// OfferID 商品对应的offer id
	OfferID uint64 `json:"offerId,omitempty"`
	// SpecID 商品规格id, 无sku商品不传
	SpecID string `json:"specId,omitempty"`
	// Quantity 商品数量(计算金额用)
	Quantify float64 `json:"quantity,omitempty"`
}

Cargo 商品信息

type CargoInfo

type CargoInfo struct {
	// OfferID 商品ID
	OfferID uint64 `json:"offerId,omitempty"`
	// Ammount 产品总金额
	Amount decimal.Decimal `json:"amount,omitempty"`
	// Message 返回信息
	Message string `json:"message,omitempty"`
	// FinalUnitPrice 最终单价
	FinalUnitPrice decimal.Decimal `json:"finalUnitPrice,omitempty"`
	// SpecID 规格ID,offer内唯一
	SpecID string `json:"specId,omitempty"`
	// SkuID 规格ID,全局唯一
	SkuID uint64 `json:"skuId,omitempty"`
	// ResultCode 返回码
	ResultCode string `json:"resultCode,omitempty"`
	// PromotionList 商品优惠列表
	PromotionList []Promotion `json:"cargoPromotionList,omitempty"`
}

CargoInfo 规格信息

type CreateOrder4CybMediaRequest

type CreateOrder4CybMediaRequest struct {
	// Address 收货地址
	Address *Address `json:"addressParam,omitempty"`
	// CargoList 购买的商品信息
	CargoList []Cargo `json:"cargoParamList,omitempty"`
	// Message 买家留言
	Message string `json:"message,omitempty"`
	// OuterOrderInfo 机构的订单信息,json格式,如果校验不通过,不能创建订单。业务线原因机构订单信息不能放在上面的下单参数结构体中,只能新增该字段用于机构订单信息回写,没有幂等校验,纯记录统计分析。mediaOrderId:机构订单号;phone:电话;offers.id:Long,1688商品id;offers.specId:String,1688商品specId(可能无);offers.price:Long,媒体溢价单价(单位分);offers.num:Long,售卖数量
	OuterOrderInfo *OuterOrderInfo `json:"outerOrderInfo,omitempty"`
	// TradeType 由于不同的商品支持的交易方式不同,没有一种交易方式是全局通用的,所以当前下单可使用的交易方式必须通过下单预览接口的tradeModeNameList获取。交易方式类型说明:fxassure(交易4.0通用担保交易),alipay(大市场通用的支付宝担保交易(目前在做切流,后续会下掉)),period(普通账期交易), assure(大买家企业采购询报价下单时需要使用的担保交易流程), creditBuy(诚E赊),bank(银行转账),631staged(631分阶段付款),37staged(37分阶段);此字段不传则系统默认会选取一个可用的交易方式下单,如果开通了诚E赊默认是creditBuy(诚E赊),未开通诚E赊默认使用的方式是支付宝担宝交易。
	TradeType TradeType `json:"tradeType,omitempty"`
	// UseChannelPrice 是否走渠道专属价,传true优先使用渠道传享价,不传或者传false则不走渠道专享价,走普通的分销价
	UseChannelPrice bool `json:"useChannelPrice,omitempty"`
	// Flow 不传,价格逻辑由useChannelPrice控制;传入general使用批发价,即useChannelPrice的价格逻辑失效;传入paired使用火拼价,若该商品未参与伙拼,则下单失败。
	Flow TradeFlow `json:"flow,omitempty"`
	// ShopPromotionID .
	ShopPromotionID string `json:"shopPromotionId,omitempty"`
}

CreateOrder4CybMediaRequest 溢价模式订单创建接口 API Request

func (CreateOrder4CybMediaRequest) Map

Map implement RequestData interface

func (CreateOrder4CybMediaRequest) Name

Name implement RequestData interface

type CreateOrder4CybMediaResponse

type CreateOrder4CybMediaResponse struct {
	go1688.BaseResponse
	// Result 返回结果
	Result *CreateOrder4CybMediaResult `json:"result,omitempty"`
}

CreateOrder4CybMediaResponse 溢价模式订单创建接口 API Response

type CreateOrder4CybMediaResult

type CreateOrder4CybMediaResult struct {
	// TotalSuccessAmount 下单成功的订单总金额,单位:分
	TotalSuccessAmount int64 `json:"totalSuccessAmount,omitempty"`
	// OrderID 下单成功后的订单id
	OrderID string `jsong:"orderId,omitempty"`
	// PostFee 原始运费,单位:分。注意:下单后卖家可能调整,因此该值可能不等于最终支付运费
	PostFee int64 `json:"postFee,omitempty"`
}

CreateOrder4CybMediaResult 溢价模式订单创建接口 API Result

func CreateOrder4CybMedia

func CreateOrder4CybMedia(client *go1688.Client, req *CreateOrder4CybMediaRequest, accessToken string) (*CreateOrder4CybMediaResult, error)

CreateOrder4CybMedia 溢价模式订单创建接口

type CreateOrderPreview4CybMediaRequest

type CreateOrderPreview4CybMediaRequest struct {
	// Address 收货地址信息
	Address *Address `json:"addressParam,omitempty"`
	// CargoList 商品信息
	CargoList []Cargo `json:"cargoParamList,omitempty"`
	// UseChannelPrice 是否走渠道专属价,传true优先使用渠道传享价,不传或者传false则不走渠道专享价,走普通的分销价
	UseChannelPrice bool `json:"useChannelPrice,omitempty"`
	// Flow 不传,价格逻辑由useChannelPrice控制;传入general使用批发价,即useChannelPrice的价格逻辑失效;传入paired使用火拼价,若该商品未参与伙拼,则下单失败。
	Flow TradeFlow `json:"flow,omitempty"`
}

CreateOrderPreview4CybMediaRequest 溢价模式创建订单前预览数据接口 API Request

func (CreateOrderPreview4CybMediaRequest) Map

Map implement RequestData interface

func (CreateOrderPreview4CybMediaRequest) Name

Name implement RequestData interface

type CreateOrderPreview4CybMediaResponse

type CreateOrderPreview4CybMediaResponse struct {
	go1688.BaseResponse
	// PostFeeByDescOfferList 运费说明的商品列表
	PostFeeByDescOfferList []uint64 `json:"postFeeByDescOfferList,omitempty"`
	// ConsignOfferList 代销商品列表
	ConsignOfferList []uint64 `json:"consignOfferList,omitempty"`
	// OrderPreview 订单预览结果,过自动拆单会返回多个记录
	OrderPreview []OrderPreview `json:"orderPreviewResuslt,omitempty"`
}

CreateOrderPreview4CybMediaResponse 溢价模式创建订单前预览数据接口 API Response

func CreateOrderPreview4CybMedia

func CreateOrderPreview4CybMedia(client *go1688.Client, req *CreateOrderPreview4CybMediaRequest, accessToken string) (*CreateOrderPreview4CybMediaResponse, error)

CreateOrderPreview4CybMedia 溢价模式创建订单前预览数据接口 溢价模式创建订单前预览数据接口; 订单创建只允许购买同一个供应商的商品。本接口返回创建订单相关的优惠等信息。 1、校验商品数据是否允许订购。 2、校验代销关系 3、校验库存、起批量、是否满足混批条件

type CreateRefundRequest

type CreateRefundRequest struct {
	// OrderID 主订单
	OrderID uint64 `json:"orderId,omitempty"`
	// OrderEntryIDs 子订单
	OrderEntryIDs []uint64 `json:"orderEntryIds,omitempty"`
	// DisputeRequest 退款/退款退货。只有已收到货,才可以选择退款退货。退款:"refund"; 退款退货:"returnRefund"
	DisputeRequest DisputeRequest `json:"disputeRequest,omitempty"`
	// ApplyPayment 退款金额(单位:分)。不大于实际付款金额;等待卖家发货时,必须为商品的实际付款金额。
	ApplyPayment int64 `json:"applyPayment,omitempty"`
	// ApplyCarriage 退运费金额(单位:分)。
	ApplyCarriage int64 `json:"applyCarriage,omitempty"`
	// ApplyReasonID 退款原因id(从API getRefundReasonList获取)
	ApplyReasonID uint64 `json:"applyReasonId,omitempty"`
	// Description 退款申请理由,2-150字
	Description string `json:"description,omitempty"`
	// GoodsStatus 货物状态, 售中等待卖家发货:"refundWaitSellerSend"; 售中等待买家收货:"refundWaitBuyerReceive"; 售中已收货(未确认完成交易):"refundBuyerReceived" 售后未收货:"aftersaleBuyerNotReceived"; 售后已收到货:"aftersaleBuyerReceived"
	GoodsStatus RefundGoodsStatus `json:"goodsStatus,omitempty"`
	// Vouchers 凭证图片URLs。1-5张,必须使用API uploadRefundVoucher返回的“图片域名/相对路径”
	Vouchers []string `json:"vouchers,omitempty"`
	// OrderEntryCountList 子订单退款数量。仅在售中买家已收货(退款退货)时,可指定退货数量;默认,全部退货。
	OrderEntryCountList []OrderEntryCount `json:"orderEntryCountList,omitempty"`
}

CreateRefundRequest 创建退款退货申请 API Request

func (CreateRefundRequest) Map

func (r CreateRefundRequest) Map() map[string]string

Map implement RequestData interface

func (CreateRefundRequest) Name

func (r CreateRefundRequest) Name() string

Name implement RequestData interface

type CreateRefundResponse

type CreateRefundResponse struct {
	go1688.BaseResponse
	Result *CreateRefundResult `json:"result,omitempty"`
}

CreateRefundResponse 创建退款退货申请 API Response

type CreateRefundResult

type CreateRefundResult struct {
	// Code 错误码
	Code string `json:"code"`
	// Message 错误信息
	Message string `json:"message"`
	// Result 结果
	Result struct {
		// RefundID 创建成功,退款id
		RefundID string `json:"refundId,omitempty"`
	} `json:"result,omitempty"`
	// Success 是否成功
	Success bool `json:"success,omitempty"`
}

CreateRefundResult 创建退款退货申请 API Result

func (CreateRefundResult) Error

func (r CreateRefundResult) Error() string

Error implement error interface

func (CreateRefundResult) IsError

func (r CreateRefundResult) IsError() bool

IsError check create refund success

type CreditOrderDetail

type CreditOrderDetail struct {
	// PayAmount 订单金额
	PayAmount int64 `json:"payAmount,omitempty"`
	// CreateTime 支付时间
	CreateTime string `json:"createTime,omitempty"`
	// Status 状态
	Status string `json:"status,omitempty"`
	// GracePeriodEndTime 最晚还款时间
	GracePeriodEndTime string `json:"gracePeriodEndTime,omitempty"`
	// StatusStr 状态描述
	StatusStr string `json:"statusStr,omitempty"`
	// RestRepayAmount 应还金额
	RestRepayAmount int64 `json:"restRepayAmount,omitempty"`
}

CreditOrderDetail 诚e赊支付详情,只有使用诚e赊付款时返回

type CustomerAttributeInfo

type CustomerAttributeInfo struct {
	// Sku sku标识
	Sku      string  `json:"sku,omitempty"`
	CnName   string  `json:"cnName,omitempty"`
	EnName   string  `json:"enName,omitempty"`
	Amount   float64 `json:"amount,omitempty"`
	Quantity float64 `json:"quantify,omitempty"`
	Weight   float64 `json:"weight,omitempty"`
	Currency string  `json:"currency,omitempty"`
}

CustomerAttributeInfo 报关信息

type DisputeRequest

type DisputeRequest = string

DisputeRequest 退款/退款退货。只有已收到货,才可以选择退款退货。退款:"refund"; 退款退货:"returnRefund"

const (
	// DISPUTE_REFUND 退款
	DISPUTE_REFUND DisputeRequest = "refund"
	// DISPUTE_RETURN_REFUND 退款退货
	DISPUTE_RETURN_REFUND DisputeRequest = "returnRefund"
)

type GetRefundReasonListRequest

type GetRefundReasonListRequest struct {
	// OrderID 主订单
	OrderID uint64 `json:"orderId,omitempty"`
	// OrderEntryIDs 子订单
	OrderEntryIDs []uint64 `json:"orderEntryIds,omitempty"`
	// GoodsStatus 货物状态, 售中等待卖家发货:"refundWaitSellerSend"; 售中等待买家收货:"refundWaitBuyerReceive"; 售中已收货(未确认完成交易):"refundBuyerReceived" 售后未收货:"aftersaleBuyerNotReceived"; 售后已收到货:"aftersaleBuyerReceived"
	GoodsStatus RefundGoodsStatus `json:"goodsStatus,omitempty"`
}

GetRefundReasonListRequest 查询退款退货原因(用于创建退款退货) API Request

func (GetRefundReasonListRequest) Map

Map implement RequestData interface

func (GetRefundReasonListRequest) Name

Name implement RequestData interface

type GetRefundReasonListResponse

type GetRefundReasonListResponse struct {
	go1688.BaseResponse
	Result *GetRefundReasonListResult `json:"result,omitempty"`
}

GetRefundReasonListResponse 查询退款退货原因(用于创建退款退货) API Response

type GetRefundReasonListResult

type GetRefundReasonListResult struct {
	// Code 错误码
	Code string `json:"code"`
	// Message 错误信息
	Message string `json:"message"`
	// Result 结果
	Result struct {
		// Reasons 原因列表
		Reasons []OrderRefundReason `json:"reasons,omitempty"`
	} `json:"result,omitempty"`
	// Success 是否成功
	Success bool `json:"success,omitempty"`
}

GetRefundReasonListResult 查询退款退货原因(用于创建退款退货) API Result

func (GetRefundReasonListResult) Error

Error implement error interface

func (GetRefundReasonListResult) IsError

func (r GetRefundReasonListResult) IsError() bool

IsError check success

type GuaranteesTermInfo

type GuaranteesTermInfo struct {
	// AssuranceInfo 保障条款
	AssuranceInfo string `json:"assuranceInfo,omitempty"`
	// AssuranceType 保障方式。国际站:TA(信保)
	AssuranceType string `json:"assuranceType,omitempty"`
	// QualityAssuranceType 质量保证类型。国际站:pre_shipment(发货前),post_delivery(发货后)
	QualityAssuranceType QualityAssuranceType `json:"qualityAssuranceType,omitempty"`
}

GuaranteesTermInfo 保障条款

type KeyValuePair

type KeyValuePair struct {
	Key         string `json:"key,omitempty"`
	Value       string `json:"value,omitempty"`
	Description string `json:"description,omitempty"`
}

KeyValuePair 扩展属性

type LstOrderInfo

type LstOrderInfo struct {
	// LstWarehouseType 零售通仓库类型。customer:虚仓;cainiao:实仓
	LstWarehouseType LstWarehouseType `json:"lstWarehouseType,omitempty"`
}

type LstWarehouseType

type LstWarehouseType = string

LstWarehouseType 零售通仓库类型。customer:虚仓;cainiao:实仓

const (
	// CUSTOMER_LST_WAREHOUSE 虚仓
	CUSTOMER_LST_WAREHOUSE LstWarehouseType = "customer"
	// CAINIAO_LST_WAREHOUSE 实仓
	CAINIAO_LST_WAREHOUSE LstWarehouseType = "cainiao"
)

type NativeLogisticsInfo

type NativeLogisticsInfo struct {
	Address       string `json:"address,omitempty"`
	Area          string `json:"area,omitempty"`
	AreaCode      string `json:"areaCode,omitempty"`
	City          string `json:"city,omitempty"`
	ContactPerson string `json:"contactPerson,omitempty"`
	Fax           string `json:"fax,omitempty"`
	Mobile        string `json:"mobile,omitempty"`
	Province      string `json:"province,omitempty"`
	Telephone     string `json:"telephone,omitempty"`
	Zip           string `json:"zip,omitempty"`
	// LogisticsItems 运单明细
	LogisticsItems []NativeLogisticsItemInfo `json:"logisticsItems,omitempty"`
	// TownCode 镇,街道地址码
	TownCode string `json:"townCode,omitempty"`
	// Town 镇,街道
	Town string `json:"town,omitempty"`
}

NativeLogisticsInfo 国内物流

type NativeLogisticsItemInfo

type NativeLogisticsItemInfo struct {
	// DeliveredTime 发货时间
	DeliveredTime go1688.JsonTime `json:"deliveredTime,omitempty"`
	// LogisticsCode 物流编号
	LogisticsCode string `json:"logisticsCode,omitempty"`
	// Type SELF_SEND_GOODS("0")自行发货,在线发货ONLINE_SEND_GOODS("1",不需要物流的发货 NO_LOGISTICS_SEND_GOODS("2")
	Type string `json:"type,omitempty"`
	// ID 主键id
	ID uint64 `json:"id,omitempty"`
	// Status 状态
	Status string `json:"status,omitempty"`
	// GmtModified 修改时间
	GmtModified go1688.JsonTime `json:"gmtModified,omitempty"`
	// GmtCreate 创建时间
	GmtCreate go1688.JsonTime `json:"gmtCreate,omitempty"`
	// Carriage 运费(单位为元)
	Carriage decimal.Decimal `json:"carriage,omitempty"`
	// FromProvince 发货省
	FromProvince string `json:"fromProvince,omitempty"`
	// FromCity 发货市
	FromCity string `json:"fromCity,omitempty"`
	// FromArea 发货区
	FromArea string `json:"fromArea,omitempty"`
	// FromAddress 发货街道地址
	FromAddress string `json:"fromAddress,omitempty"`
	// FromPhone 发货联系电话
	FromPhone string `json:"fromPhone,omitempty"`
	// FromMobile 发货联系手机
	FromMobile string `json:"fromMobile,omitempty"`
	// FromPost 发货地址邮编
	FromPost string `json:"fromPost,omitempty"`
	// LogisticsCompanyID 物流公司Id
	LogisticsCompanyID uint64 `json:"logisticsCompanyId,omitempty"`
	// LogisticsCompanyNo 物流公司编号
	LogisticesCompanyNo string `json:"logisticsCompanyNo,omitempty"`
	// LogisticsCompanyName 物流公司名称
	LogisticsCompanyName string `json:"logisticsCompanyName,omitempty"`
	// LogisticsBillNo 物流公司运单号
	LogisticsBillNo string `json:"logisticsBillNo,omitempty"`
	// SubItemIDs 商品明细条目id,如有多个以,分隔
	SubItemIDs string `json:"subItemIds,omitempty"`
	// ToProvince 收货省
	ToProvince string `json:"toProvince,omitempty"`
	// ToCity 收货市
	ToCity string `json:"toCity,omitempty"`
	// ToArea 收货区
	ToArea string `json:"toArea,omitempty"`
	// ToAddress 收货街道地址
	ToAddress string `json:"toAddress,omitempty"`
	// ToPhone 收货联系电话
	ToPhone string `json:"toPhone,omitempty"`
	// ToMobile 收货联系手机
	ToMobile string `json:"toMobile,omitempty"`
	// ToPost 收货地址邮编
	ToPost string `json:"toPost,omitempty"`
	// NoLogisticsName 物流姓名
	NoLogisticsName string `json:"noLogisticsName,omitempty"`
	// NoLogisticsTel 联系方式
	NoLogisticsTel string `json:"noLogisticsTel,omitempty"`
	// NoLogisticsBillNo 无需物流业务单号
	NoLogisticsBillNo string `json:"noLogisticsBillNo,omitempty"`
	// NoLogisticsCondition 无需物流类别,noLogisticsCondition=1, 表示其他第三方物流、小型物充商、车队等, noLogisticsCondition=2 表示补运费、差价, noLogisticsCondition=3 表示卖家配送, noLogisticsCondition=4 表示买家自提 noLogisticsCondition=5 表示其他原因
	NoLogisticsCondition string `json:"noLogisticsCondition,omitempty"`
	// IsTimePromise 是否使用限时达物流
	IsTimePromise bool `json:"isTimePromise,omitempty"`
	// ArriveTime 限时达物流,预计到达时间
	ArriveTime go1688.JsonTime `json:"arriveTime,omitempty"`
}

NativeLogisticsItemInfo 运单明细

type OpOrderRefundModel added in v1.0.4

type OpOrderRefundModel struct {
	// AftersaleAgreeTimeout 售后超时标记
	AftersaleAgreeTimeout bool `json:"aftersaleAgreeTimeout,omitempty"`
	// AftersaleAutoDisburse 售后自动打款
	AftersaleAutoDisburse bool `json:"aftersaleAutoDisburse,omitempty"`
	// AlipayPaymentID 支付宝交易号
	AlipayPaymentID string `json:"alipayPaymentId,omitempty"`
	// ApplyCarriage 运费的申请退款金额,单位:分
	ApplyCarriage int64 `json:"applyCarriage,omitempty"`
	// ApplyExpect 买家原始输入的退款金额(可以为空)
	ApplyExpect int64 `json:"applyExpect,omitempty"`
	// ApplyPayment 买家申请退款金额,单位:分
	ApplyPayment int64 `json:"applyPayment,omitempty"`
	// ApplyReason 申请原因
	ApplyReason string `json:"applyReason,omitempty"`
	// ApplyReasonID 申请原因ID
	ApplyReasonID uint64 `json:"applyReasonId,omitempty"`
	// ApplySubReason 二级退款原因
	ApplySubReason string `json:"applySubReason,omitempty"`
	// ApplySubReasonID 二级退款原因Id
	ApplySubReasonID uint64 `json:"applySubReasonId,omitempty"`
	// AsynErrCode
	AsynErrCode string `json:"asynErrCode,omitempty"`
	// AsynSubErrCode
	AsynSubErrCode string `json:"asynSubErrCode,omitempty"`
	// BuyerAlipayID 买家支付宝ID
	BuyerAlipayID string `json:"buyerAlipayId,omitempty"`
	// BuyerLogisticsName 买家退货物流公司名
	BuyerLogisticsName string `json:"buyerLogisticsName,omitempty"`
	// BuyerMemberID 买家会员ID
	BuyerMemberID string `json:"buyerMemberId,omitempty"`
	// BuyerSendGoods 买家是否已经发货(如果有退货的流程)
	BuyerSendGoods bool `json:"buyerSendGoods,omitempty"`
	// BuyerUserID 买家阿里帐号ID(包括淘宝帐号Id)
	BuyerUserID uint64 `json:"buyerUserId,omitempty"`
	// CanRefundPayment 最大能够退款金额,单位:分
	CanRefundPayment int64 `json:"canRefundPayment,omitempty"`
	// CrmModifyRefund 是否小二修改过退款单
	CrmModifyRefund bool `json:"crmModifyRefund,omitempty"`
	// DisburseChannel 极速到账打款渠道
	DisburseChannel string `json:"disburseChannel,omitempty"`
	// DisputeRequest 售后退款要求
	DisputeRequest int `json:"disputeRequest,omitempty"`
	// DisputeType 纠纷类型:售中退款 售后退款,默认为售中退款
	DisputeType int `json:"disputeType,omitempty"`
	// ExtInfo 扩展信息
	ExtInfo map[string]string `json:"extInfo,omitempty"`
	// FreightBill 运单号
	FreightBill string `json:"freightBill,omitempty"`
	// FrozenFund 实际冻结账户金额,单位:分
	FrozenFund int64 `json:"frozenFund,omitempty"`
	// GmtApply 申请退款时间
	GmtApply go1688.JsonTime `json:"gmtApply,omitempty"`
	// GmtCompleted 完成时间
	GmtCompleted go1688.JsonTime `json:"gmtCompleted,omitempty"`
	// GmtCreate 创建时间
	GmtCreate go1688.JsonTime `json:"gmtCreate,omitempty"`
	// GmtFreezed 该退款单超时冻结开始时间
	GmtFreezed go1688.JsonTime `json:"gmtFreezed,omitempty"`
	// GmtModified 修改时间
	GmtModified go1688.JsonTime `json:"gmtModified,omitempty"`
	// GmtTimeOut 该退款单超时完成的时间期限
	GmtTimeOut go1688.JsonTime `json:"gmtTimeOut,omitempty"`
	// GoodsReceived 买家是否已收到货
	GoodsReceived bool `json:"goodsReceived,omitempty"`
	// GoodsStatus 1:买家未收到货 2:买家已收到货 3:买家已退货
	GoodsStatus int `json:"goodsStatus,omitempty"`
	// ID 退款单编号
	ID uint64 `json:"id,omitempty"`
	// InstantRefundType 极速到账退款类型
	InstantRefundType int `json:"instantRefundType,omitempty"`
	// InsufficientAccount 交易4.0退款余额不足
	InsufficientAccount bool `json:"insufficientAccount,omitempty"`
	// InsufficientBail 极速到账退款保证金不足
	InsufficientBail bool `json:"insufficientBail,omitempty"`
	// NewRefundReturn 是否新流程创建的退款退货
	NewRefundReturn bool `json:"newRefundReturn,omitempty"`
	// OnlyRefund 是否仅退款
	OnlyRefund bool `json:"onlyRefund,omitempty"`
	// OrderEntryCountMap 子订单退货数量
	OrderEntryCountMap map[string]int64 `json:"orderEntryCountMap,omitempty"`
	// OrderEntryIDList 退款单包含的订单明细,时间逆序排列
	OrderEntryIDList []uint64 `json:"orderEntryIdList,omitempty"`
	// OrderID 退款单对应的订单编号
	OrderID uint64 `json:"orderId,omitempty"`
	// PrepaidBalance 极速退款垫资金额,该值不为空时,只代表该退款单可以走垫资流程,但不代表一定垫资成功
	PrepaidBalance int64 `json:"prepaidBalance,omitempty"`
	// ProductName 产品名称(退款单关联订单明细的货品名称)
	ProductName string `json:"productName,omitempty"`
	// RefundCarriage 运费的实际退款金额,单位:分
	RefundCarriage int64 `json:"refundCarriage,omitempty"`
	// RefundGoods 是否要求退货
	RefundGoods bool `json:"refundGoods,omitempty"`
	// RefundID 退款单逻辑主键
	RefundID string `json:"refundId,omitempty"`
	// RefundPayment 实际退款金额,单位:分
	RefundPayment int64 `json:"refundPayment,omitempty"`
	// RejectReason 卖家拒绝原因
	RejectReason string `json:"rejectReason,omitempty"`
	// RejectTimes 退款单被拒绝的次数
	RejectTimes int `json:"rejectTimes,omitempty"`
	// SellerAlipayID 卖家支付宝ID
	SellerAlipayID string `json:"sellerAlipayId,omitempty"`
	// SellerDelayDisburse 是否卖家延迟打款,即安全退款
	SellerDelayDisburse bool `json:"sellerDelayDisburse,omitempty"`
	// SellerMemberID 卖家会员ID
	SellerMemberID string `json:"sellerMemberId,omitempty"`
	// SellerMobile 收货人手机
	SellerMobile string `json:"sellerMobile,omitempty"`
	// SellerRealName 收货人姓名
	SellerRealName string `json:"sellerRealName,omitempty"`
	// SellerReceiveAddress 买家退货时卖家收货地址
	SellerReceiveAddress string `json:"sellerReceiveAddress,omitempty"`
	// SellerTel 收货人电话
	SellerTel string `json:"sellerTel,omitempty"`
	// SellerUserID 卖家阿里帐号ID(包括淘宝帐号Id)
	SellerUserID uint64 `json:"sellerUserId,omitempty"`
	// Status 退款状态
	Status string `json:"status,omitempty"`
	// SupportNewSteppay 是否支持交易4.0
	SupportNewSteppay bool `json:"supportNewSteppay,omitempty"`
	// TaskStatus 工单子状态,没有流到CRM创建工单时为空
	TaskStatus bool `json:"taskStatus,omitempty"`
	// TimeOutFreeze 是否超时系统冻结,true代表冻结,false代表不冻结
	TimeOutFreeze bool `json:"timeOutFreeze,omitempty"`
	// TimeOutOperateType 超时后执行的动作
	TimeOutOperateType string `json:"timeOutOperateType,omitempty"`
	// TradeTypeStr 交易类型,用来替换枚举类型的tradeType
	TradeTypeStr string `json:"tradeTypeStr,omitempty"`
	// Success 是否成功
	Success bool `json:"success,omitempty"`
	// RefundOperationList  操作记录列表
	RefundOperationList []OpOrderRefundOperationModal `json:"refundOperationList,omitempty"`
	// IsCrmModifyRefund 是否小二修改过退款单
	IsCrmModifyRefund bool `json:"isCrmModifyRefund,omitempty"`
	// IsTimeOutFreeze 是否超时系统冻结,true代表冻结,false代表不冻结
	IsTimeOutFreeze bool `json:"isTimeOutFreeze,omitempty"`
	// IsInsufficientAccount 交易4.0退款余额不足
	IsInsufficientAccount bool `json:"isInsufficientAccount,omitempty"`
	// IsGoodsReceived 买家是否已收到货
	IsGoodsReceived bool `json:"isGoodsReceived,omitempty"`
	// IsOnlyRefund 是否仅退款
	IsOnlyRefund bool `json:"isOnlyRefund,omitempty"`
	// IsRefundGoods 是否要求退货
	IsRefundGoods bool `json:"isRefundGoods,omitempty"`
	// IsSellerDelayDisburse 是否卖家延迟打款,即安全退款
	IsSellerDelayDisburse bool `json:"isSellerDelayDisburse,omitempty"`
	// IsAftersaleAutoDisburse 售后自动打款
	IsAftersaleAutoDisburse bool `json:"isAftersaleAutoDisburse,omitempty"`
	// IsSupportNewSteppay 是否支持交易4.0
	IsSupportNewSteppay bool `json:"isSupportNewSteppay,omitempty"`
	// IsNewRefundReturn 是否新流程创建的退款退货
	IsNewRefundReturn bool `json:"isNewRefundReturn,omitempty"`
	// IsBuyerSendGoods 买家是否已经发货(如果有退货的流程)
	IsBuyerSendGoods bool `json:"isBuyerSendGoods,omitempty"`
	// IsAftersaleAgreeTimeout 售后超时标记
	IsAftersaleAgreeTimeout bool `json:"isAftersaleAgreeTimeout,omitempty"`
	// IsInsufficientBail 极速到账退款保证金不足
	IsInsufficientBail bool `json:"isInsufficientBail,omitempty"`
}

OpOrderRefundModel 退款单

func RefundOpQueryBatchRefundByOrderIdAndStatus added in v1.0.4

func RefundOpQueryBatchRefundByOrderIdAndStatus(client *go1688.Client, req *RefundOpQueryBatchRefundByOrderIdAndStatusRequest, accessToken string) ([]OpOrderRefundModel, error)

RefundOpQueryBatchRefundByOrderIdAndStatus 查询退款单详情-根据订单ID(买家视角)

func RefundOpQueryOrderRefund added in v1.0.4

func RefundOpQueryOrderRefund(client *go1688.Client, req *RefundOpQueryOrderRefundRequest, accessToken string) ([]OpOrderRefundModel, error)

RefundOpQueryOrderRefund 查询退款单详情-根据退款单ID(买家视角)

type OpOrderRefundOperationModal added in v1.0.4

type OpOrderRefundOperationModal struct {
	// AfterOperateStatus 操作后的退款状态
	AfterOperateStatus string `json:"afterOperateStatus,omitempty"`
	// BeforeOperateStatus 操作前的退款状态
	BeforeOperateStatus string `json:"beforeOperateStatus,omitempty"`
	// CloseRefundStepId 分阶段订单正向操作关闭退款时的阶段ID
	CloseRefundStepId uint64 `json:"closeRefundStepId,omitempty"`
	// CrmModifyRefund 是否小二修改过退款单
	CrmModifyRefund bool `json:"crmModifyRefund,omitempty"`
	// Description 描述、说明
	Description string `json:"description,omitempty"`
	// Email 联系人EMAIL
	Email string `json:"email,omitempty"`
	// FreightBill 运单号
	FreightBill string `json:"freightBill,omitempty"`
	// GmtCreate 创建时间
	GmtCreate go1688.JsonTime `json:"gmtCreate,omitempty"`
	// GmtModified 修改时间
	GmtModified go1688.JsonTime `json:"gmtModified,omitempty"`
	// ID 主键,退款操作记录流水号
	ID uint64 `json:"id,omitempty"`
	// MessageStatus 凭证状态,1:正常 2:后台小二屏蔽
	MessageStatus int `json:"messageStatus,omitempty"`
	// Mobile 联系人手机
	Mobile string `json:"mobile,omitempty"`
	// MsgType 留言类型 3:小二留言给买家和卖家 4:给买家的留言 5:给卖家的留言 7:cbu的普通留言等同于淘宝的1
	MsgType int `json:"msgType,omitempty"`
	// OperateRemark 操作备注
	OperateRemark string `json:"operateRemark,omitempty"`
	// OperateTypeInt 操作类型 取代operateType
	OperateTypeInt int `json:"operateTypeInt,omitempty"`
	// OperatorID 操作者-memberID
	OperatorID string `json:"operatorId,omitempty"`
	// OperatorLoginID 操作者-loginID
	OperatorLoginID string `json:"operatorLoginId,omitempty"`
	// OperatorRoleID 操作者角色名称 买家 卖家 系统
	OperatorRoleID int `json:"operatorRoleID,omitempty"`
	// OperatorUserID 操作者-userID
	OperatorUserID uint64 `json:"operatorUserID,omitempty"`
	// Phone 联系人电话
	Phone string `json:"phone,omitempty"`
	// RefundAddress 退货地址
	RefundAddress string `json:"refundAddress,omitempty"`
	// RefundID 退款记录ID
	RefundID string `json:"refundId,omitempty"`
	// RejectReason 卖家拒绝退款原因
	RejectReason string `json:"rejectReason,omitempty"`
	// Vouchers 凭证图片地址
	Vouchers []string `json:"vouchers,omitempty"`
	// LogisticsCompany 物流公司详情
	LogisticsCompany []logistics.OpLogisticsCompany `json:"logisticsCompany,omitempty"`
	// BuyerLoginID 买家LoginId
	BuyerLoginID string `json:"buyerLoginId,omitempty"`
	// SellerLoginID 卖家LoginId
	SellerLoginID string `json:"sellerLoginId,omitempty"`
}

OpOrderRefundOperationModal 操作记录

func RefundOpQueryOrderRefundOperationList added in v1.0.4

func RefundOpQueryOrderRefundOperationList(client *go1688.Client, req *RefundOpQueryOrderRefundRequest, accessToken string) ([]OpOrderRefundOperationModal, error)

RefundOpQueryOrderRefundOperationList 退款单操作记录列表(买家视角)

type OpQueryOrderRefundListResult added in v1.0.4

type OpQueryOrderRefundListResult struct {
	// List 退款单列表
	List []OpOrderRefundModel `json:"opOrderRefundModels,omitempty"`
	// TotalCount 符合条件总的记录条数
	TotalCount int `json:"totalCount,omitempty"`
	// CurrentPageNum 查询的当前页码
	CurrentPageNum int `json:"currentPageNum,omitempty"`
}

OpQueryOrderRefundListResult 查询结果

func RefundBuyerQueryOrderRefundList added in v1.0.4

func RefundBuyerQueryOrderRefundList(client *go1688.Client, req *RefundBuyerQueryOrderRefundListRequest, accessToken string) (*OpQueryOrderRefundListResult, error)

RefundBuyerQueryOrderRefundList 订单列表查看(买家视角)

type OrderBaseInfo

type OrderBaseInfo struct {
	// AllDeliveredTime 完全发货时间
	AllDeliveredTime go1688.JsonTime `json:"allDeliveredTime,omitempty"`
	// SellerCreditLevel 卖家诚信等级
	SellerCreditLevel string `json:"sellerCreditLevel,omitempty"`
	// PayTime 付款时间,如果有多次付款,这里返回的是首次付款时间
	PayTime go1688.JsonTime `json:"payTime,omitempty"`
	// Discount 折扣信息,单位分
	Discount int64 `json:"discount,omitempty"`
	// AlipayTradeID 外部支付交易Id
	AlipayTradeID string `json:"alipayTradeId,omitempty"`
	// SumProductPayment 产品总金额(该订单产品明细表中的产品金额的和),单位元
	SumProductPayment decimal.Decimal `json:"sumProductPayment,omitempty"`
	// BuyerFeedback 买家留言,不超过500字
	BuyerFeedback string `json:"buyerFeedback,omitempty"`
	// FlowTemplateCode 4.0交易流程模板code
	FlowTemplateCode string `json:"flowTemplateCode,omitempty"`
	// SellerOrder 是否自主订单(邀约订单)
	SellerOrder bool `json:"sellerOrder,omitempty"`
	// BuyerLoginID 买家loginId,旺旺Id
	BuyerLoginID string `json:"buyerLoginId,omitempty"`
	// ModifyTime 修改时间
	ModifyTime go1688.JsonTime `json:"modifyTime,omitempty"`
	// SubBuyerLoginID 买家子账号
	SubBuyerLoginID string `json:"subBuyerLoginId,omitempty"`
	// ID 交易id
	ID uint64 `json:"id,omitempty"`
	// CloseReason 关闭原因。buyerCancel:买家取消订单,sellerGoodsLack:卖家库存不足,other:其它
	CloseReason CancelReason `json:"closeReason,omitempty"`
	// BuyerContact 买家联系人
	BuyerContact *TradeContact `json:"buyerContact,omitempty"`
	// SellerAlipayID 卖家支付宝id
	SellerAlipayID string `json:"sellerAlipayId,omitempty"`
	// CompleteTime 完成时间
	CompleteTime go1688.JsonTime `json:"completeTime,omitempty"`
	// SellerLoginID 卖家oginId,旺旺Id
	SellerLoginID string `json:"sellerLoginId,omitempty"`
	// BuyerID 买家主账号id
	BuyerID string `json:"buyerID,omitempty"`
	// CloseOperateType 关闭订单操作类型。CLOSE_TRADE_BY_SELLER:卖家关闭交易,CLOSE_TRADE_BY_BOPS:BOPS后台关闭交易,CLOSE_TRADE_BY_SYSTEM:系统(超时)关闭交易,CLOSE_TRADE_BY_BUYER:买家关闭交易,CLOSE_TRADE_BY_CREADIT:诚信保障投诉关闭
	CloseOperateType TradeCloseType `json:"closeOperateType,omitempty"`
	// TotalAmount 应付款总金额,totalAmount = ∑itemAmount + shippingFee,单位为元
	TotalAmount decimal.Decimal `json:"totalAmount,omitempty"`
	// SellerID 卖家主账号id
	SellerID string `json:"sellerID,omitempty"`
	// ShippingFee 运费,单位为元
	ShippingFee decimal.Decimal `json:"shippingFee,omitempty"`
	// BuyerUserID 买家数字id
	BuyerUserID uint64 `json:"buyerUserId,omitempty"`
	// BuyerMemo 买家备忘信息
	BuyerMemo string `json:"buyerMemo,omitempty"`
	// Refund 退款金额,单位为元
	Refund decimal.Decimal `json:"refund,omitempty"`
	// Status 交易状态,waitbuyerpay:等待买家付款;waitsellersend:等待卖家发货;waitbuyerreceive:等待买家收货;confirm_goods:已收货;success:交易成功;cancel:交易取消;terminated:交易终止;未枚举:其他状态
	Status TradeStatus `json:"status,omitempty"`
	// RefundPayment 退款金额
	RefundPayment int64 `json:"refundPayment,omitempty"`
	// SellerContact 卖家联系人信息
	SellerContact *TradeContact `json:"sellerContact,omitempty"`
	// RefundStatus 订单的售中退款状态,等待卖家同意:waitselleragree ,待买家修改:waitbuyermodify,等待买家退货:waitbuyersend,等待卖家确认收货:waitsellerreceive,退款成功:refundsuccess,退款失败:refundclose
	RefundStatus RefundStatus `json:"refundStatus,omitempty"`
	// Remark 备注,1688指下单时的备注
	Remark string `json:"remark,omitempty"`
	// PreOrderID 预订单ID
	PreOrderID uint64 `json:"preOrderId,omitempty"`
	// ConfirmedTime 确认时间
	ConfirmedTime go1688.JsonTime `json:"confirmedTime,omitempty"`
	// CloseRemark 关闭订单备注
	CloseRemark string `json:"closeRemark,omitempty"`
	// TradeType 1:担保交易 2:预存款交易 3:ETC境外收单交易 4:即时到帐交易 5:保障金安全交易 6:统一交易流程 7:分阶段付款 8.货到付款交易 9.信用凭证支付交易 10.账期支付交易,50060 交易4.0
	TradeType string `json:"tradeType,omitempty"`
	// ReceivingTime 收货时间,这里返回的是完全收货时间
	ReceivingTime go1688.JsonTime `json:"receivingTime,omitempty"`
	// StepAgreementPath 分阶段法务协议地址
	StepAgreementPath string `json:"stepAgreementPath,omitempty"`
	// IDOfStr 交易id(字符串格式)
	IDOfStr string `json:"idOfStr,omitempty"`
	// RefundStatusForAs 订单的售后退款状态
	RefundStatusForAs string `json:"refundStatusForAs,omitempty"`
	// StepPayAll 是否一次性付款
	StepPayAll bool `json:"stepPayAll,omitempty"`
	// SellerUserID 卖家数字id
	SellerUserID uint64 `json:"sellerUserId,omitempty"`
	// StepOrderList [交易3.0]分阶段交易,分阶段订单list
	StepOrderList []StepOrder `json:"stepOrderList,omitempty"`
	// BuyerAlipayID 买家支付宝id
	BuyerAlipayID string `json:"buyerAlipayId,omitempty"`
	// CreateiIme 创建时间
	CreateTime go1688.JsonTime `json:"createTime,omitempty"`
	// BusinessType 业务类型。国际站:ta(信保),wholesale(在线批发)。 中文站:普通订单类型 = "cn"; 大额批发订单类型 = "ws"; 普通拿样订单类型 = "yp"; 一分钱拿样订单类型 = "yf"; 倒批(限时折扣)订单类型 = "fs"; 加工定制订单类型 = "cz"; 协议采购订单类型 = "ag"; 伙拼订单类型 = "hp"; 供销订单类型 = "supply"; 淘工厂订单 = "factory"; 快订下单 = "quick"; 享拼订单 = "xiangpin"; 当面付 = "f2f"; 存样服务 = "cyfw"; 代销订单 = "sp"; 微供订单 = "wg";零售通 = "lst";跨境='cb';分销='distribution';采源宝='cab';加工定制="manufact"
	BusinessType BusinessType `json:"businessType,omitempty"`
	// OverSeaOrder 是否海外代发订单,是:true
	OverSeaOrder bool `json:"overSeaOrder,omitempty"`
	// RefundID 退款单ID
	RefundID string `json:"refundId,omitempty"`
	// TradeTypeDesc 下单时指定的交易方式
	TradeTypeDesc string `json:"tradeTypeDesc,omitempty"`
	// PayChannelList 支付渠道名称列表。一笔订单可能存在多种支付渠道。枚举值:支付宝,网商银行信任付,诚e赊,对公转账,赊销宝,账期支付,合并支付渠道,支付平台,声明付款,网商电子银行承兑汇票,银行转账,跨境宝,红包,其它
	PayChannelList []string `json:"payChannelList,omitempty"`
	// TradeTypeCode 下单时指定的交易方式tradeType
	TradeTypeCode string `json:"tradeTypeCode,omitempty"`
	// PayTimeout 支付超时时间,定长情况时单位:秒,目前都是定长
	PayTimeout int64 `json:"payTimeout,omitempty"`
	// PayTimeoutType 支付超时TYPE,0:定长,1:固定时间
	PayTimeoutType uint `json:"payTimeoutType,omitempty"`
}

OrderBaseInfo 订单基础信息

type OrderBizInfo

type OrderBizInfo struct {
	// OdsCyd 是否采源宝订
	OdsCyd bool `json:"odsCyd,omitempty"`
	// AccountPeriodTime 账期交易订单的到账时间
	AccountPeriodTime string `json:"accountPeriodTime,omitempty"`
	// CreditOrder 为true,表示下单时选择了诚e赊交易方式。注意不等同于“诚e赊支付”,支付时有可能是支付宝付款,具体支付方式查询tradeTerms.payWay
	CreditOrder bool `json:"creditOrder,omitempty"`
	// CreditOrderDetail 诚e赊支付详情,只有使用诚e赊付款时返回
	CreditOrderDetail *CreditOrderDetail `json:"creditOrderDetail,omitempty"`
	// PreOrderInfo 预订单信息
	PreOrderInfo *PreOrderInfo `json:"preOrderInfo,omitempty"`
	// ListOrderInfo .
	LstOrderInfo *LstOrderInfo `json:"lstOrderInfo,omitempty"`
}

OrderBizInfo 订单业务信息

type OrderCustoms

type OrderCustoms struct {
	ID          uint64          `json:"id,omitempty"`
	GmtCreate   go1688.JsonTime `json:"gmtCreate,omitempty"`
	GmtModified go1688.JsonTime `json:"gmtModified,omitempty"`
	BuyerID     uint64          `json:"buyerId,omitempty"`
	OrderID     uint64          `json:"orderId,omitempty"`
	// Type 业务数据类型,默认1:报关单
	Type int `json:"type,omitempty"`
	// Attributes 报关信息列表
	Attributes []CustomerAttributeInfo `json:"attributes,omitempty"`
}

OrderCustoms 跨境报关信息

type OrderEntryCount

type OrderEntryCount struct {
	// ID 子订单id
	ID uint64 `json:"id,omitempty"`
	// Count 子订单购买商品数量
	Count int `json:"count,omitempty"`
}

OrderEntryCount 子订单退款数量。仅在售中买家已收货(退款退货)时,可指定退货数量;默认,全部退货。

type OrderInvoiceInfo

type OrderInvoiceInfo struct {
	// InvoiceCompanyName 发票公司名称(即发票抬头-title)
	InvoiceCompanyName string `json:"invoiceCompanyName,omitempty"`
	// InvoiceType 发票类型. 0:普通发票,1:增值税发票,9未知类型
	InvoiceType int `json:"invoiceType,omitempty"`
	// LocalInvoiceID 本地发票号
	LocalInvoiceID uint64 `json:"localInvoiceId,omitempty"`
	// OrderID 订单Id
	OrderID uint64 `json:"orderId,omitempty"`
	// ReceiveCode (收件人)址区域编码
	ReceiveCode string `json:"receiveCode,omitempty"`
	// ReceiveCodeText (收件人) 省市区编码对应的文案(增值税发票信息)
	ReceiveCodeText string `json:"receiveCodeText,omitempty"`
	// ReceiveMobile (收件者)发票收货人手机
	ReceiveMobile string `json:"receiveMobile,omitempty"`
	// ReceiveName (收件者)发票收货人
	ReceiveName string `json:"receiveName,omitempty"`
	// ReceivePhone (收件者)发票收货人电话
	ReceivePhone string `json:"receivePhone,omitempty"`
	// ReceivePost (收件者)发票收货地址邮编
	ReceivePost string `json:"receivePost,omitempty"`
	// ReceiveStreet (收件人) 街道地址(增值税发票信息)
	ReceiveStreet string `json:"receiveStreet,omitempty"`
	// RegisterAccountID (公司)银行账号
	RegisterAccountID string `json:"registerAccountId,omitempty"`
	// RegisterBank (公司)开户银行
	RegisterBank string `json:"registerBank,omitempty"`
	// RegisterCode (注册)省市区编码
	RegisterCode string `json:"registerCode,omitempty"`
	// RegisterCodeText (注册)省市区文本
	RegisterCodeText string `json:"registerCodeText,omitempty"`
	// RegisterPhone (公司)注册电话
	RegisterPhone string `json:"registerPhone,omitempty"`
	// RegisterStreet (注册)街道地址
	RegisterStreet string `json:"registerStreet,omitempty"`
	// TaxPayerIdentify 纳税人识别号
	TaxPayerIdentify string `json:"taxpayerIdentify,omitempty"`
}

OrderInvoiceInfo 发票信息

type OrderMemoAddRequest

type OrderMemoAddRequest struct {
	// OrderID 交易id,订单号
	OrderID uint64 `json:"orderId,omitempty"`
	// Memo 备忘信息
	Memo string `json:"memo,omitempty"`
	// RemarkIcon 备忘图标,目前仅支持数字。1位红色图标,2为蓝色图标,3为绿色图标,4为黄色图标
	RemarkIcon string `json:"remarkIcon,omitempty"`
}

OrderMemoAddRequest 修改订单备忘 API Request

func (OrderMemoAddRequest) Map

func (r OrderMemoAddRequest) Map() map[string]string

Map implement RequestData interface

func (OrderMemoAddRequest) Name

func (r OrderMemoAddRequest) Name() string

Name implement RequestData interface

type OrderPreview

type OrderPreview struct {
	// DiscountFee 计算完货品金额后再次进行的减免金额. 单位: 分
	DiscountFee uint `json:"discountFee,omitempty"`
	// TradeModeNameList 当前交易可以支持的交易方式列表。某些场景的创建订单接口需要使用。
	TradeModeNameList []string `jsong:"tradeModeNameList,omitempty"`
	// Status 状态
	Status bool `json:"status,omitempty"`
	// TaoSampleSinglePromotion 是否有淘货源单品优惠 false:有单品优惠 true:没有单品优惠
	TaoSampleSinglePromotion bool `json:"taoSampleSinglePromotion,omitempty"`
	// SumPayment 订单总费用, 单位为分.
	SumPayment int64 `json:"sumPayment,omitempty"`
	// Message 返回信息
	Message string `json:"message,omitempty"`
	// SumCarriage 总运费信息, 单位为分.
	SumCarriage int64 `json:"sumCarriage,omitempty"`
	// ResultCode 返回码
	ResultCode string `json:"resultCode,omitempty"`
	// SumPaymentNoCarriage 不包含运费的货品总费用, 单位为分.
	SumPaymentNoCarriage int64 `json:"sumPaymentNoCarriage,omitempty"`
	// AdditionalFee 附加费,单位,分
	AdditionalFee int64 `json:"additionalFee,omitempty"`
	// FlowFlag 订单下单流程
	FlowFlag string `json:"flowFlag,omitempty"`
	// CargoList 规格信息
	CargoList []CargoInfo `json:"cargoList,omitempty"`
	// ShopPromotionList 可用店铺级别优惠列表
	ShopPromotionList []Promotion `json:"shopPromotionList,omitempty"`
	// TradeModeList 当前交易可以支持的交易方式列表。结果可以参照1688下单预览页面的交易方式。
	TradeModeList []TradeMode `json:"tradeModeList,omitempty"`
}

OrderPreview 订单预览结果

type OrderRateDetail

type OrderRateDetail struct {
	// StarLevel 评价星级
	StarLevel int `json:"starLevel,omitempty"`
	// Content 评价详情
	Content string `json:"content,omitempty"`
	// ReceiverNick 收到评价的用户昵称
	ReceiverNick string `json:"receiverNick,omitempty"`
	// PosterNick 发送评价的用户昵称
	PosterNick string `json:"posterNick,omitempty"`
	// PublishTime 评价上线时间
	PublishTime go1688.JsonTime `json:"publishTime,omitempty"`
}

OrderRateDetail 评价详情

type OrderRateInfo

type OrderRateInfo struct {
	// BuyerRateStatus 买家评价状态(4:已评论,5:未评论,6;不需要评论)
	BuyerRateStatus int `json:"buyerRateStatus,omitempty"`
	// SellerRateStatus 卖家评价状态(4:已评论,5:未评论,6;不需要评论)
	SellerRateStatus int `json:"sellerRateStatus,omitempty"`
	// BuyerRateList 卖家給买家的评价
	BuyerRateList []OrderRateDetail `json:"buyerRateList,omitempty"`
	// SellerRateList 买家給卖家的评价
	SellerRateList []OrderRateDetail `json:"sellerRateList,omitempty"`
}

OrderRateInfo 订单评价信息

type OrderRefundReason

type OrderRefundReason struct {
	// ID 原因id
	ID uint64 `json:"id,omitempty"`
	// Name 原因
	Name string `json:"name,omitempty"`
	// NeedVoucher 凭证是否必须上传
	NeedVoucher bool `json:"needVoucher,omitempty"`
	// NoRefundCarriage 是否支持退运费
	NoRefundCarriage bool `json:"noRefundCarriage,omitempty"`
	// Tip 提示
	Tip string `json:"tip,omitempty"`
}

OrderRefundReason 退款原因

func GetRefundReasonList

func GetRefundReasonList(client *go1688.Client, req *GetRefundReasonListRequest, accessToken string) ([]OrderRefundReason, error)

GetRefundReasonList 查询退款退货原因(用于创建退款退货)

type OrderRefundUploadVoucherResult added in v1.0.4

type OrderRefundUploadVoucherResult struct {
	// ImageDomain 图片域名
	ImageDomain string `json:"imageDomain,omitempty"`
	// ImageRelativeURL 图片相对路径
	ImageRelativeURL string `json:"imageRelativeURL,omitempty"`
}

OrderRefundUploadVoucherResult 上传退款退货凭证结果

func UploadRefundVoucher added in v1.0.4

func UploadRefundVoucher(client *go1688.Client, req *UploadRefundVoucherRequest, accessToken string) (*OrderRefundUploadVoucherResult, error)

UploadRefundVoucher 上传退款退货凭证

type OuterOrderInfo

type OuterOrderInfo struct {
	// MediaOrderID 机构订单号
	MediaOrderID string `json:"mediaOrderId,omitempty"`
	// Phone 电话
	Phone string `json:"phone,omitempty"`
	// Offers
	Offers []OuterOrderOffer `json:"offers,omitempty"`
}

OuterOrderInfo 机构的订单信息

type OuterOrderOffer

type OuterOrderOffer struct {
	// ID 1688商品id
	ID uint64 `json:"id,omitempty"`
	// SpecID 1688商品specId(可能无)
	SpecID string `json:"specId,omitempty"`
	// Price 媒体溢价单价(单位分)
	Price int64 `json:"price,omitempty"`
	// Num 售卖数量
	Num int64 `json:"num,omitempty"`
}

OuterOrderOffer

type OverseasExtraAddress

type OverseasExtraAddress struct {
	// ChannelName 路线名称
	ChannelName string `json:"channelName,omitempty"`
	// ChannelID 路线id
	ChannelID string `json:"channelId,omitempty"`
	// ShippingCompanyID 货代公司id
	ShippingCompanyID string `json:"shippingCompanyId,omitempty"`
	// ShippingCompanyName 货代公司名称
	ShippingCompanyName string `json:"shoppingCompanyName,omitempty"`
	// CountryCode 国家code
	CountryCode string `json:"countryCode,omitempty"`
	// Country 国家
	Country string `json:"country,omitempty"`
	// Email 买家邮箱
	Email string `json:"email,omitempty"`
}

OverseasExtraAddress 跨境地址扩展信息

type PayProtocolPayIsOpenRequest added in v1.0.5

type PayProtocolPayIsOpenRequest struct {
}

PayProtocolPayIsOpenRequest 查询是否开通免密支付 API Request

func (PayProtocolPayIsOpenRequest) Map added in v1.0.5

Map implement RequestData interface

func (PayProtocolPayIsOpenRequest) Name added in v1.0.5

Name implement RequestData interface

type PayProtocolPayIsOpenResponse added in v1.0.5

type PayProtocolPayIsOpenResponse struct {
	go1688.BaseResponse
	// Result 免密支付结果
	Result *PayProtocolPayIsOpenResult `json:"result,omitempty"`
}

PayProtocolPayIsOpenResponse 查询是否开通免密支付 API Response

func (PayProtocolPayIsOpenResponse) Error added in v1.0.5

Error implement error interface

func (PayProtocolPayIsOpenResponse) IsError added in v1.0.5

func (r PayProtocolPayIsOpenResponse) IsError() bool

IsError check success

type PayProtocolPayIsOpenResult added in v1.0.5

type PayProtocolPayIsOpenResult struct {
	// Success 是否成功
	Success go1688.Bool `json:"success,omitempty"`
	// Code 错误码
	Code string `json:"code,omitempty"`
	// Message 结果的描述
	Message string `json:"message,omitempty"`
	// Result 扣款返回值
	Result *TradeWithholdStatusResult `json:"result,omitempty"`
}

PayProtocolPayIsOpenResult 免密支付结果

func (PayProtocolPayIsOpenResult) Error added in v1.0.5

Error implement error interface

func (PayProtocolPayIsOpenResult) IsError added in v1.0.5

func (r PayProtocolPayIsOpenResult) IsError() bool

IsError check success

type PayProtocolPayPreparePayRequest added in v1.0.5

type PayProtocolPayPreparePayRequest struct {
	// OrderID 订单ID
	OrderID uint64 `json:"orderId,omitempty"`
}

PayProtocolPayPreparePayRequest 发起免密支付 API Request

func (PayProtocolPayPreparePayRequest) Map added in v1.0.5

Map implement RequestData interface

func (PayProtocolPayPreparePayRequest) Name added in v1.0.5

Name implement RequestData interface

type PayProtocolPayPreparePayResponse added in v1.0.5

type PayProtocolPayPreparePayResponse struct {
	go1688.BaseResponse
	// Result 免密支付结果
	Result *PayProtocolPayPreparePayResult `json:"result,omitempty"`
}

PayProtocolPayPreparePayResponse 发起免密支付 API Response

func (PayProtocolPayPreparePayResponse) Error added in v1.0.5

Error implement error interface

func (PayProtocolPayPreparePayResponse) IsError added in v1.0.5

IsError check success

type PayProtocolPayPreparePayResult added in v1.0.5

type PayProtocolPayPreparePayResult struct {
	// Success 是否成功
	Success go1688.Bool `json:"success,omitempty"`
	// Code 错误码
	Code string `json:"code,omitempty"`
	// Message 结果的描述
	Message string `json:"message,omitempty"`
	// Result 扣款返回值
	Result *TradeWithholdPreparePayResult `json:"result,omitempty"`
}

PayProtocolPayPreparePayResult 免密支付结果

func (PayProtocolPayPreparePayResult) Error added in v1.0.5

Error implement error interface

func (PayProtocolPayPreparePayResult) IsError added in v1.0.5

IsError check success

type PayProtocolPayRequest

type PayProtocolPayRequest struct {
	// OrderID 订单ID
	OrderID uint64 `json:"orderId,omitempty"`
}

PayProtocolPayRequest 支付宝协议代扣支付 API Request

func (PayProtocolPayRequest) Map

func (r PayProtocolPayRequest) Map() map[string]string

Map implement RequestData interface

func (PayProtocolPayRequest) Name

func (r PayProtocolPayRequest) Name() string

Name implement RequestData interface

type PayProtocolPayResponse

type PayProtocolPayResponse struct {
	go1688.BaseResponse
	// Code 错误码
	Code string `json:"code,omitempty"`
	// Message 结果的描述
	Message string `json:"message,omitempty"`
}

PayProtocolPayResponse 支付宝协议代扣支付 API Response

func (PayProtocolPayResponse) Error

func (r PayProtocolPayResponse) Error() string

Error implement error interface

func (PayProtocolPayResponse) IsError

func (r PayProtocolPayResponse) IsError() bool

IsError check success

type PreOrderInfo

type PreOrderInfo struct {
	// MarketName 创建预订单时传入的市场名
	MarketName string `json:"marketName,omitempty"`
	// CreatePreOrderApp 预订单是否为当前查询的通过当前查询的ERP创建
	CreatePreOrderApp bool `json:"createPreOrderApp,omitempty"`
}

PreOrderInfo 预订单信息

type ProductItemInfo

type ProductItemInfo struct {
	// CargoNumber 指定单品货号,国际站无需关注。该字段不一定有值,仅仅在下单时才会把货号记录(如果卖家设置了单品货号的话)。别的订单类型的货号只能通过商品接口去获取。请注意:通过商品接口获取时的货号和下单时的货号可能不一致,因为下单完成后卖家可能修改商品信息,改变了货号。
	CargoNumber string `json:"cargoNumber,omitempty"`
	// Description 描述,1688无此信息
	Description string `json:"description,omitempty"`
	// ItemAmount 实付金额,单位为元
	ItemAmount decimal.Decimal `json:"itemAmount,omitempty"`
	// Name 商品名称
	Name string `json:"name,omitempty"`
	// Price 原始单价,以元为单位
	Price decimal.Decimal `json:"price,omitempty"`
	// ID 产品ID(非在线产品为空)
	ID uint64 `json:"productID,omitempty"`
	// ImgURL 商品图片url
	ImgURL []string `json:"productImgUrl,omitempty"`
	// SnapshotURL 产品快照url,交易订单产生时会自动记录下当时的商品快照,供后续纠纷时参考
	SnapshotURL string `json:"productSnapshotUrl,omitempty"`
	// Quantity 以unit为单位的数量,例如多少个、多少件、多少箱、多少吨
	Quantity decimal.Decimal `json:"quantity,omitempty"`
	// Refund 退款金额,单位为元
	Refund decimal.Decimal `json:"refund,omitempty"`
	// SkuID
	SkuID uint64 `json:"skuID,omitempty"`
	// Sort 排序字段,商品列表按此字段进行排序,从0开始,1688不提供
	Sort int `json:"sort,omitempty"`
	// Status 子订单状态
	Status string `json:"status,omitempty"`
	// SubItemID 子订单号,或商品明细条目ID
	SubItemID uint64 `json:"subItemId,omitempty"`
	// Type 类型,国际站使用,供卖家标注商品所属类型
	Type string `json:"type,omitempty"`
	// Unit 售卖单位 例如:个、件、箱、吨
	Unit string `json:"unit,omitempty"`
	// Weight 重量 按重量单位计算的重量,例如:100
	Weight string `json:"weight,omitempty"`
	// WeightUnit 重量单位 例如:g,kg,t
	WeightUnit string `json:"weightUnit,omitempty"`
	// GuaranteesTerms 保障条款,此字段仅针对1688
	GuaranteesTerms []GuaranteesTermInfo `json:"guaranteesTerms,omitempty"`
	// ProductCargoNumber 指定商品货号,该字段不一定有值,在下单时才会把货号记录。别的订单类型的货号只能通过商品接口去获取。请注意:通过商品接口获取时的货号和下单时的货号可能不一致,因为下单完成后卖家可能修改商品信息,改变了货号。该字段和cargoNUmber的区别是:该字段是定义在商品级别上的货号,cargoNUmber是定义在单品级别的货号
	ProductCargoNumber string `json:"productCargoNumber,omitempty"`
	// SkuInfos SKU详情
	SkuInfos []SkuItemDesc `json:"skuInfos,omitempty"`
	// EntryDiscount 订单明细涨价或降价的金额
	EntryDiscount int64 `json:"entryDiscount,omitempty"`
	// SpecID 订单销售属性ID
	SpecID string `json:"specId,omitempty"`
	// QuantityFactor 以unit为单位的quantity精度系数,值为10的幂次,例如:quantityFactor=1000,unit=吨,那么quantity的最小精度为0.001吨
	QuantityFactor decimal.Decimal `json:"quantityFactor,omitempty"`
	// StatusStr 子订单状态描述
	StatusStr string `json:"statusStr,omitempty"`
	// RefundStatus WAIT_SELLER_AGREE 等待卖家同意 REFUND_SUCCESS 退款成功 REFUND_CLOSED 退款关闭 WAIT_BUYER_MODIFY 待买家修改 WAIT_BUYER_SEND 等待买家退货 WAIT_SELLER_RECEIVE 等待卖家确认收货
	RefundStatus string `json:"refundStatus,omitempty"`
	// CloseReason 关闭原因
	CloseReason string `json:"closeReason,omitempty"`
	// LogisticsStatus 1 未发货 2 已发货 3 已收货 4 已经退货 5 部分发货 8 还未创建物流订单
	LogisticsStatus int `json:"logisticsStatus,omitempty"`
	// GmtCreate 创建时间
	GmtCreate go1688.JsonTime `json:"gmtCreate,omitempty"`
	// GmtModified 修改时间
	GmtModified go1688.JsonTime `json:"gmtModified,omitempty"`
	// GmtCompleted 明细完成时间
	GmtCompleted go1688.JsonTime `json:"gmtCompleted,omitempty"`
	// GmtPayExpireTime 库存超时时间,格式为“yyyy-MM-dd HH:mm:ss”
	GmtPayExpireTime string `json:"gmtPayExpireTime,omitempty"`
	// RefundID 售中退款单号
	RefundID string `json:"refundId,omitempty"`
	// SubItemIDString 子订单号,或商品明细条目ID(字符串类型,由于Long类型的ID可能在JS和PHP中处理有问题,所以可以用字符串类型来处理)
	SubItemIDString string `json:"subItemIDString,omitempty"`
	// RefundIDForAs 售后退款单号
	RefundIDForAs string `json:"refundIdForAs,omitempty"`
}

ProductItemInfo 商品条目信息

type Promotion

type Promotion struct {
	// ID 优惠券ID
	ID string `json:"promotionId,omitempty"`
	// Selected 是否默认选中
	Selected bool `json:"selected,omitempty"`
	// Text 优惠券名称
	Text string `json:"text,omitempty"`
	// Desc 优惠券描述
	Desc string `json:"desc,omitempty"`
	// FreePostage 是否免邮
	FreePostage bool `json:"freePostage,omitempty"`
	// DiscountFee 减去金额,单位为分
	DiscountFee int64 `json:"discountFee,omitempty"`
}

Promotion 商品优惠

type QualityAssuranceType

type QualityAssuranceType = string

QualityAssuranceType 质量保证类型。国际站:pre_shipment(发货前),post_delivery(发货后)

const (
	// PRE_SHIPMENT_QA 发货前
	PRE_SHIPMENT_QA QualityAssuranceType = "pre_shipment"
	// POST_DELIVERY_QA 发货后
	POST_DELIVERY_QA QualityAssuranceType = "post_delivery"
)

type ReceiveAddress

type ReceiveAddress struct {
	// Address 街道地址,不包括省市编码
	Address string `json:"address,omitempty"`
	// AddressCode 地址区域编码
	AddressCode string `json:"addressCode,omitempty"`
	// AddressCodeText 地址区域编码对应的文本(包括国家,省,城市)
	AddressCodeText string `json:"addressCodeText,omitempty"`
	// AddressID .
	AddressID uint64 `json:"addressId,omitempty"`
	// BizType 记录收货地址的业务类型
	BizType string `json:"bizType,omitempty"`
	// IsDefault 是否为默认
	IsDefault bool `json:"isDefault,omitempty"`
	// FullName 收货人姓名
	FullName string `json:"fullName,omitempty"`
	// Latest 是否是最后选择的收货地址
	Latest bool `json:"latest,omitempty"`
	// Mobile 手机号
	Mobile string `json:"mobile,omitempty"`
	// Phone 电话
	Phone string `json:"phone,omitempty"`
	// PostCode 邮编
	PostCode string `json:"postCode,omitempty"`
}

ReceiveAddress 收获地址

func AddressCodeParse

func AddressCodeParse(client *go1688.Client, req *AddressCodeParseRequest, accessToken string) (*ReceiveAddress, error)

AddressCodeParse 根据地址解析地区码

type RefundBuyerQueryOrderRefundListRequest added in v1.0.4

type RefundBuyerQueryOrderRefundListRequest struct {
	// OrderID 订单Id
	OrderID uint64 `json:"orderId,omitempty"`
	// ApplyStartTime 退款申请时间(起始)
	ApplyStartTime go1688.JsonTime `json:"applyStartTime,omitempty"`
	// ApplyEndTime 退款申请时间(截止)
	ApplyEndTime go1688.JsonTime `json:"applyEndTime,omitempty"`
	// RefundStatusSet 退款状态列表
	RefundStatusSet []RefundStatus `json:"refundStatusSet,omitempty"`
	// SellerMemberID 卖家memberId
	SellerMemberID string `json:"sellerMemberId,omitempty"`
	// Page 当前页码
	Page int `json:"currentPageNum,omitempty"`
	// PageSize 每页条数
	PageSize int `json:"pageSize,omitempty"`
	// LogisticsNo 退货物流单号(传此字段查询时,需同时传入sellerMemberId)
	LogisticsNo string `json:"logisticsNo,omitempty"`
	// ModifyStartTime 退款修改时间(起始)
	ModifyStartTime go1688.JsonTime `json:"modifyStartTime,omitempty"`
	// ModifyEndTime 退款修改时间(截止)
	ModifyEndTime go1688.JsonTime `json:"modifyEndTime,omitempty"`
	// DisputeType 1:售中退款,2:售后退款;0:所有退款单
	DisputeType int `json:"disputeType,omitempty"`
}

RefundBuyerQueryOrderRefundListRequest 订单列表查看(买家视角) API Request

func (RefundBuyerQueryOrderRefundListRequest) Map added in v1.0.4

Map implement RequestData interface

func (RefundBuyerQueryOrderRefundListRequest) Name added in v1.0.4

Name implement RequestData interface

type RefundBuyerQueryOrderRefundListResponse added in v1.0.4

type RefundBuyerQueryOrderRefundListResponse struct {
	go1688.BaseResponse
	// Result 查询返回列表
	Result *OpQueryOrderRefundListResult `json:"result,omitempty"`
}

RefundBuyerQueryOrderRefundListResponse 订单列表查看(买家视角) API Response

type RefundGoodsStatus

type RefundGoodsStatus = string

RefundGoodsStatus 货物状态

const (
	// REFUND_WAIT_SELLER_SEND 售中等待卖家发货
	REFUND_WAIT_SELLER_SEND RefundGoodsStatus = "refundWaitSellerSend"
	// REFUND_WAIT_BUYER_RECEIVE 售中等待买家收货
	REFUND_WAIT_BUYER_RECEIVE RefundGoodsStatus = "refundWaitBuyerReceive"
	// REFUND_BUYER_RECEIVED 售中已收货(未确认完成交易)
	REFUND_BUYER_RECEIVED RefundGoodsStatus = "refundBuyerReceived"
	// AFTER_SALE_BUYER_NOT_RECEIVED 售后未收货
	AFTER_SALE_BUYER_NOT_RECEIVED RefundGoodsStatus = "aftersaleBuyerNotReceived"
	// AFTER_SALE_BUYER_RECEIVED 售后已收到货
	AFTER_SALE_BUYER_RECEIVED RefundGoodsStatus = "aftersaleBuyerReceived"
)

type RefundOpQueryBatchRefundByOrderIdAndStatusRequest added in v1.0.4

type RefundOpQueryBatchRefundByOrderIdAndStatusRequest struct {
	// OrderID 订单id
	OrderID uint64 `json:"orderId,omitempty"`
	// QueryType 1:活动;3:退款成功(只支持退款中和退款成功)
	QueryType int `json:"queryType,omitempty"`
}

RefundOpQueryBatchRefundByOrderIdAndStatusRequest 查询退款单详情-根据订单ID(买家视角)

func (RefundOpQueryBatchRefundByOrderIdAndStatusRequest) Map added in v1.0.4

Map implement RequestData interface

func (RefundOpQueryBatchRefundByOrderIdAndStatusRequest) Name added in v1.0.4

Name implement RequestData interface

type RefundOpQueryOrderRefundOperationListRequest added in v1.0.4

type RefundOpQueryOrderRefundOperationListRequest struct {
	// RefundID 退款单业务主键 TQ+ID
	RefundID string `json:"refundId,omitempty"`
	// PageNo 当前页号
	PageNo int `json:"pageNo,omitempty"`
	// PageSize 页大小
	PageSize int `json:"pageSize,omitempty"`
}

RefundOpQueryOrderRefundOperationListRequest 退款单操作记录列表(买家视角)

func (RefundOpQueryOrderRefundOperationListRequest) Map added in v1.0.4

Map implement RequestData interface

func (RefundOpQueryOrderRefundOperationListRequest) Name added in v1.0.4

Name implement RequestData interface

type RefundOpQueryOrderRefundOperationListResponse added in v1.0.4

type RefundOpQueryOrderRefundOperationListResponse struct {
	go1688.BaseResponse
	// Result 查询结果
	Result *RefundOpQueryOrderRefundOperationListResult `json:"result,omitempty"`
}

RefundOpQueryOrderRefundOperationListResponse 退款单操作记录列表(买家视角)

type RefundOpQueryOrderRefundOperationListResult added in v1.0.4

type RefundOpQueryOrderRefundOperationListResult struct {
	// List 退款模型
	List []OpOrderRefundOperationModal `json:"opOrderRefundOperationModels,omitempty"`
}

type RefundOpQueryOrderRefundRequest added in v1.0.4

type RefundOpQueryOrderRefundRequest struct {
	// RefundID 退款单业务主键 TQ+ID
	RefundID string `json:"refundId,omitempty"`
	// NeedTimeOutInfo 需要退款单的超时信息
	NeedTimeOutInfo bool `json:"needTimeOutInfo,omitempty"`
	// NeedOrderRefundOperation 需要退款单伴随的所有退款操作信息
	NeedOrderRefundOperation bool `json:"needOrderRefundOperation,omitempty"`
}

RefundOpQueryOrderRefundRequest 查询退款单详情-根据退款单ID(买家视角)

func (RefundOpQueryOrderRefundRequest) Map added in v1.0.4

Map implement RequestData interface

func (RefundOpQueryOrderRefundRequest) Name added in v1.0.4

Name implement RequestData interface

type RefundOpQueryOrderRefundResponse added in v1.0.4

type RefundOpQueryOrderRefundResponse struct {
	go1688.BaseResponse
	// Result 查询结果
	Result *RefundOpQueryOrderRefundResult `json:"result,omitempty"`
}

RefundOpQueryOrderRefundResponse 查询退款单详情-根据退款单ID(买家视角)

type RefundOpQueryOrderRefundResult added in v1.0.4

type RefundOpQueryOrderRefundResult struct {
	// List 退款模型
	List []OpOrderRefundModel `json:"opOrderRefundModelDetail,omitempty"`
}

type RefundReturnGoodsRequest

type RefundReturnGoodsRequest struct {
	// RefundID 退款单号,TQ开头
	RefundID string `json:"refundId,omitempty"`
	// LogisticsCompanyNo 物流公司编码,调用alibaba.logistics.OpQueryLogisticCompanyList.offline接口查询
	LogisticsCompanyNo string `json:"logisticsCompanyNo,omitempty"`
	// FreightBill 物流公司运单号,请准确填写,否则卖家有权拒绝退款
	FreightBill string `json:"freightBill,omitempty"`
	// Description 发货说明,内容在2-200个字之间
	Description string `json:"description,omitempty"`
	// Vouchers 凭证图片URLs,必须使用API alibaba.trade.uploadRefundVoucher返回的“图片域名/相对路径”,最多可上传 10 张图片 ;单张大小不超过1M;支持jpg、gif、jpeg、png、和bmp格式。 请上传凭证,以便以后续赔所需(不上传将无法理赔)
	Vouchers []string `json:"vouchers,omitempty"`
}

RefundReturnGoodsRequest 买家提交退款货信息 API Request

func (RefundReturnGoodsRequest) Map

Map implement RequestData interface

func (RefundReturnGoodsRequest) Name

Name implement RequestData interface

type RefundReturnGoodsResponse

type RefundReturnGoodsResponse struct {
	go1688.BaseResponse
	Result *RefundReturnGoodsResult `json:"result,omitempty"`
}

RefundReturnGoodsResponse 买家提交退款货信息 API Response

type RefundReturnGoodsResult

type RefundReturnGoodsResult struct {
	// ErrorCode 错误码
	ErrorCode string `json:"errorCode"`
	// ErrorInfo 错误信息
	ErrorInfo string `json:"errorInfo"`
	// Success 是否提交成功
	Success bool `json:"success"`
}

RefundReturnGoodsResult 买家提交退款货信息 API Result

func (RefundReturnGoodsResult) Error

func (r RefundReturnGoodsResult) Error() string

func (RefundReturnGoodsResult) IsError

func (r RefundReturnGoodsResult) IsError() bool

IsError check success

type RefundStatus

type RefundStatus = string

RefundStatus 退款状态

const (
	// REFUND_WAIT_SELLER_AGREE 等待卖家同意
	REFUND_WAIT_SELLER_AGREE RefundStatus = "waitselleragree"
	// REFUND_WAIT_BUYER_MODIFY 待买家修改
	REFUND_WAIT_BUYER_MODIFY RefundStatus = "waitbuyermodify"
	// REFUND_WAIT_BUYER_SEND 等待买家退货
	REFUND_WAIT_BUYER_SEND RefundStatus = "waitbuyersend"
	// REFUND_WAIT_SELLER_RECEIVE 等待卖家确认收货
	REFUND_WAIT_SELLER_RECEIVE RefundStatus = "waitsellerreceive"
	// REFUND_SUCCESS 退款成功
	REFUND_SUCCESS RefundStatus = "refundsuccess"
	// REFUND_CLOSE 退款成功
	REFUND_CLOSE RefundStatus = "refundclose"
)

type SkuItemDesc

type SkuItemDesc struct {
	// Name 属性名
	Name string `json:"name,omitempty"`
	// Value 属性值
	Value string `json:"value,omitempty"`
}

SkuItemDesc SKU属性

type StepOrder

type StepOrder struct {
	// ID 阶段id
	ID uint64 `json:"stepOrderId,omitempty"`
	// Status waitactivate 未开始(待激活) waitsellerpush 等待卖家推进 success 本阶段完成 settlebill 分账 cancel 本阶段终止 inactiveandcancel 本阶段未开始便终止 waitbuyerpay 等待买家付款 waitsellersend 等待卖家发货 waitbuyerreceive 等待买家确认收货 waitselleract 等待卖家XX操作 waitbuyerconfirmaction 等待买家确认XX操作
	Status StepOrderStatus `json:"stepOrderStatus,omitempty"`
	// PayStatus 1 未冻结/未付款 2 已冻结/已付款 4 已退款 6 已转交易 8 交易未付款被关闭
	PayStatus int `json:"stepPayStatus,omitempty"`
	// No 阶段序列:1、2、3...
	No int `json:"stepNo,omitepty"`
	// LastStep 是否最后一个阶段
	LastStep bool `json:"lastStep,omitempty"`
	// HasDisbursed 是否已打款给卖家
	HasDisbursed bool `json:"hasDisbursed,omitempty"`
	// PayFee 创建时需要付款的金额,不含运费
	PayFee decimal.Decimal `json:"payFee,omitempty"`
	// ActualPayFee 应付款(含运费)= 单价×数量-单品优惠-店铺优惠+运费+修改的金额(除运费外,均指分摊后的金额)
	ActualPayFee decimal.Decimal `json:"actualPayFee,omitempty"`
	// DiscountFee 本阶段分摊的店铺优惠
	DiscountFee decimal.Decimal `json:"discountFee,omitempty"`
	// ItemDiscountFee 本阶段分摊的单品优惠
	ItemDiscountFee decimal.Decimal `json:"itemDiscountFee,omitempty"`
	// Price 本阶段分摊的单价
	Price decimal.Decimal `json:"price,omitempty"`
	// Amount 购买数量
	Amount int `json:"amount,omitempty"`
	// PostFee 运费
	PostFee decimal.Decimal `json:"postFee,omitempty"`
	// AdjustPostFee 修改价格修改的金额
	AdjustPostFee decimal.Decimal `json:"adjustPostFee,omitempty"`
	// GmtCreate 创建时间
	GmtCreate go1688.JsonTime `json:"gmtCreate,omitempty"`
	// GmtModified 修改时间
	GmtModified go1688.JsonTime `json:"gmtModified,omitempty"`
	// EnterTime 开始时间
	EnterTime go1688.JsonTime `json:"enterTime,omitempty"`
	// PayTime 付款时间
	PayTime go1688.JsonTime `json:"payTime,omitempty"`
	// SellerActionTime 卖家操作时间
	SellerActionTime go1688.JsonTime `json:"sellerActionTime,omitempty"`
	// EndTime 本阶段结束时间
	EndTime go1688.JsonTime `json:"endTime,omitempty"`
	// MessagePath 卖家操作留言路径
	MessagePath string `json:"messagePath,omitempty"`
	// PicturePath 卖家上传图片凭据路径
	PicturePath string `json:"picturePath,omitempty"`
	// Message 卖家操作留言
	Message string `json:"message,omitempty"`
	// TemplateID 使用的模板id
	TemplateID uint64 `json:"templateId,omitempty"`
	// Name 当前步骤的名称
	Name string `json:"stepName,omitempty"`
	// SellerActionName 卖家操作名称
	SellerActionName string `json:"sellerActionName,omitempty"`
	// BuyerPayTimeout 买家不付款的超时时间(秒)
	BuyerPayTimeout int64 `json:"buyerPayTimeout,omitempty"`
	// BuyerConfirmTimeout 买家不确认的超时时间
	BuyerConfirmTimeout int64 `json:"buyerConfirmTimeout,omitempty"`
	// NeedLogistics 是否需要物流
	NeedLogistics bool `json:"needLogistics,omitempty"`
	// NeedSellerAction 是否需要卖家操作和买家确认
	NeedSellerAction bool `json:"needSellerAction,omitempty"`
	// TransferAfterConfirm 阶段结束是否打款
	TransferAfterConfirm bool `json:"transferAfterConfirm,omitempty"`
	// NeedSellerCallNext 是否需要卖家推进
	NeedSellerCallNext bool `json:"needSellerCallNext,omitempty"`
	// InstantPay 是否允许即时到帐
	InstantPay bool `json:"instantPay,omitempty"`
}

StepOrder [交易3.0]分阶段交易,分阶段订单

type StepOrderStatus

type StepOrderStatus = string

StepOrderStatus 分阶段交易状态

const (
	// STEP_ORDER_WAIT_ACTIVATE 未开始(待激活)
	STEP_ORDER_WAIT_ACTIVATE StepOrderStatus = "waitactive"
	// STEP_ORDER_WAIT_SELLER_PUSH 等待卖家推进
	STEP_ORDER_WAIT_SELLER_PUSH StepOrderStatus = "waitsellerpush"
	// STEP_ORDER_SUCCESS 本阶段完成
	STEP_ORDER_SUCCESS StepOrderStatus = "success"
	// STEP_ORDER_SETTLE_BILL 分账
	STEP_ORDER_SETTLE_BILL StepOrderStatus = "settlebill"
	// STEP_ORDER_CANCEL 本阶段终止
	STEP_ORDER_CANCEL StepOrderStatus = "cancel"
	// STEP_ORDER_INACTIVE_AND_CANCEL 本阶段未开始便终止
	STEP_ORDER_INACTIVE_AND_CANCEL StepOrderStatus = "inactiveandcancel"
	// STEP_ORDER_WAIT_BUYER_PAY 等待买家付款
	STEP_ORDER_WAIT_BUYER_PAY StepOrderStatus = "waitbuyerpay"
	// STE_ORDER_WAIT_SELLER_SEND 等待卖家发货
	STEP_ORDER_WAIT_SELLER_SEND StepOrderStatus = "waitsellersend"
	// STEP_ORDER_WAIT_BUYER_RECEIVE 等待买家确认收货
	STEP_ORDER_WAIT_BUYER_RECEIVE StepOrderStatus = "waitbuyerreceive"
	// STEP_ORDER_WAIT_SELLER_ACT 等待卖家XX操作
	STEP_ORDER_WAIT_SELLER_ACT StepOrderStatus = "waitselleract"
	// STEP_ORDER_WAIT_BUYER_CONFIRMATION 等待买家确认XX操作
	STEP_ORDER_WAIT_BUYER_CONFIRMATION StepOrderStatus = "waitbuyerconfirmaction"
)

type TradeAddressCode

type TradeAddressCode struct {
	// Code 地区编码
	Code string `json:"code,omitempty"`
	// Name 地区名称
	Name string `json:"name,omitempty"`
	// ParentCode 父节点编码,可能为空
	ParentCode string `json:"parentCode,omitempty"`
	// Post 邮编
	Post string `json:"post,omitempty"`
	//  Children 下一级编码列表,可能为空
	Children []string `json:"children,omitempty"`
}

TradeAddressCode 地区信息

func AddressCodeGet

func AddressCodeGet(client *go1688.Client, req *AddressCodeGetRequest, accessToken string) (*TradeAddressCode, error)

AddressCodeGet 获取交易地址代码表详情

type TradeCloseType

type TradeCloseType = string

TradeCloseType 关闭订单操作类型

const (
	// CLOSE_TRADE_BY_SELLER 卖家关闭交易
	CLOSE_TRADE_BY_SELLER TradeCloseType = "CLOSE_TRADE_BY_SELLER"
	// CLOSE_TRADE_BY_BOPS 后台关闭交
	CLOSE_TRADE_BY_BOPS TradeCloseType = "CLOSE_TRADE_BY_BOPS"
	// CLOSE_TRADE_BY_SYSTEM 系统(超时)关闭交易
	CLOSE_TRADE_BY_SYSTEM TradeCloseType = "CLOSE_TRADE_BY_SYSTEM"
	// CLOSE_TRADE_BY_BUYER 买家关闭交易
	CLOSE_TRADE_BY_BUYER TradeCloseType = "CLOSE_TRADE_BY_BUYER"
	// CLOSE_TRADE_BY_CREADIT 诚信保障投诉关闭
	CLOSE_TRADE_BY_CREADIT TradeCloseType = "CLOSE_TRADE_BY_CREADT"
)

type TradeContact

type TradeContact struct {
	// Phone 联系电话
	Phone string `json:"phone,omitempty"`
	// Fax 传真
	Fax string `json:"fax,omitempty"`
	// Email 邮箱
	Email string `json:"email,omitempty"`
	// ImInPlatform 联系人在平台的IM账号
	ImInPlatform string `json:"imInPlatform,omitempty"`
	// Name 联系人名称
	Name string `json:"name,omitempty"`
	// Mobile 联系人手机号
	Mobile string `json:"mobile,omitempty"`
	// CompanyName 公司名称
	CompanyName string `json:"companyName,omitempty"`
	// WgSenderName 发件人名称,在微供等分销场景下由分销商设置
	WgSenderName string `json:"wgSenderName,omitempty"`
	// WgSenderPhone 发件人电话,在微供等分销场景下由分销商设置
	WgSenderPhone string `json:"wgSenderPhone,omitempty"`
}

TradeContact 联系人

type TradeFlow

type TradeFlow = string

TradeFlow 价格逻辑由useChannelPrice控制;传入general使用批发价,即useChannelPrice的价格逻辑失效;传入paired使用火拼价,若该商品未参与伙拼,则下单失败。

const (
	// TRADE_FLOW_GENERAL 使用批发价
	TRADE_FLOW_GENERAL TradeFlow = "general"
	//使用火拼价,若该商品未参与伙拼,则下单失败。
	TRADE_FLOW_PAIR TradeFlow = "pair"
)

type TradeGetBuyerOrderListRequest

type TradeGetBuyerOrderListRequest struct {
	// BizTypes 业务类型,支持: "cn"(普通订单类型), "ws"(大额批发订单类型), "yp"(普通拿样订单类型), "yf"(一分钱拿样订单类型), "fs"(倒批(限时折扣)订单类型), "cz"(加工定制订单类型), "ag"(协议采购订单类型), "hp"(伙拼订单类型), "gc"(国采订单类型), "supply"(供销订单类型), "nyg"(nyg订单类型), "factory"(淘工厂订单类型), "quick"(快订下单), "xiangpin"(享拼订单), "nest"(采购商城-鸟巢), "f2f"(当面付), "cyfw"(存样服务), "sp"(代销订单标记), "wg"(微供订单), "factorysamp"(淘工厂打样订单), "factorybig"(淘工厂大货订单)
	BizTypes []string `json:"bizTypes,omitempty"`
	// CreateEndTime 下单结束时间
	CreateEndTime go1688.JsonTime `json:"createEndTime,omitempty"`
	// CreateStartTime 下单开始时间
	CreateStartTime go1688.JsonTime `json:"createStartTime,omitempty"`
	// IsHis 是否查询历史订单表,默认查询当前表,即默认值为false
	IsHis bool `json:"isHis,omitempty"`
	// ModifyEndTime 查询修改时间结束
	ModifyEndTime go1688.JsonTime `json:"modifyEndTime,omitempty"`
	// ModifyStartTime 查询修改时间开始
	ModifyStartTime go1688.JsonTime `json:"modifyStartTime,omitempty"`
	// OrderStatus 订单状态,值有 success, cancel(交易取消,违约金等交割完毕), waitbuyerpay(等待卖家付款), waitsellersend(等待卖家发货), waitbuyerreceive(等待买家收货 )
	OrderStatus TradeStatus `json:"orderStatus,omitempty"`
	// Page 查询分页页码,从1开始
	Page int `json:"page,omitempty"`
	// PageSize 查询的每页的数量
	PageSize int `json:"pageSize,omitempty"`
	// RefundStatus 退款状态,支持: "waitselleragree"(等待卖家同意), "refundsuccess"(退款成功), "refundclose"(退款关闭), "waitbuyermodify"(待买家修改), "waitbuyersend"(等待买家退货), "waitsellerreceive"(等待卖家确认收货)
	RefundStatus RefundStatus `json:"refundStatus,omitempty"`
	// SellerMemberID 卖家memberId
	SellerMemberID string `json:"sellerMemberId,omitempty"`
	// SellerRateStatus 卖家评价状态 (4:已评价,5:未评价,6;不需要评价)
	SellerRateStatus int `json:"sellerRateStatus,omitempty"`
	// TradeType 交易类型: 担保交易(1), 预存款交易(2), ETC境外收单交易(3), 即时到帐交易(4), 保障金安全交易(5), 统一交易流程(6), 分阶段交易(7), 货到付款交易(8), 信用凭证支付交易(9), 账期支付交易(10), 1688交易4.0,新分阶段交易(50060), 当面付的交易流程(50070), 服务类的交易流程(50080)
	TradeType string `json:"tradeType,omitempty"`
	// ProductName 商品名称
	ProductName string `json:"productName,omitempty"`
	// NeedBuyerAddressAndPhone 是否需要查询买家的详细地址信息和电话
	NeedBuyerAddressAndPhone bool `json:"needBuyerAddressAndPhone,omitempty"`
	// NeedMemoInfo 是否需要查询备注信息
	NeedMemoInfo bool `json:"needMemoInfo,omitempty"`
}

TradeGetBuyerOrderListRequest 订单列表查看(买家视角) API Request

func (TradeGetBuyerOrderListRequest) Map

Map implement RequestData interface

func (TradeGetBuyerOrderListRequest) Name

Name implement RequestData interface

type TradeGetBuyerOrderListResponse

type TradeGetBuyerOrderListResponse struct {
	go1688.BaseResponse
	// Result 查询返回列表
	Result []TradeInfo `json:"result,omitempty"`
	// TotalRecord 总记录数
	TotalRecord int `json:"totalRecord,omitempty"`
}

TradeGetBuyerOrderListResponse 订单列表查看(买家视角) API Response

func TradeGetBuyerOrderList

func TradeGetBuyerOrderList(client *go1688.Client, req *TradeGetBuyerOrderListRequest, accessToken string) (*TradeGetBuyerOrderListResponse, error)

TradeGetBuyerOrderList 订单列表查看(买家视角)

type TradeGetBuyerViewRequest

type TradeGetBuyerViewRequest struct {
	// Website 站点信息,指定调用的API是属于国际站(alibaba)还是1688网站(1688)
	Website APIWebsite `json:"webSite,omitempty"`
	// OrderID 交易id,订单号
	OrderID uint64 `json:"orderId"`
	// IncludeFields 查询结果中包含的域,GuaranteesTerms:保障条款,NativeLogistics:物流信息,RateDetail:评价详情,OrderInvoice:发票信息。默认返回GuaranteesTerms、NativeLogistics、OrderInvoice。
	IncludeFields string `json:"includeFields,omitempty"`
	// AttributeKeys 垂直表中的attributeKeys
	AttributeKeys []string `json:"attributeKeys,omitempty"`
}

TradeGetBuyerViewRequest 订单详情查看(买家视角) API Request

func (TradeGetBuyerViewRequest) Map

Map implement ReqeustData interface

func (TradeGetBuyerViewRequest) Name

Name implement ReqeustData interface

type TradeGetBuyerViewResponse

type TradeGetBuyerViewResponse struct {
	go1688.BaseResponse
	Result *TradeInfo `json:"result,omitempty"`
}

TradeGetBuyerViewResponse 订单详情查看(买家视角) API Response

type TradeInfo

type TradeInfo struct {
	// BaseInfo 订单基础信息
	BaseInfo *OrderBaseInfo `json:"baseInfo,omitempty"`
	// BizInfo 订单业务信息
	BizInfo *OrderBizInfo `json:"orderBizInfo,omitempty"`
	// TradeTerms 交易条款
	TradeTerms []TradeTermInfo `json:"tradeTerms,omitempty"`
	// ProductItems 商品条目信息
	ProductItems []ProductItemInfo `json:"productItems,omitempty"`
	// NativeLogistics 国内物流
	NativeLogistics *NativeLogisticsInfo `json:"nativeLogistics,omitempty"`
	// InvoiceInfo 发票信息
	InvoiceInfo *OrderInvoiceInfo `json:"orderInvoiceInfo,omitempty"`
	// GuaranteesTerms 保障条款
	GuaranteesTerms *GuaranteesTermInfo `json:"guaranteesTerms,omitempty"`
	// OrderRateInfo 订单评价信息
	OrderRateInfo *OrderRateInfo `json:"orderRateInfo,omitempty"`
	// OverseasExtraAddress 跨境地址扩展信息
	OverseasExtraAddress *OverseasExtraAddress `json:"overseasExtraAddress,omitempty"`
	// Customs 跨境报关信息
	Customs *OrderCustoms `json:"customs,omitempty"`
	// QuoteList 采购单详情列表,为大企业采购订单独有域。
	QuoteList []CaigouQuoteInfo `json:"quoteList,omitempty"`
	// ExtAttributes 订单扩展属性
	ExtAttributes []KeyValuePair `json:"extAttributes,omitempty"`
}

TradeInfo 交易信息

func TradeGetBuyerView

func TradeGetBuyerView(client *go1688.Client, req *TradeGetBuyerViewRequest, accessToken string) (*TradeInfo, error)

TradeGetBuyerView 订单详情查看(买家视角)

type TradeMode

type TradeMode struct {
	// TradeWay 交易方式
	TradeWay string `json:"tradeWay,omitempty"`
	// Name 交易方式名称
	Name string `json:"name,omitempty"`
	// TradeType 开放平台下单时候传入的tradeType
	TradeType TradeType `json:"tradeType,omitempty"`
	// Description 交易描述
	Description string `json:"description,omitempty"`
	// OpSupport 是否支持
	OpSupport bool `json:"opSupport,omitempty"`
}

TradeMode 当前交易可以支持的交易方式

type TradePaymentAgreement added in v1.0.5

type TradePaymentAgreement struct {
	// PayChannel 支付成功渠道
	PayChannel string `json:"payChannel,omitempty"`
	// BindingStatus 支付宝或者诚E赊是否已设置绑定,signedStatus和bindingStatus均为true才能发起代扣
	BindingStatus go1688.Bool `json:"bindingStatus,omitempty"`
	// SignedStatus 支付宝或者诚E赊是否已签约代扣,signedStatus和bindingStatus均为true才能发起代扣
	SignedStatus go1688.Bool `json:"signedStatus,omitempty"`
	// SignURL 签约URl
	SignURL string `json:"signUrl,omitempty"`
	// AgreementNo 签约单号
	AgreementNo string `json:"agreementNo,omitempty"`
}

TradePaymentAgreement

func PayProtocolPayIsOpen added in v1.0.5

func PayProtocolPayIsOpen(client *go1688.Client, req *PayProtocolPayIsOpenRequest, accessToken string) ([]TradePaymentAgreement, error)

PayProtocolPayIsOpen 查询是否开通免密支付

type TradeStatus

type TradeStatus = string
const (
	// TRADE_WAIT_BUYER_PAY 等待买家付款
	TRADE_WAIT_BUYER_PAY TradeStatus = "waitbuyerpay"
	// TRADE_WAIT_SELLER_SEND 等待卖家发货
	TRADE_WAIT_SELLER_SEND TradeStatus = "waitsellersend"
	// TRADE_WAIT_BUYER_RECEIVE 等待买家收货
	TRADE_WAIT_BUYER_RECEIVE TradeStatus = "waitbuyerreceive"
	// TRADE_CONFIRM_GOODS 已收货
	TRADE_CONFIRM_GOODS TradeStatus = "confirm_goods"
	// TRADE_SUCCESS 交易成功
	TRADE_SUCCESS TradeStatus = "success"
	// TRADE_CANCEL 交易取消
	TRADE_CANCEL TradeStatus = "cancel"
	// TRADE_TERMINATED 交易终止
	TRADE_TERMINATED TradeStatus = "terminated"
	// TRADE_UNKNOWN 其它
	TRADE_UNKNOWN TradeStatus = ""
)

type TradeTermInfo

type TradeTermInfo struct {
	// PayStatus 支付状态。国际站:WAIT_PAY(未支付),PAYER_PAID(已完成支付),PART_SUCCESS(部分支付成功),PAY_SUCCESS(支付成功),CLOSED(风控关闭),CANCELLED(支付撤销),SUCCESS(成功),FAIL(失败)。 1688:1(未付款);2(已付款);4(全额退款);6(卖家有收到钱,回款完成) ;7(未创建外部支付单);8 (付款前取消) ; 9(正在支付中);12(账期支付,待到账)
	PayStatus string `json:"payStatus,omitempty"`
	// PayTime 完成阶段支付时间
	PayTime go1688.JsonTime `json:"payTime,omitempty"`
	// PayWay 支付方式。 国际站:ECL(融资支付),CC(信用卡),TT(线下TT),ACH(echecking支付)。 1688:1-支付宝,2-网商银行信任付,3-诚e赊,4-银行转账,5-赊销宝,6-电子承兑票据,7-账期支付,8-合并支付渠道,9-无打款,10-零售通赊购,13-支付平台,12-声明付款
	PayWay string `json:"payWay,omitempty"`
	// PhasAmount 付款额
	PhasAmount decimal.Decimal `json:"phasAmount,omitempty"`
	// Phase 阶段单id
	Phase uint64 `json:"phase,omitempty"`
	// PhaseCondition 阶段条件,1688无此内容
	PhaseCondition string `json:"phaseCondition,omitempty"`
	// PhaseDate 阶段时间,1688无此内容
	PhaseDate string `json:"phaseDate,omitempty"`
	// CardPay 是否银行卡支付
	CardPay bool `json:"cardPay,omitempty"`
	// ExpressPay 是否快捷支付
	ExpressPay bool `json:"expressPay,omitempty"`
	// PayWayDesc 支付方式
	PayWayDesc string `json:"payWayDesc,omitempty"`
}

TradeTermInfo 交易条款

type TradeType

type TradeType = string

TradeType 交易方式类型

const (
	// FXASSURE_TRADE 交易4.0通用担保交易
	FXASSURE_TRADE TradeType = "fxassure"
	// ALIPAY_TRADE 大市场通用的支付宝担保交易(目前在做切流,后续会下掉)
	ALIPAY_TRADE TradeType = "alipay"
	// PERIOD_TRADE 普通账期交易
	PERIOD_TRADE TradeType = "period"
	// ASSURE_TRADE 大买家企业采购询报价下单时需要使用的担保交易流程
	ASSURE_TRADE TradeType = "assure"
	// CREDIT_BUY_TRADE 诚E赊
	CREDIT_BUY_TRADE TradeType = "creditBuy"
	// BANK_TRADE 银行转账
	BANK_TRADE TradeType = "bank"
	// STAGED631_TRADE 631分阶段付款
	STAGED631_TRADE TradeType = "631staged"
	// STAGED37_TRADE 37分阶段
	STAGED37_TRADE TradeType = "37staged"
)

type TradeWithholdPreparePayResult added in v1.0.5

type TradeWithholdPreparePayResult struct {
	// PayChannel 支付成功渠道
	PayChannel string `json:"payChannel,omitempty"`
	// PaySuccess 支付是否成功
	PaySuccess bool `json:"paySuccess,omitempty"`
}

TradeWithholdPreparePayResult

func PayProtocolPayPreparePay added in v1.0.5

func PayProtocolPayPreparePay(client *go1688.Client, req *PayProtocolPayPreparePayRequest, accessToken string) (*TradeWithholdPreparePayResult, error)

PayProtocolPayPreparePay 发起免密支付

type TradeWithholdStatusResult added in v1.0.5

type TradeWithholdStatusResult struct {
	// PaymentAgreements .
	PaymentAgreements []TradePaymentAgreement `json:"paymentAgreements,omitempty"`
}

TradeWithholdStatusResult 签约状态

type UploadRefundVoucherRequest added in v1.0.4

type UploadRefundVoucherRequest struct {
	// ImageData 凭证图片数据。小于1M,jpg格式。
	ImageData io.Reader `json:"imageData,omitempty"`
}

UploadRefundVoucherRequest 上传退款退货凭证 API Request

func (UploadRefundVoucherRequest) Files added in v1.0.4

Files implement UploadRequestData interface

func (UploadRefundVoucherRequest) Map added in v1.0.4

Map implement UploadRequestData interface

func (UploadRefundVoucherRequest) Name added in v1.0.4

Name implement RequestData interface

type UploadRefundVoucherResponse added in v1.0.4

type UploadRefundVoucherResponse struct {
	go1688.BaseResponse
	Result *UploadRefundVoucherResult `json:"result,omitempty"`
}

UploadRefundVoucherResponse 上传退款退货凭证 API Response

type UploadRefundVoucherResult added in v1.0.4

type UploadRefundVoucherResult struct {
	// Code 错误码
	Code string `json:"code"`
	// Message 错误信息
	Message string `json:"message"`
	// Success 是否提交成功
	Success bool `json:"success"`
	// Result 上传退款退货凭证结果
	Result *OrderRefundUploadVoucherResult `json:"result,omitempty"`
}

UploadRefundVoucherResult 返回结果

func (UploadRefundVoucherResult) Error added in v1.0.4

func (UploadRefundVoucherResult) IsError added in v1.0.4

func (r UploadRefundVoucherResult) IsError() bool

IsError check success

Jump to

Keyboard shortcuts

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