天心天思数字化API平台

生成【请购单】接口

概述

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

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO     是   第三方单号，必填
程序代号 PGM     是 DRPSQ  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_SQ
请购单号 SQ_NO string 20 是   1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
请购日期 SQ_DD datetime   是   格式为：YYYY-MM-DD
请购部门 DEP string 8 是    
采购对象 CUS_NO string 12      
请购人 SAL_NO string 12      
转出单号 PO_NO string 20      
合并转出 INC_ID string 1      
备注 REM string 0      
预交日 EST_DD datetime        
转出单号ID BIL_ID string 2      
录入员 USR string 12 是    
审核人 CHK_MAN string 12      
打印注记 PRT_SW string 1      
拷贝注记 CPY_SW string 1      
批号 BAT_NO string 40      
转出单号 BIL_NO string 20      
终审日期 CLS_DATE datetime        
采购部门 PO_DEP string 8      
结案标志 CLS_ID string 1      
采购单/询价单区分 BACK_ID string 2      
单据类别 BIL_TYPE string 10      
币别 CUR_ID string 4      
汇率 EXC_RTO float        
受订单号 SO_NO string 25      
审核模版 MOB_ID string 10      
锁单人 LOCK_MAN string 12      
锁单时间 LOCK_DATE datetime 0      
输单日期 SYS_DATE datetime        
工程案号 CAS_NO string 20      
阶段编号 TASK_ID integer 0      
受订标识 SO_ID string 2      
打印人员 PRT_USR string 12      
合同编号 CNTT_NO string 40      
作废标记 CANCEL_ID string 1      
打印日期 PRT_DATE datetime 0      
最近修改日期 MODIFY_DD datetime 0      
最近修改人 MODIFY_MAN string 12      
工程人员 CAS_MAN string 12      
数据表TF_SQ
请购单号 SQ_NO string 20 是    
项次 ITM integer   是    
品号 PRD_NO string 30 是    
品名 PRD_NAME string 160      
单位 UNIT string 1 是    
单位名称 UNIT_NAME string 8      
数量 QTY float        
单价 UP float        
预估金额 AMTN float        
预交日 EST_DD datetime        
用途 REM string 200      
核准人 CHK_MAN string 12      
采购对象 CUS_NO string 12      
币别 CUR_ID string 4      
汇率 EXC_RTO float 0      
转出单号ID BIL_ID string 2      
转出单号 BIL_NO string 20      
转出单号项次 BIL_ITM integer        
费用项目 IDX_NO string 20      
副单位数量 QTY1 float        
副单位单价 UP_QTY1 float        
已采购数量 QTY_PO float        
未审核已采购量 QTY_PO_UNSH float 0      
已询价数量 QTY_QS float        
未审核已询价量 QTY_QS_UNSH float 0      
与询价,采购单关联 EST_ITM integer        
货品特征 PRD_MARK string 100      
批号 BAT_NO string 40      
摘要 REMARK string 200      
预估金额(外) AMT float        
鞋服组合栏位 COMPOSE_IDNO string 50      
受订单号 SO_NO string 20      
已调拨数量  QTY_ID float        
库位 WH string 12      
配方号 ID_NO string 38      
对方货号 SUP_PRD_NO string 40      
与受订单EST_ITM关联 EST_ITM_SO integer 0      
受订单ID SO_ID string 2      
已汇总量 QTY_HZ float 0      
未审核已汇总量 QTY_HZ_UNSH float 0      
请购集团公司 DEP string 8      
生产单号 MO_NO string 20      
生产单标识 MO_ID string 2      
来源单ID LY_ID string 2      
来源单号 LY_NO string 20      
来源单项次 LY_ITM integer 0      
替代品 PRD_NO_CHG string 255      
对方特征 SUP_PRD_MARK string 100      
客户订单号 CUS_OS_NO string 30      
是样品 IS_SP string 1      
母件货品 MRP_NOS string 800      
转单标识 TOBILID string 2      
单据回写标识 DOBILID string 2      
价格来源方式 GETUP_FROM string 2      
系统获取单价 UP_GSYSTEM float 0      

