生成【异常通知单】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【异常通知单】的生成接口,将第三方系统对制程生产不合量异常通知信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【异常通知单】。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/MRPTR/ADDDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO       第三方单号,必填
程序代号 PGM     MRPTR  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表TZERR
异常单号 TR_NO string 20     1.自动编码时,根据单据编码原则自动产生;
2.手工编码时,根据JSON的单据号码必填,且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行,不可以通过第三方单号,因此第三方须记录online单号
异常日期 TR_DD datetime      
生产通知单号 TZ_NO string 20    
制程代号 ZC_NO string 10    
数量 QTY float      
机台 DEP string 8    
异常原因 SPC_NO string 10      
建议处理 PRC_AD string 1      
处理方式 PRC_ID string 1    
经办人 USR_NO string 12      
制单人 USR string 12    
审核人 CHK_MAN string 12      
打印标志 PRT_SW string 1      
拷贝标志 CPY_SW string 1      
备注1 REM1 string 100    
备注2 REM2 string 100    
处理否 CLOSE_ID string 1      
制令单号 MO_NO string 20    
生产成品 MRP_NO string 30    
成品特征 PRD_MARK string 100      
生成单据 BIL_BUILD string 26      
配方号 ID_NO string 38    
来源单据识别码 BIL_ID string 2    
来源单号 BIL_NO string 20    
来源单项次 BIL_ITM int 0    
终审日期 CLS_DATE datetime        
批号 BAT_NO string 40      
链接文档 OLEFIELD string 100      
单据类别 BIL_TYPE string 10      
鞋服组合栏位 COMPOSE_IDNO string 50      
审核模版 MOB_ID string 10      
锁单人 LOCK_MAN string 12      
锁单时间 LOCK_DATE datetime 0      
输单日期 SYS_DATE datetime        
报废/强制缴库处理选择 PRC_ID2 string 1    
生成单据二 BIL_BUILD2 string 26      
工程案号 CAS_NO string 20      
任务编号 TASK_ID int 0      
数量(副) QTY1 float 0      
单位 UNIT string 1      
打印人员 PRT_USR string 12      
完工品制程代号 ZC_PRD string 100      
制程完工品品号 PRD_ZC string 200      
合并转入标识 HB_ID string 1      
打印日期 PRT_DATE datetime 0      
最近修改日期 MODIFY_DD datetime 0      
最近修改人 MODIFY_MAN string 12      
单据ID TZ_ID string 2    
选择 YN string 1      
责任部门 DEP_ZR string 8      
产品别 APP_NAME_DATA string 30      
WMS出入库通知量 QTY_CRK_WMS float 0      
WMS出入库通知量(副) QTY1_CRK_WMS float 0      
入库货品代号 PRD_NO2 string 30      
入库货品特征 PRD_MARK2 string 100      
入库批号 BAT_NO2 string 40      
入库仓库 WH2 string 12      

请求JSON示例

{

  "REF_NO": "{{$guid}}",    //第三方单号
  "PGM": "MRPTR",     //程序代号
  "TZERR": [      //请求生成单据的参数明细信息
    {
         "TR_NO":"",
         "TR_DD":"2022-03-21",
         "TZ_NO": "TZ23210001",
         "ZC_NO": "01",
         "QTY": 2,
         "DEP": "00000000",
         "SPC_NO": "01",
         "PRC_ID": "3",
         "USR": "ADMIN",
         "MO_NO": "MO23210001",
         "MRP_NO": "1003",
         "ID_NO": "1003->1.0",
         "BIL_ID": "TQ",
         "BIL_NO": "TQ23210001",
         "BIL_ITM": "1",
         "PRC_ID2": "1",
         "QTY1": 4,
         "UNIT": "1",
         "HB_ID": "T",
         "TZ_ID": "TZ",
         "BIL_TYPE":""
    }
  ]
}

返回结果示例

{
    "code": 0,    //返回0表示执行成功,否则为失败
    "message": "新增成功",
    "data": {
        "TZERR": [     //返回生成单据的参数信息
            {
                "TR_NO": "TR23210001",
                "TR_DD": "2022-03-21 00:00:00",
                "TZ_NO": "TZ23210001",
                "ZC_NO": "01",
                "QTY": 2.0,
                "DEP": "00000000",
                "SPC_NO": "01",
                "PRC_ID": "3",
                "USR": "ADMIN",
                "CHK_MAN": "ADMIN",
                "PRT_SW": "N",
                "MO_NO": "MO23210001",
                "MRP_NO": "1003",
                "ID_NO": "1003->1.0",
                "BIL_ID": "TQ",
                "BIL_NO": "TQ23210001",
                "BIL_ITM": 1,
                "CLS_DATE": "2022-03-21 00:00:00",
                "BIL_TYPE": "",
                "SYS_DATE": "2022-03-22 12:11:50",
                "PRC_ID2": "1",
                "QTY1": 4.0,
                "UNIT": "1",
                "HB_ID": "T",
                "TZ_ID": "TZ"
            }
        ],
        "BILL_STATE": {
            "READONLY": false,
            "READONLY_REM": []
        }
    }
}