天心天思数字化API平台

生成【调拨申请单】接口

概述

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

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 DRPDS 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_DS
申请标识 DS_ID string 2 是 DS 　
调拨申请单号 DS_NO string 20 是 　 1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
调拨日期 DS_DD datetime 0 是 　 格式为：YYYY-MM-DD
批号 BAT_NO string 40 　 　 　
摘要 REM string 0 　 　 　
录入员 USR string 12 是 　 　
审核注记 CHK_MAN string 12 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
终审日期 CLS_DATE datetime 0 　 　 　
部门 DEP string 8 是 　 　
汇率 EXC_RTO float 0 　 　 　
币别 CUR_ID string 4 　 　 　
包装方式 SPC_ID string 10 　 　 　
成本别 FIX_CST string 1 是 　 1固定成本；2变动成本
经办人 SAL_NO string 12 　 　 　
调拨单号 IC_NO string 20 　 　 　
单据种类 BIL_TYPE string 10 　 　 　
审核模版 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
输单日期 SYS_DATE datetime 0 　 　 　
来源单别 BIL_ID string 2 　 　 　
来源单号 BIL_NO string 20 　 　 　
结案标志 CLS_ID string 1 　 　 　
打印人员 PRT_USR string 12 　 　 　
申请数量 QTY float 0 　 　 　
调拨注记 MC_ID string 1 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
区域代号 AREA_NO string 20 　 　 　
送货地址 SHDZ string 200 　 　 　
费用代号 FEE_ID string 10 　 　 　
报销项目 FY_ID string 12 　 　 　
工程案号 CAS_NO string 20 　 　 　
阶段编号 TASK_ID integer 0 　 　 　
拨出部门 OUTDEP string 8 　 　 　
数据表TF_DS
申请标识 DS_ID string 2 是 　 必须与MF_DS的DS_ID相同
调拨申请单号 DS_NO string 20 是 　 必须与MF_DS的DS_NO相同
项次 ITM integer 0 是 　 　
日期 DS_DD datetime 0 是 　 　
货品代号 PRD_NO string 30 是 　 　
出库特征 PRD_MARK string 100 　 　 　
单位 UNIT string 1 是 　 　
数量 QTY float 0 　 　 　
副单位数量 QTY1 float 0 　 　 　
销货库位 WH1 string 12 是 　 　
入货库位 WH2 string 12 是 　 　
出库批号 BAT_NO string 40 　 　 　
备注 REM string 50 　 　 　
入库批号 BAT_NO2 string 40 　 　 　
单价 UP float 0 　 　 　
金额 AMTN float 0 　 　 　
部门 DEP string 8 　 　 　
单据标识 BIL_ID string 2 　 　 　
转入单据号码 BIL_NO string 20 　 　 　
制令单号 MO_NO string 20 　 　 　
受订单号 SO_NO string 20 　 　 　
成本别 FIX_CST string 1 是 　 必须与MF_DS的FIX_CST相同
成本 CST float 0 　 　 　
标准成本 CST_STD float 0 　 　 　
项次 EST_ITM integer 0 　 　 　
单据历次变动项次 PRE_ITM integer 0 　 　 　
已调拨量 QTY_PS float 0 　 　 　
已调拨量(未审核) QTY_PS_UNSH float 0 　 　 　
INVOICE 号码 INVO_NO string 20 　 　 　
报关号码 ZK_NO string 20 　 　 　
版本 REV string 10 　 　 　
请购单号 SQ_NO string 20 　 　 　
已调拨量(副) QTY1_PS float 0 　 　 　
已调拨量(副)未审核 QTY1_PS_UNSH float 0 　 　 　
成品代号 MRP_NO string 30 　 　 　
调拨申请套数 QTY_DM float 0 　 　 　
入库特征 PRD_MARK2 string 100 　 　 　
配方号 ID_NO string 38 　 　 　
单位标准成本 UP_STD float 0 　 　 　
货品名称 PRD_NAME string 160 　 　 　
包装数量 QTY_BZ float 0 　 　 　
包装单位 UNIT_BZ string 8 　 　 　
已发货量 QTY_FH float 0 　 　 　
未审核发货量 QTY_FH_UNSH float 0 　 　 　
预交日 EST_DD datetime 0 　 　 　
已分配量 QTY_HGFP float 0 　 　 　
已分配足米量 QTY_HGFP_ZM float 0 　 　 　
需足量 CHK_XZL string 1 　 　 　
已转计划量 QTY_JH float 0 　 　 　
已转未审核计划量 QTY_JH_UNSH float 0 　 　 　
销货储位代号 CHUW1 string 60 　 　 　
入货储位代号 CHUW2 string 60 　 　 　
包装单位 PAK_UNIT string 20 　 　 　
包装换算 PAK_EXC float 0 　 　 　
包装净重 PAK_NW float 0 　 　 　
包装净重单位 PAK_WEIGHT_UNIT string 8 　 　 　
包装毛重 PAK_GW float 0 　 　 　
包装大小 PAK_MEAST float 0 　 　 　
包装大小单位 PAK_MEAST_UNIT string 8 　 　 　
WMS出入库通知量 QTY_CRK_WMS float 0 　 　 　
WMS出入库通知量(副) QTY1_CRK_WMS float 0 　 　 　

