磅单入库锁定接口

接口说明

接口地址: /gys/inspection-micro-service-web-api/bill/syncBillStatus
接口用途: 导入磅单引用关系接口，磅单入库锁定/解锁接口
请求方式: POST
请求参数: JSON格式字符串
注意事项: 
    1、请求中任意一条单据锁定失败，则全体回滚，锁定失败
    2、单据列表出现重复单据，但状态不同，以最后一条单据状态为准。
    3、单据解锁，必须所有条件(项目+来源产品+引用单据类型+引用单据三方ID+guid+磅单材料行id)，一致才能解锁
    4、同磅单，同来源单据，允许重复锁定或重复解锁
    5、磅单不存在锁定记录，允许推送解锁操作
    6、唯一性判断条件：项目+来源产品+引用单据类型+引用单据三方ID+guid+磅单材料行id
    7、校验数据一致性字段传值null不验证该字段，number字段传0验证字段值为0或null，string字段传空字符串验证字段值为空串或null

请求参数

推送JSONObject对象说明

单据引用主表属性

单据详情billList属性

单据材料详情materials属性

附加费详情surcharges属性

返回结果

常见异常信息

请求参数格式示例

{
    "syncCode":"xrqhhgj",                //类型：String  必有字段  备注：项目同步编码
    "source":"GEPS",                //类型：String  必有字段  备注：来源产品
    "billList":[                //类型：Array  必有字段  备注：单据列表
        {                //类型：Object  必有字段  备注：磅单详情
            "billType":0,                //类型：Number  必有字段  备注：磅单类型 0收料，1发料,2直入直出，8：其他磅单
            "guid":"08fc8be6-aabf-462f-8c12-e79532409354",                //类型：String  必有字段  备注：磅单唯一标示（guid）
            "originBizRefId":"20170228100600",                //类型：String  必有字段  备注：引用三方单据ID
            "originBizType":"入库单",                //类型：String  必有字段  备注：引用单据类型：入库单、到货点验、小票、直入直出、物资处置
            "materials":[                //类型：Array  必有字段  备注：磅单材料细表
                {                //类型：Object  必有字段  备注：磅单材料
                    "materialRowId":111,                //类型：Number  必有字段  备注：磅单材料行id
                    "globalStatus":8,                //类型：Number  必有字段  备注：磅单入库状态，已入库：8，取消入库：-8，不修改：0
                    "materialName":"挂篮模板",                //类型：String  可有字段  备注：材料名称，用于校验数据一致性，空不校验
                    "materialCode":"12",                //类型：String  可有字段  备注：材料编码，用于校验数据一致性，空不校验
                    "billQuantity":1.02,                //类型：Number  可有字段  备注：运单数量，用于校验数据一致性，空不校验
                    "realQuantity":1.3,                //类型：Number  可有字段  备注：实际数量，用于校验数据一致性，空不校验
                    "confirmationQuantity":1.4,                //类型：Number  可有字段  备注：确认量，用于校验数据一致性，空不校验
                    "surcharges":[                //类型：Array  可有字段  备注：附加费列表，用于校验数据一致性，空不校验
                        {                //类型：Object  可有字段  备注：附加费，用于校验数据一致性，空不校验
                            "id":12222,                //类型：Number  必有字段  备注：附加费id，用于校验数据一致性
                            "name":"附加费1",                //类型：String  可有字段  备注：附加费名称，用于校验数据一致性，空不校验
                            "code":"fjf11"                //类型：String  可有字段  备注：附加费编码，用于校验数据一致性，空不校验
                        }
                    ]
                }
            ]
        }
    ]
}

返回结果格式

