概述

该接口主要用于第三方平台或自主研发者，通过调用【托工缴回单】的生成接口，将第三方的委外加工的制成品或半成品缴回的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【托工缴回单】。

参数说明

1.请求方式

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

2.header参数

Content-Type	application/json
Authorization	token	为小写token，token是获取每次登录的值

3.请求参数

字段名称	字段代号	类型	长度	必填	固定值	备注
第三方单号	REF_NO			是		第三方单号，必填
程序代号	PGM			是	MRPBF
数据表MF_TB
缴回单号	TB_NO	string	20	是		1.自动编码时，根据单据编码原则自动产生； 2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同 3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号
缴回日期	TB_DD	datetime		是		格式为：YYYY-MM-DD
结帐期	PAY_DD	datetime
票据到期日	CHK_DD	datetime
客户代号	CUS_NO	string	12	是
凭证模版代号	VOH_ID	string	2
凭证号码	VOH_NO	string	20
部门代号	DEP	string	8	是
发票号码	INV_NO	string	20
税别	TAX_ID	string	1	是
托外单号	TW_NO	string	25	是
送货方式	SEND_MTH	string	200
送货仓	SEND_WH	string	12
立帐否	ZHANG_ID	string	1	是
币别	CUR_ID	string	4
汇率	EXC_RTO	integer
业务员代号	SAL_NO	string	12	是
交易类别	PAY_MTH	string	1
起算日	PAY_DAYS	integer
票据天数	CHK_DAYS	integer
间隔天数	INT_DAYS	integer
交易摘要	PAY_REM	string	80
结案	CLOSE_ID	string	1
摘要	REM	string	100
指定结帐日资料	CLS_REM	string	30
制单人	USR	string	12	是
审核	CHK_MAN	string	12
打印注记	PRT_SW	string	1
终审日期	CLS_DATE	datetime
缴库单凭证模版代号	MMVOH_ID	string	2
费用单号	EP_NO	string	20
费用合计	AMTN_EP	integer
托外货品税率	RTO_TAX	integer
单据类别	BIL_TYPE	string	10
开票标记	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
已开发票金额合计	AMT_CLS	integer	0
已开发票未税合计	AMTN_NET_CLS	integer	0
已开发票税额合计	TAX_CLS	integer	0
工程案号	CAS_NO	string	20
任务编号	TASK_ID	string	0
立帐开票开票方式	TURN_ID	string	1
转入单标识（托外或者收料）	TW_ID	string	2
客户订单	CUS_OS_NO	string	30
打印人员	PRT_USR	string	12
已开发票数量合计	QTY_CLS	integer	0
作废标记	CANCEL_ID	string	1
打印日期	PRT_DATE	datetime	0
已开发票数量合计(副)	QTY1_CLS	integer	0
发票来源单ID	INV_BIL_ID	string	2
发票来源单号	INV_BIL_NO	string	20
立帐结案日期	LZ_CLS_DD	datetime	0
最近修改日期	MODIFY_DD	datetime	0
最近修改人	MODIFY_MAN	string	12
扫描状态	SCAN_ID	string	1
扫描人	SCAN_USR	string	12
扫描日期	SCAN_DATE	datetime	0
对帐人	DZ_USR	string	12
对帐日期	DZ_DATE	datetime	0
已开票金额差额	AMT_ZG_CLS	integer	0
已开票未税差额	AMTN_NET_ZG_CLS	integer	0
已开票税额差额	TAX_ZG_CLS	integer	0
WMS产生的单据	WMS_ID	string	1
关联标识(费用)	FLG_EP	string	1
数据表TF_TB
缴回单号	TB_NO	string	20	是		必须与表头MF_TB的TB_NO相同
项次	ITM	integer		是
货品代号	PRD_NO	string	30	是
货品名称	PRD_NAME	string	160
货品特征	PRD_MARK	string	100
库位	WH	string	12	是
单位	UNIT	string	1	是
数量	QTY	integer		是
副单位数量	QTY1	integer
损耗量	QTY_LOST	integer
副单位损耗	QTY1_LOST	integer
已退数量	QTY_RTN	integer
未审核已退数量	QTY_RTN_UNSH	integer	0
单价	UP	integer
副单位单价	UP_QTY1	integer
损耗单位成本	UP_LOST	integer
副单位损耗单位成本	UP_QTY1_LOST	integer
未税本位币	AMTN_NET	integer
税额	TAX	integer
外币金额	AMT	integer
批号	BAT_NO	string	40
托外单号	TW_NO	string	20	是
领料单号(M4)	ML_NO	string	20
缴库单号	MM_NO	string	20
制令单号	MO_NO	string	20
摘要	REM	string	200
包装单位	PAK_UNIT	string	20
包装换算	PAK_EXC	integer
包装净重	PAK_NW	integer
包装净重单位	PAK_WEIGHT_UNIT	string	8
包装毛重	PAK_GW	integer
包装大小	PAK_MEAST	integer
包装大小单位	PAK_MEAST_UNIT	string	8
追踪退回数量项次	EST_ITM	integer
转移至单据	TZ_NO2	string	20
配方号	ID_NO	string	38	是
托外货品税率	RTO_TAX	integer
鞋服组合栏位	COMPOSE_IDNO	string	50
发票票面金额	AMT_FP	integer
发票本位币金额	AMTN_NET_FP	integer
发票税额	TAX_FP	integer
发票数量	QTY_FP	integer
费用	AMTN_EP	integer
特殊费用	AMTN_EP1	integer
唯一项次	PRE_ITM	integer
特殊费用分摊比率	RTO_EP	integer
任务编号	TASK_ID	integer	0
收料单号	SL_NO	string	20
收料项次	SL_ITM	integer	0
转入单ID(TW,TC,SL)	TW_ID	string	2
客户订单	CUS_OS_NO	string	30
标准成本	CST_STD	integer	0
来源单ID	BIL_ID	string	2
来源单号	BIL_NO	string	20
来源单项	BIL_ITM	integer	0
检验标识(T0,Q0:合格转入;T2,Q2让步接收)	QC_FLAG	string	2
送货单号	SH_NO_CUS	string	20
入库日期	RK_DD	datetime	0
有效日期	VALID_DD	datetime	0
是搭赠品否	FREE_ID	string	1
集团公司代号	DEP_RK	string	8
折扣	DIS_CNT	integer	0
折扣额	AMT_DIS_CNT	integer	0
已开票差异金额	AMT_ZG_FP	integer	0
已开票未税差额	AMTN_NET_ZG_FP	integer	0
已开票税金差额	TAX_ZG_FP	integer	0
单位标准成本	UP_STD	integer	0
已开发票数量(副)	QTY1_FP	integer	0
倒冲损耗标记	DC_QTYLOST	string	1
净重(单)	PAK_NW_N	integer	0
毛重(单)	PAK_GW_N	integer	0
对方货号	SUP_PRD_NO	string	40
对方特征	SUP_PRD_MARK	string	100
生产日期	SC_DD	datetime	0
暂估价	UP_ZG_FLAG	string	1
储位代号	CHUW	string	60
已上架标志	CWSJ_Y	string	1
对账人	DZ_USR	string	12
对账日期	DZ_DATE	datetime	0
最早交货日期	B_DD	datetime	0
最晚交货日期	E_DD	datetime	0
已退数量(副)	QTY1_RTN	integer	0
未审核已退数量(副)	QTY1_RTN_UNSH	integer	0
WMS出入库通知量	QTY_CRK_WMS	integer	0
WMS出入库通知量(副)	QTY1_CRK_WMS	integer	0

