alscmerchant

package
v1.2.5 Latest Latest
Warning

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

 Go to latest Published: Aug 30, 2022 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package alscmerchant 包含本地生活商户基础API相关结构体

https://open.taobao.com/API.htm?docId=57545&docType=2

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AlibabaAlscMerchantExtTicketCancelAPIRequest added in v1.2.5 

type AlibabaAlscMerchantExtTicketCancelAPIRequest struct {
	model.Params
	// contains filtered or unexported fields
}

AlibabaAlscMerchantExtTicketCancelAPIRequest 凭证作废 API请求 alibaba.alsc.merchant.ext.ticket.cancel

isv调用银行接口超时导致凭证信息同步失败,触发关单处理,调用作废接口

func NewAlibabaAlscMerchantExtTicketCancelRequest added in v1.2.5 

func NewAlibabaAlscMerchantExtTicketCancelRequest() *AlibabaAlscMerchantExtTicketCancelAPIRequest

NewAlibabaAlscMerchantExtTicketCancelRequest 初始化AlibabaAlscMerchantExtTicketCancelAPIRequest对象

func (AlibabaAlscMerchantExtTicketCancelAPIRequest) GetApiMethodName added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketCancelAPIRequest) GetApiMethodName() string

GetApiMethodName IRequest interface 方法, 获取Api method

func (AlibabaAlscMerchantExtTicketCancelAPIRequest) GetApiParams added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketCancelAPIRequest) GetApiParams() url.Values

GetApiParams IRequest interface 方法, 获取API参数

func (AlibabaAlscMerchantExtTicketCancelAPIRequest) GetBuyerId added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketCancelAPIRequest) GetBuyerId() string

GetBuyerId BuyerId Getter

func (AlibabaAlscMerchantExtTicketCancelAPIRequest) GetTicketRequestId added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketCancelAPIRequest) GetTicketRequestId() string

GetTicketRequestId TicketRequestId Getter

func (AlibabaAlscMerchantExtTicketCancelAPIRequest) GetTicketTaskId added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketCancelAPIRequest) GetTicketTaskId() string

GetTicketTaskId TicketTaskId Getter

func (*AlibabaAlscMerchantExtTicketCancelAPIRequest) SetBuyerId added in v1.2.5 

func (r *AlibabaAlscMerchantExtTicketCancelAPIRequest) SetBuyerId(_buyerId string) error

SetBuyerId is BuyerId Setter 购买商品的买家userId((纯数字))

func (*AlibabaAlscMerchantExtTicketCancelAPIRequest) SetTicketRequestId added in v1.2.5 

func (r *AlibabaAlscMerchantExtTicketCancelAPIRequest) SetTicketRequestId(_ticketRequestId string) error

SetTicketRequestId is TicketRequestId Setter 请求的唯一requestId

func (*AlibabaAlscMerchantExtTicketCancelAPIRequest) SetTicketTaskId added in v1.2.5 

func (r *AlibabaAlscMerchantExtTicketCancelAPIRequest) SetTicketTaskId(_ticketTaskId string) error

SetTicketTaskId is TicketTaskId Setter 凭证任务单Id

type AlibabaAlscMerchantExtTicketCancelAPIResponse added in v1.2.5 

type AlibabaAlscMerchantExtTicketCancelAPIResponse struct {
	model.CommonResponse
	AlibabaAlscMerchantExtTicketCancelAPIResponseModel
}

AlibabaAlscMerchantExtTicketCancelAPIResponse 凭证作废 API返回值 alibaba.alsc.merchant.ext.ticket.cancel

isv调用银行接口超时导致凭证信息同步失败,触发关单处理,调用作废接口

type AlibabaAlscMerchantExtTicketCancelAPIResponseModel added in v1.2.5 

