packages

package
v0.1.211 Latest Latest
Warning

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

 Go to latest Published: Dec 15, 2021 License: MIT Imports: 0 Imported by: 0

README

packages

订单类接口 订单列表 订单详情

Documentation

Index

Constants

View Source 
const (
	URL_PACKAGES_DETAIL    = "/ark/open_api/v0/packages/{package_id}" // 订单详情路由
	METHOD_PACKAGES_DETAIL = "package.getPackageDetail"
)
View Source 
const (
	URL_PACKAGES_LIST    = "/ark/open_api/v0/packages" // 订单列表路由
	METHOD_PACKAGES_LIST = "package.getPackageList"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type CancelStatus added in v0.1.1 

type CancelStatus int

CancelStatus 申请取消状态 

const (
	CANCEL_0 CancelStatus = iota // 未申请取消
	CANCEL_1                     // 取消处理中
)

func (CancelStatus) Int added in v0.1.1 

func (c CancelStatus) Int() int

Int ...

type IsChannel added in v0.1.1 

type IsChannel bool

IsChannel 是否是渠道商品 

const (
	CHANNEL_TRUE  IsChannel = true  // 渠道商品
	CHANNEL_FALSE           = false // 非渠道商品
)

func (IsChannel) Bool added in v0.1.1 

func (i IsChannel) Bool() bool

Bool ...

type IsGift added in v0.1.1 

type IsGift bool

IsGift 是否是赠品 

const (
	GIFT_TRUE  IsGift = true  // 赠品
	GIFT_FALSE        = false // 非赠品
)

func (IsGift) Bool added in v0.1.1 

func (i IsGift) Bool() bool

Bool ...

type LogisticsMode 

type LogisticsMode string
const (
	EXPRESS        LogisticsMode = "red_express"        // 三方备货直邮(备货海外仓)
	DOMESTIC_TRADE LogisticsMode = "red_domestic_trade" // (三方备货内贸)
	STANDARD       LogisticsMode = "red_standard"       // (三方备货保税仓)
	AUTO           LogisticsMode = "red_auto"           // (三方自主发货)
	BOX            LogisticsMode = "red_box"            // (三方小包)
	BONDED         LogisticsMode = "red_bonded"         // (三方保税)
)

func (LogisticsMode) String added in v0.0.11 

func (l LogisticsMode) String() string

type PackageAfterSalesStatus added in v0.1.1 

type PackageAfterSalesStatus int

PackageAfterSalesStatus 售后状态 

const (
	NONE     PackageAfterSalesStatus = iota + 1 // 无售后
	HANDLING                                    // 售后处理中
	COMPLETE                                    // 售后完成（含取消）
)

func (PackageAfterSalesStatus) Int added in v0.1.1 

func (p PackageAfterSalesStatus) Int() int

Int ...

type PackageStatus added in v0.1.1 

type PackageStatus int

PackageStatus 包裹状态 

const (
	ALL PackageStatus = iota // 全部

)

func (PackageStatus) Int added in v0.1.1 

func (p PackageStatus) Int() int

Int ...

type PackageType added in v0.1.1 

type PackageType int

PackageType 包裹类型 

const (
	NULL         PackageType = iota // 全部
	NORMAL                          // 普通
	PREORDER                        // 定金预售
	FULLPREORDER                    // 全额预售
	DELAY                           // 延迟发货
	CHANGE                          // 换货补发
)

func (PackageType) Int added in v0.1.1 

func (p PackageType) Int() int

Int ...

type ReqDetail added in v0.1.1 

type ReqDetail struct {
	PackageId string `json:"packageId" mapstructure:"packageId"` // 包裹号
}

ReqDetail 订单详情请求

type ReqList added in v0.1.1 

type ReqList struct {
	StartTime     int           `json:"startTime" param:"startTime"`         // 时间范围起点
	EndTime       int           `json:"endTime" param:"endTime"`             // 时间范围终点
	TimeType      TimeType      `json:"timeType" param:"timeType"`           // startTime/endTime对应的时间类型，1 创建时间 限制 end-start<=24h、2 更新时间 限制 end-start<=30min 倒序拉取 最后一页到第一页
	PackageType   PackageType   `json:"packageType" param:"packageType"`     // 包裹类型，0/null 全部 1 普通 normal 2 定金预售 3 全款预售 4 延迟发货 5 换货补发
	PackageStatus PackageStatus `json:"packageStatus" param:"packageStatus"` // 包裹状态，0全部 1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中
	PageNo        int           `json:"pageNo" param:"pageNo"`               // 页码，默认1，限制100
	PageSize      int           `json:"pageSize" param:"pageSize"`           // 查询总数，默认50，限制100
}

ReqList 订单列表参数

type RspDetail added in v0.1.1 

type RspDetail struct {
	PackageId                string                  `json:"packageId" mapstructure:"packageId"`                               // 包裹号
	OrderId                  string                  `json:"orderId" mapstructure:"orderId"`                                   // 母单号
	PackageType              PackageType             `json:"packageType" mapstructure:"packageType"`                           // 包裹类型，1普通 2定金预售 3全款预售 4延迟发货 5换货补发
	PackageStatus            PackageStatus           `json:"packageStatus" mapstructure:"packageStatus"`                       // 包裹状态，1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中
	PackageAfterSalesStatus  PackageAfterSalesStatus `json:"packageAfterSalesStatus" mapstructure:"packageAfterSalesStatus"`   // 售后状态，1无售后 2售后处理中 3售后完成(含取消)
	CancelStatus             CancelStatus            `json:"cancelStatus" mapstructure:"cancelStatus"`                         // 申请取消状态，0未申请取消 1取消处理中
	CreatedTime              int64                   `json:"createdTime" mapstructure:"createdTime"`                           // 创建时间 单位ms
	PaidTime                 int64                   `json:"paidTime" mapstructure:"paidTime"`                                 // 支付时间 单位ms
	UpdateTime               int64                   `json:"updateTime" mapstructure:"updateTime"`                             // 更新时间 单位ms
	DeliveryTime             int64                   `json:"deliveryTime" mapstructure:"deliveryTime"`                         // 包裹发货时间 单位ms
	CancelTime               int64                   `json:"cancelTime" mapstructure:"cancelTime"`                             // 包裹取消时间 单位ms
	FinishTime               int64                   `json:"finishTime" mapstructure:"finishTime"`                             // 包裹完成时间 单位ms
	PromiseLastDeliveryTime  int64                   `json:"promiseLastDeliveryTime" mapstructure:"promiseLastDeliveryTime"`   // 承诺最晚发货时间 单位ms
	PlanInfoId               string                  `json:"planInfoId" mapstructure:"planInfoId"`                             // 物流方案id
	PlanInfoName             string                  `json:"planInfoName" mapstructure:"planInfoName"`                         // 物流方案名称
	ReceiverCountryId        string                  `json:"receiverCountryId" mapstructure:"receiverCountryId"`               // 收件人国家id
	ReceiverCountryName      string                  `json:"receiverCountryName" mapstructure:"receiverCountryName"`           // 目前仅 中国
	ReceiverProvinceId       string                  `json:"receiverProvinceId" mapstructure:"receiverProvinceId"`             // 收件人省份id
	ReceiverProvinceName     string                  `json:"receiverProvinceName" mapstructure:"receiverProvinceName"`         // 收件人省份
	ReceiverCityId           string                  `json:"receiverCityId" mapstructure:"receiverCityId"`                     // 收件人城市id
	ReceiverCityName         string                  `json:"receiverCityName" mapstructure:"receiverCityName"`                 // 收件人城市
	ReceiverDistrictId       string                  `json:"receiverDistrictId" mapstructure:"receiverDistrictId"`             // 收件人区县id
	ReceiverDistrictName     string                  `json:"receiverDistrictName" mapstructure:"receiverDistrictName"`         // 收件人区县名称
	CustomerRemark           string                  `json:"customerRemark" mapstructure:"customerRemark"`                     // 用户备注
	SellerRemark             string                  `json:"sellerRemark" mapstructure:"sellerRemark"`                         // 商家标记备注
	SellerRemarkFlag         SellerRemarkFlag        `json:"sellerRemarkFlag" mapstructure:"sellerRemarkFlag"`                 // 商家标记优先级，ark订单列表展示旗子颜色 1灰旗 2红旗 3黄旗 4绿旗 5蓝旗 6紫旗
	PresaleDeliveryStartTime int64                   `json:"presaleDeliveryStartTime" mapstructure:"presaleDeliveryStartTime"` // 预售最早发货时间 单位ms
	PresaleDeliveryEndTime   int64                   `json:"presaleDeliveryEndTime" mapstructure:"presaleDeliveryEndTime"`     // 预售最晚发货时间 单位ms
	ItemList                 []struct {
		ItemId       string `json:"itemId" mapstructure:"itemId"`             // 商品id
		ItemName     string `json:"itemName" mapstructure:"itemName"`         // 商品名称
		Erpcode      string `json:"erpcode" mapstructure:"erpcode"`           // 商家编码(若为组合品，暂不支持组合品的商家编码，但skulist会返回子商品商家编码)
		ItemSpec     string `json:"itemSpec" mapstructure:"itemSpec"`         // 规格
		ItemImage    string `json:"itemImage" mapstructure:"itemImage"`       // 商品图片url
		ItemQuantity int    `json:"itemQuantity" mapstructure:"itemQuantity"` // 商品数量
		SkuList      []struct {
			ItemId                 string `json:"itemId" mapstructure:"itemId"`                                 // 单品商品Id(渠道商品为生成渠道商品的原商品单品id，组合商品为各个子商品的单品id，多包组为对应单包组商品id,商家编码同理)
			ErpCode                string `json:"erpCode" mapstructure:"erpCode"`                               // 商家编码
			Barcode                string `json:"barcode" mapstructure:"barcode"`                               // 商品条码
			SkuCode                string `json:"skuCode" mapstructure:"skuCode"`                               // 商品编码
			Quantity               int    `json:"quantity" mapstructure:"quantity"`                             // 购买数量
			RegisterName           string `json:"registerName" mapstructure:"registerName"`                     // 商品备案名称
			ItemName               string `json:"itemName" mapstructure:"itemName"`                             // 商品名
			PricePerSku            int    `json:"pricePerSku" mapstructure:"pricePerSku"`                       // 单个sku价格
			TaxPerSku              int    `json:"taxPerSku" mapstructure:"taxPerSku"`                           // 单个sku税金
			PaidAmountPerSku       int    `json:"paidAmountPerSku" mapstructure:"paidAmountPerSku"`             // 单个sku实付
			DepositAmountPerSku    int    `json:"depositAmountPerSku" mapstructure:"depositAmountPerSku"`       // 单个sku定金
			MerchantDiscountPerSku int    `json:"merchantDiscountPerSku" mapstructure:"merchantDiscountPerSku"` // 单个sku商家承担优惠
			RedDiscountPerSku      int    `json:"redDiscountPerSku" mapstructure:"redDiscountPerSku"`           // 单个sku平台承担优惠
			RawPricePerSku         int    `json:"rawPricePerSku" mapstructure:"rawPricePerSku"`                 // 单个sku原价
		} `json:"skuList" mapstructure:"skuList"` // 商品sku信息列表（可能出现相同skuCode不同价格的状况）
		TotalPaidAmount       int       `json:"totalPaidAmount" mapstructure:"totalPaidAmount"`             // 总支付金额（考虑总件数）商品总实付
		TotalMerchantDiscount int       `json:"totalMerchantDiscount" mapstructure:"totalMerchantDiscount"` // 商家承担总优惠
		TotalRedDiscount      int       `json:"totalRedDiscount" mapstructure:"totalRedDiscount"`           // 平台承担总优惠
		TotalTaxAmount        int       `json:"totalTaxAmount" mapstructure:"totalTaxAmount"`               // 商品税金
		TotalNetWeight        float32   `json:"totalNetWeight" mapstructure:"totalNetWeight"`               // 商品总净重
		ItemTag               IsGift    `json:"itemTag" mapstructure:"itemTag"`                             // 是否赠品，1 赠品 0 普通商品
		IsChannel             IsChannel `json:"isChannel" mapstructure:"isChannel"`                         // 是否是渠道商品
		Channel               string    `json:"channel" mapstructure:"channel"`                             // -
	} `json:"itemList" mapstructure:"itemList"` // item列表 相同itemid聚合 金额为相同item下sku价格总和 单位 分
	OriginalPackageId    string `json:"originalPackageId" mapstructure:"originalPackageId"`       // 原始关联包裹号(退换包裹的原包裹)
	TotalNetWeightAmount int    `json:"totalNetWeightAmount" mapstructure:"totalNetWeightAmount"` // 订单商品总净重 单位g
	TotalPayAmount       int    `json:"totalPayAmount" mapstructure:"totalPayAmount"`             // 订单实付金额(包含运费) 单位分
	TotalShippingFree    int    `json:"totalShippingFree" mapstructure:"totalShippingFree"`       // 包裹运费 单位分
	Unpack               bool   `json:"unpack" mapstructure:"unpack"`                             // 是否拆包 true已拆包 false未拆包
	ExpressTrackingNo    string `json:"expressTrackingNo" mapstructure:"expressTrackingNo"`       // 快递单号
	ExpressCompanyCode   string `json:"expressCompanyCode" mapstructure:"expressCompanyCode"`     // 快递公司编码
	ReceiverName         string `json:"receiverName" mapstructure:"receiverName"`                 // 收件人姓名 暂不返回 详情通过getReceiverInfo获取
	ReceiverPhone        string `json:"receiverPhone" mapstructure:"receiverPhone"`               // 收件人手机 暂不返回 详情通过getReceiverInfo获取
	ReceiverAddress      string `json:"receiverAddress" mapstructure:"receiverAddress"`           // 收件人地址 暂不返回 详情通过getReceiverInfo获取
	BoundExtendInfo      struct {
		PayNo          string   `json:"payNo" mapstructure:"payNo"`                   // 交易流水号
		PayChannel     string   `json:"payChannel" mapstructure:"payChannel"`         // 交易渠道
		ProductValue   string   `json:"productValue" mapstructure:"productValue"`     // 订单价值（货值，订单商品申价之和（税前价））
		PayAmount      string   `json:"payAmount" mapstructure:"payAmount"`           // 订单支付金额（含运费）
		TaxAmount      string   `json:"taxAmount" mapstructure:"taxAmount"`           // 订单税金
		ShippingFee    string   `json:"shippingFee" mapstructure:"shippingFee"`       // 运费 含运费税
		DiscountAmount string   `json:"discountAmount" mapstructure:"discountAmount"` // 订单优惠
		ZoneCodes      []string `json:"zoneCodes" mapstructure:"zoneCodes"`           // 海关三级地址区域编码
	} `json:"boundExtendInfo" mapstructure:"boundExtendInfo"` // 三方保税节点 金额单位 分
	TransferExtendInfo struct {
		InternationalExpressNo string `json:"internationalExpressNo" mapstructure:"internationalExpressNo"` // 国际快递单号
		OrderDeclaredAmount    string `json:"orderDeclaredAmount" mapstructure:"orderDeclaredAmount"`       // 订单申报金额
		PaintMarker            string `json:"paintMarker" mapstructure:"paintMarker"`                       // 大头笔
		CollectionPlace        string `json:"collectionPlace" mapstructure:"collectionPlace"`               // 集包地
		ThreeSegmentCode       string `json:"threeSegmentCode" mapstructure:"threeSegmentCode"`             // 三段码
	} `json:"transferExtendInfo" mapstructure:"transferExtendInfo"` // 小包转运节点
	OpenAddressId             string `json:"openAddressId" mapstructure:"openAddressId"` // 收件人姓名+手机+地址等计算得出，用来查询收件人详情
	SimpleDeliveryPackageList []struct {
		DeliveryPackageIndex string        `json:"deliveryPackageIndex" mapstructure:"deliveryPackageIndex"` // 发货包裹索引标识 修改快递单号会使用
		Status               PackageStatus `json:"status" mapstructure:"status"`                             // 发货包裹状态,1:已下单待付款 2:已支付处理中 3:清关中 4:待发货 6:待收货 7:已完成 8:已关闭 9:已取消 10:换货申请中
		ExpressTrackingNo    string        `json:"expressTrackingNo" mapstructure:"expressTrackingNo"`       // 拆包快递单号
		ExpressCompanyCode   string        `json:"expressCompanyCode" mapstructure:"expressCompanyCode"`     // 快递公司代码
		ItemIdList           []string      `json:"itemIdList" mapstructure:"itemIdList"`                     // 此发货包裹中有哪些商品，status=4待发货时，列表中的item可以拆包发货。status=6时，列表中的item共享相同的快递公司和单号，修改时一起修改
	} `json:"simpleDeliveryPackageList" mapstructure:"simpleDeliveryPackageList"` // 拆包信息节点
	Logistics LogisticsMode `json:"logistics" mapstructure:"logistics"` // 物流模式red_express三方备货直邮(备货海外仓),red_domestic_trade(三方备货内贸),red_standard(三方备货保税仓),red_auto(三方自主发货),red_box(三方小包),red_bonded(三方保税)
}

RspDetail 订单详情返回

type RspList added in v0.1.1 

type RspList struct {
	Total       int `json:"total" mapstructure:"total"`         // 包裹总数
	PageNo      int `json:"pageNo" mapstructure:"pageNo"`       // 当前页数 请求参数中的值
	PageSize    int `json:"pageSize" mapstructure:"pageSize"`   // 页大小 请求参数中的值
	MaxPageNo   int `json:"maxPageNo" mapstructure:"maxPageNo"` // 最大页码数 方便 直接从最后一页拉数据
	PackageList []struct {
		PackageId               string                  `json:"packageId" mapstructure:"packageId"`                                // 包裹号
		OrderId                 string                  `json:"orderId" mapstructure:"orderId"`                                    // 母单号
		PackageType             PackageType             `json:"packageType" mapstructure:"package_type"`                           // 包裹类型，1普通 2定金预售 3全款预售 4延迟发货 5换货补发
		PackageStatus           PackageStatus           `json:"packageStatus" mapstructure:"package_status"`                       // 包裹状态，1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中
		PackageAfterSalesStatus PackageAfterSalesStatus `json:"packageAfterSalesStatus" mapstructure:"package_after_sales_status"` // 售后状态，1无售后 2售后处理中 3售后完成(含取消)
		CancelStatus            CancelStatus            `json:"cancelStatus" mapstructure:"cancel_status"`                         // 申请取消状态，0未申请取消 1取消处理中
		CreatedTime             int64                   `json:"createdTime" mapstructure:"created_time"`                           // 创建时间 单位ms
		PaidTime                int64                   `json:"paidTime" mapstructure:"paid_time"`                                 // 支付时间 单位ms
		UpdateTime              int64                   `json:"updateTime" mapstructure:"update_time"`                             // 更新时间 单位ms
		DeliveryTime            int64                   `json:"deliveryTime" mapstructure:"delivery_time"`                         // 包裹发货时间 单位ms
		CancelTime              int64                   `json:"cancelTime" mapstructure:"cancel_time"`                             // 包裹取消时间 单位ms
		FinishTime              int64                   `json:"finishTime" mapstructure:"finish_time"`                             // 包裹完成时间 单位ms
		PromiseLastDeliveryTime int64                   `json:"promiseLastDeliveryTime" mapstructure:"promise_last_delivery_time"` // 承诺最晚发货时间 单位ms
		PlanInfoId              string                  `json:"planInfoId" mapstructure:"plan_info_id"`                            // 物流方案id
		PlanInfoName            string                  `json:"planInfoName" mapstructure:"plan_info_name"`                        // 物流方案名称
		ReceiverCountryId       string                  `json:"receiverCountryId" mapstructure:"receiver_country_id"`              // 收件人国家id
		ReceiverCountryName     string                  `json:"receiverCountryName" mapstructure:"receiver_country_name"`          // 目前仅 中国
		ReceiverProvinceId      string                  `json:"receiverProvinceId" mapstructure:"receiver_province_id"`            // 收件人省份id
		ReceiverProvinceName    string                  `json:"receiverProvinceName" mapstructure:"receiver_province_name"`        // 收件人省份
		ReceiverCityId          string                  `json:"receiverCityId" mapstructure:"receiver_city_id"`                    // 收件人城市id
		ReceiverCityName        string                  `json:"receiverCityName" mapstructure:"receiver_city_name"`                // 收件人城市
		ReceiverDistrictId      string                  `json:"receiverDistrictId" mapstructure:"receiver_district_id"`            // 收件人区县id
		ReceiverDistrictName    string                  `json:"receiverDistrictName" mapstructure:"receiver_district_name"`        // 收件人区县名称
		CustomerRemark          string                  `json:"customerRemark" mapstructure:"customer_remark"`                     // 用户备注
		SellerRemark            string                  `json:"sellerRemark" mapstructure:"seller_remark"`                         // 商家标记备注
		SellerRemarkFlag        SellerRemarkFlag        `json:"sellerRemarkFlag" mapstructure:"seller_remark_flag"`                // 商家标记优先级，ark订单列表展示旗子颜色 1灰旗 2红旗 3黄旗 4绿旗 5蓝旗 6紫旗
		OriginalPackageId       string                  `json:"originalPackageId" mapstructure:"original_package_id"`              // 原始包裹编号，换货包裹的原包裹
		Logistics               LogisticsMode           `json:"logistics" mapstructure:"logistics"`                                // 物流模式: red_express三方备货直邮(备货海外仓),red_domestic_trade(三方备货内贸),red_standard(三方备货保税仓),red_auto(三方自主发货),red_box(三方小包),red_bonded(三方保税)
	} `json:"packageList" mapstructure:"package_list"` // 包裹信息
}

RspList 订单列表返回

type SellerRemarkFlag added in v0.1.1 

type SellerRemarkFlag int

SellerRemarkFlag 商家标记优先级 

const (
	GRAY   SellerRemarkFlag = iota + 1 // 灰
	RED                                // 红
	YELLOW                             // 黄
	GREEN                              // 绿
	BLUE                               // 蓝
	P                                  // 紫
)

func (SellerRemarkFlag) Int added in v0.1.1 

func (s SellerRemarkFlag) Int() int

Int ...

type TimeType 

type TimeType int

TimeType startTime/endTime对应的时间类型 

const (
	CREATED TimeType = iota + 1 // 创建时间
	UPDATED                     // 更新时间
)

func (TimeType) Int added in v0.1.1 

func (t TimeType) Int() int

Int ...

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.