物料商品传入
最后更新时间：2021-10-11
请求
基本信息
| 基本 | ||
| 正式 DOMAIN | https://open.bianxingjimu.com | |
| 测试 DOMAIN | https://open.tb.tokoyi.com | |
| PATH | api/v1/bom/importBomItemForId | |
| HTTP Method | POST | |
| 调用方式 | 第三方调用TB | |
请求头
| 名称 | 类型 | 必填 | 描述 |
| Authorization | string | 是 | 值格式："TB TbTestAccessKeyId:`access_token`" 示例值："TB TbTestAccessKeyId:JuMYM0eWev33g1H4yZguXP026HCnaorOGQC3nAh4rU4=" |
| Content-Type | string | 是 | 固定值："application/json" |
| Date | string | 是 | 请求时间，仅支持GMT格式 |
请求体
| 名称 | 类型 | 必填 | 说明 |
| prj_id | int | 是 | 项目ID |
| sku_group | array | 是 | 商品组【最大商品数量不能超过100个】 |
| ∟sku_id | int | 是 | 商品ID |
| ∟sku_volume | string | 是 | 商品采购数量 |
请求体示例
json
{
"prj_id":319,
"sku_group":[
{
"sku_id": 124,
"sku_volume": 100
},
{
"sku_id": 142,
"sku_volume": 50
}
]
}
响应
响应头
| 名称 | 类型 | 必须 | 描述 |
| Content-Type | string | 是 | 固定值："application/json" |
| X-Tb-LogId | string | 是 | 日志ID 示例值："2021092309572286544XFCO1143" |
响应体
| 参数 | 类型 | 说明 |
| code | int | 错误码，非200表示失败 |
| msg | string | 返回码的描述 |
| data | map | 返回业务信息 |
| ∟data_check_pass | int | 检查商品通过数量 |
| ∟data_check_fail | int | 检查商品失败数量 |
| ∟data_check_fail_detail | map | 检查商品失败详情 |
| ∟∟sku_id | int | 商品sku_id |
| ∟∟fail_msg | string | 失败信息 |
| ∟data_insert | int | 插入成功数量 |
| ∟data_ignore | int | 插入失败数量 |
200响应体示例
json
{
"code": 200,
"msg": "SUCCESS",
"data": {
"data_check_pass": 2,
"data_check_fail": 0,
"data_check_fail_ids_msg": [],
"data_insert": 2,
"data_ignore": 0
}
}
400响应体示例
json
{
"code": 400,
"msg": "商品数量不能为空",
"data": []
}
401响应体示例
json
{
"code": 401,
"msg": "Data check failed",
"data": {
"data_check_pass": 1,
"data_check_fail": 2,
"data_check_fail_detail": [
{
"sku_id": 1522,
"fail_msg": "Invalid sku_id"
},
{
"sku_id": 1512,
"fail_msg": "Invalid sku_id"
}
],
"data_insert": 0,
"data_ignore": 3
}
}
404响应体示例
json
{
"code": 404,
"msg": "Project does not exist",
"data": {
"data_check_pass": 0,
"data_check_fail": 3,
"data_check_fail_detail": [],
"data_insert": 0,
"data_ignore": 3
}
}
错误码
| HTTP状态码 | 业务状态码 | 解释 | 对应msg信息 |
| 200 | 200 | 成功 | SUCCESS |
| 200 | 400 | 参数错误 | XX不能为空|格式错误 |
| 200 | 401 | 商品信息验证失败 | 详见返回信息 |
| 200 | 404 | 暂无信息 | 详见返回信息 |
| 403 | 无 | token错误 | 详见返回信息 |