【v3.8版本】通知固定车延期/充值

简要描述

• 该接口用于第三方通知固定车延期充值（query 参数 Route 固定传 MonthlyCarRecharge）。
• 月租车按请求有效期延期并生成月卡充值记录，
• 储值车按请求金额充值并生成钱包充值记录与储值余额明细；缴费记录与缴费明细成对写入，成功后清空计费结果缓存并异步同步岗亭。
• 按系统车位号（优先）或车主编号定位车位（都非空时以系统车位号为准），有效期与储值余额按车主维度生效，一次操作作用于该车主名下的全部车辆。
• NoticeType 仅支持 0（新增或更新）；传 1 报 固定车延期充值仅支持新增或更新操作！。

请求URL

• http://localhost:8888/Api/V2/OpenApi/Notice

请求方式

• POST

请求类型

• Content-Type：application/json

请求参数

Query参数

Body参数

请求示例

月租车延期（不修改开始时间）

{
    "ParkKey": "{{parkkey}}",
    "AppId": "{{appid}}",
    "TimeStamp": "{{timestamp}}",
    "Nonce": "vqnkpzhigqhm",
    "Sign": "rcjmptcxcqaqszkczkotjuny",
    "Data": {
        "NoticeType": 0,
        "Items": [
            {
                "SystemSpotNumber": "A001",
                "OwnerNo": "OWNER001",
                "IsModifyStartTime": 0,
                "EndTime": "2024-12-31 23:59:59",
                "TotalAmountDue": 500.00,
                "TotalAmountPaid": 500.00,
                "PaymentMethod": "79001",
                "PaymentOrderNo": "PAY20230226001",
                "Remarks": "月租车延期充值"
            }
        ]
    }
}

储值车充值

{
    "ParkKey": "{{parkkey}}",
    "AppId": "{{appid}}",
    "TimeStamp": "{{timestamp}}",
    "Nonce": "vqnkpzhigqhm",
    "Sign": "rcjmptcxcqaqszkczkotjuny",
    "Data": {
        "NoticeType": 0,
        "Items": [
            {
                "SystemSpotNumber": "B002",
                "TotalAmountDue": 200.00,
                "TotalAmountPaid": 200.00,
                "PaymentMethod": "79009",
                "Remarks": "储值车充值"
            }
        ]
    }
}

修改开始时间延期

{
    "ParkKey": "{{parkkey}}",
    "AppId": "{{appid}}",
    "TimeStamp": "{{timestamp}}",
    "Nonce": "vqnkpzhigqhm",
    "Sign": "rcjmptcxcqaqszkczkotjuny",
    "Data": {
        "NoticeType": 0,
        "Items": [
            {
                "OwnerNo": "OWNER002",
                "IsModifyStartTime": 1,
                "StartTime": "2023-03-01 00:00:00",
                "EndTime": "2024-02-29 23:59:59",
                "TotalAmountDue": 600.00,
                "TotalAmountPaid": 600.00
            }
        ]
    }
}

返回参数说明

返回示例

成功

{
  "ResultCode": 200,
  "ResultMsg": "本次延期充值操作成功！",
  "ResultId": "500303426998446",
  "Data": null
}

校验失败（示例）

{
  "ResultCode": 1002,
  "ResultMsg": "实收金额不能大于应收金额！",
  "ResultId": "500303426998447",
  "Data": null
}

写入失败（示例）

{
  "ResultCode": 1005,
  "ResultMsg": "本次延期充值未能完成，请检查请求数据！",
  "ResultId": "500303426998448",
  "Data": null
}