停车记录日对账 | 开放平台开发文档

# 停车记录日对账

最新更新时间：2023.06.13

停车场库本地系统将驶入记录数、驶出记录数上传，开放平台会对比平台自身记录的数量后给出对账结果。
平台返回对应参数0或1，返回0时表示对账平，返回1时表示对账不平。（相关解释请阅读下方请求参数和返回参数说明）
若有漏传则按照以下账不平补传流程进行补传。（建议在次日凌晨业务低谷时进行对账，对账和补账时间控制在次日凌晨4点之前，4点之后不在统计范围，会导致对账失败。）

账不平补传流程

1.对账日定时（推荐次日夜间0点~4点）请求接口【停车记录日对账】进行对账，比对停车场库入场出场记录数与开放平台记录数是否帐平；
2.若账不平，请求【停车记录对账日开放平台order_id获取】接口来获取停车场库已经传递给开放平台的数据（驶入驶出记录需分开请求，通过type区别），和停车场库数据进行对比，确定漏传数据；
3.根据漏传数据的情况调用【停车场入场信息上报】、【停车场出场信息上报】接口来补传信息。

# 接口说明

请求URL： https://{domain}/os-park/ospark/open/api/v2/uploadCheckRecord

请求方式： POST

公共请求参数

参数名	必填	类型	说明
access_id	是	string	开发者唯一标识
sign_type	是	string	固定传RSA2
time_stamp	是	long	请求时间，Linux时间戳，单位毫秒
sign	是	string	签名结果
data	是	string	将业务参数转为JSON字符串，然后使用BASE64编码的数据
详细签名方法请阅读接口加密方案

请求参数

名称	必填	类型	说明
osStoreCode	是	string	备案系统中停车场编码(ID)
checkDate	是	Date	对账的日期，格式为：2021-01-01
driveInNum	是	int	对账日停车点的驶入记录数
driveOutNum	是	int	对账日停车点的驶出记录数

返回参数

名称	必填	类型	说明
driveInFlag	是	int	对账日停车点的驶入记录数帐平标记 0帐平 1账不平，常量定义在SDK的TyhConstants.CheckRecordFlag
driveOutFlag	是	int	对账日停车点的驶入记录数帐平标记 0帐平 1账不平，常量定义在SDK的TyhConstants.CheckRecordFlag

SDK方法

// 创建上传数据client
TyhUploadClient client = TyhUploadClient.create(TyhOptions.builder()
    .accessId(ACCESS_ID)
    .secretKey(SECRET_KEY)
    .build());
  
// 停车场日对账
OpenParkingCheckRecordCmd cmd = OpenParkingCheckRecordCmd.builder()
    .osStoreCode(OS_STORE_CODE)
    .checkDate(DateUtil.stringToDate("2021-11-11", "yyyy-MM-dd"))
    .driveInNum(200)
    .driveOutNum(203)
    .build();

// 发送请求 result.ifSuccess()表示请求成功
Results<OpenParkingCheckRecordDto> results = client.uploadCheckRecord(cmd);

入参格式

{
  "osStoreCode" : "30000000000001",
  "checkDate": "2021-11-11",
  "driveInNum": 200,
  "driveOutNum": 203
}

出参格式：

{ "code":8888, "msg":"success", "data": "{ "driveInFlag" : 0, "driveOutFlag": 1 }"}

code 为 8888 表示操作成功，其它值则为失败，具体内容参见错误码说明。

← 停车场心跳上传对账日开放平台order_id获取 →