{
    "code":200,                //类型：Number  必有字段  备注：状态码
    "success":true,                //类型：Boolean  必有字段  备注：接口是否成功
    "message":"操作成功",                //类型：String  必有字段  备注：接口状态信息
    "data":{                //类型：Object  必有字段  备注：处理结果
        "successList":[                //类型：Array  必有字段  备注：成功列表
            {                //类型：Object  必有字段  备注：磅单详情
                "billType":0,                //类型：Number  必有字段  备注：磅单类型 0收料，1发料,2直入直出，8：其他磅单
                "guid":"08fc8be6-aabf-462f-8c12-e79532409354",                //类型：String  必有字段  备注：磅单唯一标示（guid）
                "originBizRefId":"20170228100600",                //类型：String  必有字段  备注：引用三方单据ID
                "originBizType":"入库单",                //类型：String  必有字段  备注：引用单据类型：入库单、到货点验、小票、直入直出、物资处置
                "materials":[                //类型：Array  必有字段  备注：磅单材料细表
                    {                //类型：Object  必有字段  备注：磅单材料
                        "materialRowId":111,                //类型：Number  必有字段  备注：磅单材料行id
                        "globalStatus":8,                //类型：Number  必有字段  备注：磅单入库状态，已入库：8，取消入库：-8，不修改：0
                        "materialName":"挂篮模板",                //类型：String  可有字段  备注：材料名称，用于校验数据一致性，空不校验
                        "materialCode":"12",                //类型：String  可有字段  备注：材料编码，用于校验数据一致性，空不校验
                        "billQuantity":1.02,                //类型：Number  可有字段  备注：运单数量，用于校验数据一致性，空不校验
                        "realQuantity":1.3,                //类型：Number  可有字段  备注：实际数量，用于校验数据一致性，空不校验
                        "confirmationQuantity":1.4,                //类型：Number  可有字段  备注：确认量，用于校验数据一致性，空不校验
                        "surcharges":[                //类型：Array  可有字段  备注：附加费列表，用于校验数据一致性，空不校验
                            {                //类型：Object  可有字段  备注：附加费，用于校验数据一致性，空不校验
                                "id":12222,                //类型：Number  必有字段  备注：附加费id，用于校验数据一致性
                                "name":"附加费1",                //类型：String  可有字段  备注：附加费名称，用于校验数据一致性，空不校验
                                "code":"fjf11"                //类型：String  可有字段  备注：附加费编码，用于校验数据一致性，空不校验
                            }
                        ]
                    }
                ]
            }
        ],
        "errorList":[                //类型：Array  必有字段  备注：失败列表
            [                //类型：Array  必有字段  备注：无
                {                //类型：Object  必有字段  备注：磅单详情
                    "errCode":"NOT_EXIST",                //类型：String  必有字段  备注：失败编码
                    "errMsg":"billType为空",                //类型：String  必有字段  备注：失败原因
                    "billType":0,                //类型：Number  必有字段  备注：磅单类型 0收料，1发料,2直入直出，8：其他磅单
                    "guid":"08fc8be6-aabf-462f-8c12-e79532409354",                //类型：String  必有字段  备注：磅单唯一标示（guid）
                    "originBizRefId":"20170228100600",                //类型：String  必有字段  备注：引用三方单据ID
                    "originBizType":"入库单",                //类型：String  必有字段  备注：引用单据类型：入库单、到货点验、小票、直入直出、物资处置
                    "materials":[                //类型：Array  必有字段  备注：磅单材料细表
                        {                //类型：Object  必有字段  备注：磅单材料
                            "materialRowId":111,                //类型：Number  必有字段  备注：磅单材料行id
                            "globalStatus":8,                //类型：Number  必有字段  备注：磅单入库状态，已入库：8，取消入库：-8，不修改：0
                            "materialName":"挂篮模板",                //类型：String  可有字段  备注：材料名称，用于校验数据一致性，空不校验
                            "materialCode":"12",                //类型：String  可有字段  备注：材料编码，用于校验数据一致性，空不校验
                            "billQuantity":1.02,                //类型：Number  可有字段  备注：运单数量，用于校验数据一致性，空不校验
                            "realQuantity":1.3,                //类型：Number  可有字段  备注：实际数量，用于校验数据一致性，空不校验
                            "confirmationQuantity":1.4,                //类型：Number  可有字段  备注：确认量，用于校验数据一致性，空不校验
                            "surcharges":[                //类型：Array  可有字段  备注：附加费列表，用于校验数据一致性，空不校验
                                {                //类型：Object  可有字段  备注：附加费，用于校验数据一致性，空不校验
                                    "id":12222,                //类型：Number  必有字段  备注：附加费id，用于校验数据一致性
                                    "name":"附加费1",                //类型：String  可有字段  备注：附加费名称，用于校验数据一致性，空不校验
                                    "code":"fjf11"                //类型：String  可有字段  备注：附加费编码，用于校验数据一致性，空不校验
                                }
                            ]
                        }
                    ]
                }
            ]
        ],
        "message":"成功:1条，失败:1条"                //类型：String  必有字段  备注：结果说明
    }
}