zhao
2021-07-19 8347f2fbddbd25369359dcb2da1233ac48a19fdc
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
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
 
namespace HH.WMS.Entitys.Common
{
    public class KdEOrder
    {
        //订单编号(自定义,不可重复)    
        public string OrderCode { get; set; }
        //快递公司编码 详细编码参考《2018快递鸟接口支持快递公司编码.xlsx》    
        public string ShipperCode { get; set; }
        //邮费支付方式:1-现付,2-到付,3-月结,4-第三方支付(仅SF支持)    
        public int PayType { get; set; }
        //快递类型:1-标准快件 ,详细快递类型参考《快递公司快递业务类型.xlsx》    
        public string ExpType { get; set; }
        //快递运费    
        public double Cost { get; set; }
        //其他费用    
        public double OtherCost { get; set; }
        //收件人信息
        public KdEOrderReceiver Receiver { get; set; }
        //发件人信息
        public KdEOrderSender Sender { get; set; }
        //商品信息
        public List<KdEOrderCommoditys> Commodity { get; set; }
        //包裹总重量kg 当为快运的订单时必填,不填时快递鸟将根据各个快运公司要求传对应的默认值    
        public double Weight { get; set; }
        //包裹数(最多支持30件) 一个包裹对应一个运单号,如果是大于1个包裹,返回则按照子母件的方式返回母运单号和子运单号    
        public int Quantity { get; set; }
        //包裹总体积m3 当为快运的订单时必填,不填时快递鸟将根据各个快运公司要求传对应的默认值    
        public double Volume { get; set; }
        //备注
        public string Remark { get; set; }
        //返回电子面单模板:0-不需要;1-需要    
        public string IsReturnPrintTemplate { get; set; }
 
    }
    //完整版参数
    public class KdEOrderEntity
    {
        //ERP系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识,用于区分其用户    
        public string MemberID { get; set; }
        //电子面单客户号,需要下载《快递鸟电子面单客户号参数对照表.xlsx》,参考对应字段传值
        public string CustomerName { get; set; }
        //电子面单客户号,需要下载《快递鸟电子面单客户号参数对照表.xlsx》,参考对应字段传值
        public string CustomerPwd { get; set; }
        //电子面单客户号,需要下载《快递鸟电子面单客户号参数对照表.xlsx》,参考对应字段传值
        public string SendSite { get; set; }
        //电子面单客户号,需要下载《快递鸟电子面单客户号参数对照表.xlsx》,参考对应字段传值
        public string SendStaff { get; set; }
        //电子面单客户号,需要下载《快递鸟电子面单客户号参数对照表.xlsx》,参考对应字段传值
        public string MonthCode { get; set; }
        //商家自定义区域    
        public string CustomArea { get; set; }
        //发货仓编码    
        public string WareHouseID { get; set; }
        //运输方式 1-    陆运 2-    空运 不填默认为1    
        public int TransType { get; set; }
        //快递公司编码 详细编码参考《2018快递鸟接口支持快递公司编码.xlsx》    
        public string ShipperCode { get; set; }
        //快递单号(仅宅急送可用)    
        public string LogisticCode { get; set; }
        //第三方订单号 (ShipperCode为JD且ExpType为1时必填)    
        public string ThrOrderCode { get; set; }
        //订单编号(自定义,不可重复)    
        public string OrderCode { get; set; }
        //邮费支付方式:1-现付,2-到付,3-月结,4-第三方支付(仅SF支持)    
        public int PayType { get; set; }
        //快递类型:1-标准快件 ,详细快递类型参考《快递公司快递业务类型.xlsx》    
        public string ExpType { get; set; }
        //是否要求签回单 1-    要求 0-不要求    
        public int IsReturnSignBill { get; set; }
        //签回单操作要求(如:签名、盖章、身份证复印件等)    
        public string OperateRequire { get; set; }
        //快递运费    
        public double Cost { get; set; }
        //其他费用    
        public double OtherCost { get; set; }
        //收件人信息
        public KdEOrderReceiver Receiver { get; set; }
        //发件人信息
        public KdEOrderSender Sender { get; set; }
        //是否通知快递员上门揽件 0-    通知 1-    不通知 不填则默认为1    
        public int IsNotice { get; set; }
        //上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化,本文中所有时间格式相同    
        public DateTime StartDate { get; set; }
        //上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化,本文中所有时间格式相同    
        public DateTime EndDate { get; set; }
        //包裹总重量kg 当为快运的订单时必填,不填时快递鸟将根据各个快运公司要求传对应的默认值    
        public double Weight { get; set; }
        //包裹数(最多支持30件) 一个包裹对应一个运单号,如果是大于1个包裹,返回则按照子母件的方式返回母运单号和子运单号    
        public int Quantity { get; set; }
        //包裹总体积m3 当为快运的订单时必填,不填时快递鸟将根据各个快运公司要求传对应的默认值    
        public double Volume { get; set; }
        //备注
        public string Remark { get; set; }
        //增值服务
        public KdEOrderAddServices AddService { get; set; }
        //商品信息
        public List<KdEOrderCommoditys> Commodity { get; set; }
        //返回电子面单模板:0-不需要;1-需要    
        public string IsReturnPrintTemplate { get; set; }
        //是否订阅短信:0-不需要;1-需要    
        public int IsSendMessage { get; set; }
        //模板规格(默认的模板无需传值,非默认模板传对应模板尺寸)    
        public string TemplateSize { get; set; }
        //包装类型(快运字段)默认为0; 0-    纸 1-    纤 2-    木 3-    托膜 4-    木托 99-其他    
        public int PackingType { get; set; }
        //送货方式(快运字段)默认为0; 0-    自提 1-    送货上门(不含上楼) 2-    送货上楼    
        public int DeliveryMethod { get; set; }
    }
 
