2.14、意向协议接口

---

POST  

接口说明

第三方系统调用该接口，以保存意向协议数据，
此方法保存的意向协议为已生效的意向协议。

请求Body参数

公共参数

请求时必须传入公共参数，详见公共接口说明

私有参数

数据结构

名称	类型	必选	中文名	说明
StoreID	String	是	项目ID	结算详情ID
IntentionContract	Json	是	意向协议信息	Json数组
UnitID	String	是	单元ID	招商租赁系统单元ID,单元ID数组
BuildingID	String	是	楼栋ID	招商租赁系统单元ID
FloorsID	String	是	楼层ID	招商租赁系统楼层ID
IntentionContractID	String	是	意向协议ID	招商租赁系统意向协议主键
F_CompanyId	String	是	收款甲方ID	招商租赁系统收款公司ID
CustomerName	String	是	商户名称
CustomerNo	String		商户编码
TaxCode	String	是	税号/身份证号	公司则为税号/个人则为身份证号
IntentionAmt	String	是	意向金额	需要收取的意向金金额
EffectiveDate	String	是	有效期	格式为YYYY-MM-dd
Remark	String	否	备注	意向协议的备注
CreateUserID	String	是	创建人	招商租赁系统用户ID

请求示例

{
	"StoreID": "08a2f8ee-700a-4fb0-810a-1e8995a8631e",
	"num": 3,
	"IntentionContract": {
		"UnitID": [
			"1F001",
			"1F002",
			"1F003"
		],
		"BuildingID": "250d787b-2703-4b96-901a-4e3bd40e6517",
		"FloorsID": "97dfa26d-29c3-47b0-b7d9-65e656860634",
		"ContractsID ": "",
		"F_CompanyId": "5677c42d-b4ed-4577-92a0-285bcf15a56c",
		"CustomerID": "",
		"CustomerName": "测试商户A",
		"CustomerType": 1,
		"TaxCode": "12465469846516341665146",
		"IntentionAmt": "100000.00",
		"EffectiveDate": "2022-03-03",
		"Remark": "备注文字"
	},
	"CreateUserID": "admin"
}

返回响应

数据结构

名称	类型	必选	中文名	说明
code	Int	是	错误码
msg	String	是	描述
data	JSON	是	返回信息
CustomerID	String		商户ID
TaxCode	String		税号
IntentionContractID	String		意向协议ID

响应示例

成功

{
	"code": 0,
	"msg": "接受数据成功，且成功处理",
	"data": [{
		" CustomerID ": "xxxx",
		" TaxCode ": "xxxx",
		" IntentionContractID ": "xxxx"
	}]
}

错误码

数据结构

错误码	描述
0	接受数据成功，且成功处理。
-1	数据接收失败，数据校验未通过
-2	数据接收失败，租户未找到
-4	数据接收失败，租户重复（未传商户ID，且统一信用代码/身份证号重复
-999	数据处理失败：其他错误