概述
该接口主要用于第三方平台或自主研发者，通过调用【托工退回单】的生成接口，将第三方的委外加工的制成品或半成品退回给加工供应商的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【托工退回单】。
参数说明
1.请求方式
| 请求方式 |
POST |
| 接口地址 |
http://ERPAPI站点/MRPBR/ADDDATA |
| 格式 |
JSON |
| 编码类型 |
UTF-8 |
2.header参数
| Content-Type |
application/json |
| Authorization |
token |
授权接口所获取的值 |
3.请求参数
| 字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
| 第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号，必填 |
| 程序代号 |
PGM |
|
|
是 |
MRPBR |
|
| 数据表MF_TC |
| 退回单号 |
TC_NO |
string |
20 |
是 |
|
1.自动编码，则不用传值；
2.手工编码，则与REF_NO必须相同 |
| 退回日期 |
TC_DD |
datetime |
0 |
是 |
|
格式：YYYY-MM-DD |
| 结帐期 |
PAY_DD |
datetime |
|
|
|
|
| 票据到期日 |
CHK_DD |
datetime |
|
|
|
|
| 贸易条件代号 |
TRAD_MTH |
string |
20 |
|
|
|
| 批号 |
BAT_NO |
string |
40 |
|
|
|
| 客户代号 |
CUS_NO |
string |
12 |
是 |
|
|
| 凭证模版代号 |
VOH_ID |
string |
2 |
|
|
|
| 凭证号码 |
VOH_NO |
string |
20 |
|
|
|
| 部门代号 |
DEP |
string |
8 |
是 |
|
|
| 发票号码 |
INV_NO |
string |
20 |
|
|
|
| 税别 |
TAX_ID |
string |
1 |
是 |
|
|
| 托工缴回单号 |
TB_NO |
string |
25 |
|
|
|
| 送货方式 |
SEND_MTH |
string |
200 |
|
|
|
| 送货仓 |
SEND_WH |
string |
12 |
|
|
|
| 送货地址 |
ADR |
string |
50 |
|
|
|
| 付款单号 |
RP_NO |
string |
20 |
|
|
|
| 立帐方式 |
ZHANG_ID |
string |
1 |
是 |
|
|
| 币别 |
CUR_ID |
string |
4 |
|
|
|
| 汇率 |
EXC_RTO |
float |
|
|
|
|
| 业务员代号 |
SAL_NO |
string |
12 |
|
|
|
| 应收帐单号 |
ARP_NO |
string |
20 |
|
|
|
| 交易类别 |
PAY_MTH |
string |
1 |
|
|
|
| 起算日 |
PAY_DAYS |
integer |
|
|
|
|
| 票据天数 |
CHK_DAYS |
integer |
|
|
|
|
| 间隔天数 |
INT_DAYS |
integer |
|
|
|
|
| 交易摘要 |
PAY_REM |
string |
80 |
|
|
|
| 指定结帐日资料 |
CLS_REM |
string |
30 |
|
|
|
| 结案否 |
CLOSE_ID |
string |
1 |
|
|
|
| 摘要 |
REM |
string |
100 |
|
|
|
| 拷贝注记 |
CPY_SW |
string |
1 |
|
|
|
| 制单人 |
USR |
string |
12 |
是 |
|
|
| 审核人 |
CHK_MAN |
string |
12 |
|
|
|
| 打印注记 |
PRT_SW |
string |
1 |
|
|
|
| 终审日期 |
CLS_DATE |
datetime |
|
|
|
|
| 影响托工已交量 |
TC_ID |
string |
1 |
|
|
值的范围：T、F或NULL（T影响；F或NULL为不影响，默认T） |
| 单据类别 |
BIL_TYPE |
string |
10 |
|
|
|
| 开票标记 |
KP_ID |
string |
1 |
|
|
|
| 开票立帐结案标志 |
LZ_CLS_ID |
string |
1 |
|
|
|
| 缴库单凭证模版代号 |
MMVOH_ID |
string |
2 |
|
|
|
| 审核模版 |
MOB_ID |
string |
10 |
|
|
|
| 锁单人 |
LOCK_MAN |
string |
12 |
|
|
|
| 锁单时间 |
LOCK_DATE |
datetime |
0 |
|
|
|
| 附件张数 |
FJ_NUM |
integer |
|
|
|
|
| 输单日期 |
SYS_DATE |
datetime |
|
|
|
|
| 发票日 |
INV_DD |
datetime |
|
|
|
|
| 买受人抬头 |
TITLE_BUY |
string |
50 |
|
|
|
| 申报期别 |
INV_YM |
integer |
|
|
|
|
| 发票别 |
METH_ID |
string |
2 |
|
|
|
| 已开发票金额合计 |
AMT_CLS |
float |
0 |
|
|
|
| 已开发票未税合计 |
AMTN_NET_CLS |
float |
0 |
|
|
|
| 已开发票税额合计 |
TAX_CLS |
float |
0 |
|
|
|
| 工程案号 |
CAS_NO |
string |
20 |
|
|
|
| 任务编号 |
TASK_ID |
integer |
0 |
|
|
|
| 立帐开票开票方式 |
TURN_ID |
string |
1 |
|
|
|
| 客户订单 |
CUS_OS_NO |
string |
30 |
|
|
|
| 打印人员 |
PRT_USR |
string |
12 |
|
|
|
| 已开发票数量合计 |
QTY_CLS |
float |
0 |
|
|
|
| 发票退回金额 |
AMT_INV |
float |
0 |
|
|
|
| 发票退回税额 |
TAX_INV |
float |
0 |
|
|
|
| 作废标记 |
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 |
|
|
|
| 汇率(功能货币) |
EXC_RTO_IFRS |
float |
0 |
|
|
|
| 打印日期 |
PRT_DATE |
datetime |
0 |
|
|
|
| 已开发票数量合计(副) |
QTY1_CLS |
float |
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_DATE |
datetime |
0 |
|
|
|
| 扫描人 |
SCAN_USR |
string |
12 |
|
|
|
| 对帐人 |
DZ_USR |
string |
12 |
|
|
|
| 对帐日期 |
DZ_DATE |
datetime |
0 |
|
|
|
| 已开票金额差额 |
AMT_ZG_CLS |
float |
0 |
|
|
|
| 已开票未税差额 |
AMTN_NET_ZG_CLS |
float |
0 |
|
|
|
| 已开票税额差额 |
TAX_ZG_CLS |
float |
0 |
|
|
|
| 取来源单发票 |
BIL_FP_FLAG |
string |
1 |
|
|
|
| WMS产生的单据 |
WMS_ID |
string |
1 |
|
|
|
| 数据表TF_TC |
| 退回单号 |
TC_NO |
string |
20 |
是 |
|
必须与表MF_TC的TC_NO相同 |
| 项次 |
ITM |
integer |
|
是 |
|
|
| 退回日期 |
TC_DD |
datetime |
|
是 |
|
必须与表MF_TC的TC_DD相同 |
| 货品代号 |
PRD_NO |
string |
30 |
是 |
|
|
| 货品特征 |
PRD_MARK |
string |
100 |
|
|
|
| 仓库 |
WH |
string |
12 |
是 |
|
|
| 单位 |
UNIT |
string |
1 |
是 |
|
|
| 数量 |
QTY |
float |
|
是 |
|
|
| 副单位数量 |
QTY1 |
float |
|
|
|
|
| 单价 |
UP |
float |
|
|
|
|
| 副单位单价 |
UP_QTY1 |
float |
|
|
|
|
| 未税本位币 |
AMTN_NET |
float |
|
|
|
|
| 税额 |
TAX |
float |
|
|
|
|
| 外币金额 |
AMT |
float |
|
|
|
|
| 批号 |
BAT_NO |
string |
40 |
|
|
|
| 托工缴回单 |
TB_NO |
string |
20 |
是 |
|
|
| 托工单号 |
TW_NO |
string |
20 |
是 |
|
|
| 摘要 |
REM |
string |
100 |
|
|
|
| 包装单位 |
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 |
|
|
|
| 拷贝注记 |
CPY_SW |
string |
1 |
|
|
|
| 追踪项次 |
EST_ITM |
integer |
|
|
|
|
| 配方号 |
ID_NO |
string |
38 |
|
|
|
| 托外货品税率 |
RTO_TAX |
float |
|
|
|
|
| 鞋服组合栏位 |
COMPOSE_IDNO |
string |
50 |
|
|
|
| 发票票面金额 |
AMT_FP |
float |
|
|
|
|
| 发票本位币金额 |
AMTN_NET_FP |
float |
|
|
|
|
| 发票税额 |
TAX_FP |
float |
|
|
|
|
| 退料单号(M5) |
ML_NO |
string |
20 |
|
|
|
| 缴库单号 |
MM_NO |
string |
20 |
|
|
|
| 发票数量 |
QTY_FP |
float |
|
|
|
|
| 任务编号 |
TASK_ID |
integer |
0 |
|
|
|
| 追踪项次 |
PRE_ITM |
integer |
0 |
|
|
|
| 客户订单 |
CUS_OS_NO |
string |
30 |
|
|
|
| 入库日期 |
RK_DD |
datetime |
0 |
|
|
|
| 有效日期 |
VALID_DD |
datetime |
0 |
|
|
|
| 是搭赠品否 |
FREE_ID |
string |
1 |
|
|
|
| 集团公司代号 |
DEP_RK |
string |
8 |
|
|
|
| 退回转缴回量 |
QTY_TB |
float |
0 |
|
|
|
| 未审核缴回量 |
QTY_TB_UNSH |
float |
0 |
|
|
|
| 折扣 |
DIS_CNT |
float |
0 |
|
|
|
| 折扣额 |
AMT_DIS_CNT |
float |
0 |
|
|
|
| 已开票差异金额 |
AMT_ZG_FP |
float |
0 |
|
|
|
| 已开票未税差额 |
AMTN_NET_ZG_FP |
float |
0 |
|
|
|
| 已开票税金差额 |
TAX_ZG_FP |
float |
0 |
|
|
|
| 已开发票数量(副) |
QTY1_FP |
float |
0 |
|
|
|
| 品名 |
PRD_NAME |
string |
160 |
|
|
|
| 生产日期 |
SC_DD |
datetime |
0 |
|
|
|
| 入库数量 |
QTY_RK |
float |
0 |
|
|
|
| 未审核入库数量 |
QTY_RK_UNSH |
float |
0 |
|
|
|
| 储位代号 |
CHUW |
string |
60 |
|
|
|
| 对账人 |
DZ_USR |
string |
12 |
|
|
|
| 对账日期 |
DZ_DATE |
datetime |
0 |
|
|
|
4.自定义参数
| 字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
| 数据表MF_TC_Z（表头自定义字段） |
| 自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
| 自定义栏位2 |
自定义 |
string |
|
|
|
| …… |
…… |
…… |
|
|
|
| 数据表TF_TC_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": "TC20081300000001", //第三方单号，必填
"PGM": "MRPBR", //单据程序代号
"MF_TC": [ //新增单据表头信息
{
"TC_NO": "TC20081300000001",
"TC_DD": "2020-08-13 00:00:00",
"DEP": "00000000",
"CUS_NO": "0009",
"TB_NO": "TB20081300000001",
"BAT_NO": "",
"SAL_NO": "9999",
"TAX_ID": "2",
"VOH_ID": "",
"REM": "倒冲领料",
"USR": "0001",
"PAY_DD": "2020-09-01 00:00:00",
"CHK_DD": "2020-10-01 00:00:00",
"ZHANG_ID": "1",
"CUR_ID": "",
"EXC_RTO": 1.0,
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2020-09-01; 票据到期日:2020-10-01",
"CLS_REM": "票据到期日:97-02-15",
"TC_ID": "T",
"BIL_TYPE": "01",
"MMVOH_ID": "",
"MOB_ID": "",
"CAS_NO": "",
"CUS_OS_NO": ""
}
],
"TF_TC": [ //新增单据表身信息
{
"ITM": 1,
"PRD_NO": "0021",
"WH": "001",
"UNIT": "1",
"QTY": 1.0,
"UP": 200.0,
"AMT": 200.0,
"AMTN_NET": 190.48,
"TAX": 9.52,
"TB_NO": "TB20081300000001",
"TW_NO": "TW20081200000001",
"REM": "倒冲领料",
"BAT_NO": "",
"ID_NO": "0021->1.0",
"QTY1": 0.0,
"TC_NO": "TC20081300000001",
"EST_ITM": 1,
"TC_DD": "2020-08-13 00:00:00",
"PRD_MARK": "",
"RTO_TAX": 5.0,
"PRE_ITM": 1,
"CUS_OS_NO": "",
"FREE_ID": "",
"PRD_NAME": "0021制成品",
"SPC": "",
"SO_ITM": "1"
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_TC": [ //生成单据表头信息
{
"TC_NO": "TC20081300000001",
"TC_DD": "2020-08-13 00:00:00",
"DEP": "00000000",
"CUS_NO": "0009",
"TB_NO": "TB20081300000001",
"BAT_NO": "",
"SAL_NO": "9999",
"TAX_ID": "2",
"VOH_ID": "",
"REM": "倒冲领料",
"USR": "0001",
"CLOSE_ID": "F",
"PAY_DD": "2020-09-01 00:00:00",
"CHK_DD": "2020-10-01 00:00:00",
"SEND_WH": "",
"RP_NO": "",
"ZHANG_ID": "1",
"CUR_ID": "",
"EXC_RTO": 1.0,
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2020-09-01; 票据到期日:2020-10-01",
"PRT_SW": "N",
"CLS_REM": "票据到期日:97-02-15",
"TC_ID": "T",
"BIL_TYPE": "01",
"KP_ID": "F",
"MMVOH_ID": "",
"MOB_ID": "01",
"SYS_DATE": "2020-08-20 16:04:49",
"CAS_NO": "",
"CUS_OS_NO": "",
"PRT_USR": ""
}
],
"TF_TC": [ //生成单据表身信息
{
"ITM": 1,
"PRD_NO": "0021",
"WH": "001",
"UNIT": "1",
"QTY": 1.0,
"UP": 200.0,
"AMT": 200.0,
"AMTN_NET": 190.48,
"TAX": 9.52,
"TB_NO": "TB20081300000001",
"TW_NO": "TW20081200000001",
"REM": "倒冲领料",
"BAT_NO": "",
"ID_NO": "0021->1.0",
"QTY1": 0.0,
"TC_NO": "TC20081300000001",
"EST_ITM": 1,
"TC_DD": "2020-08-13 00:00:00",
"PRD_MARK": "",
"RTO_TAX": 5.0,
"MM_NO": "MM2008130003",
"PRE_ITM": 1,
"CUS_OS_NO": "",
"FREE_ID": "",
"PRD_NAME": "0021制成品",
"SPC": ""
}
],
"MF_TC_Z": [ //生成单据表头自定义信息
{
"TC_NO": "TC20081300000001"
}
],
"TF_TC_Z": [ //生成单据表身自定义信息
{
"TC_NO": "TC20081300000001",
"ITM": 1
}
]
}
}