fix: 更新发票请求结构体,修正内容字段为非必填,更新注释以提高可读性
This commit is contained in:
1 parent
3edbaef170
commit
f2bb2ef952
1 file changed
+9
-7
@@ -1,24 +1,26 @@
|
||||
package models
|
||||
package models
|
||||
|
||||
// ========== 客户端发票请求/响应结构体 ==========
|
||||
|
||||
// InvoiceCreateRequest 客户申请发票请求结构
|
||||
// InvoiceCreateRequest 客户端申请发票请求结构
|
||||
// Content 非必填。
|
||||
type InvoiceCreateRequest struct {
|
||||
OrderID string `json:"order_id" binding:"required"` // 订单ID,必填
|
||||
InvoiceType string `json:"invoice_type" binding:"required,oneof=personal enterprise vat_special"` // 发票类型,必填,personal-个人/enterprise-企业普票/vat_special-增值税专用发票
|
||||
ReceiverEmail string `json:"receiver_email" binding:"required,email"` // 收票邮箱,必填,格式为邮箱地址
|
||||
Title string `json:"title" binding:"required,max=200"` // 发票抬头,必填,最大200字符
|
||||
TaxpayerID *string `json:"taxpayer_id,omitempty"` // 纳税人识别号,企业发票必填,个人发票可为空
|
||||
Content string `json:"content" binding:"required,max=200"` // 开票内容,必填,最大200字符
|
||||
Remark *string `json:"remark,omitempty"` // 备注,可选
|
||||
Title string `json:"title" binding:"required,max=200"` // 发票抬头,必填,最多200字符
|
||||
TaxpayerID *string `json:"taxpayer_id,omitempty"` // 纳税人识别号,企业发票必填,个人发票可为空
|
||||
Content string `json:"content" binding:"omitempty,max=200"` // 开票内容,非必填,最多200字符
|
||||
Remark *string `json:"remark,omitempty"` // 备注,可选
|
||||
}
|
||||
|
||||
// InvoiceListRequest 发票列表查询请求结构
|
||||
// 注:apply_date 格式为 YYYY-MM-DD。
|
||||
type InvoiceListRequest struct {
|
||||
Page int `form:"page" binding:"omitempty,min=1"` // 页码,默认1
|
||||
PageSize int `form:"page_size" binding:"omitempty,min=1,max=100"` // 每页条数,默认10,最大100
|
||||
Status string `form:"status" binding:"omitempty"` // 状态筛选,pending-待处理/issued-已开票/rejected-已驳回
|
||||
Search string `form:"search" binding:"omitempty"` // 搜索关键词,支持发票号或订单号模糊匹配
|
||||
Search string `form:"search" binding:"omitempty"` // 搜索关键字,支持发票号或订单号模糊匹配
|
||||
ApplyDate string `form:"apply_date" binding:"omitempty"` // 申请日期筛选,格式YYYY-MM-DD
|
||||
CustomerID string `form:"customer_id" binding:"omitempty"` // 客户ID筛选(管理端)
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user