4.自定义参数

字段名称	字段代号	类型	长度	是否	固定值	备注
数据表MF_TB_Z（表头自定义字段）
自定义栏位1	自定义	string	2			自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。
自定义栏位2	自定义	string
……	……	……
数据表TF_TB_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": "TB20081200000001",
  "PGM": "MRPBF",
  "MF_TB": [
    {
      "TB_NO": "TB20081200000001",
      "TB_DD": "2020-08-12 00:00:00",
      "PAY_DD": "2020-09-01 00:00:00",
      "CHK_DD": "2020-10-01 00:00:00",
      "BAT_NO": "",
      "CUS_NO": "0009",
      "VOH_ID": "01",
      "DEP": "00000000",
      "TAX_ID": "2",
      "TW_NO": "TW20081000000001",
      "ZHANG_ID": "1",
      "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",
      "REM": "托外缴回",
      "CLS_REM": "票据到期日:97-02-15结帐期:97-0",
      "USR": "ADMIN",
      "MMVOH_ID": "",
      "BIL_TYPE": "",
      "MOB_ID": "",
      "CAS_NO": "",
      "TW_ID": "TW",
      "CUS_OS_NO": "",
      "LJ_TB1": 1.0,
      "LJ_TB2": 1.0
    }
  ],
  "TF_TB": [
    {
      "TB_NO": "TB20081200000001",
      "ITM": 1,
      "PRD_NO": "0022",
      "PRD_NAME": "0022混合制程货品",
      "PRD_MARK": "",
      "WH": "001",
      "UNIT": "1",
      "QTY": 3.0,
      "QTY1": 6.0,
      "UP": 0.0,
      "UP_QTY1": 0.0,
      "UP_LOST": 0.0,
      "UP_QTY1_LOST": 0.0,
      "AMTN_NET": 0.0,
      "TAX": 0.0,
      "AMT": 0.0,
      "BAT_NO": "",
      "BAT_NAME": "",
      "TW_NO": "TW20081000000001",
      "MO_NO": "MO20081000000001",
      "EST_ITM": 2,
      "ID_NO": "0022->",
      "RTO_TAX": 5.0,
      "PRE_ITM": 2,
      "TW_ID": "TW",
      "CUS_OS_NO": "",
      "UP_STD": 0.0,
      "CST_STD": 0.0,
      "SPC": "",
      "LJ_TB3": 1.0,
      "LJ_TB4": 1.0
    }
  ]
}

