express

type AddOrderRequest struct {
	WxStoreID       string     `json:"wx_store_id,omitempty"`       // 微信门店编号，二选一
	OutStoreID      string     `json:"out_store_id,omitempty"`      // 自定义门店编号，二选一
	OutOrderID      string     `json:"out_order_id"`                // 自定义订单号，需唯一
	ServiceTransID  string     `json:"service_trans_id,omitempty"`  // 运力ID
	UserOpenID      string     `json:"user_openid"`                 // 用户openid
	UserPhone       string     `json:"user_phone"`                  // 用户联系电话
	UserName        string     `json:"user_name"`                   // 用户姓名
	UserLat         float64    `json:"user_lat"`                    // 用户地址纬度
	UserLng         float64    `json:"user_lng"`                    // 用户地址经度
	UserAddress     string     `json:"user_address"`                // 用户详细地址
	PayMode         PayMode    `json:"pay_mode,omitempty"`          // 充值/扣费主体
	CargoInfo       *CargoInfo `json:"cargo_info,omitempty"`        // 货物信息
	OrderDetailPath string     `json:"order_detail_path,omitempty"` // 订单详情页路径
	CallbackURL     string     `json:"callback_url,omitempty"`      // 配送状态回调URL
	UseInsurance    uint32     `json:"use_insurance,omitempty"`     // 是否使用保价：0-不使用，1-使用
	InsuranceValue  uint32     `json:"insurance_value,omitempty"`   // 保价金额，单位：分
	ExpectTime      uint32     `json:"expect_time,omitempty"`       // 期望送达时间戳
	Remark          string     `json:"remark,omitempty"`            // 备注
}

type AddOrderResponse struct {
	util.CommonError
	WxOrderID      string `json:"wx_order_id"`      // 微信订单号
	AppID          string `json:"appid"`            // 小程序appid
	WxStoreID      string `json:"wx_store_id"`      // 微信门店编号
	OutOrderID     string `json:"out_order_id"`     // 自定义订单号
	ServiceTransID string `json:"service_trans_id"` // 运力ID
	BillID         string `json:"bill_id"`          // 运力订单号
	Price          uint32 `json:"price"`            // 配送费用，单位：分
	Distance       uint32 `json:"distance"`         // 配送距离，单位：米
}

type BalanceInfo struct {
	ServiceTransID string `json:"service_trans_id"` // 运力ID
	Balance        int32  `json:"balance"`          // 余额，单位：分
}

type BalanceQueryRequest struct {
	WxStoreID      string  `json:"wx_store_id,omitempty"`      // 微信门店编号
	ServiceTransID string  `json:"service_trans_id,omitempty"` // 运力ID
	PayMode        PayMode `json:"pay_mode,omitempty"`         // 充值/扣费主体
}

type BalanceQueryResponse struct {
	util.CommonError
	AppID       string        `json:"appid"`        // 小程序appid
	WxStoreID   string        `json:"wx_store_id"`  // 微信门店编号
	BalanceList []BalanceInfo `json:"balance_list"` // 余额列表
}

type CancelOrderRequest struct {
	WxOrderID    string `json:"wx_order_id,omitempty"`   // 微信订单号，二选一
	OutOrderID   string `json:"out_order_id,omitempty"`  // 自定义订单号，二选一
	WxStoreID    string `json:"wx_store_id,omitempty"`   // 微信门店编号
	OutStoreID   string `json:"out_store_id,omitempty"`  // 自定义门店编号
	CancelReason string `json:"cancel_reason,omitempty"` // 取消原因
}

type CancelOrderResponse struct {
	util.CommonError
	WxOrderID    string `json:"wx_order_id"`   // 微信订单号
	RefundAmount int32  `json:"refund_amount"` // 退款金额，单位：分
	DeductAmount int32  `json:"deduct_amount"` // 扣除违约金，单位：分
}

type CargoInfo struct {
	Name   string `json:"name"`             // 货物名称
	Num    uint32 `json:"num,omitempty"`    // 货物数量
	Price  uint32 `json:"price,omitempty"`  // 货物价格，单位：分
	Weight uint32 `json:"weight,omitempty"` // 货物重量，单位：克
}

