生成【生产变更作业】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【生产变更作业】的生成接口，将第三方系统的生产变更作业的生产信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【生产变更作业】。
参数说明
1.请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/MRPAZ/ADDDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号，必填 | |||
| 程序代号 | PGM | 是 | MRPAZ | |||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表MF_CS | ||||||
| 变更单号 | CS_NO | String | 20 | 1.自动编码时，根据单据编码原则自动产生； 2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同 3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
||
| 申请日期 | CS_DD | Datetime | 是 | |||
| 状态 | STATUS | String | 1 | 是 | 新增时表头状态是申请，要给1值，必填 | |
| 原因 | REASON | String | 100 | |||
| 备注 | REM | String | 40 | |||
| 经办人 | SAL_NO | String | 12 | |||
| 变更日期 | CHG_DD | Datetime | ||||
| 制单人 | USR | String | 12 | 是 | ||
| 审核人 | CHK_MAN | String | 12 | |||
| 拷贝注记 | CPY_SW | String | 1 | |||
| 打印注记 | PRT_SW | String | 1 | |||
| 最后修改日 | CLS_DATE | Datetime | ||||
| 部门 | DEP | String | 8 | 是 | ||
| 单据类别 | BIL_TYPE | String | 10 | |||
| 审核模版 | MOB_ID | String | 10 | |||
| 锁单人 | LOCK_MAN | String | 12 | |||
| 锁单时间 | LOCK_DATE | Datetime | 0 | |||
| 输单日期 | SYS_DATE | Datetime | ||||
| 打印人员 | PRT_USR | String | 12 | |||
| 作废标记 | CANCEL_ID | String | 1 | |||
| 打印日期 | PRT_DATE | Datetime | 0 | |||
| 最近修改日期 | MODIFY_DD | Datetime | 0 | |||
| 最近修改人 | MODIFY_MAN | String | 12 | |||
| 产品别 | APP_NAME_DATA | String | 30 | |||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表TF_CS | ||||||
| 变更单号 | CS_NO | String | 20 | 与表头MF_CS的CS_NO相同 | ||
| 项 | ITM | INT | 是 | |||
| 更改方式 | CHG_ID | String | 1 | 是 | 变更方式:1.生产变更，2.终止生产，3.继续生产，4.暂停生产，5.拆分；必填 | |
| 来源单ID | BIL_ID | String | 2 | 是 | 只允许输入MO、TZ、TW，必填 | |
| 制令单号 | MO_NO | String | 20 | 是 | 生产单号，必填 | |
| 成品代号 | MRP_NO | String | 30 | |||
| 单位 | UNIT | String | 1 | |||
| 原单数量 | QTY_SO | Float | ||||
| 已完工量 | QTY_FIN | Float | ||||
| 原订单号 | SO_NO_OLD | String | 20 | |||
| 新订单号 | SO_NO | String | 20 | |||
| 新生产量 | QTY | Float | ||||
| 原需求客户 | CUS_NO_OLD | String | 12 | |||
| 新客户 | CUS_NO | String | 12 | |||
| 原预交日 | EST_DD_OLD | Datetime | ||||
| 新预交日 | EST_DD | Datetime | ||||
| 备注 | REM | String | 100 | |||
| 原项次 | EST_ITM_OLD | INT | ||||
| 新项次 | EST_ITM | INT | ||||
| 单据种类 | TW_ID | String | 1 | 是 | 当BIL_ID=MO或TZ，给1值；当BIL_ID=TW时，给2值；必填 | |
| 鞋服组合栏位 | COMPOSE_IDNO | String | 50 | |||
| 货品特征 | PRD_MARK | String | 100 | |||
| 原生产部门 | DEP_OLD | String | 8 | |||
| 生产部门 | DEP | String | 8 | |||
| 原预开工日 | STA_DD_OLD | Datetime | ||||
| 新预开工日 | STA_DD | Datetime | ||||
| 原预完工日 | END_DD_OLD | Datetime | ||||
| 新预完工日 | END_DD | Datetime | ||||
| 原工程案号 | CAS_NO_OLD | String | 20 | |||
| 新工程案号 | CAS_NO | String | 20 | |||
| 原阶段编号 | TASK_ID_OLD | INT | 0 | |||
| 新阶段编号 | TASK_ID | INT | 0 | |||
| 新单价 | UP | Float | 0 | |||
| 原单价 | UP_OLD | Float | 0 | |||
| 变更原因描述 | REASON | String | 100 | |||
| 单据追踪项次 | PRE_ITM | INT | 0 | |||
| 新币别 | CUR_ID | String | 4 | |||
| 原币别 | CUR_ID_OLD | String | 4 | |||
| 新税率 | RTO_TAX | Float | 0 | |||
| 原税率 | RTO_TAX_OLD | Float | 0 | |||
| 新备注 | REM_MO | String | 200 | |||
| 原备注 | REM_MO_OLD | String | 200 | |||
| 新扣税类别 | TAX_ID | String | 1 | |||
| 旧扣税类别 | TAX_ID_OLD | String | 1 | |||
| 新仓库 | WH | String | 12 | |||
| 原仓库 | WH_OLD | String | 12 | |||
| 来源单ID | BIL_ID_OLD | String | 2 | 当变更方式=5.拆分时必填，其他变更方式不要传值 | ||
| 源单据 | BIL_NO_OLD | String | 20 | 当变更方式=5.拆分时必填，其他变更方式不要传值 | ||
| 制程代号 | ZC_NO | String | 10 | |||
| 承上机台 | DEP_UP | String | 8 | |||
| 转下机台 | DEP_DOWN | String | 8 | |||
| 承上厂商 | CUS_UP | String | 12 | |||
| 转下厂商 | CUS_DOWN | String | 12 | |||
| 承上制程 | ZC_NO_UP | String | 440 | |||
| 转下制程 | ZC_NO_DN | String | 440 | |||
| 生产模具 | MD_NO | String | 2000 | |||
| 设备代号 | SEB_NO | String | 200 | |||
| 批号 | BAT_NO | String | 40 | |||
| 母编号 | MO_NO_ADD | String | 38 | |||
| 客户订单 | CUS_OS_NO | String | 30 | |||
| 原客户订单 | CUS_OS_NO_OLD | String | 30 | |||
| 单据日期 | BIL_DD | Datetime | 0 | |||
| 单据类别 | BIL_TYPE | String | 10 | |||
| 工时 | USED_TIME | Float | 0 | |||
| 机时 | TIME_CNT | Float | 0 | |||
| 期初标识 | QC_YN | String | 1 | |||
| 作法描述 | ZC_REM | String | 200 | |||
| 原批号 | BAT_NO_OLD | String | 40 | |||
| 新批号 | BAT_NO_NEW | String | 40 | |||
| 新生产量副 | QTY1 | Float | 0 | |||
| 原生产量副 | QTY1_SO | Float | 0 | |||
| 指定完工日期 | FIN_DD | String | 0 | |||
| 折扣额 | AMT_DIS_CNT | Float | 0 | |||
| 原折扣额 | AMT_DIS_CNT_OLD | Float | 0 | |||
| 不确认标记 | UNCFM_ID | String | 1 | |||
| 原不确认标记 | UNCFM_ID_OLD | String | 1 | |||
| 原单据类别 | BIL_TYPE_OLD | String | 10 | |||
| 发放生产 | CF_ID | String | 1 | |||
| 单价副 | UP1 | Float | 0 | |||
| 原单价副 | UP1_OLD | Float | 0 | |||
| 需求客户 | CUS_NO_SO | String | 12 | |||
| 原需求客户 | CUS_NO_SO_OLD | String | 12 | |||
| 原使用模具 | MD_NO_OLD | String | 2000 | |||
| 原使用设备 | SEB_NO_OLD | String | 200 | |||
请求JSON示例-1.生产变更
{
"REF_NO": "HYPCS2207060001", //第三方单号，必填
"PGM": "MRPAZ", //程序代号，必填
"MF_CS": [ //请求生成单据的表头参数信息
{
"CS_ID": "CS", //单据ID，必填
"CS_NO": "",
"CS_DD": "2022-07-06", //变更日期，必填
"STATUS": "1", //新增时表头状态是申请，要给1值，必填
"SAL_NO": "001",
"USR": "ADMIN", //制单人代号，必填
"DEP": "D0100", //部门代号，必填
"BIL_TYPE": "",
"REASON": "变更生产数量", //变更原因
"REM": ""
}
],
"TF_CS": [ //请求生成单据的表身参数信息
{
"CS_ID": "CS", //单据ID，必填
"CS_NO": "",
"ITM": 1, //项次，必填
"CHG_ID": "1", //变更方式:1.生产变更，2.终止生产，3.继续生产，4.暂停生产，5.拆分；必填
"BIL_ID": "MO", //来源单ID，只允许输入MO、TZ、TW，必填
"MO_NO": "MO2207060001", //生产单号，必填
"MRP_NO": "WDP001",
"PRD_MARK": "",
"UNIT": "1",
"QTY_SO": 1.0, //原生产量
"QTY": 2.0, //新生产量
"QTY1_SO": 2.0, //原生产量(副)
"QTY1": 4.0, //新生产量(副)
"TW_ID": "1", //当BIL_ID=MO或TZ，给1值；当BIL_ID=TW时，给2值；必填
"DEP_OLD": "965",
"DEP": "965",
"STA_DD_OLD": "2022-07-06",
"STA_DD": "2022-07-06",
"END_DD_OLD": "2022-07-07",
"END_DD": "2022-07-07",
"PRE_ITM":1, //单据追踪项次
"WH_OLD": "YH001",
"WH": "YH001"
}
]
}
返回结果示例-1.生产变更
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功",
"data": {
"MF_CS": [ //生成单据表头信息
{
"CS_ID": "CS",
"CS_NO": "CS2207060001",
"CS_DD": "2022-07-06 00:00:00",
"STATUS": "2",
"REASON": "变更生产数量",
"REM": "",
"SAL_NO": "001",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2022-07-11 10:49:48",
"DEP": "D0100",
"BIL_TYPE": "",
"SYS_DATE": "2022-07-11 10:49:48"
}
],
"TF_CS": [ //生成单据表身信息
{
"CS_ID": "CS",
"CS_NO": "CS2207060001",
"ITM": 1,
"CHG_ID": "1",
"MO_NO": "MO2207060001",
"MRP_NO": "WDP001",
"PRD_MARK": "",
"UNIT": "1",
"QTY_SO": 1.0,
"QTY": 2.0,
"REM": "",
"TW_ID": "1",
"DEP_OLD": "965",
"DEP": "965",
"STA_DD_OLD": "2022-07-06 00:00:00",
"STA_DD": "2022-07-06 00:00:00",
"END_DD_OLD": "2022-07-07 00:00:00",
"END_DD": "2022-07-07 00:00:00",
"PRE_ITM": 1,
"BIL_ID": "MO",
"WH_OLD": "YH001",
"WH": "YH001",
"QTY1": 4.0,
"QTY1_SO": 2.0
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
}
请求JSON示例-5.拆分
{
"REF_NO": "HYPCS2207060003", //第三方单号，必填
"PGM": "MRPAZ", //程序代号，必填
"MF_CS": [ //请求生成单据的表头参数信息
{
"CS_ID": "CS", //单据ID，必填
"CS_NO": "",
"CS_DD": "2022-07-06", //变更日期，必填
"STATUS": "1", //新增时表头状态是申请，必须给1值，必填
"SAL_NO": "001",
"USR": "ADMIN", //制单人代号，必填
"DEP": "D0100", //部门代号，必填
"BIL_TYPE": "",
"REASON": "按生产量拆分为两张生产单", //变更原因
"REM": ""
}
],
"TF_CS": [ //请求生成单据的表身参数信息
{
"CS_ID": "CS", //单据ID，必填
"CS_NO": "",
"ITM": 1, //项次，必填
"CHG_ID": "5", //变更方式:1.生产变更，2.终止生产，3.继续生产，4.暂停生产，5.拆分；必填
"BIL_ID": "MO", //来源单ID，只允许输入MO、TZ、TW，必填
"MO_NO": "", //拆分后的新记录，生产单号MO_NO必须为空
"MRP_NO": "WDP001",
"PRD_MARK": "",
"UNIT": "1",
"QTY_SO": 0, //拆分后的新记录，原生产量QTY_SO必须为0
"QTY": 8.0, //新生产量
"QTY1_SO": 0, //原生产量(副)
"QTY1": 16.0, //新生产量(副)
"TW_ID": "1", //当BIL_ID=MO或TZ，给1值；当BIL_ID=TW时，给2值；必填
"DEP_OLD": "",
"DEP": "965",
"STA_DD_OLD": null, //拆分后的新记录，原预开工日为空，必须传小写的null
"STA_DD": "2022-07-06",
"END_DD_OLD": null,
"END_DD": "2022-07-07",
"PRE_ITM":1, //单据追踪项次
"WH_OLD": "",
"WH": "YH001",
"BIL_ID_OLD":"MO", //原来源单据别，当变更方式=5.拆分时必填，其他变更方式不要传值
"BIL_NO_OLD":"MO2207060003", //原来源单号，当变更方式=5.拆分时必填，其他变更方式不要传值
"BIL_DD":"2022-07-06",
"CF_ID":"T" //发放生产
},
{
"CS_ID": "CS", //单据ID，必填
"CS_NO": "",
"ITM": 2,
"CHG_ID": "5",
"BIL_ID": "MO",
"MO_NO": "MO2207060003", //拆分前的原记录，生产单号MO_NO要等于原来源单号BIL_NO_OLD，必填
"MRP_NO": "WDP001",
"PRD_MARK": "",
"UNIT": "1",
"QTY_SO": 10.0, //拆分前的原记录，原生产量QTY_SO要有值
"QTY": 2.0, //新生产量
"QTY1_SO": 20.0,
"QTY1": 4.0,
"TW_ID": "1",
"DEP_OLD": "965",
"DEP": "965",
"STA_DD_OLD": "2022-07-06",
"STA_DD": "2022-07-06",
"END_DD_OLD": "2022-07-07",
"END_DD": "2022-07-07",
"PRE_ITM":2,
"WH_OLD": "YH001",
"WH": "YH001",
"BIL_ID_OLD":"MO",
"BIL_NO_OLD":"MO2207060003",
"BIL_DD":"2022-07-06",
"CF_ID":"T"
}
]
}
返回结果示例-5.拆分
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功",
"data": {
"MF_CS": [ //生成单据表头信息
{
"CS_ID": "CS",
"CS_NO": "CS2207060003",
"CS_DD": "2022-07-06 00:00:00",
"STATUS": "2",
"REASON": "按生产量拆分为两张生产单",
"REM": "",
"SAL_NO": "001",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2022-07-11 10:50:29",
"DEP": "D0100",
"BIL_TYPE": "",
"SYS_DATE": "2022-07-11 10:50:29"
}
],
"TF_CS": [ //生成单据表身信息
{
"CS_ID": "CS",
"CS_NO": "CS2207060003",
"ITM": 1,
"CHG_ID": "5",
"MO_NO": "",
"MRP_NO": "WDP001",
"PRD_MARK": "",
"UNIT": "1",
"QTY_SO": 0.0,
"QTY": 8.0,
"REM": "",
"TW_ID": "1",
"DEP_OLD": "",
"DEP": "965",
"STA_DD": "2022-07-06 00:00:00",
"END_DD": "2022-07-07 00:00:00",
"PRE_ITM": 1,
"BIL_ID": "MO",
"WH_OLD": "",
"WH": "YH001",
"BIL_ID_OLD": "MO",
"BIL_NO_OLD": "MO2207060003",
"BIL_DD": "2022-07-06 00:00:00",
"QTY1": 16.0,
"QTY1_SO": 0.0,
"CF_ID": "T"
},
{
"CS_ID": "CS",
"CS_NO": "CS2207060003",
"ITM": 2,
"CHG_ID": "5",
"MO_NO": "MO2207060003",
"MRP_NO": "WDP001",
"PRD_MARK": "",
"UNIT": "1",
"QTY_SO": 10.0,
"QTY": 2.0,
"REM": "",
"TW_ID": "1",
"DEP_OLD": "965",
"DEP": "965",
"STA_DD_OLD": "2022-07-06 00:00:00",
"STA_DD": "2022-07-06 00:00:00",
"END_DD_OLD": "2022-07-07 00:00:00",
"END_DD": "2022-07-07 00:00:00",
"PRE_ITM": 2,
"BIL_ID": "MO",
"WH_OLD": "YH001",
"WH": "YH001",
"BIL_ID_OLD": "MO",
"BIL_NO_OLD": "MO2207060003",
"BIL_DD": "2022-07-06 00:00:00",
"QTY1": 4.0,
"QTY1_SO": 20.0,
"CF_ID": "T"
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
}