    //收件人
    public class KdEOrderReceiver
    {
        //收件人公司    
        public string Company { get; set; }
        //收件人    
        public string Name { get; set; }
        //电话与手机,必填一个    
        public string Tel { get; set; }
        //电话与手机,必填一个    
        public string Mobile { get; set; }
        //收件人邮编    
        public string PostCode { get; set; }
        //收件省 (如广东省,不要缺少“省”;如是直辖市,请直接传北京、上海等; 如是自治区,请直接传广西壮族自治区等)    
        public string ProvinceName { get; set; }
        //收件市(如深圳市,不要缺少“市”; 如果是市辖区,请直接传北京市、上海市等)    
        public string CityName { get; set; }
        //收件区/县(如福田区,不要缺少“区”或“县”)    
        public string ExpAreaName { get; set; }
        //收件人详细地址    
        public string Address { get; set; }
    }
 
    //发件人
    public class KdEOrderSender
    {
        //发件人公司    
        public string Company { get; set; }
        //发件人    
        public string Name { get; set; }
        //电话与手机,必填一个    
        public string Tel { get; set; }
        //电话与手机,必填一个    
        public string Mobile { get; set; }
        //发件地邮编(ShipperCode为EMS、YZPY、YZBK时必填)    
        public string PostCode { get; set; }
        //发件省 (如广东省,不要缺少“省”; 如是直辖市,请直接传北京、上海等; 如是自治区,请直接传广西壮族自治区等)    
        public string ProvinceName { get; set; }
        //发件市(如深圳市,不要缺少“市; 如是市辖区,请直接传北京市、上海市等”)    
        public string CityName { get; set; }
        //发件区/县(如福田区,不要缺少“区”或“县”)    
        public string ExpAreaName { get; set; }
        //发件人详细地址    
        public string Address { get; set; }
    }
 
    //增值服务
    public class KdEOrderAddServices
    {
        //增值服务名称(数组形式,可以有多个增值服务)
        public string Name { get; set; }
        //增值服务值    
        public string Value { get; set; }
        //客户标识(选填)    
        public string CustomerID { get; set; }
    }
 
    //商品信息
    public class KdEOrderCommoditys
    {
        //商品名称    
        public string GoodsName { get; set; }
        //商品编码    
        public string GoodsCode { get; set; }
        //商品数量    
        public int Goodsquantity { get; set; }
        //商品价格    
        public double GoodsPrice { get; set; }
        //商品重量kg    
        public double GoodsWeight { get; set; }
        //商品描述    
        public string GoodsDesc { get; set; }
        //商品体积m3    
        public double GoodsVol { get; set; }
    }
 
    //电子面单返回值
    public class KdEBusiness
    {
        //用户ID    
        public string EBusinessID { get; set; }
        //单据信息
        public KdEBusinessOrder Order { get; set; }
        //成功与否(true/false)    
        public bool Success { get; set; }
        //签回单单号    
        public string SignWaybillCode { get; set; }
        //返回编码    
        public string ResultCode { get; set; }
        //失败原因    
        public string Reason { get; set; }
        //唯一标识    
        public string UniquerRequestNumber { get; set; }
        //面单打印模板内容(html格式)    
        [JsonIgnore]
        public string PrintTemplate { get; set; }
        //订单预计到货时间yyyy-mm-dd    
        public DateTime EstimatedDeliveryTime { get; set; }
        //子单数量    
        public int SubCount { get; set; }
        //子单单号    
        public string SubOrders { get; set; }
        //子单模板内容(html格式)    
        [JsonIgnore]
        public string SubPrintTemplates { get; set; }
        //签回单模板内容(html格式)    
        [JsonIgnore]
        public string SignBillPrintTemplate { get; set; }
        //收件人安全电话    
        public string ReceiverSafePhone { get; set; }
        //收件人安全电话    
        public string SenderSafePhone { get; set; }
        //拨号页面网址(转换成二维码可扫描拨号)    
        public string DialPage { get; set; }
    }
    //返回的订单信息
    public class KdEBusinessOrder
    {
        //订单编号    
        public string OrderCode { get; set; }
        //快递公司编码    
        public string ShipperCode { get; set; }
        //快递单号    
        public string LogisticCode { get; set; }
        //大头笔    
        public string MarkDestination { get; set; }
        //始发地区域编码    
        public string OriginCode { get; set; }
        //始发地/始发网点    
        public string OriginName { get; set; }
        //目的地区域编码    
        public string DestinatioCode { get; set; }
        //目的地/到达网点    
        public string DestinatioName { get; set; }
        //分拣编码    
        public string SortingCode { get; set; }
        //集包编码    
        public string PackageCode { get; set; }
        //集包地    
        public string PackageName { get; set; }
        //目的地分类    
        public string DestinationAllocationCentre { get; set; }
    }
}