天心天思数字化API平台

生成【出库退回单】接口

概述

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

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 DRPKB 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_CK
出库单ID CK_ID string 2 是 KB 　
出库单号 CK_NO string 20 是 　 1.自动编码时，根据单据编码原则自动产生；
2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
出库日期 CK_DD datetime 　 是 　 格式为：YYYY-MM-DD
交易日期 PAY_DD datetime 　 　 　 　
票据日期 CHK_DD datetime 　 　 　 　
贸易方式 TRAD_MTH string 20 　 　 　
批号 BAT_NO string 40 　 　 　
客户代号 CUS_NO string 12 是 　 　
部门 DEP string 8 是 　 　
转入单ID OS_ID string 2 　 　 　
转入单号 OS_NO string 25 　 　 　
币别 CUR_ID string 4 　 　 　
汇率 EXC_RTO float 　 　 　 　
业务员 SAL_NO string 12 是 　 　
摘要 REM string 100 　 　 　
交易方式 PAY_MTH string 1 　 　 　
起算日 PAY_DAYS integer 　 　 　 　
票据天数 CHK_DAYS integer 　 　 　 　
间隔天数 INT_DAYS integer 　 　 　 　
交易备注 PAY_REM string 80 　 　 　
录入员 USR string 12 　 　 　
审核人 CHK_MAN string 12 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
合同号 CONTRACT string 80 　 　 　
金额合计 AMT float 　 　 　 　
未税合计 AMTN_NET float 　 　 　 　
税额合计 TAX float 　 　 　 　
扣税类别 TAX_ID string 1 是 　 1.值分别为1；2；3
2.分别表示(1不计税 2应税内含 3应税外加)
交货方式 SEND_MTH string 200 　 　 　
交货仓 SEND_WH string 12 　 　 　
交货地址 ADR string 0 　 　 　
折扣 DIS_CNT float 　 　 　 　
销货单号 PS_NO string 20 　 　 　
已开发票金额合计 AMT_CLS float 　 　 　 　
已开发票未税合计 AMTN_NET_CLS float 　 　 　 　
已开发票税额合计 TAX_CLS float 　 　 　 　
指定结帐日资料 CLS_REM string 30 　 　 　
终审日期 CLS_DATE datetime 　 　 　 　
销货单立帐标记 ZHANG_ID string 1 是 　 1.值分别为1；2；3
2.分别表示(1单张立帐 2不立帐 3收到发票才立帐)
销货结案标志 SA_CLS_ID string 1 　 　 　
立帐结案标志 LZ_CLS_ID string 1 　 　 　
销货单自动结案回写 CLSSA string 1 　 　 　
出库补开发票自动结案回写 CLSLZ string 1 　 　 　
出库补开发票标记 YD_ID string 1 　 　 　
单据类别 BIL_TYPE string 10 　 　 　
客户订单号 CUS_OS_NO string 30 　 　 　
审核模版 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
输单日期 SYS_DATE datetime 　 　 　 　
工程案号 CAS_NO string 20 　 　 　
阶段编号 TASK_ID integer 0 　 　 　
立帐开票开票方式 TURN_ID string 1 　 　 　
打印人员 PRT_USR string 12 　 　 　
已开发票数量合计 QTY_CLS float 0 　 　 　
装柜分析 ZGFX string 1 　 　 　
退回量影响受订单发货量 SOFH_ID string 1 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
首付比例 RTO_FQSK float 0 　 　 　
首付日期方式 DATEFLAG_FQSK string 1 　 　 　
首付指定日期 DATE_FQSK datetime 0 　 　 　
期数 QS_FQSK integer 0 　 　 　
会员卡号 CARD_NO string 20 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
已开发票数量合计(副) QTY1_CLS float 0 　 　 　
摊提方式设置 TT_TYPE_SET string 20 　 　 　
开始摊提年月 TT_YM_B datetime 0 　 　 　
金额小数位数 AMT_POI integer 0 　 　 　
立帐结案日期 LZ_CLS_DD datetime 0 　 　 　
联系人1 CNT_MAN1 string 20 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
拣货否 CHK_PICKING string 1 　 　 　
扫描人 SCAN_USR string 12 　 　 　
扫描日期 SCAN_DATE datetime 0 　 　 　
发货商 CUS_FH string 12 　 　 　
发货部门 DEP_FH string 8 　 　 　
所属分销商 CUS_FX string 12 　 　 　
缓存否 CHK_CACHE string 1 　 　 　
拣货否 CHK_PKCHE string 1 　 　 　
要货订单全额定金 CHK_FULL_PAY string 1 　 　 　
通知发货人 SENDCK_USR string 12 　 　 　
发货通知时间 SENDCK_DATE datetime 0 　 　 　
区域 CUS_ARE string 20 　 　 　
特价否 CHK_SPEPRI_HZ string 1 　 　 　
WMS产生的单据 WMS_ID string 1 　 　 　
分销仓库 FX_WH string 12 　 　 　
数据表TF_CK
出库单ID CK_ID string 2 是 　 　
出库单号 CK_NO string 20 是 　 　
项次 ITM integer 　 是 　 　
出库日期 CK_DD datetime 　 是 　 　
库位 WH string 12 　 　 　
批号 BAT_NO string 40 　 　 　
来源单ID OS_ID string 2 　 　 　
来源单号 OS_NO string 25 　 　 　
货品代号 PRD_NO string 30 是 　 　
货品名称 PRD_NAME string 160 　 　 　
货品特征 PRD_MARK string 100 　 　 　
单位 UNIT string 1 是 　 　
数量 QTY float 　 　 　 　
数量(副) QTY1 float 　 　 　 　
销货成本 CSTN_SAL float 　 　 　 　
单价 UP float 　 　 　 　
未税金额 AMTN_NET float 　 　 　 　
金额 AMT float 　 　 　 　
税额 TAX float 　 　 　 　
折扣 DIS_CNT float 　 　 　 　
有效日期 VALID_DD datetime 　 　 　 　
摘要 REM string 1000 　 　 　
预交日 EST_DD datetime 　 　 　 　
税率 TAX_RTO float 　 　 　 　
标准成本 CST_STD float 　 　 　 　
付单位单价 UP_QTY1 float 　 　 　 　
截取受订单货品对应项次 EST_ITM integer 　 　 　 　
已交量 QTY_PS float 0 　 　 　
未审核已交量 QTY_PS_UNSH float 0 　 　 　
配方号 ID_NO string 38 　 　 　
搭赠注记 FREE_ID string 1 　 　 　
已入库量 QTY_RK float 　 　 　 　
未审核已入库量 QTY_RK_UNSH float 0 　 　 　
发票票面金额 AMT_FP float 　 　 　 　
发票本位币金额 AMTN_NET_FP float 　 　 　 　
发票税额 TAX_FP float 　 　 　 　
价格代号 PRICE_ID string 4 　 　 　
销货单项次 OTH_ITM integer 　 　 　 　
包装单位 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 　 　 　
关联表身项次 PRE_ITM integer 　 　 　 　
跟踪销货单立帐方式 ZHANG_ID string 1 　 　 　
农副产品否 CHK_TAX string 1 　 　 　
对方货号 SUP_PRD_NO string 40 　 　 　
鞋服组合栏位 COMPOSE_IDNO string 50 　 　 　
客户订单 CUS_OS_NO string 30 　 　 　
备注2 REM2 string 40 　 　 　
发票数量 QTY_FP float 　 　 　 　
发货计划单 FH_NO string 20 　 　 　
柜数 QTY_ARK float 0 　 　 　
退回数量 QTY_PRE float 0 　 　 　
未审核退回量 QTY_PRE_UNSH float 0 　 　 　
退回数量(副) QTY1_PRE float 0 　 　 　
未审核退回量(副) QTY1_PRE_UNSH float 0 　 　 　
入库日期 RK_DD datetime 0 　 　 　
集团公司代号 DEP_RK string 8 　 　 　
配位项次 PW_ITM integer 0 　 　 　
合同编号 CNTT_NO string 40 　 　 　
包装类型 BZ_KND string 20 　 　 　
送货仓 WH_SEND string 12 　 　 　
折扣额 AMT_DIS_CNT float 0 　 　 　
是否定价政策搭赠品 FREE_ID_DEF string 1 　 　 　
单位标准成本 UP_STD float 0 　 　 　
对方特征 SUP_PRD_MARK string 100 　 　 　
已开发票数量(副) QTY1_FP float 0 　 　 　
拆分代号 CF_ID string 4 　 　 　
摊提期间 TT_RNG integer 0 　 　 　
摊提方式 TT_TYPE_IFRS string 1 　 　 　
截止摊提年月 TT_YM_E datetime 0 　 　 　
截取受订数量 QTY_OS float 0 　 　 　
标准模板代号 XPM_NO string 20 　 　 　
自选模板代号 XPM_NO1 string 20 　 　 　
自选产品对应的主产品项次 XPPRD_ITM integer 0 　 　 　
对应选配模板表身的KEY_ITM XPPRD_ITM1 integer 0 　 　 　
要货单号 YH_NO string 20 　 　 　
要货单项次 YH_ITM integer 0 　 　 　
促销代号 PRM_NO string 20 　 　 　
唛头 MAI_NO string 60 　 　 　
客户使用机型 TYPE_CUS string 40 　 　 　
安排日期 ARRANGE_DD datetime 0 　 　 　
包装数量 QTY_BZ float 0 　 　 　
包装单位 UNIT_BZ string 8 　 　 　
商城宝贝ID MALL_TID string 20 　 　 　
是否折分 ISSPLIT string 1 　 　 　
需足量 CHK_XZL string 1 　 　 　
配送数量 QTY_IC float 0 　 　 　
未审核已配送量 QTY_IC_UNSH float 0 　 　 　
销售价 UP_XS float 0 　 　 　
销售金额 AMTN_XS float 0 　 　 　
未税单价 UP_NET float 0 　 　 　
加工否 JG_ID string 1 　 　 　
加工结案否 JG_CLS string 1 　 　 　
左右 LR_ID string 1 　 　 　
调整金额 AMT_ABJ_FREE float 0 　 　 　
整单优惠分摊 AMT_MJZ_CNT float 0 　 　 　
需门店调拨 IC_SW string 1 　 　 　
不需回调商品 IC_SW1 string 1 　 　 　
电商类别 SC_TYPE_ID string 4 　 　 　
电商单号 SC_TB_NO string 20 　 　 　
淘宝子订单号 TB_OID string 30 　 　 　
储位代号 CHUW string 60 　 　 　
已开票差异金额 AMT_ZG_FP float 0 　 　 　
已开票未税差额 AMTN_NET_ZG_FP float 0 　 　 　
已开票税金差额 TAX_ZG_FP float 0 　 　 　
功能类型 FUN_TYPE_HZ string 4 　 　 　
功能关联项次 FUN_ITM_HZ integer 0 　 　 　
WMS出入库通知量 QTY_CRK_WMS float 0 　 　 　
WMS出入库通知量(副) QTY1_CRK_WMS float 0 　 　 　

