生成【制成品验收退回单】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【制成品验收退回单】的生成接口,将第三方制成品验收退回的信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【制成品验收退回单】。

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO       第三方单号,必填
程序代号 PGM     MRPYP  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_TY
单据识别 TY_ID String 2 YP  
验收单号 TY_NO String 20     1.自动编码时,根据单据编码原则自动产生;
2.手工编码时,根据JSON的单据号码必填,且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行,不可以通过第三方单号,因此第三方须记录online单号
验收日 TY_DD Datetime      
验收员 SAL_NO String 12      
结案否 CLOSE_ID String 1      
托工厂商 CUS_NO String 12      
转入单号 TI_NO String 25      
转出单号 TB_NO String 20      
备注 REM String 100      
制单人 USR String 12    
审核人 CHK_MAN String 12      
列印注记 PRT_SW String 1      
拷贝注记 CPY_SW String 1      
验收退回单结案否 PRE_CLS_ID String 1      
检验项目清单 PRD_LIST String 80      
来源单号 BIL_NO String 20      
来源单识别 BIL_ID String 2      
终审日期 CLS_DATE Datetime        
链接文档 OLEFIELD String 100      
单据类别 BIL_TYPE String 10      
部门 DEP String 8    
厂商订单 CUS_OS_NO String 30      
审核模版 MOB_ID String 10      
锁单人 LOCK_MAN String 12      
锁单时间 LOCK_DATE Datetime 0      
输单日期 SYS_DATE Datetime        
入库单ID TI_ID String 2      
退回分销仓库 FX_WH String 12      
结案(合格量) CLS_ID_OK String 1      
结案(不合格量) CLS_ID_LOST String 1      
模板代号 VOH_ID String 2      
传票代号 VOH_NO String 20      
立帐方式 ZHANG_ID String 1      
税别 TAX_ID String 1      
立帐单号 ARP_NO String 20      
币别 CUR_ID String 4      
汇率 EXC_RTO Float 0      
打印人员 PRT_USR String 12      
合同编号 CNTT_NO String 40      
检验类型(1.常规检验,2.复检) CHK_KND String 1      
作废标记 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      
影响采购单中的收料数量 SL_ID String 1      
WMS产生的单据 WMS_ID String 1      
产品别 APP_NAME_DATA String 30      
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表TF_TY
验收识别 TY_ID String 2 YP  
验收单号 TY_NO String 20     与表头MF_TY的TY_NO相同
项次 ITM INT 0    
品号 PRD_NO String 30    
品名 PRD_NAME String 160      
货品特征 PRD_MARK String 100      
库位 WH String 12      
单位 UNIT String 1    
验收量 QTY_CHK Float 0    
合格量 QTY_OK Float 0    
不合格量 QTY_LOST Float 0      
实际入库量 QTY_RTN Float 0      
备注 REM String 40      
来源单号 BIL_NO String 20    
入库单号 TI_NO String 20    
批号 BAT_NO String 40      
制令单号 MO_NO String 20      
拷贝注记 CPY_SW String 1      
原因代号 SPC_NO String 10    
处理模式 PRC_ID String 1      
产生单据(QTY_LOST) BUILD_BIL String 26      
产生单据类别 BUILD_BIL_ID String 2      
追踪已交数量项次 EST_ITM INT 0      
产生单据(QTY_OK) MM_NO String 20      
原验收单项次 PRE_ITM INT 0    
退回数量 QTY_PRE Float 0      
未审核退回量 QTY_PRE_UNSH Float 0      
制程代号 ZC_NO String 10      
配方号 ID_NO String 38      
折价 QC_UP Float 0      
验收量(副) QTY1_CHK Float 0      
验收合格量[副] QTY1_OK Float 0      
不合格量[副] QTY1_LOST Float 0      
调整单号跟踪 EST_BUILD_BIL String 26      
搭赠注记 FREE_ID String 1      
追踪出库单项次 CK_ITM INT        
验收退回单入库单号 RK_NO String 20    
鞋服组合栏位 COMPOSE_IDNO String 50      
有效期 VALID_DD Datetime        
收料单号 SL_NO String 20      
关联入库单项次 TI_ITM INT      
送货单号 SH_NO_CUS String 20      
自动转移标识 AUTO_MV String 1      
转至单据 MVTO_NO String 20      
已转合格量 QTY_OK_RTN Float        
未审核合格量 QTY_OK_RTN_UNSH Float 0      
已转不合格量 QTY_LOST_RTN Float        
未审核不合格量 QTY_LOST_RTN_UNSH Float 0      
验收转单标识 MM_ID String 2      
配送退回原因[A.正常退货,B.残次品,C.质量问题Z.其他] RTN_ID String 1      
唯一项次 KEY_ITM INT 0    
工程案号 CAS_NO String 20      
阶段编号 TASK_ID INT 0      
工时[制成品送检仅有] USED_TIME Float 0      
关封编号 GF_NO String 20      
客户/厂商订单 CUS_OS_NO String 30      
金额 AMTN Float 0      
单价 UP Float 0      
TAX Float 0      
税率 TAX_RTO Float 0      
外币 AMT Float 0      
批次 PC_NO String 30      
转特殊检验量 QTY_QC Float 0      
入库日期 RK_DD Datetime 0      
集团公司 DEP_RK String 8      
合同编号 CNTT_NO String 40      
不合格审理单号 LS_NO String 20      
折扣额 AMT_DIS_CNT Float 0      
复检日期 RECHK_DD Datetime 0      
生产日期 PRODU_DD Datetime 0      
资产代号 FX_NO String 20      
资产名称 FX_NAME String 40      
恢复送货自增ID HFSH_ITM INT 0      
已转合格量(副) QTY1_OK_RTN Float 0      
未审核合格量(副) QTY1_OK_RTN_UNSH Float 0      
已转不合格量(副) QTY1_LOST_RTN Float 0      
未审核不合格量(副) QTY1_LOST_RTN_UNSH Float 0      
退回数量(副) QTY1_PRE Float 0      
未审核退回数量(副) QTY1_PRE_UNSH Float 0      
WMS出入库通知量 QTY_CRK_WMS Float 0      
WMS出入库通知量(副) QTY1_CRK_WMS Float 0      
领料单号 ML_NO String 20      

