概述
该接口主要用于第三方平台或自主研发者，通过调用【进货验收退回单】的生成接口，将第三方系统入库验收退回的信息推送到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 |
|
|
是 |
DRPYB |
|
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 数据表MF_TY |
| 验收识别 |
TY_ID |
string |
2 |
是 |
YB |
|
| 验收单号 |
TY_NO |
string |
20 |
是 |
|
1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
| 验收日 |
TY_DD |
datetime |
|
是 |
|
格式为：YYYY-MM-DD |
| 验收员 |
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 |
是 |
|
默认值为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 |
|
|
|
| 数据表TF_TY |
| 验收识别 |
TY_ID |
string |
2 |
是 |
YB |
|
| 验收单号 |
TY_NO |
string |
20 |
是 |
|
必须与MF_TY的TY_NO相同 |
| 项次 |
ITM |
integer |
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 |
|
|
1验收退回；2让步接收；4复检 |
| 产生单据(QTY_LOST) |
BUILD_BIL |
string |
26 |
|
|
|
| 产生单据类别 |
BUILD_BIL_ID |
string |
2 |
|
|
|
| 追踪已交数量项次 |
EST_ITM |
integer |
0 |
|
|
|
| 产生单据(QTY_OK) |
MM_NO |
string |
20 |
|
|
|
| 原验收单项次 |
PRE_ITM |
integer |
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 |
integer |
|
|
|
|
| 验收退回单入库单号 |
RK_NO |
string |
20 |
|
|
|
| 鞋服组合栏位 |
COMPOSE_IDNO |
string |
50 |
|
|
|
| 有效期 |
VALID_DD |
datetime |
|
|
|
|
| 收料单号 |
SL_NO |
string |
20 |
|
|
|
| 关联入库单项次 |
TI_ITM |
integer |
|
|
|
|
| 送货单号 |
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 |
integer |
0 |
|
|
|
| 工程案号 |
CAS_NO |
string |
20 |
|
|
|
| 阶段编号 |
TASK_ID |
integer |
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 |
integer |
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 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_TY_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_TY_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": "YB20082700000001", //第三方单号，必填
"PGM": "DRPYB", //单据程序代号
"MF_TY": [ //新增单据表头信息
{
"TY_ID": "YB",
"TY_NO": "YB20082700000001",
"TY_DD": "2020-08-27 00:00:00",
"SAL_NO": "9999",
"CUS_NO": "C1000",
"TI_NO": "TY20082700000001",
"REM": "API产生",
"USR": "ADMIN",
"BIL_NO": "PO20082600000001",
"BIL_ID": "PO",
"BIL_TYPE": "",
"DEP": "00000000",
"LJ_YB1": "外部单据" //新增单据表头自定义栏位信息
}
],
"TF_TY": [ //新增单据表身信息
{
"TY_ID": "YB",
"TY_NO": "YB20082700000001",
"ITM": 1,
"PRD_NO": "0001",
"PRD_NAME": "不粘锅",
"PRD_MARK": "",
"WH": "9902",
"UNIT": "1",
"QTY_CHK": 2.0,
"BIL_NO": "PO20082600000001",
"TI_NO": "TY20082700000001",
"MM_ID": "PO",
"KEY_ITM": 1,
"SPC_NO": "01",
"EST_ITM": 1,
"PRE_ITM": 5,
"TI_ITM": 1,
"RK_NO": "TI20082600000001",
"QTY_ORG": 2.0,
"SIZE__NAME": "",
"GOOD__NAME": "",
"PRD_NO_NO": "0001"
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_TY": [ //生成单据表头信息
{
"TY_ID": "YB",
"TY_NO": "YB20082700000002",
"TY_DD": "2020-08-27 00:00:00",
"SAL_NO": "9999",
"CUS_NO": "C1000",
"TI_NO": "TY20082700000001",
"REM": "API产生",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"BIL_NO": "PO20082600000001",
"BIL_ID": "PO",
"CLS_DATE": "2020-08-27 00:00:00",
"BIL_TYPE": "",
"DEP": "00000000",
"SYS_DATE": "2020-08-27 16:40:12",
"LJ_YB1": "外部单据"
}
],
"TF_TY": [ //生成单据表身信息
{
"TY_ID": "YB",
"TY_NO": "YB20082700000002",
"ITM": 1,
"PRD_NO": "0001",
"PRD_NAME": "不粘锅",
"PRD_MARK": "",
"WH": "9902",
"UNIT": "1",
"QTY_CHK": 2.0,
"BIL_NO": "PO20082600000001",
"TI_NO": "TY20082700000001",
"MM_ID": "PO",
"KEY_ITM": 1,
"SPC_NO": "01",
"EST_ITM": 1,
"PRE_ITM": 5,
"TI_ITM": 1,
"RK_NO": "TI20082600000001",
"QTY_ORG": 2.0
}
],
"MF_TY_Z": [ //生成单据表头自定义栏位信息
{
"LJ_YB1": "外部单据",
"TY_ID": "YB",
"TY_NO": "YB20082700000002"
}
],
"TF_TY_Z": [ //生成单据表身自定义栏位信息
{
"TY_ID": "YB",
"TY_NO": "YB20082700000002",
"ITM": 1
}
]
}
}