请求JSON示例

{
  "REF_NO": "LJKB20080000001",    //第三方单号，必填
  "PGM": "DRPKB",          //单据程序代号
  "MF_CK": [          //新增单据表头信息
    {
      "CK_ID": "KB",
      "CK_NO": "LJKB20080000001",
      "CK_DD": "2020-08-18 00:00:00",
      "PAY_DD": "2020-09-01 00:00:00",
      "CHK_DD": "2020-10-01 00:00:00",
      "CUS_NO": "0002",
      "DEP": "00000000",
      "OS_ID": "CK",
      "OS_NO": "CK20081800000001",
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "SAL_NO": "0001",
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "CHK_DAYS": 30,
      "INT_DAYS": 30,
      "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
      "USR": "ADMIN",
      "AMTN_NET": 117.14,
      "TAX": 5.86,
      "TAX_ID": "2",
      "SEND_MTH": "1",
      "AMTN_NET_CLS": 0.0,
      "YD_ID": "T",
      "BIL_TYPE": "",
      "FX_WH": "",
      "LJ_KB1": "外部单据"    //新增单据表头自定义栏位信息
    }
  ],
  "TF_CK": [       //新增单据表身信息
    {
      "CK_ID": "KB",
      "CK_NO": "LJKB20080000001",
      "ITM": 1,
      "PRD_NO": "0001",
      "PRD_NO_NO": "0001",
      "PRD_NAME": "不粘锅",
      "PRD_MARK": "",
      "UNIT": "1",
      "WH": "9902",
      "QTY": 1.0,
      "UP": 123.0,
      "AMT": 123.0,
      "AMTN_NET": 117.14,
      "TAX": 5.86,
      "EST_DD": "2020-08-17 00:00:00",
      "OS_ID": "CK",
      "OS_NO": "CK20081800000001",
      "TAX_RTO": 5.0,
      "EST_ITM": 2,
      "CSTN_SAL": 111.7694,
      "FREE_ID_DEF": "F",
      "CK_DD": "2020-08-18 00:00:00",
      "PRE_ITM": 1,
      "ZHANG_ID": "2",
      "SUP_PRD_NO": "",
      "PRM_NO": "",
      "QTY_SO_ORG": 1.0,
      "LJ_KB2": "10",     //新增单据表身自定义栏位信息
      "SIZE__NAME": "",
      "GOOD__NAME": ""
    }
  ]
}

