概述
该接口主要用于第三方平台或自主研发者，通过调用【生产缴库验收单转成品缴库单处理】的生成接口，将第三方的制成品或半成品缴回的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【生产缴库验收单转成品缴库单处理】。
参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://ERPAPI站点/MRPAFC/ADDDATA |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
| Authorization |
token |
授权接口所获取的值 |
3.请求参数
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号，必填 |
| 程序代号 |
PGM |
|
|
是 |
MRPAFC |
|
| 数据表MF_MM0 |
| 单据别 |
MM_ID |
string |
2 |
是 |
|
缴库:MM |
| 缴库单号 |
MM_NO |
string |
20 |
是 |
|
1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
| 缴库日期 |
MM_DD |
datetime |
0 |
|
|
格式为：YYYY-MM-DD |
| 单据类别 |
BIL_TYPE |
string |
10 |
|
|
|
| 生产部门 |
DEP |
string |
8 |
是 |
|
|
| 来源单据ID(TB:托工缴回;TC:托工退回;DT:托工折让;MM:缴库退回) |
BIL_ID |
string |
2 |
|
|
|
| 来源单号 |
BIL_NO |
string |
25 |
|
|
|
| 制令单号 |
MO_NO |
string |
25 |
是 |
|
|
| 凭证模版 |
VOH_ID |
string |
2 |
|
|
|
| 凭证号码 |
VOH_NO |
string |
20 |
|
|
|
| 附件张数 |
FJ_NUM |
integer |
0 |
|
|
|
| 制单人 |
USR |
string |
12 |
是 |
|
|
| 经办人 |
USR_NO |
string |
12 |
是 |
|
|
| 审核人 |
CHK_MAN |
string |
12 |
|
|
|
| 锁单人 |
LOCK_MAN |
string |
12 |
|
|
|
| 锁单时间 |
LOCK_DATE |
datetime |
0 |
|
|
|
| 打印者 |
PRT_USR |
string |
12 |
|
|
|
| 输单日期 |
SYS_DATE |
datetime |
0 |
|
|
|
| 终审日期 |
CLS_DATE |
datetime |
0 |
|
|
|
| 审核模版 |
MOB_ID |
string |
10 |
|
|
|
| 打印注记 |
PRT_SW |
string |
1 |
|
|
|
| 拷贝注记 |
CPY_SW |
string |
1 |
|
|
|
| 影响制令缴库量（Affect Mo QTY_FIN） |
FIN_ID |
string |
1 |
|
|
|
| 备注 |
REM |
string |
0 |
|
|
|
| 作废标记 |
CANCEL_ID |
string |
1 |
|
|
|
| 打印日期 |
PRT_DATE |
datetime |
0 |
|
|
|
| 最近修改日期 |
MODIFY_DD |
datetime |
0 |
|
|
|
| 最近修改人 |
MODIFY_MAN |
string |
12 |
|
|
|
| 扫描状态 |
SCAN_ID |
string |
1 |
|
|
|
| 扫描人 |
SCAN_USR |
string |
12 |
|
|
|
| 扫描日期 |
SCAN_DATE |
datetime |
0 |
|
|
|
| 来源单ID |
OS_ID |
string |
2 |
|
|
|
| 来源单号 |
OS_NO |
string |
20 |
|
|
|
| 合同 |
CONTRACT |
string |
80 |
|
|
|
| 服务倒冲领料的属性取值 |
DCML_PROP_LB |
string |
255 |
|
|
|
| WMS产生的单据 |
WMS_ID |
string |
1 |
|
|
|
| 数据表TF_MM0 |
| 缴库区分 |
MM_ID |
string |
2 |
是 |
|
必须与表头MF_MM0的MM_ID相同 |
| 缴库单号 |
MM_NO |
string |
20 |
是 |
|
必须与表头MF_MM0的MM_NO相同 |
| 项 |
ITM |
integer |
0 |
是 |
|
|
| 缴库日期 |
MM_DD |
datetime |
0 |
是 |
|
|
| 制令单号 |
MO_NO |
string |
20 |
|
|
|
| 托外加工单 |
TW_NO |
string |
20 |
是 |
|
必须与表头MF_MM0的MO_NO相同 |
| 受订单号 |
SO_NO |
string |
20 |
|
|
|
| 客户订单 |
CUS_OS_NO |
string |
30 |
|
|
|
| 生产部门 |
DEP |
string |
8 |
是 |
|
|
| 批号 |
BAT_NO |
string |
40 |
|
|
|
| 成品号 |
PRD_NO |
string |
30 |
是 |
|
|
| 配方号 |
ID_NO |
string |
38 |
是 |
|
|
| 货品特征 |
PRD_MARK |
string |
100 |
|
|
|
| 成品名 |
PRD_NAME |
string |
160 |
|
|
|
| 单位 |
UNIT |
string |
1 |
是 |
|
如果为包装单位，保存后会换算为主单位数量进行扣减库存 |
| 仓库 |
WH |
string |
12 |
是 |
|
|
| 有效日期 |
VALID_DD |
datetime |
0 |
|
|
|
| 是否搭赠货品 |
FREE_ID |
string |
1 |
|
|
|
| 单据历次变动项次 |
PRE_ITM |
integer |
0 |
|
|
|
| 追踪项次 |
EST_ITM |
integer |
0 |
|
|
|
| 数量 |
QTY |
float |
0 |
是 |
|
|
| 副单位数量 |
QTY1 |
float |
0 |
|
|
|
| 退库数量 |
QTY_RTN |
float |
0 |
|
|
|
| 已销货量 |
QTY_SA |
float |
0 |
|
|
|
| 产值 |
AMTN_VAL |
float |
0 |
|
|
|
| 制造费用 |
CST_MAKE |
float |
0 |
|
|
|
| 耗用物料 |
CST_PRD |
float |
0 |
|
|
|
| 托工费用 |
CST_OUT |
float |
0 |
|
|
|
| 人工 |
CST_MAN |
float |
0 |
|
|
|
| 直接原料 |
CST |
float |
0 |
|
|
|
| 耗用工时 |
USED_TIME |
integer |
0 |
|
|
|
| 机时 |
TIME_CNT |
integer |
0 |
|
|
|
| 标准制造费用 |
CST_SMAKE |
float |
0 |
|
|
|
| 标准物料 |
CST_SPRD |
float |
0 |
|
|
|
| 标准托工 |
CST_SOUT |
float |
0 |
|
|
|
| 标准人工 |
CST_SMAN |
float |
0 |
|
|
|
| 标准原料成本 |
CST_STD |
float |
0 |
|
|
|
| 标准工时 |
USED_STIME |
integer |
0 |
|
|
|
| 标准机时 |
TIME_SCNT |
integer |
0 |
|
|
|
| 原缴库单ID |
OLD_MM_ID |
string |
2 |
|
|
|
| 原缴库单号 |
OLD_MM_NO |
string |
20 |
|
|
|
| 原缴库单项次 |
MM_ITM |
integer |
0 |
|
|
|
| 标识制令单当月是否结案 |
CALC_ID |
string |
1 |
|
|
|
| 已转标志 |
ZC_FLAG |
string |
1 |
|
|
|
| 合同编号 |
CNTT_NO |
string |
40 |
|
|
|
| 工程案号 |
CAS_NO |
string |
20 |
|
|
|
| 任务编号 |
TASK_ID |
integer |
0 |
|
|
|
| 入库日期 |
RK_DD |
datetime |
0 |
|
|
|
| 集团公司代号 |
DEP_RK |
string |
8 |
|
|
|
| 备注 |
REM |
string |
1000 |
|
|
|
| 领料单号 |
ML_NO |
string |
20 |
|
|
|
| 来源单标识 |
BIL_ID |
string |
2 |
|
|
|
| 来源单号 |
BIL_NO |
string |
20 |
|
|
|
| 来源单项次 |
BIL_ITM |
integer |
0 |
|
|
|
| 合格标志(T0,T2,Q0,Q2) |
QC_FLAG |
string |
2 |
|
|
|
| 单位成本(主单位) |
UP_MAIN |
float |
0 |
|
|
|
| 单位标准成本 |
UP_STD |
float |
0 |
|
|
|
| 是否走生产日报 |
GO_WR |
string |
1 |
|
|
|
| 倒冲损耗标记 |
DC_QTYLOST |
string |
1 |
|
|
|
| 不合格量 |
QTY_LOST |
float |
0 |
|
|
|
| 不合格量[副] |
QTY1_LOST |
float |
0 |
|
|
|
| 推荐库位 |
TJ_WH |
string |
255 |
|
|
|
| 生产日期 |
SC_DD |
datetime |
0 |
|
|
|
| 食品设备码 |
SB_NO |
string |
50 |
|
|
|
| 订单ID |
SO_ID |
string |
2 |
|
|
|
| 不足量管制 |
CHK_XZL |
string |
1 |
|
|
|
| 储位代号 |
CHUW |
string |
60 |
|
|
|
| 已上架标志 |
CWSJ_Y |
string |
1 |
|
|
|
| 包装单位 |
PAK_UNIT |
string |
20 |
|
|
|
| 包装换算 |
PAK_EXC |
float |
0 |
|
|
|
| 包装净重 |
PAK_NW |
float |
0 |
|
|
|
| 包装净重单位 |
PAK_WEIGHT_UNIT |
string |
8 |
|
|
|
| 包装大小单位 |
PAK_MEAST_UNIT |
string |
8 |
|
|
|
| 包装毛重 |
PAK_GW |
float |
0 |
|
|
|
| 包装大小 |
PAK_MEAST |
float |
0 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_MM0_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_MM0_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": "HYPMM2205120003", //第三方单号，必填
"PGM": "MRPAFC", //单据程序代号
"MF_MM0": [ //新增单据表头信息
{
"MM_ID": "MM",
"MM_NO": "",
"MM_DD": "2022-05-12 00:00:00",
"DEP": "965",
"MO_NO": "MO2205120003", //来源制令单号
"BIL_ID": "TP", //来源生产缴库验收单据别
"BIL_NO": "TP2205120003", //来源生产缴库验收单号
"VOH_ID": "",
"USR": "ADMIN",
"USR_NO": "001"
}
],
"TF_MM0": [ //新增单据表身信息
{
"MM_ID": "MM",
"MM_NO": "",
"ITM": 1,
"MM_DD": "2022-05-12 00:00:00",
"MO_NO": "MO2205120003", //来源制令单号
"DEP": "965",
"PRD_NO": "WDP001",
"ID_NO": "WDP001->",
"PRD_MARK": "",
"PRD_NAME": "打印机",
"UNIT": "1",
"WH": "YH001",
"PRE_ITM": 1,
"EST_ITM": 1,
"QTY": 1.0,
"QTY1": 2.0,
"CST_MAKE": 0.0,
"CST_PRD": 0.0,
"CST_OUT": 0.0,
"CST_MAN": 0.0,
"CST": 10.0,
"USED_TIME": 0.0,
"TIME_CNT": 0.0,
"CST_SMAKE": 0.0,
"CST_SPRD": 0.0,
"CST_SOUT": 0.0,
"CST_SMAN": 0.0,
"CST_STD":10.0,
"UP_STD": 0.0,
"QTY_MO": 1.0,
"QTY_PRC": 1.0,
"BIL_ID":"TP", //来源生产缴库验收单据别
"BIL_NO":"TP2205120003", //来源生产缴库验收单号
"BIL_ITM":1, //来源生产缴库验收单项次
"QC_FLAG":"T0",
"SC_DD":"2022-05-12 00:00:00",
"ML_BY_MM": "T"
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功",
"data": {
"MF_MM0": [ //生成单据表头信息
{
"MM_ID": "MM",
"MM_NO": "MM2205120001",
"MM_DD": "2022-05-12 00:00:00",
"DEP": "965",
"BIL_ID": "TP",
"BIL_NO": "TP2205120003",
"MO_NO": "MO2205120003",
"VOH_ID": "",
"USR": "ADMIN",
"USR_NO": "001",
"CHK_MAN": "ADMIN",
"SYS_DATE": "2022-06-06 15:57:10",
"CLS_DATE": "2022-06-06 15:57:10",
"PRT_SW": "N",
"REM": ""
}
],
"TF_MM0": [ //生成单据表身信息
{
"MM_ID": "MM",
"MM_NO": "MM2205120001",
"ITM": 1,
"MM_DD": "2022-05-12 00:00:00",
"MO_NO": "MO2205120003",
"DEP": "965",
"PRD_NO": "WDP001",
"ID_NO": "WDP001->",
"PRD_MARK": "",
"PRD_NAME": "打印机",
"UNIT": "1",
"WH": "YH001",
"VALID_DD": "2022-06-10 00:00:00",
"PRE_ITM": 1,
"EST_ITM": 1,
"QTY": 1.0,
"QTY1": 2.0,
"CST_MAKE": 0.0,
"CST_PRD": 0.0,
"CST_OUT": 0.0,
"CST_MAN": 0.0,
"CST": 10.0,
"USED_TIME": 0.0,
"TIME_CNT": 0.0,
"CST_SMAKE": 0.0,
"CST_SPRD": 0.0,
"CST_SOUT": 0.0,
"CST_SMAN": 0.0,
"CST_STD": 10.0,
"REM": "",
"ML_NO": "ML2205120001",
"BIL_ID": "TP",
"BIL_NO": "TP2205120003",
"BIL_ITM": 1,
"QC_FLAG": "T0",
"UP_STD": 0.0,
"QTY_MO": 1.0,
"QTY_PRC": 1.0,
"ML_BY_MM": "T",
"SC_DD": "2022-05-12 00:00:00",
"CST_TOTAL": 10.0
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
}