配送中心账单后台接口更改

作者: cabber | 来源:发表于2018-03-18 13:39 被阅读0次

后台接口开发与修改

[x] 1、首页获取供应商账单统计（更改角标）-已完成
[x] 2、供应商供应的门店列表（更改角标）-已完成
[x] 3、获取门店下的收货单/退货单（增加补货，修改单）
[x] 4、查看收货单/退货单单据日志（增加接口）
[ ] 5、导出单据列表接口更改
[ ] 6、查看收货单详情接口更改
[ ] 7、查看退货单详情接口更改
[ ] 8、导出收货单/退货单详情接口
[ ] 9、修改收货单详情明细并发送消息
[ ] 10、修改退货单详情明细并发送消息
[ ] 11、确认核账收货/退货并发送消息账单

工期 [2018.03.19(周一), 2018.03.20(周二), 2018.03.21(周三)]
人数 1人

后台接口更改必看计划

1、查出供应商
http://test.mealcome.cn/meallinkapi/pc/billStatistics/bill/statistics/get?mealcomeTime=1520905960000&rand=6110

参数：

{
  beginDate: '2018-03-01 00:00:00',
  endDate: '2018-03-13 23:59:59',
  branchIds: [50008, 6000000, 6000021, 6000052, 6000059],
  supplierName:
}

返回值：

{
  code: '0',
  data: [{
    actualAmount: 0,
    amount: 0,
    amountStr:"0.0",
    branchIds:[50008, 6000070],
    exceptionCount:6,(异常)
    待核账: 6,
    returnAmount:"",
    returnAmountStr:"",
    supplierId:6000041,
    supplierName:"总仓"
  }],
  msg: '',
  version: 0
}

如果是上面返回的多店
2、供应商供的门店
http://test.mealcome.cn/meallinkapi/pc/billStatistics/branch/details/get?mealcomeTime=1520906509000&rand=1793

参数

{
  beginDate: '2018-03-01 00:00:00',
  endDate: '2018-03-13 23:59:59',
  branchIds: [50008, 6000070],
  supplierId: ''
}

返回值

{
  code: '0',
  data: [{
    actualAmount:0,
    amount:0,
    amountStr:"0.0",
    branchId:6000070,
    branchName:"餐智测试店运营用",
    exceptionCount:5,(异常)
    待核账: 6,
    returnAmount:"",
    returnAmountStr:"-"
  }],
  msg: '',
  version: 0
}

分公司下只有一个店，或是切换到单门店权限管理,

查出供应商后直接进入核账单列表，查出供应商下的收货退货单

3、查出供应商下的收货/退货单

原来的模式是查询收货单与退货单的接口

1、收货单

// URL地址:
<http://test.mealcome.cn/meallinkapi/pc/billStatistics/receipt/materialDetails/get?fieldName=&sortType=&documentId=6524908&pageIndex=1&mealcomeTime=1520848432000&rand=3053)>

// 参数：
{
  "branchIds":[6000070],
  "beginDate":"2018-03-01 00:00:00",
  "endDate":"2018-03-13 23:59:59",
  "pageIndex":1,
  "isException":0,
  "supplierId":6000041
}


// 返回值:
{
  code: '',
  data: {
    list: [],
    pageCount:1,
    pageIndex:1,
    pageSize:20,
    total:5
  },
  msg: '',
  version: 0
}

2、退货单

// URL地址：
<http://test.mealcome.cn/meallinkapi/pc/billStatistics/return/details/get?mealcomeTime=1520924102000&rand=2440>

// 参数
{
  "branchIds":[6000070],
  "beginDate":"2017-12-30 00:00:00",
  "endDate":"2018-02-28 23:59:59",
  "pageIndex":1,
  "isException":0,
  "supplierId":6000434
}

