德邦快递接口开发-java(【新】下单服务接口)

查看文档:德邦文档链接

【新】下单服务接口融合了标准类的散客电子面单,快递电子面单,零担电子面单所有的下单接口;
该接口提供的服务:
(1)快递电子面单,零担电子面单和散客电子面单下单,并支持预埋单号或者同步获取运单号;
(2)轨迹订阅

根据提交数据的格式,我们建立对应的类文件,这样方便转化成对应的json数据提交,响应的数据也是一样的道理。

这里给出2个类文件,剩下的根据json结构对应建立即可。

public class DopOrder {

    private String logisticCompanyID = "DEPPON";
    
    private String companyCode = "公司编码"; //核算第三方接入商的公司编码(双方约定,建议公司简拼或者代码,字母大写)
    
    private String customerCode = "客户编码"; //与德邦crm中的客户编码保持一致
    
    private String orderSource = "客户编码";
    
    private String logisticID; //渠道单号 + 单号id
    
    private int    needTraceInfo = 1; //是否需要订阅轨迹 1:是(为是时要对接轨迹推送接口) 2:否 默认否
    
    private int    orderType = 2; //下单模式 1、 散客模式(单量较小,平台类,异地调货,退换货等发货地址不固定-需要通知快递员或者司机上门取件打单); 2、   大客户模式(仓库发货,固定点出货,单量较大客户自行打印标签,快递员直接盲扫走货)
    
    private DopPackageInfo packageInfo; //包裹信息
    
    private DopAddr receiver; //        收货人信息
    
    private DopAddr sender; //  发货人信息
    
    private DopAddService  addServices;  //增值服务
    
    private String transportType; //运输方式/产品类型  快递运输方式:3.60特惠件 RCP;   精准汽运短途 (常用):JZQY_SHORT ; 精准城运(常用):JZQY_LONG ; 精准空运 (一般):JZKY
    
    private String gmtCommit; //订单提交时间 2012-11-27 18:44:19 系统当前时间
    
    private int    payType; //支付方式  0:发货人付款(现付) 1:收货人付款(到付) 2:发货人付款(月结) (电子运单客户不支持寄付)
    
    private String isOut = "N"; //是否外发 Y:需要 N: 不需要(大客户模式下运输方式为零担时必填)
    
    private String   vistReceive = "Y";
    
    private String  remark;

    // getter and setter
}
public class DopPackageInfo {

    private String cargoName; //货物名称
    
    private String    deliveryType; //送货方式 1、自提; 2、送货进仓; 3、送货(不含上楼); 4、送货上楼; 5、大件上楼
    
    private int    totalNumber; //总件数(包裹数)
    
    private double totalWeight = 1; //总重量
    
    private String packageService; //包装  包装(直接用中文) : 纸、纤、木箱、木架、托膜、托木(大客户模式下运输方式为零担时必填)
}

通过表单,生成请求类数据,很多web框架都支持将各种数据整合成类数据:

JSONObject postJson = JSONObject.fromObject(dopOrder);
String _params = postJson.toString();

提交数据并接收响应数据,处理逻辑。

private DopOrderResponse syncOrder(long timestamp, String _params, String url) throws Exception {
    String digest = DopUtils.getDigest(_params + DopUtils.appkey + timestamp);
    Map map = new LinkedHashMap();
    map.put("params", _params);
    map.put("digest", digest);
    map.put("timestamp", String.valueOf(timestamp));
    map.put("companyCode", DopUtils.companyCode);
    
    String response = HttpClientUtils.post(url, map);
    
    System.out.println(response);
    
    JSONObject responseJson = JSONObject.fromObject(response);
    
    DopOrderResponse responseBean = (DopOrderResponse) JSONObject.toBean(responseJson, DopOrderResponse.class);
    return responseBean;
}
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,496评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,407评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,632评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,180评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,198评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,165评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,052评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,910评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,324评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,542评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,711评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,424评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,017评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,668评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,823评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,722评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,611评论 2 353

推荐阅读更多精彩内容