4.自定义参数

字段名称 字段代号 类型 长度 是否 固定值 备注
数据表MF_SQ_Z（表头自定义字段）
自定义栏位1 自定义 string 2 　 　 自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。
自定义栏位2 自定义 string 　 　 　
…… …… …… 　 　 　
数据表TF_SQ_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": "TEST20200101001",    //第三方单号，必填
  "PGM": "DRPSQ",        //单据程序代号
  "MF_SQ": [         //新增单据表头信息
    {
      "SQ_NO": "",
      "SQ_DD": "2020-08-25 00:00:00",
      "DEP": "00000000",
      "SAL_NO": "9999",
      "REM": "API产生",
      "USR": "0001",
      "PO_DEP": "00000000",
      "BIL_TYPE": "",
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "LJ_SQ1": "外部单据"        //新增单据表头自定义栏位信息
    }
  ],
  "TF_SQ": [        //新增单据表身信息
    {
      "SQ_NO": "",
      "ITM": 1,
      "PRD_NO": "0001",
      "PRD_NAME": "不粘锅",
      "UNIT": "1",
      "UNIT_NAME": "个",
      "QTY": 20.0,
      "UP": 122.0,
      "AMTN": 2440.0,
      "EST_DD": "2020-08-25 00:00:00",
      "CUS_NO": "",
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "EST_ITM": 1,
      "PRD_MARK": "",
      "AMT": 2440.0,
      "WH": "9902",
      "SPC": "4L",
      "WLGL_UP": "122",
      "LJ_SQ2": 10.0,        //新增单据表身自定义栏位信息
      "SIZE__NAME": "",
      "GOOD__NAME": "",
      "PRD_NO_NO": "0001"
    }
  ]
}

返回结果示例

{
  "code": 0,           //为0表示执行成功，其他表示错误
  "message": "新增成功",       //提示信息
  "data": {
    "MF_SQ": [            //生成单据表头信息
      {
        "SQ_NO": "SQ20082500000001",
        "SQ_DD": "2020-08-25 00:00:00",
        "DEP": "00000000",
        "SAL_NO": "9999",
        "REM": "API产生",
        "USR": "0001",
        "CHK_MAN": "0001",
        "PRT_SW": "N",
        "CLS_DATE": "2020-08-25 00:00:00",
        "PO_DEP": "00000000",
        "CLS_ID": "F",
        "BIL_TYPE": "",
        "CUR_ID": "",
        "EXC_RTO": 1.0,
        "SYS_DATE": "2020-08-25 10:57:33",
        "LJ_SQ1": "外部单据"
      }
    ],
    "TF_SQ": [             //生成单据表身信息
      {
        "SQ_NO": "SQ20082500000001",
        "ITM": 1,
        "PRD_NO": "0001",
        "PRD_NAME": "不粘锅",
        "UNIT": "1",
        "UNIT_NAME": "个",
        "QTY": 20.0,
        "UP": 122.0,
        "AMTN": 2440.0,
        "EST_DD": "2020-08-25 00:00:00",
        "CUS_NO": "",
        "CUR_ID": "",
        "EXC_RTO": 1.0,
        "EST_ITM": 1,
        "PRD_MARK": "",
        "AMT": 2440.0,
        "WH": "9902",
        "SPC": "4L",
        "WLGL_UP": "122",
        "LJ_SQ2": 10.0
      }
    ],
    "MF_SQ_Z": [            //生成单据表头自定义栏位信息
      {
        "LJ_SQ1": "外部单据",
        "SQ_NO": "SQ20082500000001"
      }
    ],
    "TF_SQ_Z": [             //生成单据表身自定义栏位信息
      {
        "LJ_SQ2": 10.0,
        "SQ_NO": "SQ20082500000001",
        "ITM": 1
      }
    ]
  }
}