天心天思数字化API平台

生成【暂估单】接口

概述

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

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 DRPZG 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_ZG
暂估ID ZG_ID string 2 是 ZG 　
暂估单号 ZG_NO string 20 是 　 1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
暂估日期 ZG_DD datetime 　 是 　 格式为：YYYY-MM-DD
贸易方式 TRAD_MTH string 20 　 　 　
批号 BAT_NO string 40 　 　 　
厂商代号 CUS_NO string 12 是 　 　
凭证模版 VOH_ID string 2 　 　 　
凭证号码 VOH_NO string 20 　 　 　
部门 DEP string 8 是 　 　
扣税类别 TAX_ID string 1 是 　 　
转入单ID OS_ID string 2 　 　 　
转入单号 OS_NO string 25 　 　 　
交货方式 SEND_MTH string 200 　 　 　
送货仓 SEND_WH string 12 　 　 　
立帐方式 ZHANG_ID string 1 是 　 　
币别 CUR_ID string 4 　 　 　
汇率 EXC_RTO float 　 　 　 　
业务员代号 SAL_NO string 12 是 　 　
送货地址 ADR string 1 　 　 　
备注 REM string 1 　 　 　
交易类别 PAY_MTH string 1 　 　 　
起算日 PAY_DAYS integer 　 　 　 　
票据天数 CHK_DAYS integer 　 　 　 　
交易摘要 PAY_REM string 80 　 　 　
结帐期 PAY_DD datetime 　 　 　 　
票据到期日 CHK_DD datetime 　 　 　 　
间隔天数 INT_DAYS integer 　 　 　 　
指定结帐日资料 CLS_REM string 30 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
全表折扣 DIS_CNT float 　 　 　 　
合同号 CONTRACT string 80 　 　 　
外币金额合计 AMT float 　 　 　 　
终审日期 CLS_DATE datetime 　 　 　 　
客户订单号 CUS_OS_NO string 30 　 　 　
单据类别 BIL_TYPE string 10 　 　 　
工程案号 CAS_NO string 20 　 　 　
结案标志 CLS_ID string 1 　 　 　
暂估单自动结案回写 CLSID string 1 　 　 　
制单人 USR string 12 　 　 　
审核人 CHK_MAN string 12 　 　 　
暂估转进货 ZB_NO string 20 　 　 　
回冲暂估凭证标志 HC_ID string 1 　 　 　
来源单ID BIL_ID string 2 　 　 　
来源单号 BIL_NO string 25 　 　 　
退回量影响采购单 PO_ID string 1 　 　 　
审核模版 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
附件张数 FJ_NUM integer 　 　 　 　
输单日期 SYS_DATE datetime 　 　 　 　
任务编号 TASK_ID integer 0 　 　 　
打印人员 PRT_USR string 12 　 　 　
合同编号 CNTT_NO string 40 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
首付比例 RTO_FQSK float 0 　 　 　
首付日期方式 DATEFLAG_FQSK string 1 　 　 　
首付指定日期 DATE_FQSK datetime 0 　 　 　
期数 QS_FQSK integer 0 　 　 　
功能货币 CUR_ID_IFRS string 4 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
金额小数位数 AMT_POI integer 0 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
扫描状态 SCAN_ID string 1 　 　 　
扫描人 SCAN_USR string 12 　 　 　
扫描日期 SCAN_DATE datetime 0 　 　 　
赎单单号 SG_NO string 20 　 　 　
赎单单据类别 SG_ID string 2 　 　 　
自定义凭证模版 VOH_ID_ZDY integer 0 　 　 　
影响采购单中的收料数量 SL_ID string 1 　 　 　
WMS产生的单据 WMS_ID string 1 　 　 　
数据表TF_ZG
暂估ID ZG_ID string 2 是 ZG 　
暂估单号 ZG_NO string 20 是 　 必须与表头MF_ZG的ZG_NO相同
项次 ITM integer 　 是 　 　
暂估日期 ZG_DD datetime 　 是 　 必须与表头MF_ZG的ZG_DD相同
库位 WH string 12 是 　 　
批号 BAT_NO string 40 　 　 　
转入单号 OS_NO string 25 　 　 　
货品代号 PRD_NO string 30 是 　 　
货品名称 PRD_NAME string 160 　 　 　
货品特征 PRD_MARK string 100 　 　 　
单位 UNIT string 1 是 　 　
数量 QTY float 　 　 　 　
数量(副) QTY1 float 　 　 　 　
单价 UP float 　 　 　 　
未税本位币 AMTN_NET float 　 　 　 　
外币金额 AMT float 　 　 　 　
税额 TAX float 　 　 　 　
折扣 DIS_CNT float 　 　 　 　
转进货数量 QTY_PC float 　 　 　 　
未审核转进货量 QTY_PC_UNSH float 0 　 　 　
包装单位 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 　 　 　
税率 TAX_RTO float 　 　 　 　
标准成本 CST_STD float 　 　 　 　
单价(副) UP_QTY1 float 　 　 　 　
追踪已交数量项次 EST_ITM integer 　 　 　 　
转入单ID OS_ID string 2 　 　 　
送货仓 SEND_WH string 12 　 　 　
损耗量 QTY_LOSS float 　 　 　 　
损耗量(副) QTY1_LOSS float 0 　 　 　
配方号 ID_NO string 38 　 　 　
包装类型 BZ_KND string 20 　 　 　
入库单项次 OTH_ITM integer 　 　 　 　
厂商订单号 CUS_OS_NO string 30 　 　 　
农副产品否 CHK_TAX string 1 　 　 　
对方货号 SUP_PRD_NO string 40 　 　 　
是搭赠货品 FREE_ID string 1 　 　 　
抽成金额 AMTN_COM float 　 　 　 　
截取采购数量 QTY_PS float 　 　 　 　
入库单号 RK_NO string 20 　 　 　
已退数量 QTY_RTN float 　 　 　 　
未审核已退数量 QTY_RTN_UNSH float 0 　 　 　
关联入库单项次 TI_ITM integer 　 　 　 　
验收单号 CK_NO string 20 　 　 　
收料单号 SL_NO string 20 　 　 　
送货单号 SH_NO_CUS string 20 　 　 　
PRE_ITM PRE_ITM integer 　 　 　 　
合格标志[T0,T2,Q0,Q2] QC_FLAG string 2 　 　 　
追踪检验单项次(PRE_ITM) QC_ITM integer 0 　 　 　
入库日期 RK_DD datetime 0 　 　 　
集团公司代号 DEP_RK string 8 　 　 　
配位项次 PW_ITM integer 0 　 　 　
收料项次 SL_ITM integer 0 　 　 　
原料成本(标) CST_STD_ML float 0 　 　 　
直接人工(标) CST_SMAN float 0 　 　 　
耗用物料(标) CST_SPRD float 0 　 　 　
制造费用(标) CST_SMAK float 0 　 　 　
托工费用(标) CST_SOUT float 0 　 　 　
暂估成本 CST float 0 　 　 　
单位成本(主单位) UP_MAIN float 0 　 　 　
生产日期 PRODU_DD datetime 0 　 　 　
是否定价政策搭赠品 FREE_ID_DEF string 1 　 　 　
单位标准成本 UP_STD float 0 　 　 　
对方特征 SUP_PRD_MARK string 100 　 　 　
折扣额 AMT_DIS_CNT float 0 　 　 　
IFRS单位成本(主单位) UP_MAIN_BX float 0 　 　 　
是样品 IS_SP string 1 　 　 　
矩阵项次 MATRIX_ITM integer 0 　 　 　
生产日期 SC_DD datetime 0 　 　 　
标准配置代号 XPM_NO string 20 　 　 　
可选配置代号 XPM_NO1 string 20 　 　 　
进货单价 UP_SALE float 0 　 　 　
储位代号 CHUW string 60 　 　 　
已上架标志 CWSJ_Y string 1 　 　 　
对账人 DZ_USR string 12 　 　 　
对账日期 DZ_DATE datetime 0 　 　 　
WMS出入库通知量 QTY_CRK_WMS float 0 　 　 　
WMS出入库通知量(副) QTY1_CRK_WMS float 0 　 　 　

