天心天思数字化API平台

生成【客户询价单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【客户询价单】的生成接口，将第三方客户询价的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【客户询价单】。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/DRPQC/ADDDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 DRPQB 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_QTS
询价/报价区分 QT_ID string 2 是 QB 　
单号 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 是 QB 　
单号 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": "QB20082100000001",    //第三方单号，必填
  "PGM": "DRPQB",       //单据程序代号
  "MF_QTS": [      //新增单据表头信息
    {
      "QT_ID": "QB",
      "QT_NO": "QB20082100000001",
      "CUS_NO1": "0002",
      "TRAD_MTH": "TD20082100000001",
      "QT_DD": "2020-08-21 00:00:00",
      "QT_VOID_DD": "2020-08-21 00:00:00",
      "SAL_NO": "9999",
      "QT_DEP": "00000000",
      "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",
      "SEND_MTH": "1",
      "USR": "ADMIN",
      "CUS_SNM1": "普通客户/厂",
      "LJ_QB1":"API单据"          //新增单据表头自定义信息
    }
  ],
  "TF_QTS": [               //新增单据表身信息
    {
      "QT_ID": "QB",
      "QT_NO": "QB20082100000001",
      "ITM": 1,
      "PRD_NO": "0001",
      "PRD_NAME": "不粘锅",
      "PRD_MARK": "",
      "WH": "9902",
      "UNIT": "1",
      "QTY": 10.0,
      "SEL_ID1": "T",
      "EST_ITM": 2,
      "TAX_RTO1": 5.0,
      "SPC": "4L",
      "TAX_RTO": 5.0,
      "SIZE__NAME": "",
      "GOOD__NAME": "",
      "PRD_NO_NO": "0001",
      "LJ_QB2":10                   //新增单据表身自定义信息
    }
  ]
}

返回结果示例

{
  "code": 0,              //为0表示执行成功，其他表示错误
  "message": "新增成功",            //提示信息
  "data": {
    "MF_QTS": [            //生成单据表头信息
      {
        "QT_ID": "QB",
        "QT_NO": "QB20082100000001",
        "CUS_NO1": "0002",
        "TRAD_MTH": "TD20082100000001",
        "QT_DD": "2020-08-21 00:00:00",
        "QT_VOID_DD": "2020-08-21 00:00:00",
        "SAL_NO": "9999",
        "QT_DEP": "00000000",
        "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",
        "SEND_MTH": "1",
        "USR": "ADMIN",
        "CHK_MAN": "ADMIN",
        "PRT_SW": "N",
        "CLS_DATE": "2020-08-21 00:00:00",
        "SYS_DATE": "2020-08-21 14:55:35",
        "CUS_SNM1": "普通客户/厂",
        "LJ_QB1": "API单据"
      }
    ],
    "TF_QTS": [                 //生成单据表身信息
      {
        "QT_ID": "QB",
        "QT_NO": "QB20082100000001",
        "ITM": 1,
        "QT_DD": "2020-08-21 00:00:00",
        "PRD_NO": "0001",
        "PRD_NAME": "不粘锅",
        "PRD_MARK": "",
        "WH": "9902",
        "UNIT": "1",
        "QTY": 10.0,
        "SEL_ID1": "T",
        "EST_ITM": 2,
        "TAX_RTO1": 5.0,
        "SPC": "4L",
        "TAX_RTO": 5.0,
        "LJ_QB2": 10.0
      }
    ],
    "MF_QTS_Z": [                 //生成单据表头自定义信息
      {
        "LJ_QB1": "API单据",
        "QT_ID": "QB",
        "QT_NO": "QB20082100000001"
      }
    ],
    "TF_QTS_Z": [                  //生成单据表身自定义信息
      {
        "LJ_QB2": 10.0,
        "QT_ID": "QB",
        "QT_NO": "QB20082100000001",
        "ITM": 1
      }
    ]
  }
}