简要描述：
- 预约入库单创建接口
接口说明：
- 1.1接口描述：逐个推送采购单据给ERP
- 1.2接口说明：判断FMS本地是否有预约采购单,再查询OMS是否已有预约采购单,如果有则无法创建,如果无则调用奇门OMS创建预约入库单接口。
接口版本：
| 版本号 | 制定人 | 制定日期 | 修订日期 |
|---|---|---|---|
| 1.0.0 | 黄会准 | 2020-07-22 | 2020-07-22 |
请求URL:
请求方式：
- POST
请求头：
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| X-AUTH-TOKEN | 是 | string | 令牌 |
| Content-Type | 是 | string | 请求类型,统一是 application/json |
请求参数:
| 参数名 | 字段 | 是否必须 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
| 采购节点 | purchase_info | 是 | data | 请求参数的1级数据节点，包含采购单所有属性信息的数据节点，节点下数据字段详见下述“purchase_info”(注意这不是一个List) |
purchase_info
| 参数名 | 字段 | 是否必须 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
| 供应商编号 | provider_no | 是 | varchar | 20 | 供应商编号，ERP供应商档案必须存在此编号，否则推送失败 |
| 仓库编号 | warehouse_no | 是 | varchar | 40 | 代表仓库所有属性的唯一编码，用于仓库区分 |
| 外部单号 | outer_no | 是 | varchar | 40 | 外部单号（如果【使用外部单号作为系统采购单号】，那么该字段长度不能超过20）保证唯一 |
| 传入ERP采购单号 | is_use_outer_no | 否 | int | 210 | 使用外部单号作为系统采购单号（1使用，0不使用），默认不使用 |
| 自动审核 | is_check | 否 | int | 1 | 是否自动审核，0 不审核，1 审核，默认不自动审核（不影响财务审核） |
| 收货人姓名 | contact | 否 | varchar | 40 | 收货人姓名 |
| 采购员 | purchase_name | 否 | varchar | 40 | 采购员 |
| 收货人联系电话 | telno | 否 | varchar | 40 | 收货人联系电话 |
| 收货地址 | receive_address | 否 | varchar | 255 | 收货地址 |
| 货运方式 | logistics_type | 否 | smallint | 6 | 货运方式 |
| 预计到货时间 | expect_arrive_time | 否 | varchar | 20 | 采购单对应货品预计到达仓库时间，时间格式：YYYY-MM-DD HH:MM:SS |
| 其他费用 | other_fee | 否 | varchar | 20 | 其他费用 |
| 邮资 | post_fee | 否 | decimal | 20 | 邮资 |
| 备注 | remark | 否 | varchar | 255 | 采购单备注 |
| 自定义属性1 | prop1 | 否 | varchar | 255 | 自定义属性1 |
| 自定义属性2 | prop2 | 否 | varchar | 255 | 自定义属性2 |
| 采购明细节点 | details_list | 是 | data[] | 请求参数的2级数据节点，包含采购单所有货品明细信息的数据节点，节点下数据字段详见下述“details_list” |
details_list
| 参数名 | 字段 | 是否必须 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
| 商家编码 | spec_no | 是 | varchar | 20 | 代表单品(sku)所有属性的编码 |
| 采购量 | num | 是 | decimal | 20 | 采购量 |
| 采购价格 | price | 是 | decimal | 20 | 采购价格,按采购单位，税前单价 |
| 折扣 | discount | 否 | decimal | 20 | 折扣（1为不打折，0.9为9折，以此类推，0即为免费，接口计算公式在上边） |
| 税率 | tax | 否 | decimal | 20 | 货品的税率，传值范围大于等于0小于等于1 |
| 税后单价 | tax_price | 否 | decimal | 20 | 税后单价，推送税后单价时折扣（discount）传值不生效，由接口计算，公式为discount=tax_price/(price*(1+tax)) |
| 备注 | remark | 否 | varchar | 255 | 采购货品明细备注 |
| 自定义属性1 | prop1 | 否 | varchar | 255 | 自定义属性1 |
| 自定义属性2 | prop2 | 否 | varchar | 255 | 自定义属性2 |
请求参数示例
{
"purchase_info": {
"provider_no": "CYAP003",
"warehouse_no": "eptison2-test",
"outer_no": "2020080002",
"is_use_outer_no": 1,
"is_check": 1,
"contact": "",
"purchase_name": "",
"telno": "",
"receive_address": "",
"logistics_type": 0,
"expect_arrive_time": "2020-08-07 00:00:00",
"other_fee": 0.0,
"post_fee": 0.0,
"remark": "【20200806001】",
"prop1": "JP20080501/0",
"prop2": "首单",
"details_list": [
{
"spec_no": "JP20080501BS",
"num": 10,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501BM",
"num": 20,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501BL",
"num": 30,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501BXL",
"num": 40,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501TS",
"num": 1,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501TM",
"num": 2,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501TL",
"num": 3,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
},
{
"spec_no": "JP20080501TXL",
"num": 4,
"price": 50.0,
"discount": 0.79646017699115046,
"tax": 0,
"remark": "",
"prop1": "JP20080501/0",
"prop2": ""
}
]
}
}返回示例:
正确时返回:
{
"code": "1",
"msg": "SUCCESS",
"requestId": "6191563f3fa846bc8f90641e31e7bb5b"
}错误时返回:
{
"code": "failure",
"flag": "failure",
"msg": "数据校验异常",
"requestId": "08ef551ae1a94b008165fe26056a10ab",
"subCode": "200001",
"subMsg": "【CG2020072104】采购单号已生成采购单，请核查！"
}备注:
- 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-07 17:43 作者：黄会准