type CreateStoreRequest struct {
	OutStoreID         string               `json:"out_store_id"`                   // 自定义门店编号
	StoreName          string               `json:"store_name"`                     // 门店名称
	OrderPattern       OrderPattern         `json:"order_pattern,omitempty"`        // 运力偏好：1-价格优先，2-运力优先
	ServiceTransPrefer string               `json:"service_trans_prefer,omitempty"` // 优先使用的运力ID，order_pattern=2时必填
	AddressInfo        IntracityAddressInfo `json:"address_info"`                   // 门店地址信息
}

type CreateStoreResponse struct {
	util.CommonError
	WxStoreID  string `json:"wx_store_id"`  // 微信门店编号
	AppID      string `json:"appid"`        // 小程序appid
	OutStoreID string `json:"out_store_id"` // 自定义门店ID
}

type Express struct {
	*context.Context
}

type FlowRecordInfo struct {
	FlowType             FlowType `json:"flow_type"`                        // 流水类型
	AppID                string   `json:"appid"`                            // appid
	WxStoreID            string   `json:"wx_store_id"`                      // 微信门店ID
	PayOrderID           uint64   `json:"pay_order_id,omitempty"`           // 充值订单号
	WxOrderID            string   `json:"wx_order_id,omitempty"`            // 订单ID（消费流水）
	ServiceTransID       string   `json:"service_trans_id"`                 // 运力ID
	OpenID               string   `json:"openid,omitempty"`                 // 用户openid（消费流水）
	DeliveryStatus       int32    `json:"delivery_status,omitempty"`        // 运单状态（消费流水）
	PayAmount            int32    `json:"pay_amount"`                       // 支付金额，单位：分
	PayTime              uint32   `json:"pay_time,omitempty"`               // 支付时间
	PayStatus            string   `json:"pay_status,omitempty"`             // 支付状态
	RefundStatus         string   `json:"refund_status,omitempty"`          // 退款状态
	RefundAmount         int32    `json:"refund_amount,omitempty"`          // 退款金额
	RefundTime           uint32   `json:"refund_time,omitempty"`            // 退款时间
	DeductAmount         int32    `json:"deduct_amount,omitempty"`          // 扣除违约金
	CreateTime           uint32   `json:"create_time"`                      // 创建时间
	ConsumeDeadline      uint32   `json:"consume_deadline,omitempty"`       // 有效截止日期
	BillID               string   `json:"bill_id,omitempty"`                // 运单ID
	DeliveryFinishedTime uint32   `json:"delivery_finished_time,omitempty"` // 运单完成配送的时间
}

type FlowType uint32

type FlowWaybillDeliveryInfo struct {
	DeliveryID   string `json:"delivery_id"`   // 运力公司id
	DeliveryName string `json:"delivery_name"` // 运力公司名称
}

type FlowWaybillInfo struct {
	WaybillID string        `json:"waybill_id"` // 运单号
	Status    WaybillStatus `json:"status"`     // 运单状态
}

type FollowWaybillGoodsInfo struct {
	DetailList []FollowWaybillGoodsInfoItem `json:"detail_list"`
}

type FollowWaybillGoodsInfoItem struct {
	GoodsName   string `json:"goods_name"`           // 必选，商品名称(最大长度为utf-8编码下的60个字符）
	GoodsImgURL string `json:"goods_img_url"`        // 必选，商品图片url
	GoodsDesc   string `json:"goods_desc,omitempty"` // 商品详情描述，不传默认取“商品名称”值，最多40汉字
}

