recycle-admin/.cursor/rules/db.mdc

---
description:
globs:
alwaysApply: false
---

下单请求报文：
logisticID
渠道单号
生成规则为：sign+客户自己订单号，sign值由德邦开放平台自动生成，客户订单号无特殊要求，随机数也可以；注意：同一子母件（一票多货），logisticid必须要保持一致
String
32
Y
custOrderNo
客户订单号/商户订单号
客户的订单号
String
32
N
mailNo
德邦运单号
预埋德邦单号场景使用；子母件场景多个运单号使用英文【,】拼接
String
500
N
needTraceInfo
是否需要自动订阅轨迹
1：是（为是时要对接轨迹推送接口） 2：否
Integer
Y
companyCode
第三方接入商的公司编码
渠道来源,查看途径:登录德邦开放平台-我要接入-基本信息
String
32
Y
orderType
下单模式
1、散单上门取件模式（单量小，发货地址不固定,需系统通知接货员上门取件,由接货员打单,适用门店调拨，退换货等场景;整车订单也选此模式）；散客模式不支持子母件 2、大客户热敏电子面单模式（单量大,发货地址固定,不需要系统通知接货员上门取件,由客户打印热敏面单贴在货上，适用电商等固定仓库批量出货场景）; 3、快递筛单下单模式（单量大,发货地址固定,由客户打印热敏面单贴在货上,只支持快递产品,不可达区域会直接下单失败）
String
32
Y
transportType
运输方式/产品类型
(具体传值请咨询销售，否则可能下单失败/计费有误) 1、快递运输方式： 1.1 大件快递360：RCP 1.2 特快专递：TZKJC 1.3 标准快递：PACKAGE 1.4 特快当日：TKDR 1.5 特快次日：HKDJC 1.6 航空大件隔日达：HKDJG 1.7 特快冷链：DEAP 1.8 DP联运(K)：DPTL 1.9 DP联运(L大宗)：TKLY 1.10 精准大票电商：YTYDS 2、零担运输方式： 2.1 新精准汽运：NLRF 2.2 新精准卡航：NFLF 2.3 新精准重货：NJZZH 2.4 精准泡货：NZBRH 2.5 精准大票：YTY 3、整车运输方式：3.1 整车配送：ZCPS 3.2 精准专车：JZZHC 3.3 精准拼车：JZPC 4、特惠运输方式(仅支持散客电子面单，务必跟德邦销售核对清晰):4.1 微小件特惠：WXJTH 4.2 泡货特惠：ZYSCZD 4.3 重货特惠：DSZH
String
32
Y
customerCode
月结账号
德邦一线营业部给到客户的月结账号，由营业部给出。沙箱环境，下子母件订单必须传值 219401
String
32
Y
+ sender
发货人信息
Sender
Y
L businessNetworkNo
发货部门编码
德邦门店编码(由德邦门店经理提供)，适用于需要指定接货门店的场景,如果不需要指定可以不填
String
32
N
L name
发货人名称
String
32
Y
L mobile
发货人手机
String
32
Y
L phone
发货人电话
String
32
N
L province
发货人省份
String
32
Y
L city
发货人城市
String
32
Y
L county
发货人区县
String
32
Y
L town
发货人乡镇街道
String
32
N
L address
发货人详细地址
String
256
Y
+ receiver
收货人信息
Receiver
Y
L toNetworkNo
到达部门编码
德邦门店编码(由德邦门店经理提供)，适用于需要指定到达门店的场景,如果不需要指定可以不填
String
32
N
L name
收货人名称
String
32
Y
L phone
收货人电话
String
32
N
L mobile
收货人手机
String
32
Y
L province
收货人省份
String
32
Y
L city
收货人城市
String
32
Y
L county
收货人区县
String
32
Y
L town
收货人镇街道
String
32
N
L address
收货人详细地址
String
256
Y
+ packageInfo
包裹信息
PackageInfo
Y
L cargoName
货物名称
String
250
Y
L totalNumber
总件数（包裹数）
1、包裹数(指实际交接给我司已打包后的总包裹数)，子母件场景下,一个包裹对应一个运单号； 2、若包裹数大于1，则返回一个母运单号和N-1个子运单号 3、单次下单总件数上限为30件，如果大于30请分多次下单 4、散客模式即orderType=1不支持子母件 5、客户编码即customerCode必须要有子母件权限才能下子母件，具体咨询德邦销售，沙箱环境下使用 219401
Integer
32
Y
L totalWeight
重量（务必由德邦运营确认）
单个包裹重量，如果是多件累计的情况下，请传总重量/总件数后得出的均值，单位：kg,可以精确到小数点后两位
double
Double (5,2)
Y
L totalVolume
体积（务必由德邦运营确认）
单个包裹体积，如果是多件累计的情况下，请传总体积/总件数后得出的均值，单位：m3,可以精确到小数点后三位
double
Double (5,2)
N
L packageService
包装
包装（直接用中文） ： 纸、纤、木箱、木架、托膜、托木（大客户模式下运输方式为零担时必填）
String
32
N
L deliveryType
送货方式
(下述为常见送货方式，请咨询销售后传值，否则可能下单失败/计费有误) 1、自提； 2、送货进仓； 3、送货（不含上楼）； 4、送货上楼； 5、大件上楼 ;
String
32
Y
gmtCommit
订单提交时间
系统当前时间,格式为 yyyy-MM-dd HH:mm:ss 如 2020-11-07 18:44:19
String
32
Y
payType
支付方式
0、发货人付款（现付）（大客户模式不支持寄付） 1、收货人付款（到付） 2、发货人付款（月结） YC（预存）
String
32
Y
+ addServices
增值服务
12
AddServices
32
N
L backSignBill
签收回单
0:无需返单 1：签收单原件返回 2:电子签收单（电子签名图片需要另外对接查询接口）
String
0
N
L returnRequirement
签收回单返单类型
对应的值为 R1:签名；R2:盖章；R3:签身份证号；R4:身份证复印件；R5:仓库收货回执单，有签回单需求，且对返单有要求可使用此字段
String
0
N
L insuranceValue
保价金额
如为空，则开单时默认为0，单位：元
BigDecimal
N
L codType
代收货款类型
0：无代收 1：即日退 3：三日退 RF：固定退 注意：代收货款金额不为0时，此项客户必填，代收货款金额为0或为空，则代收类型默认为无
String
32
N
L reciveLoanAccount
代收货款客户账号
代收货款金额不为0时，此项客户必填
String
32
N
L accountName
代收货款客户开户名
代收货款金额不为0时，此项客户必填
String
32
N
L codValue
代收货款金额
如为空，则开单时默认为0，单位：元
BigDecima
N
sendStartTime
货好时间(预约上门揽件的时间)
方便上门接货的时间范围(yyyy-MM-dd HH:mm:ss)
String
32
N
sendEndTime
货好时间(截止时间)
方便上门接货的时间范围(yyyy-MM-dd HH:mm:ss)
String
32
N
originalWaybillNumber
原运单号
异地调货退货场景可能用到
String
32
N
remark
备注
注意事项（备注）
String
100
N
isOut
是否接受外发
Y：需要 N: 不需要（仅适用于下单模式为2且是零担运输方式；或者下单模式为3时）
String
32
N
passwordSigning
是否口令签收
仅适用于快递，Y：需要 N: 不需要；若为Y，必须收货人提供验证码给快递员才能签收，该服务是有偿的，具体费用请咨询我司门店
String
30
N
isdispatched
是否可派送
Y：是 N:否 （需要与ispresaleorder搭配使用）
String
32
N
ispresaleorder
是否预售单
Y：是 N: 否 （当传值为Y时isdispatched需传值N）
String
32
N
isPickupSelf 
是否接受合伙人自提
Y：是 N: 否（只适用于同步筛单下单模式）
String
32
N
isCenterDelivery
是否接受仅镇中心派送
Y：是 N:否,若空时，默认为Y（只适用于同步筛单下单模式）
String
32
N
+ orderExtendFields
扩展字段
1.德邦可以扫客户唯一码进行揽货，key为custewb_number，value为货物唯一码，以逗号分隔，且唯一码数量与件数一致，每个唯一码长度50； 2.派送前进行锁单（客户调用派送通知接口才能送货，派送接口需另外对接），key为notifyDeliver，value为N； 3.拍照签收，key为photoSigning，value为Y需要/N不需要； 4.取件码（快递员揽收时会跟客户核对取件码），key为pickupCode，value为4位取件码； 5.签回单件数,key为returnBillQty,value为【1-10】整数; 6.货物揽收时给快递员的提示语，key为cargoCheck,value为货物提醒语; 7.以旧换新，key为businessType，value为SXQJ； 8.是否强制电联，key为isContact,value为1； 传值示例：orderExtendFields
List
N
L value
订单扩展属性值
如：QPQ01160000049,QPQ01160189349
String
256
N
L key
订单扩展属性键
如：custewb_number
String
256
N
needPickupCode
是否需要生成取件码
2：德邦生成取件码（反参：pickupCode）
String
32
N