对接京东jingdong.homefw.task.bookOndoor(预约/派件)接口的需求和Java代码实现

 

1.jingdong.homefw.task.bookOndoor(预约/派件)

API描述

上门前必须先预约用户，并通过调用此接口回传预约相关信息。

特别说明：

*对接方为商家时，由商家来调用此接口告之京东预约信息(比如：商家可在自己的物流商预约用户后，再由商家系统向京东回传预约信息)。

*对接方为物流商时，则由物流商通过此接口回传送装师傅等相关预约信息。

*对接方为安装服务商时，则由服务商通过此接口回传安装师傅等相关预约信息。

请求类：HomefwTaskBookOndoorRequest

名称	类型	是否必填	示例值	描述
appid	String	是		宙斯平台应用appid
venderCode	String	否		识别码,可为空
orderNo	String	是		任务工单号
masterName	String	是		(配送)师傅姓名
masterPhone	String	是		(配送)师傅电话
bookDate	String	是	2020-01-02 14-16	预约时间
operateTime	String	是		操作时间：格式为yyyy-MM-dd HH:mm:ss
logisticsNoExt	String	视对接方	3928320099821	运单号:对接方为物流商或商家时必填
city	String	视对接方	北京市	当前城市:对接方为物流商或商家时必填
siteType	int	视对接方	1	站点类型(1:站点,2:中转场/分拣中心):对接方为物流商或商家时必填
siteCode	String	视对接方		站点编号或中转/分拣中心编号:对接方为物流商或商家时必填
siteName	String	视对接方		站点名称或者中转场/分拣中心名称:对接方为物流商或商家时必填
remark	String	否		备注

结果集

名称	类型	是否必须	示例值	描述
returnType	ResultInfo	是		返回结果集,详见下面说明

​​​​​​​ResultInfo

名称	类型	是否必须	示例值	描述
resultCode	Number	是	100	返回码: 100:返回成功;200:返回失败
errMsg	String	否	参数不全	失败原因描述

​​​​​​​返回码解释

返回码	解释	产生原因	解决方式
100	执行成功
200	参数设置错误	参数过期或错误	检查参数

2.Java代码实现

官方Java代码实现如下

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);

HomefwTaskBookOndoorRequest request=new HomefwTaskBookOndoorRequest();

request.setVenderCode( "jingdong" );
request.setOrderNo( "jingdong" );
request.setMasterName( "jingdong" );
request.setMasterPhone( "jingdong" );
request.setBookDate( "jingdong" );
request.setOperateTime( "jingdong" );
request.setLogisticsNoExt( "jingdong" );
request.setCity( "jingdong" );
request.setSiteType( 123 );
request.setSiteCode( "jingdong" );
request.setSiteName( "jingdong" );
request.setRemark( "jingdong" );

HomefwTaskBookOndoorResponse response=client.execute(request);

自己写的Java代码实现如下：

    // 预约上门	jingdong.homefw.task.bookOndoor
    public static HomefwTaskBookOndoorResponse homefwTaskBookOndoor(
            HomefwTaskBookOndoorRequest request) throws Exception {
        JdClient client=new DefaultJdClient(serverUrl,accessToken,appKey,appSecret);
        return client.execute(request);
    }
    // 预约上门	jingdong.homefw.task.bookOndoor
    public  JdResultVO homefwTaskBookOndoor(String orderNo,String masterName,
                                                              String masterPhone,String bookDate) {
        HomefwTaskBookOndoorRequest request=new HomefwTaskBookOndoorRequest();
        try {
            request.setVenderCode(VENDER_CODE);
            request.setOrderNo(orderNo);
            request.setMasterName(masterName);
            request.setMasterPhone(masterPhone);
            request.setBookDate(bookDate);//2020-01-02 14-16
            request.setOperateTime(DateUtil.getTime());
    //        request.setLogisticsNoExt("3928320099821");
    //        request.setCity("北京市");
    //        request.setSiteType(1);
    //        request.setSiteCode("12345");
    //        request.setSiteName("亦庄站");
            request.setRemark("");
            HomefwTaskBookOndoorResponse response=JDAPIParent.homefwTaskBookOndoor(request);
            //保存明细
            jdApilogService.insert(request.getApiMethod(),
                    ReflectionToStringBuilder.toString(request),
                    ReflectionToStringBuilder.toString(response.getResultInfo()));
            return new JdResultVO();
        }catch (Exception e){
            jdApierrorService.insert(new HomefwTaskBookOndoorRequest().getApiMethod(),
                    ReflectionToStringBuilder.toString(request),
                    StringUtil.getExceptionAllinformation(e));
        }
        return new JdResultVO("失败");
    }

源码详情参考http://www.zrscsoft.com/sitepic/12105.html