请求JSON示例

{
  "REF_NO": "TXYP20220124001",     //第三方单号,必填
  "PGM": "MRPYP",      //程序代号,必填
  "MF_TY": [         //请求生成单据的表头参数信息
    {
          "TY_ID":"YP",
          "TY_NO":"",
          "TY_DD":"2022-01-24",
          "CUS_NO":"",
          "BIL_TYPE":"",
          "TI_NO":"TP21240001",
          "DEP":"00000000",
          "REM":"",
          "USR":"ADMIN"
    }
  ],
  "TF_TY": [        //请求生成单据的表身参数信息
    {
          "TY_ID":"YP",
          "TY_NO":"",
          "ITM":1,
          "PRD_NO":"1001",
          "PRD_MARK":"",
          "BAT_NO":"",
          "UNIT":"1",
          "QTY_CHK":2,
          "QTY1_CHK":4,
          "BIL_NO":"MO21240001",
          "TI_NO":"TP21240001",
          "RK_NO":"T621240001",
          "SPC_NO":"01",
          "EST_ITM":1,
          "PRE_ITM":1,
          "TI_ITM":1,
          "KEY_ITM":1,
          "WH":"00000000", 
          "REM":""
    }
  ]
}

返回结果示例

{
    "code": 0,       //返回0表示成功,否则为失败
    "message": "新增成功",
    "data": {
        "MF_TY": [      //返回生成单据的表头参数信息
            {
                "TY_ID": "YP",
                "TY_NO": "YP21240001",
                "TY_DD": "2022-01-24 00:00:00",
                "CUS_NO": "",
                "TI_NO": "TP21240001",
                "REM": "",
                "USR": "ADMIN",
                "CHK_MAN": "ADMIN",
                "PRT_SW": "N",
                "CLS_DATE": "2022-01-24 00:00:00",
                "BIL_TYPE": "",
                "DEP": "00000000",
                "SYS_DATE": "2022-01-25 12:13:34"
            }
        ],
        "TF_TY": [         //返回生成单据的表身参数信息
            {
                "TY_ID": "YP",
                "TY_NO": "YP21240001",
                "ITM": 1,
                "PRD_NO": "1001",
                "PRD_MARK": "",
                "WH": "00000000",
                "UNIT": "1",
                "QTY_CHK": 2.0,
                "QTY1_CHK": 4.0,
                "REM": "",
                "BIL_NO": "MO21240001",
                "TI_NO": "TP21240001",
                "KEY_ITM": 1,
                "BAT_NO": "",
                "SPC_NO": "01",
                "EST_ITM": 1,
                "PRE_ITM": 1,
                "TI_ITM": 1,
                "RK_NO": "T621240001"
            }
        ],
        "BILL_STATE": {
            "READONLY": false,
            "READONLY_REM": []
        }
    }
}