type FollowWaybillRequest struct {
	GoodsInfo       FollowWaybillGoodsInfo `json:"goods_info"`        // 必选，商品信息
	Openid          string                 `json:"openid"`            // 必选，用户openid
	SenderPhone     string                 `json:"sender_phone"`      // 寄件人手机号
	ReceiverPhone   string                 `json:"receiver_phone"`    // 必选，收件人手机号，部分运力需要用户手机号作为查单依据
	DeliveryID      string                 `json:"delivery_id"`       // 运力id（运单号所属运力公司id）
	WaybillID       string                 `json:"waybill_id"`        // 必选，运单号
	TransID         string                 `json:"trans_id"`          // 必选，交易单号（微信支付生成的交易单号，一般以420开头）
	OrderDetailPath string                 `json:"order_detail_path"` // 订单详情页地址
}

type FollowWaybillResponse struct {
	util.CommonError
	WaybillToken string `json:"waybill_token"` // 查询id
}

type FollowWaybillShopInfo struct {
	GoodsInfo FollowWaybillGoodsInfo `json:"goods_info"` // 商品信息
}

type GetDeliveryListResponse struct {
	util.CommonError
	DeliveryList []FlowWaybillDeliveryInfo `json:"delivery_list"` // 运力公司列表
	Count        int                       `json:"count"`         // 运力公司个数
}

type IntracityAddressInfo struct {
	Province string  `json:"province"`       // 省/自治区/直辖市
	City     string  `json:"city"`           // 地级市
	Area     string  `json:"area"`           // 县/县级市/区
	Street   string  `json:"street"`         // 街道
	House    string  `json:"house"`          // 具体门牌号或详细地址
	Lat      float64 `json:"lat"`            // 门店所在地纬度
	Lng      float64 `json:"lng"`            // 门店所在地经度
	Phone    string  `json:"phone"`          // 门店联系电话
	Name     string  `json:"name,omitempty"` // 联系人姓名（收货地址时使用）
}

type IntracityDeliveryStatus int32

type IntracityStoreInfo struct {
	WxStoreID          string               `json:"wx_store_id"`          // 微信门店编号
	OutStoreID         string               `json:"out_store_id"`         // 自定义门店编号
	CityID             string               `json:"city_id"`              // 门店所在城市ID
	StoreName          string               `json:"store_name"`           // 门店名称
	OrderPattern       OrderPattern         `json:"order_pattern"`        // 运力偏好
	ServiceTransPrefer string               `json:"service_trans_prefer"` // 优先使用的运力ID
	AddressInfo        IntracityAddressInfo `json:"address_info"`         // 门店地址信息
}

type MockNotifyRequest struct {
	WxOrderID      string                  `json:"wx_order_id"`     // 微信订单号
	DeliveryStatus IntracityDeliveryStatus `json:"delivery_status"` // 配送状态
}

type OrderPattern uint32

type PayMode string

type PreAddOrderRequest struct {
	WxStoreID      string     `json:"wx_store_id,omitempty"`      // 微信门店编号，二选一
	OutStoreID     string     `json:"out_store_id,omitempty"`     // 自定义门店编号，二选一
	UserOpenID     string     `json:"user_openid"`                // 用户openid
	UserPhone      string     `json:"user_phone,omitempty"`       // 用户联系电话
	UserName       string     `json:"user_name,omitempty"`        // 用户姓名
	UserLat        float64    `json:"user_lat"`                   // 用户地址纬度
	UserLng        float64    `json:"user_lng"`                   // 用户地址经度
	UserAddress    string     `json:"user_address"`               // 用户详细地址
	ServiceTransID string     `json:"service_trans_id,omitempty"` // 运力ID，不传则查询所有运力
	PayMode        PayMode    `json:"pay_mode,omitempty"`         // 充值/扣费主体
	CargoInfo      *CargoInfo `json:"cargo_info,omitempty"`       // 货物信息
}

type PreAddOrderResponse struct {
	util.CommonError
	WxStoreID string      `json:"wx_store_id"` // 微信门店编号
	AppID     string      `json:"appid"`       // 小程序appid
	TransList []TransInfo `json:"trans_list"`  // 运力列表
}

