概述
该接口主要用于第三方平台或自主研发者，通过调用【退回申请单】的生成接口，将第三方系统的销货退回申请信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【退回申请单】。
参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://ERPAPI站点/DRPYX/ADDDATA |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
| Authorization |
token |
授权接口所获取的值 |
3.请求参数
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号，必填 |
| 程序代号 |
PGM |
|
|
是 |
DRPYX |
|
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 数据表MF_DYH |
| 要货/退货编码原则 |
YH_ID |
A |
2 |
是 |
YX |
|
| 要货/退货申请单单号 |
YH_NO |
A |
20 |
是 |
|
1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
| 打单人员所在部门 |
DEP |
A |
8 |
是 |
|
|
| 要货/退货申请单的日期 |
YH_DD |
@ |
0 |
是 |
|
格式为：YYYY-MM-DD |
| 要货/退货申请单是否结案 |
CLS_ID |
A |
1 |
|
|
|
| 要货/退货申请单审核日期 |
CLS_DATE |
@ |
0 |
|
|
|
| 审核人 |
CHK_MAN |
A |
12 |
|
|
|
| 要货/退货申请单客户代号 |
CUS_NO |
A |
12 |
是 |
|
|
| 退货申请单的退货原因 |
REM |
M |
0 |
|
|
|
| 要货/退货申请单的打单人员编号 |
USR |
A |
12 |
是 |
|
|
| 客户分销库位 |
FX_WH |
A |
12 |
|
|
|
| 依箱条码要货 |
BYBOX |
A |
1 |
|
|
|
| 客户希望交期 |
EST_DD |
@ |
0 |
|
|
|
| 要货库位(复合) |
WH |
A |
25 |
|
|
|
| 模糊输入否 |
FUZZY_ID |
A |
1 |
|
|
|
| 是否存盘[F:表示缓存，T:表真正存盘] |
SAVE_ID |
A |
1 |
|
|
|
| 打印注记 |
PRT_SW |
A |
1 |
|
|
|
| 打印人员 |
PRT_USR |
A |
12 |
|
|
|
| 制单日期 |
SYS_DATE |
@ |
0 |
|
|
|
| 来源结案单据类别 |
BACK_ID |
A |
2 |
|
|
|
| 送货方式 |
SEND_MTH |
A |
200 |
|
|
|
| 送货仓 |
SEND_WH |
A |
12 |
|
|
|
| 送货地址 |
ADR |
M |
0 |
|
|
|
| 单据类别 |
BIL_TYPE |
A |
10 |
|
|
|
| 作废标记 |
CANCEL_ID |
A |
1 |
|
|
|
| 审核模版 |
MOB_ID |
A |
10 |
|
|
|
| 工程案号 |
CAS_NO |
A |
20 |
|
|
|
| 打印日期 |
PRT_DATE |
@ |
0 |
|
|
|
| 会员代号 |
CARD_NO |
A |
20 |
|
|
|
| 业务代号 |
SAL_NO |
A |
12 |
|
|
|
| 来源单据别 |
BIL_ID |
A |
2 |
|
|
|
| 来源单号 |
BIL_NO |
A |
25 |
|
|
|
| 汇率 |
EXC_RTO |
N |
0 |
|
|
|
| 阶段编号 |
TASK_ID |
I |
0 |
|
|
|
| 扣税类别 |
TAX_ID |
A |
1 |
|
|
|
| 退货方式(B:买家,S:卖家) |
RTN_MODE |
A |
1 |
|
|
|
| 退货地址 |
RTN_ADDR |
A |
255 |
|
|
|
| 物流单号 |
FH_NO |
A |
20 |
|
|
|
| 物流名称 |
FH_NAME |
A |
100 |
|
|
|
| 退款原因 |
RTN_REM |
M |
0 |
|
|
|
| 币别 |
CUR_ID |
A |
4 |
|
|
|
| 营业员 |
CUST_YG |
A |
12 |
|
|
|
| 客户订单 |
CUS_OS_NO |
A |
30 |
|
|
|
| 锁单人 |
LOCK_MAN |
A |
12 |
|
|
|
| 锁单时间 |
LOCK_DATE |
@ |
0 |
|
|
|
| 拷贝注记(转入/转出) |
CPY_SW |
A |
1 |
|
|
|
| 附件ID |
FILE_ID |
A |
100 |
|
|
|
| 附件内容 |
FILE_CONTENT |
G |
0 |
|
|
|
| 图片1 |
PIC1 |
G |
0 |
|
|
|
| 图片2 |
PIC2 |
G |
0 |
|
|
|
| 图片3 |
PIC3 |
G |
0 |
|
|
|
| 图片名称1 |
PIC1_ID |
A |
100 |
|
|
|
| 图片名称2 |
PIC2_ID |
A |
100 |
|
|
|
| 图片名称3 |
PIC3_ID |
A |
100 |
|
|
|
| 登陆的IP |
IP |
A |
50 |
|
|
|
| 最近修改日期 |
MODIFY_DD |
@ |
0 |
|
|
|
| 最近修改人 |
MODIFY_MAN |
A |
12 |
|
|
|
| 秒杀/特供活动代号 |
ACT_NO |
A |
20 |
|
|
|
| 要货订单全额定金 |
CHK_FULL_PAY |
A |
1 |
|
|
|
| 确认人 |
SCM_USR |
A |
12 |
|
|
|
| 确认时间 |
SCM_DD |
@ |
0 |
|
|
|
| 转来源单号(加工申请单) |
QT_NO |
A |
20 |
|
|
|
| 退换货(1.退货,2.换货) |
REFUND_ID |
A |
1 |
|
|
|
| 特价否 |
CHK_SPEPRI_HZ |
A |
1 |
|
|
|
| 合同编号 |
CNTT_NO |
A |
40 |
|
|
|
| 数据表TF_DYH |
| 要货(退货)编码原则 |
YH_ID |
A |
2 |
是 |
|
必须与表MF_DYH的YH_ID相同 |
| 要货(退货)申请单单号 |
YH_NO |
A |
20 |
是 |
|
必须与表MF_DYH的YH_NO相同 |
| 要货(退货)申请单表身编号 |
ITM |
I |
0 |
是 |
|
|
| 产品代号 |
PRD_NO |
A |
30 |
是 |
|
|
| 产品特征分段 |
PRD_MARK |
A |
100 |
|
|
|
| 库位代号 |
WH |
A |
12 |
是 |
|
|
| 预交日期 |
EST_DD |
@ |
0 |
|
|
|
| 数量 |
QTY |
N |
0 |
|
|
|
| 单位代号 |
UNIT |
A |
1 |
是 |
|
|
| 总金额 |
AMTN |
N |
0 |
|
|
|
| 退回数量 |
QTY_RTN |
N |
0 |
|
|
|
| 单价 |
UP |
N |
0 |
|
|
|
| 备注 |
REM |
A |
1000 |
|
|
|
| 追踪箱条码 |
BOX_ITM |
I |
0 |
|
|
|
| 唯一项次 |
KEY_ITM |
I |
0 |
|
|
|
| 原单数量 |
QTY_OLD |
N |
0 |
|
|
|
| 原单库位 |
WH_OLD |
A |
12 |
|
|
|
| 原单预交期 |
EST_OLD |
@ |
0 |
|
|
|
| 审核删除注记 |
DEL_ID |
A |
1 |
|
|
|
| 已受订量 |
QTY_SO |
N |
0 |
|
|
|
| 未审核受订量 |
QTY_SO_UNSH |
N |
0 |
|
|
|
| 未审核退回量 |
QTY_RTN_UNSH |
N |
0 |
|
|
|
| 折扣 |
DIS_CNT |
N |
0 |
|
|
|
| 货品名称 |
PRD_NAME |
A |
160 |
|
|
|
| 外币金额 |
AMT |
N |
0 |
|
|
|
| 税金 |
TAX |
N |
0 |
|
|
|
| 税率 |
TAX_RTO |
N |
0 |
|
|
|
| 数量（副） |
QTY1 |
N |
0 |
|
|
|
| 单位（副） |
UP_QTY1 |
N |
0 |
|
|
|
| 折扣金额 |
AMT_DIS_CNT |
N |
0 |
|
|
|
| 转入ID |
BIL_ID |
A |
2 |
|
|
|
| 转入单号 |
BIL_NO |
A |
20 |
|
|
|
| 批号 |
BAT_NO |
A |
40 |
|
|
|
| 对方货号 |
SUP_PRD_NO |
A |
40 |
|
|
|
| 追踪项次 |
OTH_ITM |
I |
0 |
|
|
|
| 唯一项次（申退单） |
PRE_ITM |
I |
0 |
|
|
|
| 退货送检量 |
QTY_QC |
N |
0 |
|
|
|
| 未审核退货送检 |
QTY_QC_UNSH |
N |
0 |
|
|
|
| 原因代号 |
SPC_NO |
A |
10 |
|
|
|
| 搭赠注记 |
FREE_ID |
A |
1 |
|
|
|
| 是否定价政策搭赠品 |
FREE_ID_DEF |
A |
1 |
|
|
|
| 已销货量 |
QTY_SA |
N |
0 |
|
|
|
| 已销货未审核量 |
QTY_SA_UNSH |
N |
0 |
|
|
|
| 标准模板代号 |
XPM_NO |
A |
20 |
|
|
|
| 自选模板代号 |
XPM_NO1 |
A |
20 |
|
|
|
| 自选产品对应的主产品项次 |
XPPRD_ITM |
I |
0 |
|
|
|
| 注射容积(泰瑞) |
ZSRJ_TR |
N |
0 |
|
|
|
| 材料密度(泰瑞) |
CLMD_TR |
N |
0 |
|
|
|
| 产出产品重量(泰瑞) |
PRDW_TR |
N |
0 |
|
|
|
| 对应选配模板表身的KEY_ITM |
XPPRD_ITM1 |
I |
0 |
|
|
|
| 阶段编号 |
TASK_NO |
A |
30 |
|
|
|
| 促销代号 |
PRM_NO |
A |
20 |
|
|
|
| 配方号 |
ID_NO |
A |
38 |
|
|
|
| 选配备注 |
REM_XP |
A |
200 |
|
|
|
| 对方货号名称 |
SUP_PRD_NAME |
A |
160 |
|
|
|
| 对方货品特征 |
SUP_PRD_MARK |
A |
100 |
|
|
|
| 生产日期 |
SC_DD |
@ |
0 |
|
|
|
| 转来源单号(加工申请单) |
QT_NO |
A |
20 |
|
|
|
| 受定单项次 |
OS_ITM |
I |
0 |
|
|
|
| 电商类型 |
SC_TYPE_ID |
A |
4 |
|
|
|
| 电商单号 |
SC_TB_NO |
A |
20 |
|
|
|
| 退款单号 |
SC_RTN_NO |
A |
20 |
|
|
|
| 淘宝子订单号 |
TB_OID |
A |
30 |
|
|
|
| 包装单位 |
PAK_UNIT |
A |
20 |
|
|
|
| 包装换算 |
PAK_EXC |
N |
0 |
|
|
|
| 净重(单) |
PAK_NW_N |
N |
0 |
|
|
|
| 包装净重 |
PAK_NW |
N |
0 |
|
|
|
| 包装净重单位 |
PAK_WEIGHT_UNIT |
A |
8 |
|
|
|
| 毛重(单) |
PAK_GW_N |
N |
0 |
|
|
|
| 包装毛重 |
PAK_GW |
N |
0 |
|
|
|
| 包装大小 |
PAK_MEAST |
N |
0 |
|
|
|
| 包装大小单位 |
PAK_MEAST_UNIT |
A |
8 |
|
|
|
| 农副产品否 |
CHK_TAX |
A |
1 |
|
|
|
| 有效期 |
VALID_DD |
@ |
0 |
|
|
|
| 包装类型 |
BZ_KND |
A |
20 |
|
|
|
| 注册状态 |
REGSTATE |
A |
10 |
|
|
|
| 反馈信息 |
REG_MSG |
A |
255 |
|
|
|
| 注册码 |
REG_NO |
A |
100 |
|
|
|
| 产品类别 |
REG_TYPE |
A |
1 |
|
|
|
| 功能类型 |
FUN_TYPE_HZ |
A |
4 |
|
|
|
| 功能关联项次 |
FUN_ITM_HZ |
I |
0 |
|
|
|
| 储位代号 |
CHUW |
A |
60 |
|
|
|
| WMS出入库通知量 |
QTY_CRK_WMS |
N |
0 |
|
|
|
| WMS出入库通知量(副) |
QTY1_CRK_WMS |
N |
0 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_DYH_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_DYH_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": "YX20082700000001", //第三方单号，必填
"PGM": "DRPYX", //单据程序代号
"MF_DYH": [ //新增单据表头信息
{
"YH_ID": "YX",
"YH_NO": "YX20082700000001",
"CUR_ID": "",
"DEP": "00000000",
"YH_DD": "2020-08-27 00:00:00",
"CUS_NO": "0008",
"REM": "API产生",
"USR": "ADMIN",
"EST_DD": "2020-08-27 00:00:00",
"PRT_SW": "N",
"SEND_MTH": "1",
"SEND_WH": "0008",
"BIL_TYPE": "",
"SAL_NO": "9999",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"LJ_YX1": "外部单据" //新增单据表头自定义栏位信息
}
],
"TF_DYH": [ //新增单据表身信息
{
"YH_ID": "YX",
"YH_NO": "YX20082700000001",
"ITM": 1,
"PRD_NO": "0001",
"PRD_NAME": "不粘锅",
"PRD_MARK": "",
"WH": "9902",
"EST_DD": "2020-08-27 00:00:00",
"QTY": 10.0,
"UNIT": "1",
"AMT": 1230.0,
"AMTN": 1171.43,
"UP": 123.0,
"TAX": 58.57,
"TAX_RTO": 5.0,
"SUP_PRD_NO": "",
"PRE_ITM": 1,
"CHK_TAX": "F",
"SUP_PRD_NAME": "",
"SUP_PRD_MARK": "",
"SPC": "4L",
"LJ_YX2": 10.0, //新增单据表身自定义栏位信息
"SIZE__NAME": "",
"GOOD__NAME": ""
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_DYH": [ //生成单据表头信息
{
"YH_ID": "YX",
"YH_NO": "YX20082700000002",
"CUR_ID": "",
"DEP": "00000000",
"YH_DD": "2020-08-27 00:00:00",
"CLS_DATE": "2020-08-27 00:00:00",
"CHK_MAN": "ADMIN",
"CUS_NO": "0008",
"REM": "API产生",
"USR": "ADMIN",
"EST_DD": "2020-08-27 00:00:00",
"PRT_SW": "N",
"SYS_DATE": "2020-08-27 16:41:48",
"SEND_MTH": "1",
"SEND_WH": "0008",
"BIL_TYPE": "",
"SAL_NO": "9999",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"LJ_YX1": "外部单据"
}
],
"TF_DYH": [ //生成单据表身信息
{
"YH_ID": "YX",
"YH_NO": "YX20082700000002",
"ITM": 1,
"PRD_NO": "0001",
"PRD_NAME": "不粘锅",
"PRD_MARK": "",
"WH": "9902",
"EST_DD": "2020-08-27 00:00:00",
"QTY": 10.0,
"UNIT": "1",
"AMT": 1230.0,
"AMTN": 1171.43,
"UP": 123.0,
"QTY_OLD": 10.0,
"WH_OLD": "9902",
"EST_OLD": "2020-08-27 00:00:00",
"TAX": 58.57,
"TAX_RTO": 5.0,
"SUP_PRD_NO": "",
"PRE_ITM": 1,
"CHK_TAX": "F",
"SUP_PRD_NAME": "",
"SUP_PRD_MARK": "",
"SPC": "4L",
"LJ_YX2": 10.0
}
],
"MF_DYH_Z": [ //生成单据表头自定义栏位信息
{
"LJ_YX1": "外部单据",
"YH_ID": "YX",
"YH_NO": "YX20082700000002"
}
],
"TF_DYH_Z": [ //生成单据表身自定义栏位信息
{
"LJ_YX2": 10.0,
"YH_ID": "YX",
"YH_NO": "YX20082700000002",
"ITM": 1
}
]
}
}