type AlibabaAlscMerchantExtTicketCancelAPIResponseModel struct {
	XMLName xml.Name `xml:"alibaba_alsc_merchant_ext_ticket_cancel_response"`
	// 平台颁发的每次请求访问的唯一标识
	RequestId string `json:"request_id,omitempty" xml:"request_id,omitempty"`
	// 凭证任务单Id
	TicketTaskId string `json:"ticket_task_id,omitempty" xml:"ticket_task_id,omitempty"`
	// 错误编码/success/fail
	BizCode string `json:"biz_code,omitempty" xml:"biz_code,omitempty"`
	// 是否需要重试(返回true时重试)
	CanRetry bool `json:"can_retry,omitempty" xml:"can_retry,omitempty"`
}

AlibabaAlscMerchantExtTicketCancelAPIResponseModel is 凭证作废 成功返回结果

type AlibabaAlscMerchantExtTicketQueryAPIRequest added in v1.2.5 

type AlibabaAlscMerchantExtTicketQueryAPIRequest struct {
	model.Params
	// contains filtered or unexported fields
}

AlibabaAlscMerchantExtTicketQueryAPIRequest 口碑凭证模版查询服务 API请求 alibaba.alsc.merchant.ext.ticket.query

isv需要在c端展示凭证信息,需要查询凭证模版

func NewAlibabaAlscMerchantExtTicketQueryRequest added in v1.2.5 

func NewAlibabaAlscMerchantExtTicketQueryRequest() *AlibabaAlscMerchantExtTicketQueryAPIRequest

NewAlibabaAlscMerchantExtTicketQueryRequest 初始化AlibabaAlscMerchantExtTicketQueryAPIRequest对象

func (AlibabaAlscMerchantExtTicketQueryAPIRequest) GetApiMethodName added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketQueryAPIRequest) GetApiMethodName() string

GetApiMethodName IRequest interface 方法, 获取Api method

func (AlibabaAlscMerchantExtTicketQueryAPIRequest) GetApiParams added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketQueryAPIRequest) GetApiParams() url.Values

GetApiParams IRequest interface 方法, 获取API参数

func (AlibabaAlscMerchantExtTicketQueryAPIRequest) GetTicketRequestId added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketQueryAPIRequest) GetTicketRequestId() string

GetTicketRequestId TicketRequestId Getter

func (AlibabaAlscMerchantExtTicketQueryAPIRequest) GetTicketTemplateId added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketQueryAPIRequest) GetTicketTemplateId() string

GetTicketTemplateId TicketTemplateId Getter

func (*AlibabaAlscMerchantExtTicketQueryAPIRequest) SetTicketRequestId added in v1.2.5 

func (r *AlibabaAlscMerchantExtTicketQueryAPIRequest) SetTicketRequestId(_ticketRequestId string) error

SetTicketRequestId is TicketRequestId Setter 请求requestID

func (*AlibabaAlscMerchantExtTicketQueryAPIRequest) SetTicketTemplateId added in v1.2.5 

func (r *AlibabaAlscMerchantExtTicketQueryAPIRequest) SetTicketTemplateId(_ticketTemplateId string) error

SetTicketTemplateId is TicketTemplateId Setter 凭证模版ID

type AlibabaAlscMerchantExtTicketQueryAPIResponse added in v1.2.5 

type AlibabaAlscMerchantExtTicketQueryAPIResponse struct {
	model.CommonResponse
	AlibabaAlscMerchantExtTicketQueryAPIResponseModel
}

AlibabaAlscMerchantExtTicketQueryAPIResponse 口碑凭证模版查询服务 API返回值 alibaba.alsc.merchant.ext.ticket.query

isv需要在c端展示凭证信息,需要查询凭证模版

type AlibabaAlscMerchantExtTicketQueryAPIResponseModel added in v1.2.5 

