The WeChat Work API for getting enterprise attendance rules (getCropCheckinOption) has been updated to return overtime information in a new ot_info_v2 structure instead of the previous ot_info format.

Issue

The existing implementation only supported the old ot_info structure, causing the overtime information to be lost when the API returns the new format:

// New API response format
"ot_info_v2": {
  "workdayconf": {
    "allow_ot": true,
    "type": 1
  },
  "restdayconf": {
    "allow_ot": false,
    "type": 0
  },
  "holidayconf": {
    "allow_ot": true,
    "type": 2
  }
}

Solution

Added support for the new ot_info_v2 structure while maintaining backward compatibility:

1. New OtInfoV2 class with nested configuration classes:

   • WorkdayConf - workday overtime settings
   • RestdayConf - rest day overtime settings
   • HolidayConf - holiday overtime settings

2. Enhanced WxCpCropCheckinOption with new field:

   • Added otInfoV2 field with @SerializedName("ot_info_v2") annotation
   • Preserved existing otInfo field for backward compatibility

3. Comprehensive testing to ensure:

   • New API format deserializes correctly
   • Old API format continues to work
   • Edge cases are handled properly

Usage

The new field will be automatically populated when the API returns the ot_info_v2 structure:

List<WxCpCropCheckinOption> options = wxService.getOaService().getCropCheckinOption();
for (WxCpCropCheckinOption option : options) {
    // Check new format first
    if (option.getOtInfoV2() != null && option.getOtInfoV2().getWorkdayConf() != null) {
        boolean allowWorkdayOt = option.getOtInfoV2().getWorkdayConf().getAllowOt();
        int otType = option.getOtInfoV2().getWorkdayConf().getType();
    }
    // Fallback to old format for backward compatibility
    else if (option.getOtInfo() != null) {
        boolean allowOt = option.getOtInfo().getAllowOtWorkingDay();
    }
}

Fixes #3567.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.