Extend Clock Input Interface and REST API to VAS and Manual Activities

Capturing the clock information of your warehouse users is a key feature in WMS Work Force Management. With 24B, you can make use of the enhanced functionality of the WFM Clock Input interface and REST API to post the clock data for VAS and Manual Activities, in addition to Facility, Work Area and Break.

CLOCK INPUT INTERFACE SUPPORT FOR VAS AND MANUAL ACTIVITIES

In addition to the existing F1 to F6 values, the cico_type field in the Clock Interface file now accepts four additional values to support clock data for VAS and Manual activities:

  • F7 - Clock into a VAS activity
  • F8 - Clock out of a VAS activity
  • F9 - Clock into a manual activity
  • F10 - Clock out of a manual activity

We’ve also introduced two non-mandatory fields "work_area_activity" and "team" to the interface file. You can use the Clock Input Interface file in both .psv and .xls file formats.

To interface clock data for a VAS activity, use the cico_type as F7 or F8 and provide the code of the VAS activity in the work_area_activity field. If the VAS activity is performed by a team, provide the name in the “team” field, else provide the id of the user in the employee_id_sap field.

NOTE: The "employee_id_sap" field is an optional field for VAS activities. For cico_type F7 and F8, either a team or employee_id_sap should be provided. The interface will fail if both are blank, or both are provided. If you provide a value for team, you are required to use "-" (dash) to indicate a blank employee_id_sap. If the field is blank, the interface will fail.

CLOCK REST API SUPPORT FOR VAS AND MANUAL ACTIVITIES

With the 24B release, we’re also enhancing Clock REST API to handle the posting of clock information for VAS and Manual Activities. You can make use of the additional parameters "Activities" and "Team" in the request body of the Clock REST API (POST ..lgfapi/v10/stage_track_record/clock_inout/.) The existing parameter  "univ_id_1" that represents employee_id is optional for VAS activities and works in conjunction with team as described in the section for Clock Input Interface.

If you use JSON, the empty string “” must be used to indicate blank values for both univ_id_1 and team. If XML is used, then you can drop the tags altogether or have empty tags.

Additionally, for cico_type, you can use the values from F7 to F10 in the same manner as that of Clock Input Interface.

DEPRECATIONS

NOTE:

  • The "create", "copy", "edit" and "save to view" icons have been removed from the Stage Record tab of Clock Input interface screen.

  • StageTrackRecordView (Product: wfm) has been removed from the Modules view. You can see the interfaced clock data in the Stage Record tab for Clock on the Input Interface screen.

Steps to Enable

  1. To interface clock data via the Input Interface, use the cico_type (F7-F10, as per the reference given above) and provide the code of the VAS activity in the work_area_activity field. 

  2. To interface clock data via REST API, use the parameters "Activities" and "Team" in request body of the Clock REST API POST ..lgfapi/v10/stage_track_record/clock_inout/.

Key Resources