You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
334 lines
8.3 KiB
334 lines
8.3 KiB
---
|
|
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
|