2.4、合同主数据接口

---

GET  

接口说明

获取合同相关信息，包含合同编码、租期等。
合同相关信息的创建、修改、删除都调用此接口获取。

请求Query参数

公共参数

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

私有参数

数据结构

名称	类型	必选	中文名	说明
times	string	是	时间	上一次获取数据最大截止时间，时间格式：yyyy-MM-dd hh:mm:ss 第一次获取该数据时传2000-01-01 00:00:00或初始化时提供excel格式的初始化数据
pageno	string	是	页数	需要获取第几页数据（接口默认每页100条数据）
bizmode	string	是	合同类型	1:商铺 ；3：广告位；6：多种经营；7：仓库；8：写字楼；9：零星收费

请求示例（参数需要进行URL编码）：

http://10.1.69.126:8099/ess/master/getcontractsinfo?appid=1234560987&ts=20190910&sig=KsLPiDYwMj5Aj1UG5RUPc58iouu=&format=json&userip=192.168.0.10&times=2000-01-01 23:59:59&bizmode=1&pageno=1

返回响应

数据结构

名称	类型	必选	中文名	说明
ContractID	String		合同ID
OriginalContractsID	String		原合同Id
LOS_ContractsID	String		租赁合同ID
LOS_CustomerID	String		租赁租户ID
LOS_StoreID	String		租赁门店ID
LOS_F_CompanyId	String		租赁公司ID
F_CompanyName	String		公司名称
ManageCompanyCode	String		管理公司编码
ManageCompanyName	String		管理公司名称
BizMode	String		合同类型
LOS_BrandID	String		租赁品牌ID
LOS_TradeRelationID	String		租赁业态ID
BrandCode	String		品牌编码
BrandName	String		品牌名称
BrandLevel	String		品牌级次
ContractCode	Sting		合同编码
CustomerID	Sting		商户ID
CustomerCode	Sting		商户编码
CustomerName	Sting		商户名称
StoreID	Sting		门店ID
StoreCode	Sting		门店编码
StoreName	Sting		门店名称
ConStartDate	Sting		合同开始日期	yyyy-mm-dd
ConEndDate	Sting		合同结束日期	yyyy-mm-dd
ConStopDate	Sting		合同终止日期	yyyy-mm-dd
ContractsStatus	int		合同状态	2：已签约；3：执行中；4：已解约；5：已到期；6：已结算；7：已清算
ShopInfo	JSON		商铺信息
ConShopID	String		主键ID
ShopID	Int		商铺ID
ConShopCode	String		商铺编码
ConShopName	String		商铺名称
TradeCode	String		业态编码
TradeName	String		业态名称
RentArea	String		签约面积
ConShopUnit	JSON		商铺单元关系
ConShopUnitID	String		单元与商铺关系主键ID
ConShopID	String		商铺ID
UnitID	String		房屋ID
RecordTime	String		记录时间	yyyy-MM-dd hh:ss:mm

响应示例

成功

{
	"items": [{
		"ContractID": "2901dfca-067f-a865-3277-ea53aa2dc525",
		"ContractCode": "ZL191000527",
		"CustomerID": "b8c0ebea-ce9a-41cd-014d-64b5477510da",
		"CustomerCode": "CODE19101500003",
		"CustomerName": "刘东来",
		"StoreID": "7fc2f4e8-e57f-433f-93f5-e3c6144e414d",
		"StoreCode": "CDZJGC",
		"StoreName": "成都珠江广场",
		"ConStartDate": "2019-10-26",
		"ConEndDate": "2022-10-25",
		"ConStopDate": "",
		"ContractsStatus": 2,
		"ShopInfo": [{
			"ConShopID": "dc0c83c6-4483-45ea-8a74-c5318cc6458c",
			"ShopID": 3687,
			"ConShopCode": "L1-07",
			"ConShopName": "网鱼网咖",
			"TradeCode": "172",
			"TradeName": "电玩",
			"RentArea": 77,
			"ConShopUnit": [{
				"ConShopUnitID": "20d22975-a525-4b4a-b379-60f9409142d0",
				"ConShopID": "dc0c83c6-4483-45ea-8a74-c5318cc6458c",
				"UnitID": "c5e9f0d9-e196-7f9a-af0b-76cf8fefa7a7"
			}]
		}],
		"RecordTime": "2019-11-01 10:44:16"
	}]
}

失败

{
	"ret": 2001,
	"msg": "获取数据失败"
}