参数维护模式(数据同步模式)

这里是指 后台的 授权配置 中，选择数据同步模式的选项。

定义/声明 ⭐ 🌟 🌠 🔥

因为数据同步模式、开启同步、关闭同步 字样在实际开发讨论中，不便理解，非常拗口，为方便理解，下面将对这些字样进行定义/声明， 用于对接过程中讨论使用。 文档也将逐步修改调整

• 以 参数维护模式 代指 后台的 数据同步模式。
• 以 系统维护 代指 后台 数据同步模式 中的 开启同步。
• 以 系统维护参数 代指 选择 后台 数据同步模式 中的 开启同步。
• 以 接入方维护 代指 后台 数据同步模式 中的 关闭同步。
• 以 接入方维护参数 代指 选择 后台 数据同步模式 中的 关闭同步。

差异

系统维护

• 充值接口参数由系统维护 设备的设置等 均由系统完成 接口负责充值、清零、开户
• 需要在后台绑定用户, 可以绑定到一个 用户
• 接口充值后系统会更新余额和充值记录
• 可以获取到系统内的，用户，和充值记录
• 价格参数等需要通过接口读取系统中设置的参数，设置方式为通过系统设置。
• 系统和接口都可以充值

接入方维护

• 充值接口参数(包括电价)由 接入方维护， 开户充值等接口 参数(count,account_id,price..等)均由 接入方自行维护 系统 不保证开户参数准确性
• 不需要绑定用户
• 无充值记录接口提供
• 充值后系统不更新余额和充值记录 余额冲突
• 开户状态系统不维护
• 拉合闸，开关阀， 状态系统不维护，仅通过系统，清零，开关阀，拉合闸，抄表时会更新状态
• 无法通过系统充值 充值冲突
• 除了上方的差异 之外，基本没有差异，(抄表，拉合闸，开关阀都是一样的)

Tips

TIP

• 除了上方的差异 之外，基本没有差异，(抄表，拉合闸，开关阀都是一样的) ------ 所有的异步操作都有回调给到回调地址，用户有了回调之后没有必要再来看我们的系统状态，属于绕弯路

如何选择

• 除了上方的差异 之外，基本没有差异，(抄表，拉合闸，开关阀都是一样的)

参数维护模式	复杂度	充值参数维护方式	充值记录	参数设置方式
系统维护	相对简单	系统维护	系统存储	系统设置
接入方维护	复杂	接入方维护	接入方记录	接口设置

更简单的总结

• 简单充值，抄表 选择 系统维护
• 尽可能不使用设备平台系统 选择 接入方维护

常见问题

余额冲突

部分开发者选择 接入方维护 模式 充值后,通过同步接口获取用户余额, 但是系统不更新余额和充值记录, 导致用户余额冲突。-- 部分表充值成功后，回调会提供余额，没有余额的可以进行一次异步抄表。

重复回调（极少数）

部分开发者选择 系统维护参数 ，充值超时，系统会在大约7天内进行多次重试，直至成功或异常，或超出时间，再此期间每次执行都会回调给用户。 -- 对业务影响不大最终状态是异常或者成功。出现此情况一般需要人工干预，现场排查。开发者不需要为重复回调做过多担心。

充值冲突

次数冲突

选择 接入方维护 模式，开户后，充值次数和系统中存储的不一致，此时通过系统充值，会出现充值错误，无法充值

户号冲突

选择 接入方维护 模式，开户后，充值户号和系统中存储的不一致，此时通过系统充值，会出现充值错误，无法充值