type AlibabaAlscMerchantExtTicketQueryAPIResponseModel struct {
	XMLName xml.Name `xml:"alibaba_alsc_merchant_ext_ticket_query_response"`
	// 平台颁发的每次请求访问的唯一标识
	RequestId string `json:"request_id,omitempty" xml:"request_id,omitempty"`
	// 请求requestID
	TicketRequestId string `json:"ticket_request_id,omitempty" xml:"ticket_request_id,omitempty"`
	// 业务编码
	BizCode string `json:"biz_code,omitempty" xml:"biz_code,omitempty"`
	// 外部AppID(外部券)
	OutAppId string `json:"out_app_id,omitempty" xml:"out_app_id,omitempty"`
	// 核销规则(方式) USER_PAY_CODE(支核一体) TICKET_CODE(券码核销) EXTERNAL_TICKET_CODE(外部券核销)
	TicketUseRule string `json:"ticket_use_rule,omitempty" xml:"ticket_use_rule,omitempty"`
	// 凭证图片(完整地址)
	TicketTemplateImg string `json:"ticket_template_img,omitempty" xml:"ticket_template_img,omitempty"`
	BrandLogo string `json:"brand_logo,omitempty" xml:"brand_logo,omitempty"`
	// 凭证模版品牌名
	BrandName string `json:"brand_name,omitempty" xml:"brand_name,omitempty"`
	// 凭证模版业务类型("SERV_INDUSTRY","生服","CATERING","餐饮","MALL""商圈")
	TicketTemplateType string `json:"ticket_template_type,omitempty" xml:"ticket_template_type,omitempty"`
	// 凭证模版业务名称
	TicketTemplateName string `json:"ticket_template_name,omitempty" xml:"ticket_template_name,omitempty"`
	// 凭证模版ID
	TicketTemplateId string `json:"ticket_template_id,omitempty" xml:"ticket_template_id,omitempty"`
	// 备注
	Remark string `json:"remark,omitempty" xml:"remark,omitempty"`
	// 外部商品ID(多个用,分割)(外部券)
	OutItemId string `json:"out_item_id,omitempty" xml:"out_item_id,omitempty"`
	// 使用须知
	Description string `json:"description,omitempty" xml:"description,omitempty"`
	// 现价(售价)(单位分)
	CurrentPrice int64 `json:"current_price,omitempty" xml:"current_price,omitempty"`
	// 原价(单位分)
	OriginalPrice int64 `json:"original_price,omitempty" xml:"original_price,omitempty"`
	// 有效期
	TicketTemplateValidPeriod *TicketTemplateValidPeriod `json:"ticket_template_valid_period,omitempty" xml:"ticket_template_valid_period,omitempty"`
	// 单次可使用数量(支核一体用)
	MaxVerifyCountToOrder int64 `json:"max_verify_count_to_order,omitempty" xml:"max_verify_count_to_order,omitempty"`
}

AlibabaAlscMerchantExtTicketQueryAPIResponseModel is 口碑凭证模版查询服务 成功返回结果

type AlibabaAlscMerchantExtTicketRefundAPIRequest added in v1.2.0 

type AlibabaAlscMerchantExtTicketRefundAPIRequest struct {
	model.Params
	// contains filtered or unexported fields
}

AlibabaAlscMerchantExtTicketRefundAPIRequest 口碑凭证售后退 API请求 alibaba.alsc.merchant.ext.ticket.refund

口碑凭证售后退

func NewAlibabaAlscMerchantExtTicketRefundRequest 

func NewAlibabaAlscMerchantExtTicketRefundRequest() *AlibabaAlscMerchantExtTicketRefundAPIRequest

NewAlibabaAlscMerchantExtTicketRefundRequest 初始化AlibabaAlscMerchantExtTicketRefundAPIRequest对象

func (AlibabaAlscMerchantExtTicketRefundAPIRequest) GetApiMethodName added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketRefundAPIRequest) GetApiMethodName() string

GetApiMethodName IRequest interface 方法, 获取Api method

