wujianwei
2026-01-07 1091c0e1f8a96391fff3f918594b3ed6b1986c63
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
package com.ruoyi.cwgl.domain;
 
import lombok.Data;
 
import java.util.List;
 
@Data
public class Order {
 
 
 
    // 购买方名称
    private String buyerName; // 类型: String, 必须, 示例值: "企业名称/个人", 长度: 100, 描述: 购方名称
 
    // 购买方税号(个人可为空)
    private String buyerTaxNum; // 类型: String, 示例值: "339901999999198", 长度: 20, 描述: 购方税号(企业要填,个人可为空;数电专票、二手车销售统一发票时必填)
 
    // 购买方电话
    private String buyerTel; // 类型: String, 示例值: "0571-88888888", 长度: 50, 描述: 购方电话(购方地址+电话总共不超100字符;二手车销售统一发票时必填)
 
    // 购买方地址
    private String buyerAddress; // 类型: String, 示例值: "杭州市", 长度: 80, 描述: 购方地址(购方地址+电话总共不超100字符;二手车销售统一发票时必填)
 
    // 购买方银行开户行及账号
    private String buyerAccount; // 类型: String, 示例值: "中国工商银行 111111111111", 长度: 100, 描述: 购方银行开户行及账号
 
    // 销售方税号
    private String salerTaxNum; // 类型: String, 必须, 示例值: "339901999999199", 长度: 20, 描述: 销方税号(使用沙箱环境请求时消息体参数salerTaxNum和消息头参数userTax填写339902999999789113)
 
    // 销售方电话
    private String salerTel; // 类型: String, 必须, 示例值: "0571-77777777", 长度: 20, 描述: 销方电话(在工作台配置过的可以不传,以传入的为准)
 
    // 销售方地址
    private String salerAddress; // 类型: String, 必须, 示例值: null, 长度: 80, 描述: 销方地址(在工作台配置过的可以不传,以传入的为准)
 
    // 销售方银行开户行及账号
    private String salerAccount; // 类型: String, 示例值: null, 长度: 100, 描述: 销方银行开户行及账号(二手车销售统一发票时必填)
 
    // 是否显示银行账号类型
    private String showBankAccountType; // 类型: String, 示例值: "0", 长度: 2, 描述: 不传默认为0:都不显示;传1:备注仅显示销方开户行及账号;传2:备注仅显示购方开户行及账号;传3:购销方开户行及账号都显示(此字段仅在数电普票和数电专票下生效)
 
    // 是否显示地址电话类型
    private String showAddressTelType; // 类型: String, 示例值: "0", 长度: 2, 描述: 不传默认为0:都不显示;传1:备注仅显示销方地址及电话;传2:备注仅显示购方地址及电话;传3:购销方地址及电话都显示(此字段仅在数电普票和数电专票下生效)
 
    // 订单号
    private String orderNo; // 类型: String, 必须, 示例值: "201701053332079312313", 长度: 64, 描述: 订单号(每个企业唯一)
 
    // 订单时间
    private String invoiceDate; // 类型: String, 必须, 示例值: "2022-01-13 12:30:00", 长度: 20, 描述: 订单时间
 
    // 蓝票发票代码
    private String invoiceCode; // 类型: String, 示例值: null, 长度: 12, 描述: 冲红时填写的对应蓝票发票代码(红票必填 10位或12 位, 11位的时候请左补 0)
 
    // 蓝票发票号码
    private String invoiceNum; // 类型: String, 示例值: null, 长度: 8, 描述: 冲红时填写的对应蓝票发票号码(红票必填,不满8位请左补0)
 
    // 红票冲红原因
    private String redReason; // 类型: String, 示例值: "1", 长度: 1, 描述: 冲红原因:1:销货退回;2:开票有误;3:服务中止;4:发生销售折让(开具红票时且票种为p,c,e,f,r需要传--成品油发票除外;不传时默认为 1)
 