// 返回值
{
  code: '',
  data: {
    "list": [{
      "id": 6064861,
      "branchId": 6000070,
      "branch": "餐智测试店运营用",
      "supplierId": 6000434,
      "supplier": "苹果苹果苹果 苹果苹果",
      "number": "CGTH1801226064861",
      "statusId": 2,
      "status": "供应商已确认",
      "money": 20.00,
      "receiverId": 6000915,
      "employee": "厨师长",
      "remark": "",
      "date": "2018-01-22 15:55:28",
      "pic": 0,
      "receiptPhotos": "",
      "deliveryId": "",
      "documentChangeRecords": [{
        "id": 13210425,
        "tenantId": 50135,
        "documentTypeId": 23,
        "documentId": 6064861,
        "detailId": 0,
        "changeContent": "餐链 提交退货",
        "changeDate": "2018-01-22 15:55:28"
      }, {
        "id": 13310535,
        "tenantId": 50135,
        "documentTypeId": 23,
        "documentId": 6064861,
        "detailId": 0,
        "changeContent": "系统自动确认退货单",
        "changeDate": "2018-01-24 16:00:01"
      }],
      "isException": 0,
      "receiptTag": 0,
      "returnTag": 0
    }],
    "pageIndex": 1,
    "pageSize": 20,
    "pageCount": 1,
    "total": 7
  },
  msg: '',
  version: 0
}

合并成一个接口

1、获取对账核账单

// url地址: 
/pc/billStatistics/orderInfo/list


// 传入参数：
{
  "branchIds":[6000070],
  "beginDate":"2018-03-01 00:00:00",
  "endDate":"2018-03-13 23:59:59",
  "isWaitCheckBill":0,
  "orderType":0,   //0全部、1收货、2退货、
  "supplierId":6000041,
  "fieldName": "",
  "sortType": ""
}

// 返回值
{
  "code": "0",
  "data": {
    "items": {
      "list": [{
        "id": 6064861,
        "branchId": 6000070,
        "branch": "餐智测试店运营用",
        "supplierId": 6000434,
        "supplier": "苹果苹果苹果 苹果苹果",
        "number": "CGTH1801226064861",
        "statusId": 2,
        "status": "供应商已确认",
        "money": 20.00,
        "employeeId": 6000915,
        "employeeName": "厨师长",
        "date": "2018-01-22 15:55:28",
        "isWaitCheckBill": 1,
        "isRecordTag": 0,
        "isEditTag": 0,
        "isRepairTag": 0,
        "orderId": 1,
        "orderType": "退货单"
      }]
    },
    "amount": 3492.09,
    "total": 7
  },
  "msg": "",
  "version": "1.0"
}

2、根据收货单id查询日志

// URL地址
/pc/billStatistics/receiptChangeRecord/get/:id

// 参数
id    // 收货单

// 返回值
{
  code: "0",
  data: [{
    id: 0,
    detailId: 0,
    changeDate: "",
    changeContent: "紫苏 收货异常, 异常原因: 不在指定收货时间段收货",
    documentId: 0
  }],
  msg: "",
  version: 1.0
}

3、根据退货单id查询日志

// URL地址
/pc/billStatistics/returnChangeRecord/get/:id

// 参数
id    // 退货单

// 返回值
{
  code: "0",
  data: [{
    id: 0,
    detailId: 0,
    changeDate: "",
    changeContent: "紫苏 收货异常, 异常原因: 不在指定收货时间段收货",
    documentId: 0
  }],
  msg: "",
  version: 1.0
}

4、导出单据列表

// URL地址

// 参数
{
  branchIds: [6000332, 694333],
    supplierId: 6001234,
    orderType: 0,
    beginDate: '2018-03-09 00:00:00',
    endDate: '2018-03-09 23:59:00',
    isWaitCheckBill: 0
}

// 返回值
{
  code: "0",
  data: [], // 生成一个文件二进制流
  msg: "",
  version: 1.0
}

5、查看收货单详情接口更改

// URL地址

// 参数
{
  id: 6527652,
  orderType: 1,
  fieldName: "",
  sortType: ""
}

// 返回值
{
  code: "0",
  data: {
    item: {
      list: [{
        goodsId: 10157127,
        goodsName: "紫苏",
        date: "2018-03-16 15:13:52",// 收货时间
        price: 2.5,
        unitId: 42,
        unitName: "斤",
        secondUnitId: 42,
        secondUnitName: "斤",
        statusId: 8,
        statusName: "异常",
        spec: "-",
        realWeight: 10, // 真实称重
        tare: 1, // 皮重
        imgUrl: "http://a.com/439u4h4938493",
        departments: [{
          detailId: 600384,
          departId: 600042,
          departName: "厨房",
          createdDate: "2017-04-21 13:52:19",// 下单时间
          code: "SH494384493849",
          purchaseQuality: 4.5, // 申购第一单位的数量
          purchaseSecondQuality: 9, // 申购第二单位的数量
          receiveQuality: 4.5,  // 收货第一单位的数量
          receiveSecondQuality: 9, // 收货第二单位的数量
          realReceiveQuality: 4.5, // 实际应收重量
          price: 2.5,
          amount: 11.25,
          realAmount: 11.25,
          statusId: 8,
          statusName: "异常",
          logCount: 6
        }]
      }]
    },
    branchId: 50008,
    branchName: "格林店",
    code: "SH8888883883834",
    total: 13,
    amount: 239.03
  },
  msg: "",
  version: 1.0
}