func (AlibabaAlscMerchantExtTicketRefundAPIRequest) GetApiParams added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketRefundAPIRequest) GetApiParams() url.Values

GetApiParams IRequest interface 方法, 获取API参数

func (AlibabaAlscMerchantExtTicketRefundAPIRequest) GetTicketCode added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketRefundAPIRequest) GetTicketCode() string

GetTicketCode TicketCode Getter

func (AlibabaAlscMerchantExtTicketRefundAPIRequest) GetTicketRequestId added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketRefundAPIRequest) GetTicketRequestId() string

GetTicketRequestId TicketRequestId Getter

func (AlibabaAlscMerchantExtTicketRefundAPIRequest) GetTransId added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketRefundAPIRequest) GetTransId() string

GetTransId TransId Getter

func (*AlibabaAlscMerchantExtTicketRefundAPIRequest) SetTicketCode added in v1.2.0 

func (r *AlibabaAlscMerchantExtTicketRefundAPIRequest) SetTicketCode(_ticketCode string) error

SetTicketCode is TicketCode Setter 凭证码，包括内部凭证码和外部凭证码，内部凭证码为12位，纯数字，且唯一不重复

func (*AlibabaAlscMerchantExtTicketRefundAPIRequest) SetTicketRequestId added in v1.2.0 

func (r *AlibabaAlscMerchantExtTicketRefundAPIRequest) SetTicketRequestId(_ticketRequestId string) error

SetTicketRequestId is TicketRequestId Setter 外部请求号，支持英文字母和数字，由开发者自行定义（不允许重复）

func (*AlibabaAlscMerchantExtTicketRefundAPIRequest) SetTransId added in v1.2.0 

func (r *AlibabaAlscMerchantExtTicketRefundAPIRequest) SetTransId(_transId string) error

SetTransId is TransId Setter 券核销流水号，针对该次核销发起售后退操作

type AlibabaAlscMerchantExtTicketRefundAPIResponse 

type AlibabaAlscMerchantExtTicketRefundAPIResponse struct {
	model.CommonResponse
	AlibabaAlscMerchantExtTicketRefundAPIResponseModel
}

AlibabaAlscMerchantExtTicketRefundAPIResponse 口碑凭证售后退 API返回值 alibaba.alsc.merchant.ext.ticket.refund

口碑凭证售后退

type AlibabaAlscMerchantExtTicketRefundAPIResponseModel added in v1.2.0 

type AlibabaAlscMerchantExtTicketRefundAPIResponseModel struct {
	XMLName xml.Name `xml:"alibaba_alsc_merchant_ext_ticket_refund_response"`
	// 平台颁发的每次请求访问的唯一标识
	RequestId string `json:"request_id,omitempty" xml:"request_id,omitempty"`
	// 外部请求号，支持英文字母和数字，由开发者自行定义（不允许重复）
	TicketRequestId string `json:"ticket_request_id,omitempty" xml:"ticket_request_id,omitempty"`
	// 业务返回code
	BizCode string `json:"biz_code,omitempty" xml:"biz_code,omitempty"`
}

AlibabaAlscMerchantExtTicketRefundAPIResponseModel is 口碑凭证售后退 成功返回结果

type AlibabaAlscMerchantExtTicketcodeSendAPIRequest added in v1.2.5 

type AlibabaAlscMerchantExtTicketcodeSendAPIRequest struct {
	model.Params
	// contains filtered or unexported fields
}

AlibabaAlscMerchantExtTicketcodeSendAPIRequest 异步发码 API请求 alibaba.alsc.merchant.ext.ticketcode.send

外部券异步发码

func NewAlibabaAlscMerchantExtTicketcodeSendRequest added in v1.2.5 

func NewAlibabaAlscMerchantExtTicketcodeSendRequest() *AlibabaAlscMerchantExtTicketcodeSendAPIRequest

NewAlibabaAlscMerchantExtTicketcodeSendRequest 初始化AlibabaAlscMerchantExtTicketcodeSendAPIRequest对象