    // 红字信息表编号
    private String billInfoNo; // 类型: String, 示例值: "1403011904008472", 长度: 24, 描述: 红字信息表编号.专票冲红时此项必填,且必须在备注中注明“开具红字增值税专用发票信息表编号ZZZZZZZZZZZZZZZZ”字样,其 中“Z”为开具红字增值税专用发票所需要的长度为16位信息表编号(建议16位,最长可支持24位)。
 
    // 开票员id
    private String clerkId; // 类型: String, 示例值: null, 长度: 32, 描述: 开票员id(开票系统中的id)
 
    // 备注信息
    private String remark; // 类型: String, 示例值: "备注信息", 长度: 230, 描述: 冲红时,在备注中注明“对应正数发票代码:XXXXXXXXX号码:YYYYYYYY”文案,其中“X”为发票代码,“Y”为发票号码,可以不填,接口会自动添加该文案;机动车发票蓝票时备注只能为空;数电票时最长为200字符
 
    // 减按征收类型
    private String taxReductionFlag; // 类型: String, 示例值: "03", 长度: null, 描述: 减按征收类型。枚举值为03(销售使用过的固定资产)、05(房屋租赁)
 
    // 复核人
    private String checker; // 类型: String, 示例值: "王五", 长度: 20, 描述: 复核人(数电电票时若有值,会显示在生成的PDF/OFD备注栏中)
 
    // 收款人
    private String payee; // 类型: String, 示例值: "李四", 长度: 20, 描述: 收款人(数电电票时若有值,会显示在生成的PDF/OFD备注栏中)
 
    // 是否展示收款人和复核人
    private String showCheckerType; // 类型: String, 示例值: "0", 长度: 2, 描述: 数电电票是否展示收款人和复核人,0:不显示 1:显示
 
    // 开票员
    private String clerk; // 类型: String, 必须, 示例值: "张三", 长度: 20, 描述: 开票员(数电票时需要传入和开票登录账号对应的开票员姓名)
 
    // 清单标志
    private String listFlag; // 类型: String, 示例值: "0", 长度: 1, 描述: 清单标志 0-无清单 1-有清单(非必填,无清单时可不填)
 
    // 清单项目名称
    private String listName; // 类型: String, 示例值: "清单项目名称", 长度: 20, 描述: 清单项目名称
 
    // 推送方式
    private String pushMode; // 类型: String, 示例值: "1", 长度: 1, 描述: 推送方式(0:邮箱;1:手机;2:邮箱和手机)
 
    // 购方手机
    private String buyerPhone; // 类型: String, 示例值: "13888888888", 长度: 20, 描述: 购方手机
 
    // 推送邮箱
    private String email; // 类型: String, 示例值: "test@example.com", 长度: 100, 描述: 推送邮箱
 
    // 抄送手机
    private String ccPhone; // 类型: String, 示例值: "13999999999", 长度: 100, 描述: 抄送手机
 
    // 抄送邮箱
    private String ccEmail; // 类型: String, 示例值: "test2@example.com", 长度: 100, 描述: 抄送邮箱
 
    // 开票类型
    private String invoiceType; // 类型: String, 示例值: "10", 长度: 2, 描述: 开票类型(10:蓝票,20:红票)
 
    // 发票种类
    private String invoiceLine; // 类型: String, 示例值: "1", 长度: 1, 描述: 发票种类(电子发票时传1或2,1代表增值税专用发票,2代表增值税普通发票;机动车发票时传0)
 
    // 数电纸票类型
    private String paperInvoiceType; // 类型: String, 示例值: "1", 长度: 2, 描述: 数电纸票类型(1-专票;2-普票)
 
    // 特定要素
    private String specificFactor; // 类型: String, 示例值: "1", 长度: 2, 描述: 特定要素(电票的数字,纸票为空)
 
    // 是否强制开具标识
    private String forceFlag; // 类型: String, 示例值: "1", 长度: 2, 描述: 是否强制开具标识(0:否;1:是)
 
    // 代开标志
    private String proxyInvoiceFlag; // 类型: String, 示例值: "0", 长度: 1, 描述: 代开标志(0-否,1-是)
 
