生成【生产补料单】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【生产补料单】的生成接口,将第三方的因生产制造需要补领料件的信息推送到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      
成品代号 MRP_NO string 30      

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": "LJM32008100001",               //第三方单号,必填
  "PGM": "MRPAGJ",                                   //单据程序代号
  "MF_ML": [                         //新增单据表头信息
    {
      "MLID": "M3",
      "ML_NO": "LJM32008100001",
      "ML_ID": "3",
      "ML_DD": "2020-08-10 00:00:00",
      "FIX_CST1": "1",
      "MO_NO": "MO20081000000001",
      "VOH_ID": "",
      "USR_NO": "9999",
      "DEP": "00101",
      "TZ_NO": "TZ20081000000001",
      "USR": "ADMIN",
      "VOH_ID_MC": "",
      "YL_ID": "F",
      "JD_M31": 12.0               //表头自定义栏位信息
    }
  ],
  "TF_ML": [                            //新增单据表身信息
    {
      "MLID": "M3",
      "ML_NO": "LJM32008100001",
      "ML_ID": "3",
      "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,
      "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",
      "JD_M32": 12.0                //表身自定义栏位信息
    }
  ]
}

返回结果示例

{
  "code": 0,                              //为0表示执行成功,其他表示错误
  "message": "新增成功",
  "data": {
    "MF_ML": [                         //单据表头信息
      {
        "MLID": "M3",
        "ML_NO": "LJM32008100001",
        "ML_ID": "3",
        "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 15:33:49",
        "VOH_ID_MC": "",
        "YL_ID": "F",
        "JD_M31": 12.0
      }
    ],
    "TF_ML": [                                //单据表身信息
      {
        "MLID": "M3",
        "ML_NO": "LJM32008100001",
        "ML_ID": "3",
        "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",
        "JD_M32": 12.0
      }
    ],
    "MF_ML_Z": [                              //单据表头自定义栏位
      {
        "JD_M31": 12.0,
        "MLID": "M3",
        "ML_NO": "LJM32008100001"
      }
    ],
    "TF_ML_Z": [                            //单据表身自定义栏位
      {
        "JD_M32": 12.0,
        "MLID": "M3",
        "ML_NO": "LJM32008100001",
        "ITM": 1
      }
    ]
  }
}