func (AlibabaAlscMerchantExtTicketcodeSendAPIRequest) GetApiMethodName added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketcodeSendAPIRequest) GetApiMethodName() string

GetApiMethodName IRequest interface 方法, 获取Api method

func (AlibabaAlscMerchantExtTicketcodeSendAPIRequest) GetApiParams added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketcodeSendAPIRequest) GetApiParams() url.Values

GetApiParams IRequest interface 方法, 获取API参数

func (AlibabaAlscMerchantExtTicketcodeSendAPIRequest) GetSendRequest added in v1.2.5 

func (r AlibabaAlscMerchantExtTicketcodeSendAPIRequest) GetSendRequest() *ExternalTicketSendRequest

GetSendRequest SendRequest Getter

func (*AlibabaAlscMerchantExtTicketcodeSendAPIRequest) SetSendRequest added in v1.2.5 

func (r *AlibabaAlscMerchantExtTicketcodeSendAPIRequest) SetSendRequest(_sendRequest *ExternalTicketSendRequest) error

SetSendRequest is SendRequest Setter 外部券异步发码

type AlibabaAlscMerchantExtTicketcodeSendAPIResponse added in v1.2.5 

type AlibabaAlscMerchantExtTicketcodeSendAPIResponse struct {
	model.CommonResponse
	AlibabaAlscMerchantExtTicketcodeSendAPIResponseModel
}

AlibabaAlscMerchantExtTicketcodeSendAPIResponse 异步发码 API返回值 alibaba.alsc.merchant.ext.ticketcode.send

外部券异步发码

type AlibabaAlscMerchantExtTicketcodeSendAPIResponseModel added in v1.2.5 

type AlibabaAlscMerchantExtTicketcodeSendAPIResponseModel struct {
	XMLName xml.Name `xml:"alibaba_alsc_merchant_ext_ticketcode_send_response"`
	// 平台颁发的每次请求访问的唯一标识
	RequestId string `json:"request_id,omitempty" xml:"request_id,omitempty"`
	// 请求id
	TicketRequestId string `json:"ticket_request_id,omitempty" xml:"ticket_request_id,omitempty"`
	// 该字段用于描述本次返回中的业务属性，现有：BIZ_ALREADY_SUCCESS（幂等业务码）。
	BizCode string `json:"biz_code,omitempty" xml:"biz_code,omitempty"`
}

AlibabaAlscMerchantExtTicketcodeSendAPIResponseModel is 异步发码 成功返回结果

type AlibabaAlscMerchantExtTicketcodeUseAPIRequest added in v1.2.0 

type AlibabaAlscMerchantExtTicketcodeUseAPIRequest struct {
	model.Params
	// contains filtered or unexported fields
}

AlibabaAlscMerchantExtTicketcodeUseAPIRequest 外部核销服务 API请求 alibaba.alsc.merchant.ext.ticketcode.use

外部核销服务

func NewAlibabaAlscMerchantExtTicketcodeUseRequest 

func NewAlibabaAlscMerchantExtTicketcodeUseRequest() *AlibabaAlscMerchantExtTicketcodeUseAPIRequest

NewAlibabaAlscMerchantExtTicketcodeUseRequest 初始化AlibabaAlscMerchantExtTicketcodeUseAPIRequest对象

func (AlibabaAlscMerchantExtTicketcodeUseAPIRequest) GetApiMethodName added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketcodeUseAPIRequest) GetApiMethodName() string

GetApiMethodName IRequest interface 方法, 获取Api method

func (AlibabaAlscMerchantExtTicketcodeUseAPIRequest) GetApiParams added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketcodeUseAPIRequest) GetApiParams() url.Values

GetApiParams IRequest interface 方法, 获取API参数

func (AlibabaAlscMerchantExtTicketcodeUseAPIRequest) GetUseRequest added in v1.2.0 

