概述

该接口主要用于第三方平台或自主研发者，通过调用【生产领料单】的生成接口，将第三方的因生产制造领用料件的信息推送到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	是
领料单号	ML_NO	string	20	是
项	ITM	Integer		是
领料日期	ML_DD	datetime	0
领退注记	ML_ID	string	1
料号	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": "LJML08100001",       //第三方单号，必填
  "PGM": "MRPAG",
  "MF_ML": [                  //生产领料单表头信息
    {
      "MLID": "ML",
      "ML_NO": "LJML08100001",
      "ML_ID": "1",
      "ML_DD": "2020-08-10 00:00:00",
      "FIX_CST1": "1",
      "MO_NO": "MO20081000000001",
      "VOH_ID": "",
      "USR_NO": "9999",
      "DEP": "00101",
      "USR": "ADMIN",
      "VOH_ID_MC": "",
      "A1": 1.0,               //表头自定义栏位信息
      "A3": 1.0
    }
  ],
  "TF_ML": [             //生产领料单表身信息
    {
      "MLID": "ML",
      "ML_NO": "ML08100001",
      "ML_ID": "1",
      "ITM": 1,
      "PRD_NO": "00221",
      "PRD_NAME": "00221制程一原料",
      "WH": "002",
      "UNIT": "1",
      "QTY": 9.0,
      "CST": 18.0,
      "BAT_NO": "",
      "REM": "",
      "QTY1": 18.0,
      "CST_STD": 0.0,
      "PRD_NO_CHG": "",
      "ID_NO": "",
      "PRE_ITM": 1,
      "EST_ITM": 1,
      "LOS_RTO": 0.0,
      "QTY_STD": 3.0,
      "ZC_PRD": "",
      "QTY_LEFT": 9.0,
      "PRD_MARK": "0101",
      "CHG_RTO": "",
      "USEIN_NO": "",
      "ML_DD": "2020-08-10 00:00:00",
      "MO_NO": "MO20081000000001",
      "QTY_ML": 3.0,
      "QL_NO": "",
      "QL_ID": "",
      "UNIT_H": "1",
      "QTY_WH": 947.0,
      "ZC_NO": "202001",
      "QTY_RSV": 9.0,
      "QTY_LOST": 0.0,
      "QTY_RTN": 0.0,
      "UP_STD": 0.0,
      "CHUW": "002A",
      "MRP_NO": "0022",
      "DEP": "00101",
      "BOM_NO": "0022->",
      "UP_STD_QTY": 2.0,
      "QTY1_RSV": 0.0,
      "QTY_KL": 9.0,
      "QTY_WL": 0.0,
      "KND": "4",
      "SIZE": "01",
      "GOOD": "01",
      "A4": 1.0,         //表身自定义栏位信息
      "A5": 1.0
    }
  ]
}

返回结果示例

{
  "code": 0,               //为0表示执行成功，其他表示错误
  "message": "新增成功",
  "data": {
    "MF_ML": [             //生成领料单表头信息
      {
        "MLID": "ML",
        "ML_NO": "LJML08100001",
        "ML_ID": "1",
        "ML_DD": "2020-08-10 00:00:00",
        "FIX_CST1": "1",
        "MO_NO": "MO20081000000001",
        "VOH_ID": "",
        "USR_NO": "9999",
        "DEP": "00101",
        "TZ_NO": "TZ20081000000001",
        "CHK_MAN": "ADMIN",
        "USR": "ADMIN",
        "PRT_SW": "N",
        "CLS_DATE": "2020-08-10 00:00:00",
        "SYS_DATE": "2020-08-10 11:06:01",
        "VOH_ID_MC": "",
        "A1": 1.0,
        "A3": 1.0
      }
    ],
    "TF_ML": [                 //生成领料单表身信息
      {
        "MLID": "ML",
        "ML_NO": "LJML08100001",
        "ML_ID": "1",
        "ITM": 1,
        "PRD_NO": "00221",
        "PRD_NAME": "00221制程一原料",
        "WH": "002",
        "UNIT": "1",
        "QTY": 9.0,
        "CST": 18.0,
        "BAT_NO": "",
        "REM": "",
        "QTY1": 18.0,
        "CST_STD": 0.0,
        "PRD_NO_CHG": "",
        "ID_NO": "",
        "PRE_ITM": 1,
        "EST_ITM": 1,
        "LOS_RTO": 0.0,
        "QTY_STD": 3.0,
        "ZC_PRD": "",
        "QTY_LEFT": 9.0,
        "PRD_MARK": "0101",
        "CHG_RTO": "",
        "USEIN_NO": "",
        "ML_DD": "2020-08-10 00:00:00",
        "MO_NO": "MO20081000000001",
        "TZ_NO": "TZ20081000000001",
        "QTY_ML": 3.0,
        "QL_NO": "",
        "QL_ID": "",
        "UNIT_H": "1",
        "QTY_WH": 947.0,
        "ZC_NO": "202001",
        "QTY_RSV": 9.0,
        "QTY_LOST": 0.0,
        "QTY_RTN": 0.0,
        "FIX_CST1": "1",
        "UP_STD": 0.0,
        "CHUW": "002A",
        "MRP_NO": "0022",
        "DEP": "00101",
        "BOM_NO": "0022->",
        "UP_STD_QTY": 2.0,
        "QTY1_RSV": 0.0,
        "QTY_KL": 9.0,
        "QTY_WL": 0.0,
        "KND": "4",
        "A4": 1.0,
        "A5": 1.0
      }
    ],
    "MF_ML_Z": [            //生成表头自定义栏位信息
      {
        "A1": 1.0,
        "A3": 1.0,
        "MLID": "ML",
        "ML_NO": "LJML08100001"
      }
    ],
    "TF_ML_Z": [           //生成表身自定义栏位信息
      {
        "A4": 1.0,
        "A5": 1.0,
        "MLID": "ML",
        "ML_NO": "LJML08100001",
        "ITM": 1
      }
    ]
  }
}

生成【生产领料单】接口

概述

参数说明

1.请求方式

2.header参数

3.请求参数

4.自定义栏位参数

请求JSON示例

返回结果示例