新增【固定资产购入单】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【固定资产购入单】的生成接口，将第三方客户询价的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【客固定资产购入单】。
参数说明
1.请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/FIXUM/ADDDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号，必填 | |||
| 程序代号 | PGM | 是 | FIXUM | |||
| 请求参数 | ||||||
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 数据表MF_GR | ||||||
| 购入ID | GR_ID | String | 2 | 是 | UM | |
| 购入单号 | GR_NO | String | 20 | 1.自动编码时，根据单据编码原则自动产生； 2.手工编码时，根据JSON的单据号码必填，且与REF_NO必须相同 3.目前删除和速查单据都只能通过ERP单号执行，不可以通过第三方单号，因此第三方须记录ERP单号 |
||
| 购入日期 | GR_DD | datetime | 0 | 是 | 格式为：YYYY-MM-DD | |
| 部门代号 | DEP | String | 8 | 是 | ||
| 业务员 | SAL_NO | String | 12 | |||
| 单据类别 | BIL_TYPE | String | 10 | |||
| 厂商代号 | CUS_NO | String | 12 | 是 | ||
| 币别代号 | CUR_ID | String | 4 | |||
| 汇率 | EXC_RTO | float | 0 | |||
| 扣税类别 | TAX_ID | String | 1 | 是 | 1.值分别为1；2；3 2.分别表示(1不计税 2应税内含 3应税外加) |
|
| 立帐方式 | ZHANG_ID | String | 1 | 是 | 1.值分别为1；2；3 2.分别表示(1单张立帐 2不立帐 3收到发票才立帐) |
|
| 转入单ID | OS_ID | String | 2 | |||
| 转入单号 | OS_NO | String | 25 | |||
| 含税资产 | CHK_HS | String | 1 | |||
| 凭证模版代号 | VOH_ID | String | 2 | |||
| 凭证号码 | VOH_NO | String | 20 | |||
| 备注 | REM | String | 255 | |||
| 送货方式 | SEND_MTH | String | 200 | |||
| 送货仓 | SEND_WH | String | 12 | |||
| 送货地址 | ADR | String | 0 | |||
| 预付外币金额 | AMT_IRP | float | 0 | |||
| 预付本币金额 | AMTN_IRP | float | 0 | |||
| 预付税额 | TAX_IRP | float | 0 | |||
| 交易方式 | PAY_MTH | String | 1 | 默认为1 | ||
| 付款天数 | PAY_DAYS | int | 0 | 默认为1 | ||
| 票据天数 | CHK_DAYS | int | 0 | 默认为30 | ||
| 间隔天数 | INT_DAYS | int | 0 | 默认为30 | ||
| 交易备注 | PAY_REM | String | 80 | 如：“结帐期:2021-09-01; 票据到期日:2021-10-01” | ||
| 指定结帐日资料 | CLS_REM | String | 30 | 如：“票据到期日:97-02-15结帐期:97-0” | ||
| 结帐期 | PAY_DD | datetime | 0 | 格式为：YYYY-MM-DD | ||
| 票据到期日 | CHK_DD | datetime | 0 | 格式为：YYYY-MM-DD | ||
| 付款单号 | RP_NO | String | 20 | |||
| 应付款单号 | ARP_NO | String | 20 | |||
| 首付比例 | RTO_FQSK | float | 0 | |||
| 首付日期方式 | DATEFLAG_FQSK | String | 1 | |||
| 首付指定日期 | DATE_FQSK | datetime | 0 | |||
| 期数 | QS_FQSK | int | 0 | |||
| 发票号码 | INV_NO | String | 20 | |||
| 开票标记 | KP_ID | String | 1 | |||
| 立帐结案标志 | LZ_CLS_ID | String | 1 | |||
| 立帐开票开票方式 | TURN_ID | String | 1 | |||
| 已开发票金额合计 | AMT_CLS | float | 0 | |||
| 已开发票未税合计 | AMTN_NET_CLS | float | 0 | |||
| 已开发票税额合计 | TAX_CLS | float | 0 | |||
| 已开发票数量合计 | QTY_CLS | float | 0 | |||
| 立帐结案日期 | LZ_CLS_DD | datetime | 0 | |||
| 审核模版 | MOB_ID | String | 10 | |||
| 制单人 | USR | String | 12 | 是 | ||
| 制单日期 | SYS_DATE | datetime | 0 | |||
| 审核人 | CHK_MAN | String | 12 | |||
| 终审日期 | CLS_DATE | datetime | 0 | |||
| 打印注记 | PRT_SW | String | 1 | |||
| 打印人员 | PRT_USR | String | 12 | |||
| 打印日期 | PRT_DATE | datetime | 0 | |||
| 拷贝注记 | CPY_SW | String | 1 | |||
| 期初清档转入标记 | QC_SW | String | 1 | |||
| 锁单人 | LOCK_MAN | String | 12 | |||
| 锁单时间 | LOCK_DATE | datetime | 0 | |||
| 来源ID | BIL_ID | String | 2 | |||
| 来源单号 | BIL_NO | String | 20 | |||
| 最近修改日期 | MODIFY_DD | datetime | 0 | |||
| 最近修改人 | MODIFY_MAN | String | 12 | |||
| 发票来源ID | INV_BIL_ID | String | 2 | |||
| 发票来源单号 | INV_BIL_NO | String | 20 | |||
| 外币金额 | AMT | float | 0 | |||
| 金额 | AMTN | float | 0 | |||
| 未税本位币 | AMTN_NET | float | 0 | |||
| 税额 | TAX | float | 0 | |||
| 已开发票数量合计(副) | QTY1_CLS | float | 0 | |||
| 作废标记 | CANCEL_ID | String | 1 | |||
| 对账人 | DZ_USR | String | 12 | |||
| 对账日期 | DZ_DATE | datetime | 0 | |||
| 结案标识 | CLS_ID | String | 1 | |||
| 集团单据类型 | GROUP_TYPE_ID | String | 2 | |||
| 批次产生单据标志 | GROUP_AUTO_BIL | String | 1 | |||
| 扫描标记 | SCAN_ID | String | 1 | |||
| 扫描用户 | SCAN_USR | String | 12 | |||
| 扫描时间 | SCAN_DATE | datetime | 0 | |||
| 合作模式(服务) | HZ_ID | String | 1 | |||
| 原立账方式 | ORG_LZ_ID | String | 1 | |||
| 集团单据唯一码 | GROUP_KEY | String | 100 | |||
| 实际客户 | GROUP_CUS_NO | String | 12 | |||
| 已开票金额差额 | AMT_ZG_CLS | float | 0 | |||
| 已开票未税差额 | AMTN_NET_ZG_CLS | float | 0 | |||
| 已开票税额差额 | TAX_ZG_CLS | float | 0 | |||
| 合作模式 | HZ_ID1 | String | 1 | |||
| 预收付未税金额(本) | AMTN_NET_IRP | float | 0 | |||
| 预收付未税金额(外) | AMT_NET_IRP | float | 0 | |||
| 合同号 | CONTRACT | String | 80 | |||
| 产品别 | APP_NAME_DATA | string | 30 | |||
请求JSON示例
{
"REF_NO": "TXUM202108060001", //第三方单号，必填
"PGM": "FIXUM", //程序代号
"MF_GR": [ //单据表峰请求参数信息
{
"GR_ID": "UM",
"GR_NO": "",
"GR_DD": "2021-08-06 00:00:00",
"PAY_DD": "2021-09-01 00:00:00",
"CHK_DD": "2021-10-01 00:00:00",
"CUS_NO": "1001",
"DEP": "00000000",
"TAX_ID": "2",
"ZHANG_ID": "1",
"CUR_ID": "",
"EXC_RTO": 1.0,
"SAL_NO": "10001",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2021-05-01;票据到期日:2021-06-01",
"USR": "ADMIN",
"BIL_TYPE": ""
}
],
"TF_GR": [ //单据表峰请求参数信息
{
"GR_ID": "UM",
"GR_NO": "",
"ITM": 1,
"GR_DD": "2021-05-25 00:00:00",
"FX_NAME": "打印机",
"UNIT": "1",
"QTY": 1.0,
"UP": 5000.0,
"AMT": 5000.0,
"AMTN_NET": 5000
}
]
}
返回结果示例
{
"code": 0, //0表示执行成功，其他值表示失败
"message": "新增成功",
"data": { //生成单据的明细情况
"MF_GR": [
{
"GR_ID": "UM",
"GR_NO": "UM18060001",
"GR_DD": "2021-08-06 00:00:00",
"DEP": "00000000",
"SAL_NO": "10001",
"BIL_TYPE": "",
"CUS_NO": "1001",
"CUR_ID": "",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"ZHANG_ID": "1",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2021-05-01;票据到期日:2021-06-01",
"PAY_DD": "2021-09-01 00:00:00",
"CHK_DD": "2021-10-01 00:00:00",
"ARP_NO": "AP18060001",
"KP_ID": "F",
"LZ_CLS_ID": "F",
"USR": "ADMIN",
"SYS_DATE": "2021-08-06 16:17:33",
"CHK_MAN": "ADMIN",
"CLS_DATE": "2021-08-06 00:00:00",
"PRT_SW": "N"
}
],
"TF_GR": [
{
"GR_ID": "UM",
"GR_NO": "UM18060001",
"ITM": 1,
"FX_NAME": "打印机",
"UNIT": "1",
"QTY": 1.0,
"UP": 5000.0,
"AMT": 5000.0,
"AMTN_NET": 5000.0,
"PRE_ITM": 1
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
}