func (r AlibabaAlscMerchantExtTicketcodeUseAPIRequest) GetUseRequest() *ExternalTicketUseRequest

GetUseRequest UseRequest Getter

func (*AlibabaAlscMerchantExtTicketcodeUseAPIRequest) SetUseRequest added in v1.2.0 

func (r *AlibabaAlscMerchantExtTicketcodeUseAPIRequest) SetUseRequest(_useRequest *ExternalTicketUseRequest) error

SetUseRequest is UseRequest Setter 外部券使用请求

type AlibabaAlscMerchantExtTicketcodeUseAPIResponse 

type AlibabaAlscMerchantExtTicketcodeUseAPIResponse struct {
	model.CommonResponse
	AlibabaAlscMerchantExtTicketcodeUseAPIResponseModel
}

AlibabaAlscMerchantExtTicketcodeUseAPIResponse 外部核销服务 API返回值 alibaba.alsc.merchant.ext.ticketcode.use

外部核销服务

type AlibabaAlscMerchantExtTicketcodeUseAPIResponseModel added in v1.2.0 

type AlibabaAlscMerchantExtTicketcodeUseAPIResponseModel struct {
	XMLName xml.Name `xml:"alibaba_alsc_merchant_ext_ticketcode_use_response"`
	// 平台颁发的每次请求访问的唯一标识
	RequestId string `json:"request_id,omitempty" xml:"request_id,omitempty"`
	// 非次卡一次性核销多份场景，被核销的凭证明细信息
	TicketUseDetails []MerchantTicketUseDetail `json:"ticket_use_details,omitempty" xml:"ticket_use_details>merchant_ticket_use_detail,omitempty"`
	// 凭证码所属的订单id
	OrderNo string `json:"order_no,omitempty" xml:"order_no,omitempty"`
	// 用户购买时商品的原价，单位为元，精确到小数点后两位
	OriginalPrice string `json:"original_price,omitempty" xml:"original_price,omitempty"`
	// 该字段用于描述本次返回中的业务属性，现有：TICKET_ALREADY_USED（幂等业务码）
	BizCode string `json:"biz_code,omitempty" xml:"biz_code,omitempty"`
	// 用户购买时商品的现价，单位为元，精确到小数点后两位
	CurrentPrice string `json:"current_price,omitempty" xml:"current_price,omitempty"`
	// 商家优惠金额，单位为元，精确到小数点后两位，一次性核销多份券场景，返回总商家优惠金额
	DiscountAmount string `json:"discount_amount,omitempty" xml:"discount_amount,omitempty"`
	// 交易中可给用户开具发票的金额，单位为元，精确到小数点后两位，一次性核销多份券场景，返回总开票金额
	InvoiceAmount string `json:"invoice_amount,omitempty" xml:"invoice_amount,omitempty"`
	// 券核销门店ID
	UseShopId string `json:"use_shop_id,omitempty" xml:"use_shop_id,omitempty"`
	// 凭证对应商品别名，在口碑商品创建时候设置
	ItemAlias string `json:"item_alias,omitempty" xml:"item_alias,omitempty"`
	// 券核销门店名称
	UseShopName string `json:"use_shop_name,omitempty" xml:"use_shop_name,omitempty"`
	// 口碑商品ID
	ItemId string `json:"item_id,omitempty" xml:"item_id,omitempty"`
	// 商家实收金额，单位为元，精确到小数点后两位，一次性核销多份券场景，返回总商家实收金额
	ReceiptAmount string `json:"receipt_amount,omitempty" xml:"receipt_amount,omitempty"`
	// 用户购买时商品的名称
	ItemName string `json:"item_name,omitempty" xml:"item_name,omitempty"`
	// 核销流水号
	TicketTransId string `json:"ticket_trans_id,omitempty" xml:"ticket_trans_id,omitempty"`
	// 券核销时间
	UseDate string `json:"use_date,omitempty" xml:"use_date,omitempty"`
	// 凭证码对应的凭证资产id
	VoucherId string `json:"voucher_id,omitempty" xml:"voucher_id,omitempty"`
	// 外部请求号，支持英文字母和数字，由开发者自行定义（不允许重复）
	TicketRequestId string `json:"ticket_request_id,omitempty" xml:"ticket_request_id,omitempty"`
	// 用户购买券的时候实际支付的金额，单位为元，精确到小数点后两位，一次性核销多份券场景，返回总实际支付金额
	BuyerPayAmount string `json:"buyer_pay_amount,omitempty" xml:"buyer_pay_amount,omitempty"`
	// 口碑补贴金额，单位为元，精确到小数点后两位，一次性核销多份券场景，返回总口碑补贴金额
	MerchantSubsidyAmount string `json:"merchant_subsidy_amount,omitempty" xml:"merchant_subsidy_amount,omitempty"`
	// 12位的券码，券码为纯数字，且唯一不重复
	TicketCode string `json:"ticket_code,omitempty" xml:"ticket_code,omitempty"`
}

