天心天思数字化API平台

生成【借入还出单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【借入还出单】的生成接口，将第三方系统向厂商借入货品的归还信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【借入还出单】。

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 DRPBB 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_BLN
借进/还出区分 BL_ID string 2 是 BB 　
单号 BL_NO string 20 是 　 1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
批号 BAT_NO string 40 　 　 　
租借方式 BL_MOD string 1 　 　 　
保留! BL_UP float 　 　 　 　
押金 AMT_PLED float 　 　 　 　
罚金 AMT_FINE float 　 　 　 　
保留! AMT_CPEN float 　 　 　 　
保留! ACC_POINT integer 　 　 　 　
客户代号 CUS_NO string 12 是 　 　
借进/还出日期 BL_DD datetime 　 是 　 格式为：YYYY-MM-DD
结帐期 PAY_DD datetime 　 　 　 　
原借出/入单号 REP_BL_NO string 25 　 　 　
应收付款单号 ARP_NO string 20 　 　 　
凭证模版代号 VOH_ID string 2 　 　 　
凭证号码 VOH_NO string 20 　 　 　
部门代号 DEP string 8 是 　 　
发票号码 INV_NO string 20 　 　 　
贸易方式 TRAD_MTH string 20 　 　 　
保留! BUY_MTH string 2 　 　 　
送货方式 SEND_MTH string 200 　 　 　
收付款单号 RP_NO string 20 　 　 　
立帐方式 ZHANG_ID string 1 　 　 　
币别 CUR_ID string 4 　 　 　
汇率 EXC_RTO float 　 　 　 　
业务员代号 SAL_NO string 12 是 　 　
借出天数 BL_DAYS integer 　 　 　 　
还回日期 RTN_DD datetime 　 　 　 　
结案否 CLS_ID string 1 　 　 　
税额 TAX float 　 　 　 　
未税本位币 AMTN_NET float 　 　 　 　
未税外币 AMT_NET float 　 　 　 　
课税别 TAX_ID string 1 　 　 　
送货地址 ADR string 100 　 　 　
摘要 REM string 100 　 　 　
交易类别 PAY_MTH string 1 　 　 　
起算日 PAY_DAYS integer 　 　 　 　
票据天数 CHK_DAYS integer 　 　 　 　
交易摘要 PAY_REM string 80 　 　 　
送货仓 SEND_WH string 12 　 　 　
逾期天数 END_DAYS integer 　 　 　 　
票据到期日 CHK_DD datetime 　 　 　 　
间隔天数 INT_DAYS integer 　 　 　 　
预还日 EST_DD datetime 　 　 　 　
录入员 USR string 12 是 　 　
审核注记 CHK_MAN string 12 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
来源单号 BIL_NO string 20 　 　 　
指定结帐日资料 CLS_REM string 30 　 　 　
来源单ID BIL_ID string 2 　 　 　
终审日期 CLS_DATE datetime 　 　 　 　
借出转出库结案标志 CK_CLS_ID string 1 　 　 　
销货成本切制否 CB_ID string 1 　 　 　
单据类别 BIL_TYPE string 10 　 　 　
工程案号 CAS_NO string 20 　 　 　
合同编号 CNTT_NO string 40 　 　 　
开票标记 KP_ID string 1 　 　 　
开票立帐结案标志 LZ_CLS_ID string 1 　 　 　
审核模板 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
附件张数 FJ_NUM integer 　 　 　 　
输单日期 SYS_DATE datetime 　 　 　 　
发票日 INV_DD datetime 　 　 　 　
申报期别 INV_YM integer 　 　 　 　
买受人抬头 TITLE_BUY string 50 　 　 　
发票别 METH_ID string 2 　 　 　
发票退回金额 AMT_INV float 　 　 　 　
发票退回税额 TAX_INV float 　 　 　 　
已开发票金额合计 AMT_CLS float 0 　 　 　
已开发票未税合计 AMTN_NET_CLS float 0 　 　 　
已开发票税额合计 TAX_CLS float 0 　 　 　
任务编号 TASK_ID integer 0 　 　 　
打印人员 PRT_USR string 12 　 　 　
立帐开票开票方式 TURN_ID string 1 　 　 　
转入单ID OS_ID string 2 　 　 　
转入单号 OS_NO string 25 　 　 　
影响采购/受订的已交量 PO_ID string 1 　 　 　
三角转单注记 SG_ID string 30 　 　 　
已开发票数量合计 QTY_CLS float 0 　 　 　
合同号 CONTRACT string 80 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
转模具标志 TO_MJ string 1 　 　 　
转设备标志 TO_SB string 1 　 　 　
折扣 DIS_CNT float 0 　 　 　
首付比例 RTO_FQSK float 0 　 　 　
首付日期方式 DATEFLAG_FQSK string 1 　 　 　
首付指定日期 DATE_FQSK datetime 0 　 　 　
期数 QS_FQSK integer 0 　 　 　
客户订单号 CUS_OS_NO string 30 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
已开发票数量合计(副) QTY1_CLS float 0 　 　 　
发票来源单ID INV_BIL_ID string 2 　 　 　
发票来源单号 INV_BIL_NO string 20 　 　 　
IFRS成本切制 CB_ID_IFRS string 1 　 　 　
立帐结案日期 LZ_CLS_DD datetime 0 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
自动结案回写 CLSID string 1 　 　 　
扫描状态 SCAN_ID string 1 　 　 　
扫描人 SCAN_USR string 12 　 　 　
扫描日期 SCAN_DATE datetime 0 　 　 　
对帐人 DZ_USR string 12 　 　 　
对帐日期 DZ_DATE datetime 　 　 　 　
集团单据唯一值 GROUP_KEY string 100 　 　 　
已开票金额差额 AMT_ZG_CLS float 0 　 　 　
已开票未税差额 AMTN_NET_ZG_CLS float 0 　 　 　
已开票税额差额 TAX_ZG_CLS float 0 　 　 　
WMS产生的单据 WMS_ID string 1 　 　 　
数据表TF_BLN
借进/还出区分 BL_ID string 2 是 　 必须与表头字段值相同
单号 BL_NO string 20 是 　 必须与表头字段值相同
项次 ITM integer 　 是 　 　
借进/还出日期 BL_DD datetime 　 是 　 必须与表头字段值相同
库位 WH string 12 是 　 　
货品代号 PRD_NO string 30 是 　 　
货品名称 PRD_NAME string 160 　 　 　
货品特征 PRD_MARK string 100 　 　 　
单位 UNIT string 1 是 　 　
数量 QTY float 　 　 　 　
副单位数量 QTY1 float 　 　 　 　
成本 CST float 　 　 　 　
金额 AMT_RNT float 　 　 　 　
补租金 AMTN_RNT_NET float 　 　 　 　
租金税额 TAX_RNT float 　 　 　 　
单价 UP float 　 　 　 　
外币金额 AMT float 　 　 　 　
本位币金额 AMTN float 　 　 　 　
已还数量 QTY_RTN float 　 　 　 　
未审核已还量 QTY_RTN_UNSH float 0 　 　 　
已还副单位数量 QTY1_RTN float 　 　 　 　
未审核已还量(副) QTY1_RTN_UNSH float 0 　 　 　
原借出单 PRE_BL_NO string 20 　 　 　
原借出单项次 PRE_ITM integer 　 　 　 　
包装单位 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 　 　 　 　
标准成本 CST_STD float 　 　 　 　
副单位单价 UP_QTY1 float 　 　 　 　
追踪已交数量项次 EST_ITM integer 　 　 　 　
批号 BAT_NO string 40 　 　 　
借出转出库数量 QTY_CK float 　 　 　 　
未审核出库数量 QTY_CK_UNSH float 0 　 　 　
对方货号 SUP_PRD_NO string 40 　 　 　
合同编号 CNTT_NO string 40 　 　 　
配方号 ID_NO string 38 　 　 　
鞋服组合栏位 COMPOSE_IDNO string 50 　 　 　
税额 TAX float 　 　 　 　
发票票面金额 AMT_FP float 　 　 　 　
发票本位币金额 AMTN_NET_FP float 　 　 　 　
发票税额 TAX_FP float 　 　 　 　
发票数量 QTY_FP float 　 　 　 　
入库单号 RK_NO string 20 　 　 　
检验单号 CK_NO string 20 　 　 　
入库单ITM TI_ITM integer 　 　 　 　
检验转入标志 QC_FLAG string 2 　 　 　
检验转入项次 QC_ITM integer 0 　 　 　
转入单ID OS_ID string 2 　 　 　
转入单号 OS_NO string 20 　 　 　
转入单项次 OS_ITM integer 0 　 　 　
税率 TAX_RTO float 0 　 　 　
入库日期 RK_DD datetime 0 　 　 　
集团公司 DEP_RK string 8 　 　 　
原料成本 CST_ML float 0 　 　 　
直接人工 CST_MAN float 0 　 　 　
制造费用 CST_MAK float 0 　 　 　
耗用物料 CST_PRD float 0 　 　 　
托工费用 CST_OUT float 0 　 　 　
原料成本(标) CST_STD_ML float 0 　 　 　
直接人工(标) CST_SMAN float 0 　 　 　
制造费用(标) CST_SMAK float 0 　 　 　
耗用物料(标) CST_SPRD float 0 　 　 　
托工费用(标) CST_SOUT float 0 　 　 　
来源识别码（三角转单用 TRD_ID string 2 　 　 　
来源单号（三角转单用） TRD_NO string 30 　 　 　
来源单项次（三角转单用） TRD_ITM integer 0 　 　 　
包装类型 BZ_KND string 20 　 　 　
单位成本(主单位) UP_MAIN float 0 　 　 　
折扣 DIS_CNT float 0 　 　 　
单位标准成本 UP_STD float 0 　 　 　
对方特征 SUP_PRD_MARK string 100 　 　 　
客户/厂商订单号 CUS_OS_NO string 30 　 　 　
已开发票数量(副) QTY1_FP float 0 　 　 　
是样品 IS_SP string 1 　 　 　
对帐人 DZ_USR string 12 　 　 　
对帐日期 DZ_DATE datetime 0 　 　 　
生产日期 SC_DD datetime 0 　 　 　
标准配置代号 XPM_NO string 20 　 　 　
可选配置代号 XPM_NO1 string 20 　 　 　
需足量 CHK_XZL string 1 　 　 　
销售单价 UP_SALE float 0 　 　 　
已放行量 QTY_FA float 0 　 　 　
未审核放行量 QTY_FA_UNSH float 0 　 　 　
农副产品否 CHK_TAX string 1 　 　 　
储位代号 CHUW string 60 　 　 　
已上架标志 CWSJ_Y string 1 　 　 　
已开票差异金额 AMT_ZG_FP float 0 　 　 　
已开票未税差额 AMTN_NET_ZG_FP float 0 　 　 　
已开票税金差额 TAX_ZG_FP float 0 　 　 　

