天心天思数字化API平台

生成【异常强制缴库】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【异常强制缴库】的生成接口，将第三方的制成品或半成品异常强制缴回的信息推送到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": "HYPMM2205120001",       //第三方单号，必填
  "PGM": "MRPAFC",          //单据程序代号
  "MF_MM0": [           //新增单据表头信息
    {
      "MM_ID": "MM",
      "MM_NO": "",
      "MM_DD": "2022-05-12 00:00:00",
      "DEP": "965",
      "BIL_ID": "TR",           //来源异常通知单据别
      "BIL_NO": "TR2205120001",           //来源异常通知单号
      "VOH_ID": "",
      "USR": "ADMIN",
      "USR_NO": "001",
      "REM":"异常强制缴库"
    }
  ],
  "TF_MM0": [            //新增单据表身信息
    {
      "MM_ID": "MM",
      "MM_NO": "",
      "ITM": 1,
      "MM_DD": "2022-05-12 00:00:00",
      "MO_NO": "MO2205120001",
      "DEP": "965",
      "PRD_NO": "WDP001",
      "ID_NO": "WDP001->",
      "PRD_MARK": "",
      "PRD_NAME": "打印机",
      "UNIT": "1",
      "WH": "YH001",
      "PRE_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":"TR",           //来源异常通知单据别
      "BIL_NO":"TR2205120001",           //来源异常通知单号
      "SC_DD":"2022-05-12 00:00:00",
      "REM":"异常强制缴库",
      "ML_BY_MM": "T"
    }
  ]
 }

返回结果示例

{
    "code": 0,
    "message": "新增成功",
    "data": {
        "MF_MM0": [
            {
                "MM_ID": "MM",
                "MM_NO": "MM2205120001",
                "MM_DD": "2022-05-12 00:00:00",
                "DEP": "965",
                "BIL_ID": "TR",
                "BIL_NO": "TR2205120001",
                "VOH_ID": "",
                "USR": "ADMIN",
                "USR_NO": "001",
                "CHK_MAN": "ADMIN",
                "SYS_DATE": "2022-05-26 09:58:34",
                "CLS_DATE": "2022-05-26 09:58:34",
                "PRT_SW": "N",
                "REM": ""
            }
        ],
        "TF_MM0": [
            {
                "MM_ID": "MM",
                "MM_NO": "MM2205120001",
                "ITM": 1,
                "MM_DD": "2022-05-12 00:00:00",
                "MO_NO": "MO2205120001",
                "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,
                "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": "TR",
                "BIL_NO": "TR2205120001",
                "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": []
        }
    }
}