请求JSON示例

{
  "REF_NO": "ZG20082100000001",       //第三方单号，必填
  "PGM": "DRPZG",       //单据程序代号
  "MF_ZG": [          //新增单据表头信息
    {
      "ZG_ID": "ZG",
      "ZG_NO": "ZG20082100000001",
      "ZG_DD": "2020-08-21 00:00:00",
      "CUS_NO": "C1000",
      "DEP": "001",
      "TAX_ID": "2",
      "OS_ID": "PO",
      "OS_NO": "PO20081700000003",
      "SEND_MTH": "1",
      "ZHANG_ID": "3",
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "SAL_NO": "0001",
      "REM": "API生产",
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "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",
      "INT_DAYS": 30,
      "DIS_CNT": 0.0,
      "AMT": 0.0,
      "BIL_TYPE": "",
      "CAS_NO": "",
      "USR": "ADMIN",
      "MOB_ID": "",
      "LJ_ZG1": "API单据"          //新增单据表头自定义栏位信息
    }
  ],
  "TF_ZG": [          //新增单据表身信息
    {
      "ZG_ID": "ZG",
      "ZG_NO": "ZG20082100000001",
      "ITM": 1,
      "ZG_DD": "2020-08-21 00:00:00",
      "WH": "002",
      "OS_NO": "PO20081700000003",
      "PRD_NO": "00221",
      "PRD_NAME": "00221制程一原料",
      "PRD_MARK": "0101",
      "UNIT": "1",
      "QTY": 100.0,
      "QTY1": 200.0,
      "UP": 2.0,
      "AMTN_NET": 190.48,
      "AMT": 200.0,
      "TAX": 9.52,
      "TAX_RTO": 5.0,
      "CST_STD": 0.0,
      "UP_QTY1": 1.0,
      "EST_ITM": 1,
      "OS_ID": "PO",
      "OTH_ITM": 1,
      "CUS_OS_NO": "",
      "PRE_ITM": 1,
      "CST": 190.48,
      "UP_MAIN": 2.0,
      "PRD_NO_NO": "00221",
      "QTY_SO_ORG": 100.0,
      "QTY_SO_ORG_ALL": 100.0,
      "CST_STD_UNIT": 0.0,
      "WLGL_UP": "2.0000",
      "LJ_ZG2": 10.0,          //新增单据表身自定义栏位信息
      "SIZE": "01",
      "GOOD": "01",
      "SIZE__NAME": "S码",
      "GOOD__NAME": "标准",
      "EST_DD": "2020-08-17"
    }
  ]
}