请求JSON示例

{
  "REF_NO": "BB20082500000001",   //第三方单号，必填
  "PGM": "DRPBB",      //单据程序代号
  "MF_BLN": [       //新增单据表头信息
    {
      "BL_ID": "BB",
      "BL_NO": "BB20082500000001",
      "BL_MOD": "1",
      "AMT_PLED": 500.0,
      "CUS_NO": "C1000",
      "BL_DD": "2020-08-25 00:00:00",
      "PAY_DD": "2020-09-01 00:00:00",
      "REP_BL_NO": "BN20082500000001",
      "DEP": "001",
      "ZHANG_ID": "3",
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "SAL_NO": "9999",
      "BL_DAYS": 0,
      "TAX": 0.0,
      "AMTN_NET": 0.0,
      "TAX_ID": "2",
      "REM": "API产生",
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "CHK_DAYS": 30,
      "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
      "END_DAYS": 0,
      "CHK_DD": "2020-10-01 00:00:00",
      "INT_DAYS": 30,
      "EST_DD": "2020-09-01 00:00:00",
      "USR": "ADMIN",
      "BIL_TYPE": "01",
      "MOB_ID": "",
      "CAS_NO": "",
      "PO_ID": "F",
      "BN_DD": "2020-08-25 00:00:00",
      "LJ_BB1": "外部单据"       //新增单据表头自定义信息信息
    }
  ],
  "TF_BLN": [       //新增单据表身信息
    {
      "BL_ID": "BB",
      "BL_NO": "BB20082500000001",
      "ITM": 1,
      "BL_DD": "2020-08-25 00:00:00",
      "WH": "9902",
      "PRD_NO": "0001",
      "PRD_NAME": "不粘锅",
      "PRD_MARK": "",
      "UNIT": "1",
      "QTY": 100.0,
      "CST": 11619.05,
      "AMT_RNT": 0.0,
      "AMTN_RNT_NET": 0.0,
      "UP": 122.0,
      "AMT": 12200.0,
      "AMTN": 11619.05,
      "QTY_RTN": 100.0,
      "PRE_BL_NO": "BN20082500000001",
      "PRE_ITM": 1,
      "CST_STD": 0.0,
      "EST_ITM": 1,
      "TAX_RTO": 5.0,
      "TAX": 580.95,
      "SPC": "4L",
      "CHK_TAX": "F",
      "QTY_SO_ORG": 100.0,
      "WH_QTY": "311.00000000",
      "CW_QTY": "0",
      "CST_STD_UNIT": 0.0,
      "PRD_NO_NO": "0001",
      "SIZE__NAME": "",
      "GOOD__NAME": ""
    }
  ]
}