AlibabaAlscMerchantExtTicketcodeUseAPIResponseModel is 外部核销服务 成功返回结果

type ExternalTicketCode added in v1.2.5 

type ExternalTicketCode struct {
	// 码的可核销份数
	Num string `json:"num,omitempty" xml:"num,omitempty"`
	// 凭证码值，必填
	Code string `json:"code,omitempty" xml:"code,omitempty"`
	// 本地生活凭证id(奇门发码通知中的ticketId)，必填
	TicketId string `json:"ticket_id,omitempty" xml:"ticket_id,omitempty"`
	// 支持核销的三方url
	Url string `json:"url,omitempty" xml:"url,omitempty"`
}

ExternalTicketCode 结构体

type ExternalTicketSendRequest added in v1.2.5 

type ExternalTicketSendRequest struct {
	// 需要发送的码列表，其中code表示串码码值，num表示码的可核销份数
	ExternalTicketCodes []ExternalTicketCode `json:"external_ticket_codes,omitempty" xml:"external_ticket_codes>external_ticket_code,omitempty"`
	// 口碑订单号
	OrderNo string `json:"order_no,omitempty" xml:"order_no,omitempty"`
	// 请求id，唯一标识一次请求
	TicketRequestId string `json:"ticket_request_id,omitempty" xml:"ticket_request_id,omitempty"`
	// 券生效时间,默认为口碑商品配置生效时间
	ValidStart string `json:"valid_start,omitempty" xml:"valid_start,omitempty"`
	// 券过期时间,默认为口碑商品配置失效时间
	ValidEnd string `json:"valid_end,omitempty" xml:"valid_end,omitempty"`
	// 口碑发码通知透传码商，码商需要跟发码通知获取到的参数一致
	SendToken string `json:"send_token,omitempty" xml:"send_token,omitempty"`
	// 口碑商品发货单号
	SendOrderNo string `json:"send_order_no,omitempty" xml:"send_order_no,omitempty"`
	// 三方异步发码是否成功,值为success 代表发码成功,external_ticket_codes 不能为空,fail代表三方发码失败,本地侧凭证发放状态推进到发码失败
	DeliverCodeSuccess string `json:"deliver_code_success,omitempty" xml:"deliver_code_success,omitempty"`
}

ExternalTicketSendRequest 结构体

type ExternalTicketUseRequest 