请求JSON示例

{
  "REF_NO": "DS20082600000001",      //第三方单号，必填
  "PGM": "DRPDS",      //单据程序代号
  "MF_DS": [      //新增单据表头信息
    {
      "DS_ID": "DS",
      "DS_NO": "DS20082600000001",
      "DS_DD": "2020-08-26 00:00:00",
      "REM": "API产生",
      "USR": "ADMIN",
      "DEP": "00000000",
      "OUTDEP": "00000000",
      "FIX_CST": "1",
      "SAL_NO": "9999",
      "BIL_TYPE": "",
      "LJ_DS1": "外部单据"      //新增单据表头自定义栏位信息
    }
  ],
  "TF_DS": [      //新增单据表身信息
    {
      "DS_ID": "DS",
      "DS_NO": "DS20082600000001",
      "ITM": 1,
      "DS_DD": "2020-08-26 00:00:00",
      "PRD_NO": "0001",
      "PRD_MARK": "",
      "UNIT": "1",
      "QTY": 11.0,
      "WH1": "9902",
      "WH2": "9901",
      "UP": 111.7738,
      "AMTN": 1229.5118,
      "FIX_CST": "1",
      "CST": 1229.5118,
      "CST_STD": 0.0,
      "PRE_ITM": 1,
      "UP_STD": 0.0,
      "PRD_NAME": "不粘锅",
      "CHK_XZL": "T",
      "WH_QTY": "311.00000000",
      "PRD_NO_NO": "0001",
      "LJ_DS2": 10.0,      //新增单据表身自定义栏位信息
      "SIZE__NAME": "",
      "GOOD__NAME": ""
    }
  ]
}

返回结果示例

{
  "code": 0,            //为0表示执行成功，其他表示错误
  "message": "新增成功",         //提示信息
  "data": {
    "MF_DS": [               //生成单据表头信息
      {
        "DS_ID": "DS",
        "DS_NO": "DS20082600000001",
        "DS_DD": "2020-08-26 00:00:00",
        "REM": "API产生",
        "USR": "ADMIN",
        "CHK_MAN": "ADMIN",
        "CLS_DATE": "2020-08-26 00:00:00",
        "DEP": "00000000",
        "OUTDEP": "00000000",
        "FIX_CST": "1",
        "SAL_NO": "9999",
        "BIL_TYPE": "",
        "SYS_DATE": "2020-08-26 11:51:58",
        "LJ_DS1": "外部单据"
      }
    ],
    "TF_DS": [           //生成单据表身信息
      {
        "DS_ID": "DS",
        "DS_NO": "DS20082600000001",
        "ITM": 1,
        "DS_DD": "2020-08-26 00:00:00",
        "PRD_NO": "0001",
        "PRD_MARK": "",
        "UNIT": "1",
        "QTY": 11.0,
        "WH1": "9902",
        "WH2": "9901",
        "UP": 111.7738,
        "AMTN": 1229.5118,
        "FIX_CST": "1",
        "CST": 1229.5118,
        "CST_STD": 0.0,
        "PRE_ITM": 1,
        "PRD_MARK2": "",
        "UP_STD": 0.0,
        "PRD_NAME": "不粘锅",
        "CHK_XZL": "T",
        "WH_QTY": "311.00000000",
        "PRD_NO_NO": "0001",
        "LJ_DS2": 10.0
      }
    ],
    "MF_DS_Z": [            //生成单据表头自定义栏位信息
      {
        "LJ_DS1": "外部单据",
        "DS_ID": "DS",
        "DS_NO": "DS20082600000001"
      }
    ],
    "TF_DS_Z": [                //生成单据表身自定义栏位信息
      {
        "LJ_DS2": 10.0,
        "DS_ID": "DS",
        "DS_NO": "DS20082600000001",
        "ITM": 1
      }
    ]
  }
}