type QueryFlowRequest struct {
	WxStoreID      string   `json:"wx_store_id"`                // 微信门店编号
	FlowType       FlowType `json:"flow_type"`                  // 流水类型：1-充值，2-消费，3-退款
	ServiceTransID string   `json:"service_trans_id,omitempty"` // 运力ID
	BeginTime      uint32   `json:"begin_time,omitempty"`       // 开始时间戳
	EndTime        uint32   `json:"end_time,omitempty"`         // 结束时间戳
	PayMode        PayMode  `json:"pay_mode"`                   // 扣费主体
}

type QueryFlowResponse struct {
	util.CommonError
	Total          uint32           `json:"total"`            // 总数
	FlowList       []FlowRecordInfo `json:"flow_list"`        // 流水数组
	TotalPayAmt    int              `json:"total_pay_amt"`    // 总支付金额
	TotalRefundAmt int              `json:"total_refund_amt"` // 总退款金额
	TotalDeductAmt int              `json:"total_deduct_amt"` // 总违约金（消费流水返回）
}

type QueryFollowTraceRequest struct {
	WaybillToken string `json:"waybill_token"` // 必选，查询id
}

type QueryFollowTraceResponse struct {
	util.CommonError
	WaybillInfo  FlowWaybillInfo         `json:"waybill_info"`  // 运单信息
	ShopInfo     FollowWaybillShopInfo   `json:"shop_info"`     // 商品信息
	DeliveryInfo FlowWaybillDeliveryInfo `json:"delivery_info"` // 运力信息
}

type QueryOrderRequest struct {
	WxOrderID  string `json:"wx_order_id,omitempty"`  // 微信订单号，二选一
	OutOrderID string `json:"out_order_id,omitempty"` // 自定义订单号，二选一
	WxStoreID  string `json:"wx_store_id,omitempty"`  // 微信门店编号
	OutStoreID string `json:"out_store_id,omitempty"` // 自定义门店编号
}

type QueryOrderResponse struct {
	util.CommonError
	WxOrderID      string                  `json:"wx_order_id"`      // 微信订单号
	AppID          string                  `json:"appid"`            // 小程序appid
	WxStoreID      string                  `json:"wx_store_id"`      // 微信门店编号
	OutOrderID     string                  `json:"out_order_id"`     // 自定义订单号
	ServiceTransID string                  `json:"service_trans_id"` // 运力ID
	BillID         string                  `json:"bill_id"`          // 运力订单号
	DeliveryStatus IntracityDeliveryStatus `json:"delivery_status"`  // 配送状态
	Price          uint32                  `json:"price"`            // 配送费用，单位：分
	Distance       uint32                  `json:"distance"`         // 配送距离，单位：米
	CreateTime     uint32                  `json:"create_time"`      // 订单创建时间
	RiderInfo      *RiderInfo              `json:"rider_info"`       // 骑手信息
	FinishTime     uint32                  `json:"finish_time"`      // 订单完成时间
}

type QueryStoreRequest struct {
	WxStoreID  string `json:"wx_store_id,omitempty"`  // 微信门店编号
	OutStoreID string `json:"out_store_id,omitempty"` // 自定义门店编号
}

type QueryStoreResponse struct {
	util.CommonError
	Total     uint32               `json:"total"`      // 符合条件的门店总数
	AppID     string               `json:"appid"`      // 小程序appid
	StoreList []IntracityStoreInfo `json:"store_list"` // 门店信息列表
}

type QueryTraceRequest struct {
	WaybillToken string `json:"waybill_token"` // 必选，查询id
}

type QueryTraceResponse struct {
	util.CommonError
	WaybillInfo  FlowWaybillInfo         `json:"waybill_info"`  // 运单信息
	ShopInfo     FollowWaybillShopInfo   `json:"shop_info"`     // 商品信息
	DeliveryInfo FlowWaybillDeliveryInfo `json:"delivery_info"` // 运力信息
}

type RiderInfo struct {
	Name        string `json:"name"`          // 骑手姓名
	Phone       string `json:"phone"`         // 骑手电话
	RiderCode   string `json:"rider_code"`    // 骑手编号
	RiderImgURL string `json:"rider_img_url"` // 骑手头像URL
}

