入库,库存增加明细单据回传API_V1.0.md

回调说明

  1. 所有方法 回调参数包含在请求体(requestBody)中, 所有参数按照json格式发送,编码格式为UTF-8

  2. 回调API授权目前支持accessToken和username/password方式,使用其中之一方式即可

  3. 所有回调会尝试3次,第三次失败会发生告警邮件, 务必将负责人的email录入到冰河系统

  4. 回调后必须返回如下json结构数据:
    { "status": "success", "mark": "说明" }
    字段说明:
    status取值范围 success/fail
    mark:处理失败,使用该参数说明

  5. 回调url格式: pushURL/(方法名)

  6. 推送是以快递纬度推送路由跟踪信息,黑狗后台已自动判断箱子是否全部送达,暂不支持以箱子纬度推送路由跟踪信息

单据状态回传(针对库内部分,快递部分不需要对接这个接口)

Push URL:/API/V1/updateReceiptStatus

回调参数

{
  "messageID":1234,
  "operateDatetime": "2015-09-15 10:43:22",
  "sourceNO": "DX123456789",
  "statusDesc": "入库成功",
  "statusCode": 0,
  "accessToken": "123457",
  "accessUserName": "accessUserName",
  "accessPassword": "123456",
  "remark": "备注",
  "detailList": [
    {
      "goodsNO": "LJ13234",
      "qit": 234,
      "unit": "盒"
    }
  ],
"recepitNO": "SN1234355"
}

参数说明

参数名 是否必须 描述 示例
messageID 消息唯一标识,防止重复推送 1234
operateDatetime 发生时间 2015-09-14 18:02:58
operationUser 操作人 张三
accessToken 授权token,token,accessUserName,accessPassword参数只能取一种 123457
accessUserName 授权用户名 accessUserName
accessPassword 授权密码 123456
sourceNO 传入黑狗的原始单号,如果有 DX123456789
detailList 单据确认明细 ,注意,一个入库通知单,会有多条入库确认通知,调用方,需要根据入库通知单总量进行比较,判断消息推送是否合法,冰河保证总量一致,不保证一次推送当前入库通知单所有确认信息
detailList.goodsNO 商品编号 SA12345678
detailList.qit 数量 123
detailList.unit 商品规格
statusDesc 状态描述 成功,失败
statusCode 状态对应的数字 取值范围,0:成功,1:失败 1
remark 备注信息 备注
recepitNO 单据入库后,冰河系统生成的唯一单据号 SN1234
receiptType 入库类型 1
receiptTypeDesc 入库类型描述 盘盈

入库类型 参数为数字

  PanYing(1, "盘盈"),
  CaiGou(2, "采购入库"),
  QuYang(3, "取样"), 
  ZuHe(4, "组合"), 
  DiaoBo(5, "调拨"), 
  TuiHuo(6,"仓库退换货"), 
  NeiLing(7, "内领"), 
  QiTa(8, "其他入库"), 
  TiaoHuo(9, "调货入库"), 
  //10,11,12,保留
  WeiTuo(13, "委托入库");

你可能感兴趣的:(入库,库存增加明细单据回传API_V1.0.md)