生成【托工退料单】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【托工领料单】的生成接口，将第三方的因托外加工需要领用料件的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【托工领料单】。
参数说明
1.请求方式
| 请求方式 | POST |
| 接口地址 | http://ERPAPI站点/MRPAG/ADDDATA |
| 格式 | JSON |
| 编码类型 | UTF-8 |
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 为小写token，token是获取每次登录的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号，必填 | |||
| 程序代号 | PGM | 是 | 生产领料：MRPAG 生产退料：MRPAGI 生产补料：MRPAGJ 托工领料：MRPAGK 托工退料：MRPAGL 托工补料：MRPAGM |
|||
| 数据表MF_ML | ||||||
| 识别代号 | MLID | string | 2 | 是 | 生产领料：ML 生产退料：M2 生产补料：M3 托工领料：M4 托工退料：M5 托工补料：M6 |
|
| 领料单号 | ML_NO | string | 20 | 是 | 1.自动编码时，根据单据编码原则自动产生； 2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同 3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
|
| 领料日期 | ML_DD | datetime | 格式为：YYYY-MM-DD | |||
| 领/退注记 | ML_ID | string | 1 | 是 | 1.领料2.退料3.补料4.托工领料5.托工退料6.托工补料，默认值为1 | |
| 批号 | BAT_NO | string | 40 | |||
| 制令单号 | MO_NO | string | 20 | |||
| 模版代号 | VOH_ID | string | 2 | |||
| 凭证模版 | VOH_NO | string | 20 | |||
| 经办人 | USR_NO | string | 12 | |||
| 部门 | DEP | string | 8 | |||
| 备注 | REM | string | ||||
| 托工厂商 | CUS_NO | string | 12 | |||
| 转入单号 | TZ_NO | string | 20 | |||
| 制单人 | USR | string | 12 | |||
| 审核 | CHK_MAN | string | 12 | |||
| 终审日期 | CLS_DATE | datetime | ||||
| 单据类别 | BIL_TYPE | string | 10 | |||
| 审核模版 | MOB_ID | string | 10 | |||
| 锁单人 | LOCK_MAN | string | 12 | |||
| 锁单时间 | LOCK_DATE | datetime | ||||
| 输单日期 | SYS_DATE | datetime | ||||
| 缴库单号 | MM_NO | string | 20 | |||
| 工程案号 | CAS_NO | string | 20 | |||
| 任务编号 | TASK_ID | Integer | ||||
| 客户订单 | CUS_OS_NO | string | 30 | |||
| 打印人员 | PRT_USR | string | 12 | |||
| 申请单ID | QL_ID | string | 2 | |||
| 申请单号 | QL_NO | string | 20 | |||
| 调拨单号 | MC_NO | string | 20 | |||
| 调拨单的凭证模板 | VOH_ID_MC | string | 2 | |||
| 补料区分 | QL_TYPE | string | 1 | |||
| 溢领标志 | YL_ID | string | 1 | |||
| 作废标记 | CANCEL_ID | string | 1 | |||
| 成本别 | FIX_CST1 | string | 1 | 是 | (1.变动成本、2.固定成本)默认值为1 | |
| WMS产生的单据 | WMS_ID | string | 1 | |||
| 数据表TF_ML | ||||||
| 领料ID(ML;M2;M3;M4;M5;M6) | MLID | string | 2 | 是 | 与表头MF_ML的MLID必须相同 | |
| 领料单号 | ML_NO | string | 20 | 是 | 与表头MF_ML的ML_NO必须相同 | |
| 项 | ITM | Integer | 是 | |||
| 领料日期 | ML_DD | datetime | 0 | 是 | 与表头MF_ML的ML_DD必须相同 | |
| 领退注记 | ML_ID | string | 1 | 是 | 与表头MF_ML的ML_ID必须相同 | |
| 料号 | PRD_NO | string | 30 | 是 | ||
| 料名 | PRD_NAME | string | 160 | |||
| 料件特征 | PRD_MARK | string | 100 | |||
| 单位 | UNIT | string | 1 | 是 | 如果为包装单位，保存后会换算为主单位数量进行扣减库存 | |
| 数量 | QTY | Integer | 是 | |||
| 数量1 | QTY1 | Integer | ||||
| 仓库 | WH | string | 12 | 是 | ||
| 成本 | CST | Integer | ||||
| 备注 | REM | string | 200 | |||
| 批号 | BAT_NO | string | 40 | |||
| 制令单号 | MO_NO | string | 20 | 是 | 来源制令单号必须存在 | |
| 通知单号 | TZ_NO | string | 20 | |||
| 制程代号 | ZC_NO | string | 10 | |||
| 标准成本 | CST_STD | Integer | ||||
| 替代品 | PRD_NO_CHG | string | 255 | |||
| 配方号 | ID_NO | string | 38 | |||
| 原单货品 | PRD_NO_MO | string | 30 | |||
| 超领数量 | QTY_DIFF | Integer | ||||
| 合同编号 | CNTT_NO | string | 40 | |||
| 历次变动项 | PRE_ITM | Integer | 是 | |||
| 单据追踪项次 | EST_ITM | Integer | 是 | 记录来源于制令单、生产通知单的项次 | ||
| 标准损耗率 | LOS_RTO | Integer | ||||
| 标准用量 | QTY_STD | Integer | ||||
| 本次未领量 | QTY_LEFT | Integer | ||||
| 替代比率 | CHG_RTO | string | 200 | |||
| 替代项次 | CHG_ITM | Integer | ||||
| 替代系数 | QTY_CHG_RTO | Integer | ||||
| 在线仓库 | WH_LC | string | 12 | |||
| 超发数量 | QTY_OVER | Integer | ||||
| 以包装单位发料 | PK_ID | string | 1 | |||
| 在线领用量 | QTY_LC | Integer | ||||
| 申请单标识 | QL_ID | string | 2 | |||
| 申请单号 | QL_NO | string | 20 | |||
| 申请单项次 | QL_ITM | Integer | 记录来源于生产领料申请单、原料调拨单的项次 | |||
| 单位成本(主单位) | UP_MAIN | Integer | ||||
| 领料套数 | QTY_ML | Integer | 系统计算得出 | |||
| 套数单位 | UNIT_H | string | 1 | |||
| 库存 | QTY_WH | Integer | ||||
| 领料套数(副) | QTY1_ML | Integer | ||||
| 应发量 | QTY_RSV | Integer | ||||
| 应损耗量 | QTY_LOST | Integer | ||||
| 已发量 | QTY_RTN | Integer | ||||
| 成本别(1.变动成本、2.固定成本) | FIX_CST1 | string | 1 | |||
| 单位标准成本 | UP_STD | Integer | ||||
| 生产日期 | SC_DD | datetime | ||||
| 派工单ID | PG_ID | string | 2 | |||
| 派工单号 | PG_NO | string | 20 | |||
| 派工项次 | PG_ITM | Integer | ||||
| 扫描人 | SCAN_USR | string | 12 | |||
| 扫描时间 | SCAN_DATE | datetime | ||||
| 不足量管制 | CHK_XZL | string | 1 | |||
| 储位代号 | CHUW | string | 60 | |||
4.自定义栏位参数
| 字段名称 | 字段代号 | 类型 | 长度 | 是否 | 固定值 | 备注 |
| 数据表MF_ML_Z（表头自定义字段） | ||||||
| 自定义栏位1 | 自定义 | string | 2 | 自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 | ||
| 自定义栏位2 | 自定义 | string | ||||
| …… | …… | …… | ||||
| 数据表TF_ML_Z（表头自定义字段） | ||||||
| 自定义栏位1 | 自定义 | string | 2 | 自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 | ||
| 自定义栏位2 | 自定义 | string | ||||
| …… | …… | …… | ||||
请求JSON示例
{ "REF_NO": "LJM520081000000001", //第三方单号，必填 "PGM": "MRPAGL", //单据程序代号 "MF_ML": [ //新增单据表头信息 { "MLID": "M5", "ML_NO": "LJM520081000000001", "ML_ID": "5", "ML_DD": "2020-08-10 00:00:00", "FIX_CST1": "1", "VOH_ID": "", "USR_NO": "9999", "DEP": "00000000", "TZ_NO": "TW20081000000001", "USR": "ADMIN", "CUS_NO": "0009", "YL_ID": "F", "LJ_M51": 1.0, //单据表头自定义栏位 "LJ_M52": 1.0 } ], "TF_ML": [ //新增单据表身信息 { "MLID": "M5", "ML_NO": "LJM520081000000001", "ML_ID": "5", "ITM": 1, "PRD_NO": "00222", "PRD_NAME": "00222托外制程二", "WH": "002", "UNIT": "1", "QTY": 15.0, "CST": 146.50484770406251, "BAT_NO": "", "REM": "", "CST_STD": 0.0, "PRD_NO_CHG": "", "ID_NO": "", "PRE_ITM": 1, "EST_ITM": 2, "LOS_RTO": 0.0, "QTY_STD": 5.0, "ZC_PRD": "", "PRD_MARK": "", "CHG_RTO": "", "USEIN_NO": "", "ML_DD": "2020-08-10 00:00:00", "MO_NO": "MO20081000000001", "TZ_NO": "TW20081000000001", "QTY_ML": 3.0, "QL_NO": "", "QL_ID": "", "UNIT_H": "1", "QTY_WH": 960.0, "ZC_NO": "202002", "QTY_RSV": 15.0, "QTY_LOST": 0.0, "QTY_RTN": 15.0, "UP_STD": 0.0, "MRP_NO": "0022", "DEP": "00000000", "BOM_NO": "0022->", "CUS_NO": "0009", "UP_STD_QTY": 9.7669898469375, "QTY_KL": 0.0, "KND": "4", "QTY_ORI": 15.0, "LJ_M53": 1.0, //新增表身自定义栏位 "LJ_M54": 1.0 } ] }
返回结果示例
{ "code": 0, //为0表示执行成功，其他表示错误 "message": "新增成功", "data": { "MF_ML": [ //单据表头信息 { "MLID": "M5", "ML_NO": "LJM520081000000001", "ML_ID": "5", "ML_DD": "2020-08-10 00:00:00", "FIX_CST1": "1", "VOH_ID": "", "USR_NO": "9999", "DEP": "00000000", "TZ_NO": "TW20081000000001", "CHK_MAN": "ADMIN", "USR": "ADMIN", "PRT_SW": "N", "CLS_DATE": "2020-08-10 00:00:00", "SYS_DATE": "2020-08-10 17:15:08", "CUS_NO": "0009", "YL_ID": "F", "LJ_M51": 1.0, "LJ_M52": 1.0 } ], "TF_ML": [ //单据表身信息 { "MLID": "M5", "ML_NO": "LJM520081000000001", "ML_ID": "5", "ITM": 1, "PRD_NO": "00222", "PRD_NAME": "00222托外制程二", "WH": "002", "UNIT": "1", "QTY": 15.0, "CST": 146.504847704063, "BAT_NO": "", "REM": "", "CST_STD": 0.0, "PRD_NO_CHG": "", "ID_NO": "", "PRE_ITM": 1, "EST_ITM": 2, "LOS_RTO": 0.0, "QTY_STD": 5.0, "ZC_PRD": "", "PRD_MARK": "", "CHG_RTO": "", "USEIN_NO": "", "ML_DD": "2020-08-10 00:00:00", "MO_NO": "MO20081000000001", "TZ_NO": "TW20081000000001", "QTY_ML": 3.0, "QL_NO": "", "QL_ID": "", "UNIT_H": "1", "QTY_WH": 960.0, "ZC_NO": "202002", "QTY_RSV": 15.0, "QTY_LOST": 0.0, "QTY_RTN": 15.0, "FIX_CST1": "1", "UP_STD": 0.0, "MRP_NO": "0022", "DEP": "00000000", "BOM_NO": "0022->", "CUS_NO": "0009", "UP_STD_QTY": 9.7669898469375, "QTY_KL": 0.0, "KND": "4", "LJ_M53": 1.0, "LJ_M54": 1.0 } ], "MF_ML_Z": [ //新增的表头自定义栏位 { "LJ_M51": 1.0, "LJ_M52": 1.0, "MLID": "M5", "ML_NO": "LJM520081000000001" } ], "TF_ML_Z": [ //新增的表身自定义栏位 { "LJ_M53": 1.0, "LJ_M54": 1.0, "MLID": "M5", "ML_NO": "LJM520081000000001", "ITM": 1 } ] } }