6、导出收货单据详情


// URL地址
/

// 参数
{
  id: 6527652,
  orderType: 1,
  fieldName: "",
  sortType: ""
}

// 返回值
{
  code: "0",
  data: [],// 生成一个文件二进制流
  msg: "",
  version: 1.0
}

7、修改收货单详情明细并发送消息


// URL地址
/

// 参数
{
  id: 6527652, // 核账单据id
  reason: "-",
  details: [{
    goodsId: 10157127, // 商品id
    goodsName: "紫苏",
    departments: [{
      departmentId: 6000776,
      departmentName: "厨房",
      note: "单价￥12 → ￥12.1，金额￥72 → ￥72.6，",
      price: 2.5,
      amount: 11.25,
      receiveQuality: 4.5,
      receiveSecondQuality: 9
    }]
  }]
}

// 返回值
{
  code: "0",
  data: "2018-03-18 11:05:44",
  msg: "",
  version: 1.0
}

8、获取核账明细单日志（收货/退货）


// URL地址
/

// 参数
{
  detailId: 600384
}

// 返回值
{
  code: "0",
  data: [{
    id: 0,
    detailId: 0,
    changeDate: "",
    changeContent: "紫苏 收货异常, 异常原因: 不在指定收货时间段收货",
    documentId: 0
  }],
  msg: "",
  version: 1.0
}

9、确认核账收货/退货并发送消息账单


// URL地址
/

// 参数
{
  id: 6527652
}

// 返回值
{
  code: "0",
  data: "2018-03-18 11:05:44",
  msg: "",
  version: 1.0
}

10、查看退货单详情接口更改

// URL地址

// 参数
{
  id: 6527652,
  orderType: 2,
  fieldName: "",
  sortType: ""
}

// 返回值
{
  code: "0",
  data: {
    item: {
      list: [{
        goodsId: 10157127,
        goodsName: "紫苏",
        date: "2018-03-16 15:13:52",// 退货时间
        price: 2.5,
        unitId: 42,
        unitName: "斤",
        secondUnitId: 42,
        secondUnitName: "斤",
        statusId: 8,
        statusName: "异常",
        spec: "-",
        realWeight: 10, // 真实称重
        tare: 1, // 皮重
        imgUrl: "http://a.com/439u4h4938493",
        departments: [{
          detailId: 600384,
          departId: 600042,
          departName: "厨房",
          code: "SH494384493849",
          returnQuality: 4.5,  // 收货第一单位的数量
          returnSecondQuality: 9, // 收货第二单位的数量
          realReturnQuality: 4.5, // 实际应收重量
          price: 2.5,
          amount: 11.25,
          realAmount: 11.25,
          reason: "-",
          statusId: 8,
          statusName: "异常",
          logCount: 6
        }]
      }]
    },
    branchId: 50008,
    branchName: "格林店",
    code: "SH8888883883834",
    total: 13,
    amount: 239.03
  },
  msg: "",
  version: 1.0
}

11、导出退货单据详情


// URL地址
/

// 参数
{
  id: 6527652,
  orderType: 2,
  fieldName: "",
  sortType: ""
}

// 返回值
{
  code: "0",
  data: [],// 生成一个文件二进制流
  msg: "",
  version: 1.0
}

12、修改退货单详情明细并发送消息


// URL地址
/

// 参数
{
  id: 6527652, // 核账单据id
  reason: "-",
  details: [{
    goodsId: 10157127, // 商品id
    goodsName: "紫苏",
    departments: [{
      departmentId: 6000776,
      departmentName: "厨房",
      note: "单价￥12 → ￥12.1，金额￥72 → ￥72.6，",
      price: 2.5,
      amount: 11.25,
      returnQuality: 4.5,
      returnSecondQuality: 9
    }]
  }]
}

// 返回值
{
  code: "0",
  data: "2018-03-18 11:05:44",
  msg: "",
  version: 1.0
}

配送中心账单后台接口更改

后台接口更改必看计划

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读