返回结果示例

{
  "code": 0,                         //为0表示执行成功，其他表示错误
  "message": "新增成功",                    //提示信息
  "data": {
    "MF_BLN": [                   //生成单据表头信息  
      {
        "BL_ID": "BB",
        "BL_NO": "BB20082500000001",
        "BL_MOD": "1",
        "AMT_PLED": 500.0,
        "CUS_NO": "C1000",
        "BL_DD": "2020-08-25 00:00:00",
        "PAY_DD": "2020-09-01 00:00:00",
        "REP_BL_NO": "BN20082500000001",
        "DEP": "001",
        "KP_ID": "F",
        "ZHANG_ID": "3",
        "CUR_ID": "",
        "EXC_RTO": 1.0,
        "SAL_NO": "9999",
        "BL_DAYS": 0,
        "TAX": 0.0,
        "AMTN_NET": 0.0,
        "TAX_ID": "2",
        "REM": "API产生",
        "PAY_MTH": "1",
        "PAY_DAYS": 1,
        "CHK_DAYS": 30,
        "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
        "END_DAYS": 0,
        "CHK_DD": "2020-10-01 00:00:00",
        "INT_DAYS": 30,
        "EST_DD": "2020-09-01 00:00:00",
        "USR": "ADMIN",
        "PRT_SW": "N",
        "BIL_TYPE": "01",
        "MOB_ID": "01",
        "SYS_DATE": "2020-08-25 12:13:48",
        "CAS_NO": "",
        "PO_ID": "F",
        "BN_DD": "2020-08-25 00:00:00",
        "LJ_BB1": "外部单据"
      }
    ],
    "TF_BLN": [                   //生成单据表身信息
      {
        "BL_ID": "BB",
        "BL_NO": "BB20082500000001",
        "ITM": 1,
        "BL_DD": "2020-08-25 00:00:00",
        "WH": "9902",
        "PRD_NO": "0001",
        "PRD_NAME": "不粘锅",
        "PRD_MARK": "",
        "UNIT": "1",
        "QTY": 100.0,
        "CST": 11619.05,
        "AMT_RNT": 0.0,
        "AMTN_RNT_NET": 0.0,
        "UP": 122.0,
        "AMT": 12200.0,
        "AMTN": 11619.05,
        "QTY_RTN": 100.0,
        "PRE_BL_NO": "BN20082500000001",
        "PRE_ITM": 1,
        "CST_STD": 0.0,
        "EST_ITM": 1,
        "TAX_RTO": 5.0,
        "TAX": 580.95,
        "SPC": "4L",
        "CHK_TAX": "F",
        "QTY_SO_ORG": 100.0,
        "WH_QTY": "311.00000000",
        "CW_QTY": "0",
        "CST_STD_UNIT": 0.0,
        "PRD_NO_NO": "0001"
      }
    ],
    "MF_BLN_Z": [               //生成单据表头自定义栏位信息
      {
        "LJ_BB1": "外部单据",
        "BL_ID": "BB",
        "BL_NO": "BB20082500000001"
      }
    ],
    "TF_BLN_Z": [                //生成单据表身自定义栏位信息
      {
        "BL_ID": "BB",
        "BL_NO": "BB20082500000001",
        "ITM": 1
      }
    ]
  }
}