对账日开放平台order_id获取 | 开放平台开发文档

# 对账日开放平台order_id获取

最新更新时间：2023.06.13

1.调用【停车记录日对账】接口后，判断驶入数据帐不平还是驶出数据帐不平，根据类别调用此接口获取停车场库已经传递给开放平台的订单id数据。
2.场库系统拿到平台的数据后对比场库数据库记录的数据，确定漏传数据；
如：平台返回驶入数据{ "orderIdList": ["001", "002"] }，场库系统记录的驶入数据有["001", "002","003"] 说明场库系统漏传订单id为003的数据（驶出数据同理）需要根据步骤3分类别补传数据。（相关字段解释请阅读下方请求参数和返回参数说明）
3.根据漏传数据的情况调用【停车场入场信息上报】、【停车场出场信息上报】接口来补传信息。

# 接口说明

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

请求方式： POST

公共请求参数

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

详细签名方法请阅读接口加密方案

请求参数

名称	必填	类型	说明
osStoreCode	是	string	备案系统中停车场编码(开放平台门店Code)
checkDate	是	string	对账的日期，格式为：2021-01-01
type	是	int	驶入驶出类型，常量定义在SDK的TyhConstants.DriveType中

返回参数

名称	必填	类型	说明
order_id_list	是	List	返回目前开放平台已有停车记录的order_id_list

SDK方法

// 创建上传数据client
TyhUploadClient client = TyhUploadClient.create(TyhOptions.builder()
    .accessId(ACCESS_ID)
    .secretKey(SECRET_KEY)
    .build());
    
// 对账日开放平台order_id获取
OpenParkingUIDCmd cmd = OpenParkingUIDCmd.builder()
    .osStoreCode(OS_STORE_CODE)
    .checkDate(DateUtil.stringToDate("2021-11-11", "yyyy-MM-dd"))
    .type(TyhConstants.DriveType.DRIVE_IN)
    .build();

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

入参格式

{
  "osStoreCode" : "30000000000001",
  "checkDate": "2021-11-11",
  "type": 1
}

出参格式：

{ "code":8888, "msg":"success", "data": "{ "orderIdList": ["xxx", "xxxx", "xxxx"] }"}

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

← 停车记录日对账车场入场信息上报 →