type ExternalTicketUseRequest struct {
	// 特殊可选 核销份数，次卡业务必填、非次卡业务选填， 非次卡场景表示核销同一订单下的同类凭证的个数
	Quantity string `json:"quantity,omitempty" xml:"quantity,omitempty"`
	// 特殊可选 口碑订单号，使用外部凭证码核销时必填
	OrderNo string `json:"order_no,omitempty" xml:"order_no,omitempty"`
	// 特殊可选 凭证码类型,INTERNAL_CODE(内部凭证码),EXTERNAL_CODE(外部凭证码),默认INTERNAL_CODE,外部券场景必填
	CodeType string `json:"code_type,omitempty" xml:"code_type,omitempty"`
	// 外部请求号，支持英文字母和数字，由开发者自行定义（不允许重复）
	TicketRequestId string `json:"ticket_request_id,omitempty" xml:"ticket_request_id,omitempty"`
	// 核销的口碑门店id(门店同步API中的alsc_store_id)，目前是必填。只有加白的合作方法可以不填写
	ShopId string `json:"shop_id,omitempty" xml:"shop_id,omitempty"`
	// 门店id类型,INTERNAL_SHOP(内部店铺id),EXTERNAL_SHOP(外部店铺id),默认INTERNAL_SHOP
	ShopType string `json:"shop_type,omitempty" xml:"shop_type,omitempty"`
	// 凭证码，包括内部凭证码和外部凭证码，内部凭证码为12位，纯数字，且唯一不重复
	TicketCode string `json:"ticket_code,omitempty" xml:"ticket_code,omitempty"`
	// 业务发生时间，默认为接口调用时间
	GmtBiz string `json:"gmt_biz,omitempty" xml:"gmt_biz,omitempty"`
	// 本地侧凭证id，如果是三方码值核销传参ticketId,则该参数必须
	TicketId string `json:"ticket_id,omitempty" xml:"ticket_id,omitempty"`
}

ExternalTicketUseRequest 结构体

type MerchantTicketUseDetail 

type MerchantTicketUseDetail struct {
	// 券核销流水号
	TicketTransId string `json:"ticket_trans_id,omitempty" xml:"ticket_trans_id,omitempty"`
	// 核销的券码
	TicketCode string `json:"ticket_code,omitempty" xml:"ticket_code,omitempty"`
	// 用户购买券的时候实际支付的金额，单位为元，精确到小数点后两位
	BuyerPayAmount string `json:"buyer_pay_amount,omitempty" xml:"buyer_pay_amount,omitempty"`
	// 商家实收金额，单位为元，精确到小数点后两位
	ReceiptAmount string `json:"receipt_amount,omitempty" xml:"receipt_amount,omitempty"`
	// 商家优惠金额，单位为元，精确到小数点后两位
	DiscountAmount string `json:"discount_amount,omitempty" xml:"discount_amount,omitempty"`
	// 口碑补贴金额，单位为元，精确到小数点后两位
	MerchantSubsidyAmount string `json:"merchant_subsidy_amount,omitempty" xml:"merchant_subsidy_amount,omitempty"`
	// 交易中可给用户开具发票的金额，单位为元，精确到小数点后两位
	InvoiceAmount string `json:"invoice_amount,omitempty" xml:"invoice_amount,omitempty"`
}

MerchantTicketUseDetail 结构体

type TicketTemplateValidPeriod added in v1.2.5 

type TicketTemplateValidPeriod struct {
	// 使用截止时间（绝对时间）(yyyy-MM-dd HH:mm:ss)
	EndTime string `json:"end_time,omitempty" xml:"end_time,omitempty"`
	// 使用开始时间（绝对时间）(yyyy-MM-dd HH:mm:ss)
	ActiveTime string `json:"active_time,omitempty" xml:"active_time,omitempty"`
	// RELATIVE(相对类型) ABSOLUTE(绝对类型)
	ValidType string `json:"valid_type,omitempty" xml:"valid_type,omitempty"`
	// 使用截止相对分钟数（相对时间）
	EndMinTimes int64 `json:"end_min_times,omitempty" xml:"end_min_times,omitempty"`
	// 使用生效相对分钟数（相对时间）
	ActiveMinTimes int64 `json:"active_min_times,omitempty" xml:"active_min_times,omitempty"`
}

TicketTemplateValidPeriod 结构体

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.