生成【托工缴回验收单】接口
概述
该接口主要用于第三方平台或自主研发者,通过调用【托工缴回验收单】的生成接口,将第三方系统的托工缴回验收的信息推送到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 | 是 | MRPTO | |||
字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
数据表MF_TY | ||||||
验收识别 | TY_ID | String | 2 | 是 | TO | |
验收单号 | 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 | ||||
输单日期 | 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 | ||||
打印人员 | PRT_USR | String | 12 | |||
合同编号 | CNTT_NO | String | 40 | |||
检验类型(1.常规检验,2.复检) | CHK_KND | String | 1 | |||
作废标记 | CANCEL_ID | String | 1 | |||
打印日期 | PRT_DATE | Datetime | ||||
最近修改日期 | MODIFY_DD | Datetime | ||||
最近修改人 | MODIFY_MAN | String | 12 | |||
扫描状态 | SCAN_ID | String | 1 | |||
扫描人 | SCAN_USR | String | 12 | |||
扫描日期 | SCAN_DATE | Datetime | ||||
影响采购单中的收料数量 | SL_ID | String | 1 | |||
WMS产生的单据 | WMS_ID | String | 1 | |||
产品别 | APP_NAME_DATA | String | 30 | |||
字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
数据表TF_TY | ||||||
验收识别 | TY_ID | String | 2 | 是 | TO | |
验收单号 | TY_NO | String | 20 | 与表头MF_TY的TY_NO相同 | ||
项次 | ITM | INT | 是 | |||
品号 | PRD_NO | String | 30 | 是 | ||
品名 | PRD_NAME | String | 160 | |||
货品特征 | PRD_MARK | String | 100 | |||
库位 | WH | String | 12 | |||
单位 | UNIT | String | 1 | 是 | ||
验收量 | QTY_CHK | Float | 是 | |||
合格量 | QTY_OK | Float | 是 | |||
不合格量 | QTY_LOST | Float | ||||
实际入库量 | QTY_RTN | Float | ||||
备注 | 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 | ||||
产生单据(QTY_OK) | MM_NO | String | 20 | |||
原验收单项次 | PRE_ITM | INT | 是 | |||
退回数量 | QTY_PRE | Float | ||||
未审核退回量 | QTY_PRE_UNSH | Float | ||||
制程代号 | ZC_NO | String | 10 | |||
配方号 | ID_NO | String | 38 | 是 | ||
折价 | QC_UP | Float | ||||
验收量(副) | QTY1_CHK | Float | ||||
验收合格量[副] | QTY1_OK | Float | ||||
不合格量[副] | QTY1_LOST | Float | ||||
调整单号跟踪 | 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 | ||||
已转不合格量 | QTY_LOST_RTN | Float | ||||
未审核不合格量 | QTY_LOST_RTN_UNSH | Float | ||||
验收转单标识 | MM_ID | String | 2 | |||
配送退回原因[A.正常退货,B.残次品,C.质量问题Z.其他] | RTN_ID | String | 1 | |||
唯一项次 | KEY_ITM | INT | 是 | |||
工程案号 | CAS_NO | String | 20 | |||
阶段编号 | TASK_ID | INT | ||||
工时[制成品送检仅有] | USED_TIME | Float | ||||
关封编号 | GF_NO | String | 20 | |||
客户/厂商订单 | CUS_OS_NO | String | 30 | |||
金额 | AMTN | Float | ||||
单价 | UP | Float | ||||
税 | TAX | Float | ||||
税率 | TAX_RTO | Float | ||||
外币 | AMT | Float | ||||
批次 | PC_NO | String | 30 | |||
转特殊检验量 | QTY_QC | Float | ||||
入库日期 | RK_DD | Datetime | ||||
集团公司 | DEP_RK | String | 8 | |||
新有效期(国光) | VALID_DD_NEW | Datetime | ||||
合同编号 | CNTT_NO | String | 40 | |||
不合格审理单号 | LS_NO | String | 20 | |||
折扣额 | AMT_DIS_CNT | Float | ||||
复检日期 | RECHK_DD | Datetime | ||||
生产日期 | PRODU_DD | Datetime | ||||
资产代号 | FX_NO | String | 20 | |||
资产名称 | FX_NAME | String | 40 | |||
恢复送货自增ID | HFSH_ITM | INT | ||||
已转合格量(副) | QTY1_OK_RTN | Float | ||||
未审核合格量(副) | QTY1_OK_RTN_UNSH | Float | ||||
已转不合格量(副) | QTY1_LOST_RTN | Float | ||||
未审核不合格量(副) | QTY1_LOST_RTN_UNSH | Float | ||||
退回数量(副) | QTY1_PRE | Float | ||||
未审核退回数量(副) | QTY1_PRE_UNSH | Float | ||||
WMS出入库通知量 | QTY_CRK_WMS | Float | ||||
WMS出入库通知量(副) | QTY1_CRK_WMS | Float | ||||
领料单号 | ML_NO | String | 20 |
请求JSON示例
{ "REF_NO": "HYPTO2111050001", //第三方单号,必填 "PGM": "MRPTO", //程序代号,必填 "MF_TY": [ //请求生成单据的表头参数信息 { "TY_ID": "TO", "TY_NO": "", "TY_DD": "2021-11-05 00:00:00", "TI_NO": "T72111050001", "CUS_NO": "CU0301", "USR": "ADMIN", "PRT_SW": "N", "DEP": "D0300", "TI_ID": "T7", "CHK_KND": "1" } ], "TF_TY": [ //请求生成单据的表身参数信息 { "TY_ID": "TO", "TY_NO": "", "ITM": 1, "PRD_NO": "WDP001", "PRD_NAME": "打印机", "PRD_MARK": "", "WH": "YH001", "UNIT": "1", "QTY_CHK": 1.0, "QTY_OK": 1.0, "BIL_NO": "TW2111050001", "TI_NO": "T72111050001", "PRE_ITM": 1, "ID_NO": "WDP001->", "QTY1_CHK": 2.0, "QTY1_OK": 2.0, "TI_ITM": 2, "RK_DD": "2021-11-5 00:00:00" } ] }
返回结果示例
{ "code": 0, //返回0表示成功,否则为失败 "message": "新增成功", "data": { "MF_TY": [ //返回生成单据的表头参数信息 { "TY_ID": "TO", "TY_NO": "TO2111050001", "TY_DD": "2021-11-05 00:00:00", "CUS_NO": "CU0301", "TI_NO": "T72111050001", "REM": "", "USR": "ADMIN", "CHK_MAN": "ADMIN", "PRT_SW": "N", "CLS_DATE": "2022-05-10 14:24:55", "DEP": "D0300", "SYS_DATE": "2022-05-10 14:24:55", "TI_ID": "T7", "CHK_KND": "1" } ], "TF_TY": [ //返回生成单据的表身参数信息 { "TY_ID": "TO", "TY_NO": "TO2111050001", "ITM": 1, "PRD_NO": "WDP001", "PRD_NAME": "打印机", "PRD_MARK": "", "WH": "YH001", "UNIT": "1", "QTY_CHK": 1.0, "QTY_OK": 1.0, "REM": "", "BIL_NO": "TW2111050001", "TI_NO": "T72111050001", "PRE_ITM": 1, "ID_NO": "WDP001->", "QTY1_CHK": 2.0, "QTY1_OK": 2.0, "TI_ITM": 2, "RK_DD": "2021-11-05 00:00:00" } ], "BILL_STATE": { "READONLY": false, "READONLY_REM": [] } } }