返回结果示例

{
  "code": 0,           //为0表示执行成功，其他表示错误
  "message": "新增成功",        //提示信息
  "data": {
    "MF_CK": [            //生成单据表头信息
      {
        "CK_ID": "KB",
        "CK_NO": "LJKB20080000001",
        "CK_DD": "2020-08-18 00:00:00",
        "PAY_DD": "2020-09-01 00:00:00",
        "CHK_DD": "2020-10-01 00:00:00",
        "CUS_NO": "0002",
        "DEP": "00000000",
        "OS_ID": "CK",
        "OS_NO": "CK20081800000001",
        "CUR_ID": "",
        "EXC_RTO": 1.0,
        "SAL_NO": "0001",
        "PAY_MTH": "1",
        "PAY_DAYS": 1,
        "CHK_DAYS": 30,
        "INT_DAYS": 30,
        "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
        "USR": "ADMIN",
        "CHK_MAN": "ADMIN",
        "PRT_SW": "N",
        "AMTN_NET": 117.14,
        "TAX": 5.86,
        "TAX_ID": "2",
        "SEND_MTH": "1",
        "AMTN_NET_CLS": 0.0,
        "CLS_DATE": "2020-08-18 00:00:00",
        "YD_ID": "T",
        "BIL_TYPE": "",
        "SYS_DATE": "2020-08-20 14:16:29",
        "FX_WH": "",
        "LJ_KB1": "外部单据" 
      }
    ],
    "TF_CK": [                      //生成单据表身信息
      {
        "CK_ID": "KB",
        "CK_NO": "LJKB20080000001",
        "ITM": 1,
        "PRD_NO": "0001",
        "PRD_NO_NO": "0001",
        "PRD_NAME": "不粘锅",
        "PRD_MARK": "",
        "UNIT": "1",
        "WH": "9902",
        "QTY": 1.0,
        "UP": 123.0,
        "AMT": 123.0,
        "AMTN_NET": 117.14,
        "TAX": 5.86,
        "EST_DD": "2020-08-17 00:00:00",
        "OS_ID": "CK",
        "OS_NO": "CK20081800000001",
        "TAX_RTO": 5.0,
        "EST_ITM": 2,
        "CSTN_SAL": 111.7694,
        "FREE_ID_DEF": "F",
        "CK_DD": "2020-08-18 00:00:00",
        "OTH_ITM": 1,
        "PRE_ITM": 1,
        "ZHANG_ID": "2",
        "SUP_PRD_NO": "",
        "PRM_NO": "",
        "QTY_SO_ORG": 1.0,
        "LJ_KB2": "10"
      }
    ],
    "MF_CK_Z": [             //生成单据表头自定义信息
      {
        "LJ_KB1": "外部单据",
        "CK_ID": "KB",
        "CK_NO": "LJKB20080000001"
      }
    ],
    "TF_CK_Z": [                 //生成单据表身自定义信息
      {
        "LJ_KB2": "10",
        "CK_ID": "KB",
        "CK_NO": "LJKB20080000001",
        "ITM": 1
      }
    ]
  }
}