概述
该接口主要用于第三方平台或自主研发者，通过调用【制程生产验收单】的生成接口，将第三方制程送检信息推送到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 |
|
|
是 |
MRPBO |
|
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 数据表MF_TY |
| 验收识别 |
TY_ID |
String |
2 |
是 |
TQ |
|
| 验收单号 |
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 |
是 |
TQ |
|
| 验收单号 |
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": "TXTQ2021120001", //第三方单号，必填
"PGM": "MRPBO", //程序代号
"MF_TY": [ //请求生成的单据表头参数明细
{
"TY_ID": "TQ",
"TY_NO": "",
"TY_DD": "2021-12-28",
"TI_NO": "TQ1C280001",
"USR": "ADMIN",
"DEP": "00000000",
"BIL_TYPE":"",
"CHK_KND": "1"
}
],
"TF_TY": [ //请求生成的单据表身参数明细
{
"TY_ID": "TQ",
"TY_NO": "",
"ITM": "1",
"PRD_NO": "1003",
"PRD_NAME": "1003成品",
"WH": "00000000",
"UNIT": "1",
"QTY_CHK": 10.00000000,
"QTY_OK": 8.00000000,
"QTY_LOST": 2.00000000,
"BIL_NO": "TZ1C280001",
"TI_NO": "T51C280001",
"MO_NO": "MO1C280001",
"SPC_NO": "01",
"PRC_ID": "5",
"EST_ITM": "1",
"PRE_ITM": "1",
"ZC_NO": "01",
"ID_NO": "1003->AAA",
"QTY1_CHK": 20.00000000,
"QTY1_OK": 16.00000000,
"QTY1_LOST": 4.00000000,
"TI_ITM": 1,
"RK_DD": "2021-12-28"
}
]
}
返回结果示例
{
"code": 0, //为0表示成功，否则为失败
"message": "新增成功",
"data": {
"MF_TY": [ //返回请求新增单据的表头明细信息
{
"TY_ID": "TQ",
"TY_NO": "TQ1C280001",
"TY_DD": "2021-12-28 00:00:00",
"TI_NO": "TQ1C280001",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2021-12-28 00:00:00",
"DEP": "00000000",
"SYS_DATE": "2021-12-28 19:10:37",
"CHK_KND": "1"
}
],
"TF_TY": [ //返回请求新增单据的表身明细信息
{
"TY_ID": "TQ",
"TY_NO": "TQ1C280001",
"ITM": 1,
"PRD_NO": "1003",
"PRD_NAME": "1003成品",
"PRD_MARK": "",
"WH": "00000000",
"UNIT": "1",
"QTY_CHK": 10.0,
"QTY_OK": 8.0,
"QTY_LOST": 2.0,
"BIL_NO": "TZ1C280001",
"TI_NO": "T51C280001",
"MO_NO": "MO1C280001",
"SPC_NO": "01",
"PRC_ID": "5",
"EST_ITM": 1,
"PRE_ITM": 1,
"ZC_NO": "01",
"ID_NO": "1003->AAA",
"QTY1_CHK": 20.0,
"QTY1_OK": 16.0,
"QTY1_LOST": 4.0,
"TI_ITM": 1,
"RK_DD": "2021-12-28 00:00:00"
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
}