Skip to content

Update Time Trackers

Operation
wsdlUpdateTimeTrackers
SOAP Action
uri:FlexForce/wsdlUpdateTimeTrackers
Service
FlexForce
Port
FlexForcePort
Style
rpc

Update Time Trackers by inserting new transactions.

Request

Message: wsdlUpdateTimeTrackersRequest

apiKeystringrequired

API key of the unit.

timeTrackersArray<timeTracker>required

Array of timeTracker records describing the transactions to apply.

itemtimeTracker

A time-tracker transaction record used by wsdlUpdateTimeTrackers and wsdlGetTimeTrackersBalance.

badgeNostringrequired

Badge number of the employee. Specify either this or userId.

userIdintrequired

Quinyx internal id of the employee. Specify either this or badgeNo.

timeTrackerIdintrequired

Time tracker id.

periodint

Period (year) for periodized trackers. If omitted, default rules pick the period.

operationintrequired
Values
1Add or subtract by value
2Set to value (sets the "outgoing value" of the day; see the doc for ordering rules on Dutch trackers)
3Dutch time trackers only: add to / subtract from the Statutory balance
4Dutch time trackers only: set the Statutory balance
valuedecimalrequired

Decimal value. Only 4 decimals are honoured (rounded half-up).

datestring

Defaults to today.

FormatYYYY-MM-DD
replaceTimeTrackerboolean

Replace any existing transaction with the same timeTrackerId and date instead of appending. Set this with operation = 1, value = 0.0, and a date to delete all manual transactions on a day.

validationErrorsArray<xsd:string>required

Returned in the response only.

curl -X POST 'https://api.quinyx.com/FlexForceWebServices.php' \
  -H 'Content-Type: text/xml; charset=utf-8' \
  -H 'SOAPAction: "uri:FlexForce/wsdlUpdateTimeTrackers"' \
  --data @- <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="https://api.quinyx.com/soap/FlexForce">
  <soap:Body>
    <tns:wsdlUpdateTimeTrackers>
    <apiKey xsi:type="xsd:string">string</apiKey>
    <timeTrackers xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:timeTracker[1]">
      <item xsi:type="tns:timeTracker">
        <badgeNo xsi:type="xsd:string">string</badgeNo>
        <userId xsi:type="xsd:int">0</userId>
        <timeTrackerId xsi:type="xsd:int">0</timeTrackerId>
        <period xsi:type="xsd:int">0</period>
        <operation xsi:type="xsd:int">0</operation>
        <value xsi:type="xsd:decimal">0</value>
        <date xsi:type="xsd:string">string</date>
        <replaceTimeTracker xsi:type="xsd:boolean">true</replaceTimeTracker>
        <validationErrors xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="xsd:string[1]">
          <item xsi:type="xsd:string">string</item>
        </validationErrors>
      </item>
    </timeTrackers>
    </tns:wsdlUpdateTimeTrackers>
  </soap:Body>
</soap:Envelope>
EOF

Response

Message: wsdlUpdateTimeTrackersResponse

returnArray<timeTracker>

Array of timeTracker records reflecting the saved state, with per-row validationErrors when applicable.

itemtimeTracker

A time-tracker transaction record used by wsdlUpdateTimeTrackers and wsdlGetTimeTrackersBalance.

badgeNostringrequired

Badge number of the employee. Specify either this or userId.

userIdintrequired

Quinyx internal id of the employee. Specify either this or badgeNo.

timeTrackerIdintrequired

Time tracker id.

periodint

Period (year) for periodized trackers. If omitted, default rules pick the period.

operationintrequired
Values
1Add or subtract by value
2Set to value (sets the "outgoing value" of the day; see the doc for ordering rules on Dutch trackers)
3Dutch time trackers only: add to / subtract from the Statutory balance
4Dutch time trackers only: set the Statutory balance
valuedecimalrequired

Decimal value. Only 4 decimals are honoured (rounded half-up).

datestring

Defaults to today.

FormatYYYY-MM-DD
replaceTimeTrackerboolean

Replace any existing transaction with the same timeTrackerId and date instead of appending. Set this with operation = 1, value = 0.0, and a date to delete all manual transactions on a day.

validationErrorsArray<xsd:string>required

Returned in the response only.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="https://api.quinyx.com/soap/FlexForce">
  <soap:Body>
    <tns:wsdlUpdateTimeTrackersResponse>
    <return xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:timeTracker[1]">
      <item xsi:type="tns:timeTracker">
        <badgeNo xsi:type="xsd:string">string</badgeNo>
        <userId xsi:type="xsd:int">0</userId>
        <timeTrackerId xsi:type="xsd:int">0</timeTrackerId>
        <period xsi:type="xsd:int">0</period>
        <operation xsi:type="xsd:int">0</operation>
        <value xsi:type="xsd:decimal">0</value>
        <date xsi:type="xsd:string">string</date>
        <replaceTimeTracker xsi:type="xsd:boolean">true</replaceTimeTracker>
        <validationErrors xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="xsd:string[1]">
          <item xsi:type="xsd:string">string</item>
        </validationErrors>
      </item>
    </return>
    </tns:wsdlUpdateTimeTrackersResponse>
  </soap:Body>
</soap:Envelope>

Change log

Date Description
2017-10-10 Imported old documentation. Added period optional parameter, for periodized time trackers. Changed the behavior of operation=2 so it now uses set-transactions, rather than generating an add-transaction based on the actual balance.
2021-03-18 added operations 3 and 4 (3 - add to Statutory balance, 4 set to Statutory balance)
2023-04-28 (update made only in this specification) — Correction of field “value”’s Data type from “integer” to “decimal”
add replaceTimeTracker