Acumatica API录入活动出现跨周工时卡归属错误求助

核心原因 #

Acumatica通过API处理工时卡周归属时，使用UTC时间判断周边界，而UI操作时使用本地时区（新西兰+12:00）判断，导致时区差带来的归属偏差：

• 你的工时卡周结束时间UTC为2025-07-06T23:59:59.9999999+00:00，转换为新西兰时区是7日11:59:59
• 周一上午11:59前的本地时间，对应UTC仍在6日范围内，会被API判定为上周的工时卡

排查与修复步骤 #

1. 检查API请求的时间字段格式
   确保提交的UTC时间字符串明确携带时区标记（Z或+00:00），例如：

   {
     "startTime": "2025-07-07T09:00:00Z",
     "endTime": "2025-07-07T10:00:00Z"
   }
   

   避免仅提交无时区标记的UTC时间字符串，防止系统误解析为本地时间。

2. 验证工时卡周边界的时区配置
   进入Acumatica后台，检查Time Entry模块的偏好设置：

   • 确认是否存在「工时卡周计算时区」的独立配置项，部分版本中该设置不会继承站点/用户时区，需手动指定为(GMT+12:00) New Zealand
   • 核对「周起始日」设置为周一，确保与业务规则一致

3. 在API请求中指定时区上下文
   Acumatica API支持通过请求头指定处理时区，在PUT请求中添加：

   X-TimeZone: (GMT+12:00) New Zealand
   

   或使用时区ID：

   X-TimeZone: Pacific/Auckland
   

   强制系统使用本地时区判断工时卡归属，而非UTC。

4. 调整时间提交策略（临时 workaround）
   如果上述配置无法修改，可将周一上午的活动时间转换为新西兰本地时区时间并提交（携带+12:00标记），例如本地时间2025-07-07T09:00:00+12:00，而非UTC时间，让系统直接按本地时区判断归属。

内容的提问来源于stack exchange，提问作者GrayFoxNZ