概述
该接口主要用于第三方平台或自主研发者，通过调用【询价单】的生成接口，将第三方向供应商询价的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【询价单】。
参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://ERPAPI站点/DRPQS/ADDDATA |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
| Authorization |
token |
授权接口所获取的值 |
3.请求参数
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号，必填 |
| 程序代号 |
PGM |
|
|
是 |
DRPQS |
|
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 数据表MF_QTS |
| 询价/报价区分 |
QT_ID |
string |
2 |
是 |
QS |
|
| 单号 |
QT_NO |
string |
20 |
是 |
|
1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
| 批号 |
BAT_NO |
string |
40 |
|
|
|
| 客户甲 |
CUS_NO1 |
string |
12 |
是 |
|
|
| 厂商/客户乙 |
CUS_NO2 |
string |
12 |
|
|
|
| 厂商/客户丙 |
CUS_NO3 |
string |
12 |
|
|
|
| 贸易方式 |
TRAD_MTH |
string |
20 |
|
|
|
| 日期 |
QT_DD |
datetime |
|
是 |
|
格式为：YYYY-MM-DD |
| 有效日期 |
QT_VOID_DD |
datetime |
|
|
|
|
| 业务员代号 |
SAL_NO |
string |
12 |
是 |
|
|
| 部门代号 |
QT_DEP |
string |
8 |
是 |
|
|
| 币别 |
CUR_ID |
string |
4 |
|
|
|
| 汇率 |
EXC_RTO |
float |
|
|
|
|
| 入历史单价否 |
HIS_PRICE |
string |
1 |
|
|
|
| 折扣 |
DIS_CNT |
float |
|
|
|
|
| 送货仓 |
SEND_WH |
string |
12 |
|
|
|
| 送货地址 |
ADR |
string |
50 |
|
|
|
| 课税别 |
TAX_ID |
string |
1 |
|
|
|
| 交易类别(甲) |
PAY_MTH |
string |
1 |
|
|
|
| 起算日(甲) |
PAY_DAYS |
integer |
|
|
|
|
| 间隔天数(甲) |
INT_DAYS |
integer |
|
|
|
|
| 票据天数(甲) |
CHK_DAYS |
integer |
|
|
|
|
| 交易摘要(甲) |
PAY_REM |
string |
80 |
|
|
|
| 结帐期(甲) |
PAY_DD |
datetime |
|
|
|
|
| 票据到期日(甲) |
CHK_DD |
datetime |
|
|
|
|
| 送货方式 |
SEND_MTH |
string |
200 |
|
|
|
| 联络人 |
CNT_MAN |
string |
30 |
|
|
|
| 登录人 |
REG_MAN |
string |
12 |
|
|
|
| 保留 |
OK_MAN |
string |
12 |
|
|
|
| 采购/受订单号 |
OS_NO |
string |
20 |
|
|
|
| 摘要 |
REM |
string |
50 |
|
|
|
| 录入员 |
USR |
string |
12 |
|
|
|
| 审核注记 |
CHK_MAN |
string |
12 |
|
|
|
| 打印注记 |
PRT_SW |
string |
1 |
|
|
|
| 拷贝注记 |
CPY_SW |
string |
1 |
|
|
|
| 内外销注记 |
INOUT_ID |
string |
1 |
|
|
|
| 指定结帐日资料(甲) |
CLS_REM |
string |
30 |
|
|
|
| 转入单号 |
SQ_NO |
string |
20 |
|
|
|
| 转入ID |
BIL_ID |
string |
2 |
|
|
|
| 缺料单号 |
BIL_NO |
string |
20 |
|
|
|
| 终审日期 |
CLS_DATE |
datetime |
|
|
|
|
| 单据类别 |
BIL_TYPE |
string |
10 |
|
|
|
| 交易类别(乙) |
PAY_MTH2 |
string |
1 |
|
|
|
| 起算日(乙) |
PAY_DAYS2 |
integer |
|
|
|
|
| 间隔天数(乙) |
INT_DAYS2 |
integer |
|
|
|
|
| 票据天数(乙) |
CHK_DAYS2 |
integer |
|
|
|
|
| 交易摘要(乙) |
PAY_REM2 |
string |
80 |
|
|
|
| 结帐期(乙) |
PAY_DD2 |
datetime |
|
|
|
|
| 票据到期日(乙) |
CHK_DD2 |
datetime |
|
|
|
|
| 交易类别(丙) |
PAY_MTH3 |
string |
1 |
|
|
|
| 起算日(丙) |
PAY_DAYS3 |
integer |
|
|
|
|
| 间隔天数(丙) |
INT_DAYS3 |
integer |
|
|
|
|
| 票据天数(丙) |
CHK_DAYS3 |
integer |
|
|
|
|
| 交易摘要(丙) |
PAY_REM3 |
string |
80 |
|
|
|
| 结帐期(丙) |
PAY_DD3 |
datetime |
|
|
|
|
| 票据到期日(丙) |
CHK_DD3 |
datetime |
|
|
|
|
| 审核模版 |
MOB_ID |
string |
10 |
|
|
|
| 锁单人 |
LOCK_MAN |
string |
12 |
|
|
|
| 锁单时间 |
LOCK_DATE |
datetime |
0 |
|
|
|
| 输单日期 |
SYS_DATE |
datetime |
|
|
|
|
| 链接文档 |
CONTRACT |
string |
80 |
|
|
|
| 工程案号 |
CAS_NO |
string |
20 |
|
|
|
| 阶段编号 |
TASK_ID |
integer |
0 |
|
|
|
| 指定结帐日资料(乙) |
CLS_REM2 |
string |
30 |
|
|
|
| 指定结帐日资料(丙) |
CLS_REM3 |
string |
30 |
|
|
|
| 打印人员 |
PRT_USR |
string |
12 |
|
|
|
| 作废标记 |
CANCEL_ID |
string |
1 |
|
|
|
| 客户/厂商订单 |
CUS_OS_NO |
string |
30 |
|
|
|
| 商机代号 |
OPPCASE_NO |
integer |
0 |
|
|
|
| 打印日期 |
PRT_DATE |
datetime |
0 |
|
|
|
| 会员卡号 |
CARD_NO |
string |
20 |
|
|
|
| 淘宝子订单号 |
TB_OID |
string |
20 |
|
|
|
| 联系人1 |
CNT_MAN1 |
string |
20 |
|
|
|
| 最近修改日期 |
MODIFY_DD |
datetime |
0 |
|
|
|
| 最近修改人 |
MODIFY_MAN |
string |
12 |
|
|
|
| 离线单唯一ID |
QT_GUID |
string |
50 |
|
|
|
| 活动收款单号 |
SK_NO |
string |
20 |
|
|
|
| 更新会员收货信息 |
UPD_ADR |
string |
1 |
|
|
|
| 作废人 |
CANCEL_USR |
string |
12 |
|
|
|
| 作废时间 |
CANCEL_DD |
datetime |
0 |
|
|
|
| 费用单号 |
EP_NO |
string |
20 |
|
|
|
| 数据表TF_QTS |
| 询价/报价区分 |
QT_ID |
string |
2 |
是 |
QS |
|
| 单号 |
QT_NO |
string |
20 |
是 |
|
必须与表头MF_QTS的QT_NO相同 |
| 项次 |
ITM |
integer |
|
是 |
|
|
| 日期 |
QT_DD |
datetime |
|
是 |
|
必须与表头MF_QTS的QT_DD相同 |
| 货品代号 |
PRD_NO |
string |
30 |
是 |
|
|
| 货品名称 |
PRD_NAME |
string |
160 |
|
|
|
| 货品特征 |
PRD_MARK |
string |
100 |
|
|
|
| 库位 |
WH |
string |
12 |
|
|
|
| 单位 |
UNIT |
string |
1 |
是 |
|
|
| 数量 |
QTY |
float |
|
|
|
|
| 副单位数量 |
QTY1 |
float |
|
|
|
|
| 甲厂商单价 |
UP1 |
float |
|
|
|
|
| 甲厂商本位币金额 |
AMTN1 |
float |
|
|
|
|
| 甲厂商外币金额 |
AMT1 |
float |
|
|
|
|
| 甲厂商税额 |
TAX1 |
float |
|
|
|
|
| 乙厂商税额 |
TAX2 |
float |
|
|
|
|
| 丙厂商税额 |
TAX3 |
float |
|
|
|
|
| 甲厂商折扣 |
DIS_CNT1 |
float |
|
|
|
|
| 甲厂商成交否 |
SEL_ID1 |
string |
1 |
是 |
|
|
| 乙厂商单价 |
UP2 |
float |
|
|
|
|
| 乙厂商本位币金额 |
AMTN2 |
float |
|
|
|
|
| 乙厂商外币金额 |
AMT2 |
float |
|
|
|
|
| 乙厂商折扣 |
DIS_CNT2 |
float |
|
|
|
|
| 乙厂商成交否 |
SEL_ID2 |
string |
1 |
|
|
|
| 丙厂商单价 |
UP3 |
float |
|
|
|
|
| 丙厂商本位币金额 |
AMTN3 |
float |
|
|
|
|
| 丙厂商外币金额 |
AMT3 |
float |
|
|
|
|
| 丙厂商折扣 |
DIS_CNT3 |
float |
|
|
|
|
| 丙厂商成交否 |
SEL_ID3 |
string |
1 |
|
|
|
| 包装单位 |
PAK_UNIT |
string |
20 |
|
|
|
| 包装换算 |
PAK_EXC |
float |
|
|
|
|
| 包装净重 |
PAK_NW |
float |
|
|
|
|
| 包装净重单位 |
PAK_WEIGHT_UNIT |
string |
8 |
|
|
|
| 包装毛重 |
PAK_GW |
float |
|
|
|
|
| 包装大小 |
PAK_MEAST |
float |
|
|
|
|
| 包装大小单位 |
PAK_MEAST_UNIT |
string |
8 |
|
|
|
| 有效期 |
VALID_DD |
datetime |
|
|
|
|
| 摘要 |
REM |
string |
1000 |
|
|
|
| 抽成金额 |
AMTN_COM |
float |
|
|
|
|
| 预交日 |
EST_DD |
datetime |
|
|
|
|
| 副单位单价1 |
UP_QTY1 |
float |
|
|
|
|
| 副单位单价2 |
UP_QTY2 |
float |
|
|
|
|
| 副单位单价3 |
UP_QTY3 |
float |
|
|
|
|
| 配方号 |
ID_NO |
string |
38 |
|
|
|
| 与请购单关联 |
EST_ITM |
integer |
|
|
|
|
| 与采购单关联 |
OTH_ITM |
integer |
|
|
|
|
| 请购单ID |
SQ_ID |
string |
2 |
|
|
|
| 请购单;客户询价单 |
SQ_NO |
string |
20 |
|
|
|
| 已采购量 |
QTY_PO |
float |
0 |
|
|
|
| 未审核已采购量 |
QTY_PO_UNSH |
float |
0 |
|
|
|
| 包装类型 |
BZ_KND |
string |
20 |
|
|
|
| 对方货号 |
SUP_PRD_NO |
string |
40 |
|
|
|
| 鞋服组合栏位 |
COMPOSE_IDNO |
string |
50 |
|
|
|
| 批号 |
BAT_NO |
string |
40 |
|
|
|
| 已转核价单 |
TO_HJ |
string |
1 |
|
|
|
| 已转核价单2 |
TO_HJ2 |
string |
1 |
|
|
|
| 已转核价单3 |
TO_HJ3 |
string |
1 |
|
|
|
| 对方货号乙 |
SUP_PRD_NO2 |
string |
40 |
|
|
|
| 对方货号丙 |
SUP_PRD_NO3 |
string |
40 |
|
|
|
| 图片路径 |
PICPATH |
string |
128 |
|
|
|
| 生产单号 |
MO_NO |
string |
20 |
|
|
|
| 生产单标识 |
MO_ID |
string |
2 |
|
|
|
| 来源单ID |
LY_ID |
string |
2 |
|
|
|
| 来源单号 |
LY_NO |
string |
20 |
|
|
|
| 来源单项次 |
LY_ITM |
integer |
0 |
|
|
|
| 客户/厂商订单 |
CUS_OS_NO |
string |
30 |
|
|
|
| 搭赠注记 |
FREE_ID |
string |
1 |
|
|
|
| 对方特征 |
SUP_PRD_MARK |
string |
100 |
|
|
|
| 对方特征乙 |
SUP_PRD_MARK2 |
string |
100 |
|
|
|
| 对方特征丙 |
SUP_PRD_MARK3 |
string |
100 |
|
|
|
| 来源询价单号 |
QS_NO |
string |
20 |
|
|
|
| 来源询价单唯一项次 |
QS_ITM |
integer |
0 |
|
|
|
| 回价否 |
CHK_PRICE |
string |
1 |
|
|
|
| 原采购业务员 |
SAL_NO_PO |
string |
100 |
|
|
|
| 是样品 |
IS_SP |
string |
1 |
|
|
|
| 母件货品 |
MRP_NOS |
string |
800 |
|
|
|
| 税率1 |
TAX_RTO1 |
float |
0 |
|
|
|
| 税率2 |
TAX_RTO2 |
float |
0 |
|
|
|
| 税率3 |
TAX_RTO3 |
float |
0 |
|
|
|
| 已询价量 |
QTY_QS |
float |
0 |
|
|
|
| 未审核已询价量 |
QTY_QS_UNSH |
float |
0 |
|
|
|
| 折扣额 |
AMT_DIS_CNT1 |
float |
0 |
|
|
|
| 折扣额 |
AMT_DIS_CNT2 |
float |
0 |
|
|
|
| 折扣额 |
AMT_DIS_CNT3 |
float |
0 |
|
|
|
| 是否定价政策搭赠品 |
FREE_ID_DEF |
string |
1 |
|
|
|
| 受订单号 |
SO_NO |
string |
20 |
|
|
|
| 受订项次 |
EST_ITM_SO |
integer |
0 |
|
|
|
| 制程代号 |
ZC_NO |
string |
10 |
|
|
|
| 预开工日 |
STA_DD |
datetime |
0 |
|
|
|
| 标准模板代号 |
XPM_NO |
string |
20 |
|
|
|
| 自选模板代号 |
XPM_NO1 |
string |
20 |
|
|
|
| 销售单价 |
UP_SALE |
string |
20 |
|
|
|
| 活动单价 |
UP_CAS |
float |
0 |
|
|
|
| 活动单价(副) |
UP_QTY1_CAS |
float |
0 |
|
|
|
| 活动总价 |
AMTN_CAS |
float |
0 |
|
|
|
| 淘宝子订单号 |
TB_OID |
string |
30 |
|
|
|
| 农副产品否 |
CHK_TAX |
string |
1 |
|
|
|
| 颜色显示单价 |
UP_SHOWCOL |
float |
0 |
|
|
|
| 已报价分析 |
BFFLAG |
string |
1 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_QTS_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_QTS_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": "QS20082100000001", //第三方单号，必填
"PGM": "DRPQS", //单据程序代号
"MF_QTS": [ //新增单据表头信息
{
"QT_ID": "QS",
"QT_NO": "QS20082100000001",
"CUS_NO1": "C1000",
"CUS_NO2": "A0001",
"TRAD_MTH": "TD20082100000001",
"QT_DD": "2020-08-21 00:00:00",
"SAL_NO": "9999",
"QT_DEP": "A",
"CUR_ID": "",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"INT_DAYS": 30,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
"PAY_DD": "2020-09-01 00:00:00",
"CHK_DD": "2020-10-01 00:00:00",
"REM": "API产生",
"USR": "ADMIN",
"PAY_MTH2": "1",
"PAY_DAYS2": 1,
"INT_DAYS2": 30,
"CHK_DAYS2": 30,
"PAY_REM2": "结帐期:2020-09-01;票据到期日:2020-10-01",
"PAY_DD2": "2020-09-01 00:00:00",
"CHK_DD2": "2020-10-01 00:00:00",
"LJ_QS1":"API单据" //新增单据表头自定义栏位信息
}
],
"TF_QTS": [ //新增单据表身信息
{
"QT_ID": "QS",
"QT_NO": "QS20082100000001",
"ITM": 1,
"PRD_NO": "0001",
"PRD_NAME": "不粘锅",
"PRD_MARK": "",
"WH": "9902",
"UNIT": "1",
"QTY": 10.0,
"UP1": 122.0,
"AMTN1": 1161.9,
"AMT1": 1220.0,
"TAX1": 58.1,
"TAX2": 58.1,
"TAX3": 0.0,
"SEL_ID1": "T",
"UP2": 122.0,
"AMTN2": 1161.9,
"AMT2": 1220.0,
"SEL_ID2": "F",
"AMTN3": 0.0,
"AMT3": 0.0,
"SEL_ID3": "F",
"OTH_ITM": 1,
"SPC": "4L",
"CHK_TAX": "F",
"TAX_RTO": 5.0,
"WLGL_UP1": "122.0000",
"SIZE__NAME": "",
"GOOD__NAME": "",
"PRD_NO_NO": "0001",
"LJ_QS2":10 //新增单据表身自定义栏位信息
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_QTS": [ //生成单据表头信息
{
"QT_ID": "QS",
"QT_NO": "QS20082100000001",
"CUS_NO1": "C1000",
"CUS_NO2": "A0001",
"TRAD_MTH": "TD20082100000001",
"QT_DD": "2020-08-21 00:00:00",
"SAL_NO": "9999",
"QT_DEP": "A",
"CUR_ID": "",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"INT_DAYS": 30,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
"PAY_DD": "2020-09-01 00:00:00",
"CHK_DD": "2020-10-01 00:00:00",
"REM": "API产生",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2020-08-21 00:00:00",
"PAY_MTH2": "1",
"PAY_DAYS2": 1,
"INT_DAYS2": 30,
"CHK_DAYS2": 30,
"PAY_REM2": "结帐期:2020-09-01;票据到期日:2020-10-01",
"PAY_DD2": "2020-09-01 00:00:00",
"CHK_DD2": "2020-10-01 00:00:00",
"SYS_DATE": "2020-08-21 16:07:57",
"LJ_QS1": "API单据"
}
],
"TF_QTS": [ //生成单据表身信息
{
"QT_ID": "QS",
"QT_NO": "QS20082100000001",
"ITM": 1,
"QT_DD": "2020-08-21 00:00:00",
"PRD_NO": "0001",
"PRD_NAME": "不粘锅",
"PRD_MARK": "",
"WH": "9902",
"UNIT": "1",
"QTY": 10.0,
"UP1": 122.0,
"AMTN1": 1161.9,
"AMT1": 1220.0,
"TAX1": 58.1,
"TAX2": 58.1,
"TAX3": 0.0,
"SEL_ID1": "T",
"UP2": 122.0,
"AMTN2": 1161.9,
"AMT2": 1220.0,
"SEL_ID2": "F",
"AMTN3": 0.0,
"AMT3": 0.0,
"SEL_ID3": "F",
"OTH_ITM": 1,
"CHK_PRICE": "F",
"SPC": "4L",
"CHK_TAX": "F",
"TAX_RTO": 5.0,
"WLGL_UP1": "122.0000",
"LJ_QS2": 10.0
}
],
"MF_QTS_Z": [ //生成单据表头自定义栏位信息
{
"LJ_QS1": "API单据",
"QT_ID": "QS",
"QT_NO": "QS20082100000001"
}
],
"TF_QTS_Z": [ //生成单据表身自定义栏位信息
{
"LJ_QS2": 10.0,
"QT_ID": "QS",
"QT_NO": "QS20082100000001",
"ITM": 1
}
]
}
}