Authored by wangxin

Update pda-interface-doc.md

@@ -721,4 +721,151 @@ code为200即为成功,否则是失败。 响应JSON格式如下所示: @@ -721,4 +721,151 @@ code为200即为成功,否则是失败。 响应JSON格式如下所示:
721 "code": 200, 721 "code": 200,
722 "message": "success", 722 "message": "success",
723 "data": [] 723 "data": []
724 - }  
  724 + }
  725 +
  726 +
  727 + 21.# PDA查询任务列表接口 #
  728 + TaskInfoController/getTaskInfoList4PDA
  729 +
  730 + 入参:
  731 +
  732 + {
  733 + taskType ---任务类型:1.销售拣货,2.调拨拣货,3.巡场任务, 传空查全部
  734 + taskStatus --- 任务状态:1.待接收,2.已接收,3.已完成,4.已终止, 传空查全部
  735 + startTime ---查询开始时间 格式yyyy-MM-dd HH:mm:ss 可以为空
  736 + endTime ---查询结束时间 格式yyyy-MM-dd HH:mm:ss 可以为空
  737 + storeId ---线下店ID,必填,通过登录接口返回获取
  738 + userId ---用户ID,查询“我的任务”时必填,通过登录接口返回获取
  739 + }
  740 +
  741 + 返回:
  742 +
  743 + {"code":200,
  744 + "message":"success",
  745 + "data":{
  746 + "total":1, ---记录总条数
  747 + "currentPage":0,
  748 + "pageSize":0,
  749 + "totalPage":0,
  750 + "rows":[{
  751 + "createTime":1469703776,
  752 + "createTimeStr":"2016-07-28 19:02:56", ---任务创建时间
  753 + "index":1, ---序号
  754 + "id":2, ---任务单号
  755 + "taskType":1,
  756 + "taskTypeStr":"销售拣货", ---任务类型
  757 + "linkId":123456,
  758 + "taskStatus":1,
  759 + "taskStatusStr":"待接收", ----任务状态
  760 + "receiveUserId":50,
  761 + "receiveUserName":"Alex", ---任务接收人
  762 + "receiveTime":"2016-07-28 19:02:56", ---接收时间
  763 + "finishTime":"2016-07-28 19:02:56", ----结束时间
  764 + "number": 10 ----销售拣货或调拨拣货表示拣货商品数,巡场任务表示区域数
  765 + "storeId":70} ...]}}
  766 +
  767 +
  768 + 22.#PDA接收任务接口#
  769 + TaskInfoController/receiveTask4PDA
  770 +
  771 + 入参:
  772 +
  773 + {
  774 + id ---任务单号
  775 + userId ---接收人用户ID
  776 + }
  777 +
  778 + 返回
  779 +
  780 + {
  781 + code: "200" --- 200表示成功,201表示任务已经被他人接收,其他情况返回码待定
  782 + message:"success" ---失败则返回错误信息内容
  783 + }
  784 +
  785 +
  786 + 23.# PDA上传巡场区域接口 #
  787 + TaskInfoController/checkPatrolTask4PDA
  788 + 入参:
  789 +
  790 + {
  791 + id ---任务单号
  792 + regionCode : ---区域编码(二维码上的信息)
  793 + userId ---接收人用户ID
  794 + }
  795 +
  796 + 返回
  797 +
  798 + {
  799 + code: "200" --- 200表示成功,其他情况返回码待定
  800 + message:"success" ---失败则返回错误信息内容
  801 + }
  802 +
  803 + 24.# PDA查询任务数接口 #
  804 + TaskInfoController/getTaskNums4PDA
  805 +
  806 + 入参:
  807 +
  808 + {
  809 + userId ---接收人用户ID
  810 + }
  811 +
  812 + 返回 {
  813 +
  814 + code: "200" --- 200表示成功,其他情况返回码待定
  815 + message:"success" ---失败则返回错误信息内容
  816 + data: {
  817 + totalUnreceivedTaskNums ---全部待接收任务数量
  818 + myReceivedTaskNums ---我的已接受任务数量
  819 + }
  820 + }
  821 +
  822 + 25.#PDA查询任务详情接口#
  823 + TaskInfoController/getTaskDetailList4PDA
  824 + 请求参数:
  825 +
  826 + {
  827 + id: ---任务单号
  828 + task_type : --- 任务类型:1.销售拣货,2.调拨拣货,3.巡场任务
  829 + }
  830 +
  831 + 返回参数:
  832 + //销售拣货,调拨拣货返回
  833 +
  834 + {code: "200" --- 200表示成功,其他情况返回码待定
  835 + message:"success" ---失败则返回错误信息内容
  836 + data: {
  837 + taskStatus: 1 ---任务状态:1.待接收,2.已接收,3.已完成,4.已终止
  838 + receiveTime: 121212 ---任务接收时间
  839 + finishTime:12121 ---任务完成时间
  840 +
  841 + list : [ ---拣货任务返回
  842 + {
  843 + imageUrl ---商品图片地址
  844 + templatePic ---PDA格式图片地址
  845 + productSku ---sku
  846 + sizeName --- 尺码
  847 + colorName ---颜色
  848 + productSkc ---SKC
  849 + brandName ---品牌
  850 + productName ---商品名称
  851 + maxSortName ---分类
  852 +
  853 + productSkn --skn
  854 + allStock ---总仓库存
  855 + shopStock ---门店库存
  856 + goodsShelvesStock ---门店库存位置
  857 + num ---应拣数量
  858 + realNum ---实际拣货数量
  859 + shelfProductNum ---货架包含商品数量
  860 + shelfProductDetail ---货架商品数量详情
  861 + } .....]
  862 + }
  863 +
  864 + list : [ ----巡场任务返回
  865 + {
  866 + taskId ---任务单号
  867 + regionCode ---区域编码
  868 + patrolTime ---巡场时间
  869 + }
  870 + ]
  871 + }