返回结果示例

{
  "code": 0,                //为0表示执行成功，其他表示错误
  "message": "新增成功",         //提示信息
  "data": {
    "MF_ZG": [                //生成单据表头信息
      {
        "ZG_ID": "ZG",
        "ZG_NO": "ZG20082100000001",
        "ZG_DD": "2020-08-21 00:00:00",
        "CUS_NO": "C1000",
        "DEP": "001",
        "TAX_ID": "2",
        "OS_ID": "PO",
        "OS_NO": "PO20081700000003",
        "SEND_MTH": "1",
        "ZHANG_ID": "3",
        "CUR_ID": "",
        "EXC_RTO": 1.0,
        "SAL_NO": "0001",
        "REM": "API生产",
        "PAY_MTH": "1",
        "PAY_DAYS": 1,
        "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",
        "INT_DAYS": 30,
        "PRT_SW": "N",
        "DIS_CNT": 0.0,
        "AMT": 0.0,
        "CLS_DATE": "2020-08-21 00:00:00",
        "BIL_TYPE": "",
        "CAS_NO": "",
        "USR": "ADMIN",
        "CHK_MAN": "ADMIN",
        "MOB_ID": "",
        "SYS_DATE": "2020-08-21 14:28:10",
        "LJ_ZG1": "API单据"
      }
    ],
    "TF_ZG": [                    //生成单据表身信息
      {
        "ZG_ID": "ZG",
        "ZG_NO": "ZG20082100000001",
        "ITM": 1,
        "ZG_DD": "2020-08-21 00:00:00",
        "WH": "002",
        "OS_NO": "PO20081700000003",
        "PRD_NO": "00221",
        "PRD_NAME": "00221制程一原料",
        "PRD_MARK": "0101",
        "UNIT": "1",
        "QTY": 100.0,
        "QTY1": 200.0,
        "UP": 2.0,
        "AMTN_NET": 190.48,
        "AMT": 200.0,
        "TAX": 9.52,
        "TAX_RTO": 5.0,
        "CST_STD": 0.0,
        "UP_QTY1": 1.0,
        "EST_ITM": 1,
        "OS_ID": "PO",
        "OTH_ITM": 1,
        "CUS_OS_NO": "",
        "QTY_PS": 100.0,
        "PRE_ITM": 1,
        "CST": 190.48,
        "UP_MAIN": 2.0,
        "PRD_NO_NO": "00221",
        "QTY_SO_ORG": 100.0,
        "QTY_SO_ORG_ALL": 100.0,
        "CST_STD_UNIT": 0.0,
        "WLGL_UP": "2.0000",
        "LJ_ZG2": 10.0
      }
    ],
    "MF_ZG_Z": [               //生成单据表头自定义栏位信息
      {
        "LJ_ZG1": "API单据",
        "ZG_ID": "ZG",
        "ZG_NO": "ZG20082100000001"
      }
    ],
    "TF_ZG_Z": [                //生成单据表身自定义栏位信息
      {
        "LJ_ZG2": 10.0,
        "ZG_ID": "ZG",
        "ZG_NO": "ZG20082100000001",
        "ITM": 1
      }
    ]
  }
}