生成【托工折让单】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【托工折让单】的生成接口，将第三方系统托工折让的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【托工折让单】。
参数说明
1.请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/MRPBRA/ADDDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号，必填 | |||
| 程序代号 | PGM | 是 | MRPBRA | |||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表MF_TD | ||||||
| 折让单号 | TD_NO | string | 20 | 是 | 1.自动编码时，根据单据编码原则自动产生； 2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同 3.目前删除和速查单据都只能通过online单号执行，不可以通过第三方单号，因此第三方须记录online单号 |
|
| 折让日期 | TD_DD | datetime | 0 | 是 | 格式为：YYYY-MM-DD | |
| 部门 | DEP | string | 8 | 是 | ||
| 客户代号 | CUS_NO | string | 12 | 是 | ||
| 结帐期 | PAY_DD | datetime | 0 | |||
| 票据到期日 | CHK_DD | datetime | 0 | |||
| 批号 | BAT_NO | string | 40 | |||
| 凭证模版代号 | VOH_ID | string | 2 | |||
| 凭证号码 | VOH_NO | string | 20 | |||
| 发票号码 | INV_NO | string | 20 | |||
| 扣税类别 | TAX_ID | string | 1 | 是 | 1.不计税；2.应税内含；3.应税外加 | |
| 托外缴回单号 | TB_NO | string | 25 | |||
| 送货方式 | SEND_MTH | string | 200 | |||
| 送货仓 | SEND_WH | string | 12 | |||
| 送货地址 | ADR | string | 0 | |||
| 立帐方式 | ZHANG_ID | string | 1 | 是 | 1.单据立帐；2.不立帐；3.收到发票才立帐 | |
| 立帐单号 | ARP_NO | string | 20 | |||
| 币别 | CUR_ID | string | 4 | |||
| 汇率 | EXC_RTO | float | 0 | |||
| 业务员 | SAL_NO | string | 12 | |||
| 交易类别 | PAY_MTH | string | 1 | |||
| 起算日 | PAY_DAYS | int | 0 | |||
| 票据天数 | CHK_DAYS | int | 0 | |||
| 间隔天数 | INT_DAYS | int | 0 | |||
| 交易摘要 | PAY_REM | string | 80 | |||
| 指定结帐日资料 | CLS_REM | string | 30 | |||
| 结案否 | CLOSE_ID | string | 1 | |||
| 备注 | REM | string | 0 | |||
| 拷贝注记 | CPY_SW | string | 1 | |||
| 打印注记 | PRT_SW | string | 1 | |||
| 录入员 | USR | string | 12 | 是 | ||
| 审核人 | CHK_MAN | string | 12 | |||
| 终审日期 | CLS_DATE | datetime | 0 | |||
| 单据类别 | BIL_TYPE | string | 10 | |||
| 审核模板 | MOB_ID | string | 10 | |||
| 锁单人 | LOCK_MAN | string | 12 | |||
| 锁单时间 | LOCK_DATE | datetime | 0 | |||
| 输单日期 | SYS_DATE | datetime | 0 | |||
| 附件张数 | FJ_NUM | int | 0 | |||
| 缴库单凭证模版 | MMVOH_ID | string | 2 | |||
| 开票标记 | KP_ID | string | 1 | |||
| 开票立帐结案标志 | LZ_CLS_ID | string | 1 | |||
| 发票日 | INV_DD | datetime | 0 | |||
| 申报期别 | INV_YM | int | 0 | |||
| 发票别 | METH_ID | string | 2 | |||
| 任务编号 | TASK_ID | int | 0 | |||
| 工程案号 | CAS_NO | string | 20 | |||
| 买受人抬头 | TITLE_BUY | string | 50 | |||
| RP_NO | string | 20 | ||||
| 贸易条件代号 | TRAD_MTH | string | 20 | |||
| 立帐开票开票方式 | TURN_ID | string | 1 | |||
| 已开发票金额合计 | AMT_CLS | float | 0 | |||
| 已开发票未税合计 | AMTN_NET_CLS | float | 0 | |||
| 已开发票税额合计 | TAX_CLS | float | 0 | |||
| 打印人员 | PRT_USR | string | 12 | |||
| 已开发票数量合计 | QTY_CLS | float | 0 | |||
| 调整发票差额 | TZZG | string | 1 | |||
| 作废标记 | CANCEL_ID | string | 1 | |||
| 发票退回金额 | AMT_INV | float | 0 | |||
| 发票退回税额 | TAX_INV | float | 0 | |||
| 首付比例 | RTO_FQSK | float | 0 | |||
| 首付日期方式 | DATEFLAG_FQSK | string | 1 | |||
| 首付指定日期 | DATE_FQSK | datetime | 0 | |||
| 期数 | QS_FQSK | int | 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 | |||
| 对帐人 | 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 | |||
| 发票自动结案回写 | CLSLZ | string | 1 | |||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表TF_TD | ||||||
| 折让单号 | TD_NO | string | 20 | 是 | 必须要与MF_TW的TD_NO相同 | |
| 项 | ITM | int | 0 | 是 | ||
| 折让日期 | TD_DD | datetime | 0 | 是 | 必须要与MF_TW的TD_DD相同 | |
| 品号 | PRD_NO | string | 30 | 是 | ||
| 特征 | PRD_MARK | string | 100 | |||
| 库位 | WH | string | 12 | 是 | ||
| 单位 | UNIT | string | 1 | 是 | ||
| 数量 | QTY | float | 0 | 是 | ||
| 数量副 | QTY1 | float | 0 | |||
| 未税本位币 | AMTN_NET | float | 0 | |||
| 税额 | TAX | float | 0 | |||
| 外币金额 | AMT | float | 0 | |||
| 批号 | BAT_NO | string | 40 | |||
| 缴回单号 | TB_NO | string | 20 | |||
| 托工单号 | TW_NO | string | 20 | 是 | 关联的托工单号 | |
| 备注 | REM | string | 100 | |||
| 包装单位 | PAK_UNIT | string | 20 | |||
| 包装换算 | PAK_EXC | float | 0 | |||
| 包装净重 | PAK_NW | float | 0 | |||
| 包装净重单位 | PAK_WEIGHT_UNIT | string | 8 | |||
| 包装毛重 | PAK_GW | string | 20 | |||
| 包装大小 | PAK_MEAST | float | 0 | |||
| 包装大小单位 | PAK_MEAST_UNIT | string | 8 | |||
| 追踪项次 | EST_ITM | int | 0 | |||
| 配方号 | ID_NO | string | 38 | 是 | 如A001-> | |
| 税率 | TAX_RTO | float | 0 | |||
| 缴库单号 | MM_NO | string | 20 | |||
| 发票票面金额 | AMT_FP | float | 0 | |||
| 发票本位币金额 | AMTN_NET_FP | float | 0 | |||
| 发票税额 | TAX_FP | float | 0 | |||
| PRE_ITM | int | 0 | ||||
| 发票数量 | QTY_FP | float | 0 | |||
| 已开票差异金额 | AMT_ZG_FP | float | 0 | |||
| 已开票未税差额 | AMTN_NET_ZG_FP | float | 0 | |||
| 已开票税金差额 | TAX_ZG_FP | float | 0 | |||
| 税额(功能货币) | TAX_IFRS | float | 0 | |||
| 已开发票数量(副) | QTY1_FP | float | 0 | |||
| 品名 | PRD_NAME | string | 160 | |||
| 生产日期 | SC_DD | datetime | 0 | |||
| 对账人 | DZ_USR | string | 12 | |||
| 对账日期 | DZ_DATE | datetime | 0 | |||
请求JSON示例
{
"REF_NO": "MRPBRA20201228001", //第三方单号，必填
"PGM": "MRPBRA", //单据程序代号
"MF_TD": [ //新增单据表头信息
{
"TD_NO": "",
"TD_DD": "2020-12-28 00:00:00",
"DEP": "0101",
"CUS_NO": "1001",
"PAY_DD": "2021-01-01 00:00:00",
"CHK_DD": "2021-02-01 00:00:00",
"BAT_NO": "",
"VOH_ID": "",
"TAX_ID": "2",
"TB_NO": "TB0C280001",
"SEND_MTH": "1",
"ZHANG_ID": "1",
"CUR_ID": "",
"EXC_RTO": 0.0,
"SAL_NO": "10001",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2021-01-01;票据到期日:2021-02-01",
"CLS_REM": "",
"USR": "ADMIN",
"BIL_TYPE": "",
"MMVOH_ID": "",
"CAS_NO": ""
}
],
"TF_TD": [ //新增单据表身信息
{
"TD_NO": "",
"ITM": 1,
"TD_DD": "2020-12-28 00:00:00",
"PRD_NO": "A2001",
"PRD_MARK": "",
"WH": "A000",
"UNIT": "1",
"AMTN_NET": 9.52,
"TAX": 0.48,
"AMT": 10.0,
"TB_NO": "TB0C280001",
"TW_NO": "TW0C280001",
"EST_ITM": 1,
"ID_NO": "A2001->",
"TAX_RTO": 5.0,
"PRE_ITM": 1,
"PRD_NAME": "A2001制成品",
"BAT_NO": ""
}
]
}
返回结果示例
{
"code": 0,
"message": "新增成功",
"data": {
"MF_TD": [
{
"TD_NO": "DT0C280001",
"TD_DD": "2020-12-28 00:00:00",
"DEP": "0101",
"CUS_NO": "1001",
"PAY_DD": "2021-01-01 00:00:00",
"CHK_DD": "2021-02-01 00:00:00",
"BAT_NO": "",
"VOH_ID": "",
"TAX_ID": "2",
"TB_NO": "TB0C280001",
"SEND_MTH": "1",
"SEND_WH": "",
"ZHANG_ID": "1",
"ARP_NO": "AP0C280002",
"CUR_ID": "",
"EXC_RTO": 0.0,
"SAL_NO": "10001",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2021-01-01;票据到期日:2021-02-01",
"CLS_REM": "",
"CLOSE_ID": "F",
"PRT_SW": "N",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"CLS_DATE": "2020-12-28 00:00:00",
"BIL_TYPE": "",
"MOB_ID": "",
"SYS_DATE": "2020-12-29 14:20:14",
"MMVOH_ID": "",
"KP_ID": "F",
"CAS_NO": "",
"RP_NO": "",
"PRT_USR": ""
}
],
"TF_TD": [
{
"TD_NO": "DT0C280001",
"ITM": 1,
"TD_DD": "2020-12-28 00:00:00",
"PRD_NO": "A2001",
"PRD_MARK": "",
"WH": "A000",
"UNIT": "1",
"AMTN_NET": 9.52,
"TAX": 0.48,
"AMT": 10.0,
"TB_NO": "TB0C280001",
"TW_NO": "TW0C280001",
"EST_ITM": 1,
"ID_NO": "A2001->",
"TAX_RTO": 5.0,
"PRE_ITM": 1,
"PRD_NAME": "A2001制成品",
"BAT_NO": ""
}
]
}
}