    // 代办退税标记
    private String taxRebateProxy; // 类型: String, 示例值: "0", 长度: 2, 描述: 代办退税标记(0-否,1-是)
 
    // 数电发票差额征税开具方式
    private String invoiceDifferenceType; // 类型: String, 示例值: "1", 长度: 2, 描述: 数电发票差额征税开具方式(1-差额开票,2-差额征税)
 
    // 分机号
    private String extensionNumber; // 类型: String, 示例值: "123", 长度: 10, 描述: 分机号
 
    // 终端号
    private String terminalNumber; // 类型: String, 示例值: "456", 长度: 10, 描述: 终端号
 
    // 机器编号
    private String machineCode; // 类型: String, 示例值: "789", 长度: 100, 描述: 机器编号
 
    // 是否机动车类专票
    private String vehicleFlag; // 类型: String, 示例值: "1", 长度: 1, 描述: 是否机动车类专票(0-否,1-是)
 
    // 是否隐藏编码表版本号
    private String hiddenBmbbbh; // 类型: String, 示例值: "0", 长度: 1, 描述: 是否隐藏编码表版本号(0-否,1-是)
 
    // 指定发票代码
    private String nextInvoiceCode; // 类型: String, 示例值: "144001999999", 长度: 12, 描述: 指定发票代码
 
    // 发票起始号码
    private String nextInvoiceNum; // 类型: String, 示例值: "16666666", 长度: 12, 描述: 发票起始号码
 
    // 发票终止号码
    private String invoiceNumEnd; // 类型: String, 示例值: "18888888", 长度: 12, 描述: 发票终止号码
 
    // 3%、1%税率开具理由
    private String surveyAnswerType; // 类型: String, 示例值: "1", 长度: 1, 描述: 3%、1%税率开具理由(1:现行政策适用;2:征税基础或减征幅度发生变化;3:临时适用政策;4:不征税产品销售;5:其他)
 
    // 购买方经办人姓名
    private String buyerManagerName; // 类型: String, 示例值: null, 长度: 20, 描述: 购买方经办人姓名
 
    // 经办人证件类型
    private String managerCardType; // 类型: String, 示例值: null, 长度: 2, 描述: 经办人证件类型
 
    // 经办人证件号码
    private String managerCardNo; // 类型: String, 示例值: null, 长度: 20, 描述: 经办人证件号码
 
    // 业务方自定义字段1
    private String bField1; // 类型: String, 示例值: null, 长度: 32, 描述: 业务方自定义字段1
 
    // 业务方自定义字段2
    private String bField2; // 类型: String, 示例值: null, 长度: 32, 描述: 业务方自定义字段2
 
    // 业务方自定义字段3
    private String bField3; // 类型: String, 示例值: null, 长度: 32, 描述: 业务方自定义字段3
 
    // 购买方自然人标志
    private String naturalPersonFlag; // 类型: String, 示例值: null, 长度: 1, 描述: 购买方自然人标志
 
    // 销售方自然人标志
    private String sellerNaturalPersonFlag; // 类型: String, 示例值: null, 长度: 1, 描述: 销售方自然人标志
 
    // 收购发票销售方证件类型
    private String certificateType; // 类型: String, 示例值: null, 长度: 2, 描述: 收购发票销售方证件类型
 
    // 购方税号校验标志
    private String taxNumVerifyFlag; // 类型: String, 示例值: null, 长度: 1, 描述: 购方税号校验标志
 
    // 购方名称校验标志
    private String naturalPersonVerifyFlag; // 类型: String, 示例值: null, 长度: 1, 描述: 购方名称校验标志
 
    // 商品匹配规则
    private String isIgnoreType; // 类型: String, 示例值: null, 长度: 2, 描述: 商品匹配规则
 
    // 发票明细
    private List<InvoiceDetailApi> invoiceDetail; // 类型: List<Object>, 示例值: null, 描述: 发票明细
 
    // 发票货物运输服务
    private List<InvoiceGoodsTransports> invoiceGoodsTransports; // 类型: List<Object>, 示例值: null, 描述: 发票货物运输服务
}