type StoreChargeRequest struct {
	WxStoreID      string  `json:"wx_store_id,omitempty"` // 微信门店编号，pay_mode=PAY_MODE_STORE时必传
	ServiceTransID string  `json:"service_trans_id"`      // 运力ID
	Amount         uint32  `json:"amount"`                // 充值金额，单位：分，50元起充
	PayMode        PayMode `json:"pay_mode,omitempty"`    // 充值主体
}

type StoreChargeResponse struct {
	util.CommonError
	PayURL    string `json:"payurl"`      // 充值页面地址
	AppID     string `json:"appid"`       // 小程序appid
	WxStoreID string `json:"wx_store_id"` // 微信门店编号
}

type StoreRefundRequest struct {
	WxStoreID      string  `json:"wx_store_id,omitempty"` // 微信门店编号
	PayMode        PayMode `json:"pay_mode,omitempty"`    // 充值/扣费主体
	ServiceTransID string  `json:"service_trans_id"`      // 运力ID
}

type StoreRefundResponse struct {
	util.CommonError
	AppID        string `json:"appid"`         // 小程序appid
	WxStoreID    string `json:"wx_store_id"`   // 微信门店编号
	RefundAmount uint32 `json:"refund_amount"` // 退款金额，单位：分
}

type TraceWaybillRequest struct {
	GoodsInfo       FollowWaybillGoodsInfo `json:"goods_info"`        // 必选，商品信息
	Openid          string                 `json:"openid"`            // 必选，用户openid
	SenderPhone     string                 `json:"sender_phone"`      // 寄件人手机号
	ReceiverPhone   string                 `json:"receiver_phone"`    // 必选，收件人手机号，部分运力需要用户手机号作为查单依据
	DeliveryID      string                 `json:"delivery_id"`       // 运力id（运单号所属运力公司id）
	WaybillID       string                 `json:"waybill_id"`        // 必选，运单号
	TransID         string                 `json:"trans_id"`          // 必选，交易单号（微信支付生成的交易单号，一般以420开头）
	OrderDetailPath string                 `json:"order_detail_path"` // 订单详情页地址

}

type TraceWaybillResponse struct {
	util.CommonError
	WaybillToken string `json:"waybill_token"` // 查询id
}

type TransInfo struct {
	ServiceTransID string `json:"service_trans_id"` // 运力ID
	ServiceName    string `json:"service_name"`     // 运力名称
	Price          uint32 `json:"price"`            // 配送费用，单位：分
	Distance       uint32 `json:"distance"`         // 配送距离，单位：米
	Errcode        int    `json:"errcode"`          // 错误码，0表示成功
	Errmsg         string `json:"errmsg"`           // 错误信息
}

type UpdateFollowWaybillGoodsRequest struct {
	WaybillToken string                 `json:"waybill_token"` // 必选，查询id
	GoodsInfo    FollowWaybillGoodsInfo `json:"goods_info"`    // 必选，商品信息
}

type UpdateStoreContent struct {
	StoreName          string                `json:"store_name,omitempty"`           // 门店名称
	OrderPattern       OrderPattern          `json:"order_pattern,omitempty"`        // 运力偏好
	ServiceTransPrefer string                `json:"service_trans_prefer,omitempty"` // 优先使用的运力ID
	AddressInfo        *IntracityAddressInfo `json:"address_info,omitempty"`         // 门店地址信息
}

type UpdateStoreKeyInfo struct {
	WxStoreID  string `json:"wx_store_id,omitempty"`  // 微信门店编号
	OutStoreID string `json:"out_store_id,omitempty"` // 自定义门店编号，二选一
}

type UpdateStoreRequest struct {
	Keys    UpdateStoreKeyInfo `json:"keys"`    // 门店编号
	Content UpdateStoreContent `json:"content"` // 更新内容
}

type UpdateWaybillGoodsRequest struct {
	WaybillToken string                 `json:"waybill_token"` // 必选，查询id
	GoodsInfo    FollowWaybillGoodsInfo `json:"goods_info"`    // 必选，商品信息
}

type WaybillStatus int