Registrations - Clock In, GET

API Url

Clock In (CI) variant of generic registration

Ignore the URI, for the correct URI see

GET
http://localhost:16010/ProMarkREST/{DummyRegistration?type=CI}

Success 200

FieldTypeDescription
actualTimedatetime

The actual time the registration was made

approvaloptionalobject[]

Approval information

  approvalTimeoptionaldatetime

Time of approval/rejection, available when status is 2 or 3

  approverIdoptionalstring

Id of user that approved or rejected, available when status is 2 or 3

  deptIdstring

Department ID, secondary to approval group

  groupIdstring

Approval group ID

  levelnumber

1: First level approval, 2: Second level approval or 3: Escalated level approval

Allowed values:123
  rejectCodeoptionalstring

Rejection code, in use when status is 3

  rejectMsgoptionalstring

Rejection message, in use when status is 3

  statusnumber

0: No approval, 1: Needs approval, 2: Approved or 3: Rejected

Allowed values:0123
approvalStatusnumber

0: No approval, 1: Needs approval, 2: Approved or 3: Rejected

Allowed values:0123
attendanceDatedate

The date that the registration belongs to. Typical the date of the registration unless it's a night shift

clockInoptionalobject

Clock In

  absenceoptionalobject

Absence

    anyTimeoptionalboolean
    hoursoptionalnumber

Absence time in seconds.

    percentoptionalnumber

Absence time as percentage according to the selected reason setup.

    reasonoptionalobject

Absence reason

      backColoroptionalstring

Hex encoded RGB background color related to reason

      codestring

ID of reason

      descriptionstring

Description of reason

      foreColoroptionalstring

Hex encoded RGB foreground color related to reason

      typestring

Reason type

Allowed values:"AA"
    typenumber

-1: As pre-reported. 0: No absence. 1: Absent percent of day. 2: Absent a number of hours. 3: Absent during a full shift.

Allowed values:-10123
  autoClockInboolean

Automatic generated clock in.

  commentoptionalstring

Extra data fill in when there are no secondary reasons.

  dayProfIdoptionalstring

The day profile used as basis for validating the registration. It is usually the day profile from the employee's schedule or from the clock-in reason (if any). It is alternatively possible to explicitly assign a day profile ID to be used for the registration by setting lockDayProfile to true. If lockDayProfile is not set ProMark will as fill-in the field and conversely the class user should not.

  explicitTimeoptionaldatetime

Time entered if fixed reason has ticked the "Explicit corrected time" field

  isOvertimeoptionalboolean

The Clock In is overtime, the overtime button has been used at clock-in.

  lockDayProfileoptionalboolean

See "DayProfId".

  lockUserDataoptionalboolean

Similar to lockDayProfile but works on attendanceDate. Can also in some cases prevent ProMark from automatically changing the selected clock-in reason to something else.

  reasonoptionalobject

Reason

    backColoroptionalstring

Hex encoded RGB background color related to reason

    codestring

ID of reason

    descriptionstring

Description of reason

    distributionoptionalobject[]

Distribution on secondary reasons with time.

      secondaryReasonobject

Secondary reason.

        descriptionstring

Secondary reason description.

        groupstring

Secondary reason group.

        idstring

Secondary reason id.

      timenumber

Reason distribution time in seconds.

    foreColoroptionalstring

Hex encoded RGB foreground color related to reason

    secondaryReasonoptionalobject

Secondary reason without distribution.

      descriptionstring

Secondary reason description.

      groupstring

Secondary reason group.

      idstring

Secondary reason id.

    typestring

Reason type

Allowed values:"CIE,CIL,CIA,CIS"
  totalTimeAccountIdoptionalstring

Account where total time is posted in addition to the account specified on the day profile.

closedPeriodboolean

The registration is in a closed period

correctedRegTimedatetime

Registration time adjusted according to setup in ProMark

descriptionstring
Default value: Clock In
empIdstring

Internal employee ID

isDeletedboolean

The registration is deleted and cannot be altered.

isErroneousboolean

The registrations is erroneous and should either be changed or deleted. It's typical a result of offline CI/CO registration where a reason is missing or it's a duplicate.

locationoptionalobject

Geo location of registration

  latitudenumber

Latitude, negative value is west

Size range: -180 to 180
  longitudenumber

Longitude, negative value is south

Size range: -180 to 180
noDeleteboolean

It's not allowed to delete the registration. Some registrations may be readOnly but can still be deleted

noTimeChangeboolean

regTime cannot be changed, for instance on absence registrations

readOnlyboolean

It's not allowed to edit the registration

regTimedatetime

The time of registration

signOffoptionalobject

Sign off information

  bystring

Used if status = 2: Terminal Id is signed off by employee or User Id if signed off by user

  statusnumber

0: Not required, 1: Pending or 2: Signed off

Allowed values:012
  timedatetime

Used if status = 2: Time of sign off

terminalIdstring

Numeric ID (optional prefixed by*) of registration terminal. If it's not numeric (it does not start with a digit or *) then it's the ID of the user that changed or created the registration

transSeqnumber

Unique reference of registration

typestring
Default value: CI
underValidationboolean

The registration is under validation