返回结果示例

{
  "code": 0,                       //为0表示执行成功，其他表示错误
  "message": "新增成功",       //提示信息
  "data": {
    "MF_TB": [                        //生成单据表头信息
      {
        "TB_NO": "TB20081200000001",
        "TB_DD": "2020-08-12 00:00:00",
        "PAY_DD": "2020-09-01 00:00:00",
        "CHK_DD": "2020-10-01 00:00:00",
        "BAT_NO": "",
        "CUS_NO": "0009",
        "VOH_ID": "01",
        "DEP": "00000000",
        "TAX_ID": "2",
        "TW_NO": "TW20081000000001",
        "SEND_WH": "",
        "RP_NO": "",
        "ZHANG_ID": "1",
        "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",
        "CLOSE_ID": "F",
        "REM": "托外缴回",
        "CLS_REM": "票据到期日:97-02-15结帐期:97-0",
        "USR": "ADMIN",
        "CHK_MAN": "ADMIN",
        "PRT_SW": "N",
        "CLS_DATE": "2020-08-12 00:00:00",
        "MMVOH_ID": "",
        "BIL_TYPE": "",
        "KP_ID": "F",
        "MOB_ID": "",
        "SYS_DATE": "2020-08-12 12:03:22",
        "CAS_NO": "",
        "TW_ID": "TW",
        "CUS_OS_NO": "",
        "PRT_USR": "",
        "LJ_TB1": 1.0, 
        "LJ_TB2": 1.0
      }
    ],
    "TF_TB": [                           //生产单据表身信息
      {
        "TB_NO": "TB20081200000001",
        "ITM": 1,
        "PRD_NO": "0022",
        "PRD_NAME": "0022混合制程货品",
        "PRD_MARK": "",
        "WH": "001",
        "UNIT": "1",
        "QTY": 3.0,
        "QTY1": 6.0,
        "UP": 0.0,
        "UP_QTY1": 0.0,
        "UP_LOST": 0.0,
        "UP_QTY1_LOST": 0.0,
        "AMTN_NET": 0.0,
        "TAX": 0.0,
        "AMT": 0.0,
        "BAT_NO": "",
        "BAT_NAME": "",
        "TW_NO": "TW20081000000001",
        "MO_NO": "MO20081000000001",
        "EST_ITM": 2,
        "ID_NO": "0022->",
        "RTO_TAX": 5.0,
        "PRE_ITM": 2,
        "TW_ID": "TW",
        "CUS_OS_NO": "",
        "UP_STD": 0.0,
        "CST_STD": 0.0,
        "SPC": "",
        "LJ_TB3": 1.0,
        "LJ_TB4": 1.0
      }
    ],
    "MF_TB_Z": [
      {
        "LJ_TB1": 1.0,
        "LJ_TB2": 1.0,
        "TB_NO": "TB20081200000001"
      }
    ],
    "TF_TB_Z": [
      {
        "LJ_TB3": 1.0,
        "LJ_TB4": 1.0,
        "TB_NO": "TB20081200000001",
        "ITM": 1
      }
    ]
  }
}

生成【托工缴回单】接口

概述

参数说明

1.请求方式

2.header参数

3.请求参数

4.自定义参数

请求JSON示例

返回结果示例