GetEmployeeNormalWorkingHoursRaw
Reporting API: Returns the weekday hours of each normal-working-time scheme, once per employee currently assigned to it.
| API | Reporting API (raw extracts) |
| Endpoint | POST https://app{server-number}.timelog.com/{account}/Service.asmx |
| SOAPAction | http://www.timelog.com/ws/tlp/v4_4/GetEmployeeNormalWorkingHoursRaw |
| Content-Type | text/xml; charset=utf-8 |
| Authentication | siteCode, apiID and apiPassword as the first three parameters. See Authentication |
| Changes data | No. Safe to retry. |
| Paging | No: the whole result comes in one response. Narrow it with the filters. |
How it works
Only the CURRENT assignment is reflected - history is in GetEmployeeNormalWorkingTimeHistoriesRaw. status 0 does NOT return inactive employees.
Parameters
Each parameter has one label: Required, Conditional (required depending on other values) or Optional. Send them in the order shown.
Your account's site code, from the Reporting API settings.
The Reporting API ID, from the Reporting API settings.
The Reporting API password, from the Reporting API settings.
Employee id. 0 = no filter.
Current profile department, exact. 0 = no filter.
As GetWorkingHoursRaw: only > 0 is sent; 1 = active only; 0 / negative = ALL.
Request
POST /{account}/Service.asmx HTTP/1.1
Host: app{server-number}.timelog.com
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://www.timelog.com/ws/tlp/v4_4/GetEmployeeNormalWorkingHoursRaw"
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tlp="http://www.timelog.com/ws/tlp/v4_4">
<soap:Body>
<tlp:GetEmployeeNormalWorkingHoursRaw>
<tlp:siteCode>{siteCode}</tlp:siteCode>
<tlp:apiID>{apiID}</tlp:apiID>
<tlp:apiPassword>{apiPassword}</tlp:apiPassword>
<tlp:employeeID>0</tlp:employeeID>
<tlp:departmentID>0</tlp:departmentID>
<tlp:status>-1</tlp:status>
</tlp:GetEmployeeNormalWorkingHoursRaw>
</soap:Body>
</soap:Envelope>
curl -X POST "https://app{server-number}.timelog.com/{account}/Service.asmx" \
-H "Content-Type: text/xml; charset=utf-8" \
-H 'SOAPAction: "http://www.timelog.com/ws/tlp/v4_4/GetEmployeeNormalWorkingHoursRaw"' \
--data-binary @request.xml
import requests
URL = "https://app{server-number}.timelog.com/{account}/Service.asmx"
SOAP_ACTION = '"http://www.timelog.com/ws/tlp/v4_4/GetEmployeeNormalWorkingHoursRaw"'
envelope = """<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tlp="http://www.timelog.com/ws/tlp/v4_4">
<soap:Body>
<tlp:GetEmployeeNormalWorkingHoursRaw>
<tlp:siteCode>{siteCode}</tlp:siteCode>
<tlp:apiID>{apiID}</tlp:apiID>
<tlp:apiPassword>{apiPassword}</tlp:apiPassword>
<tlp:employeeID>0</tlp:employeeID>
<tlp:departmentID>0</tlp:departmentID>
<tlp:status>-1</tlp:status>
</tlp:GetEmployeeNormalWorkingHoursRaw>
</soap:Body>
</soap:Envelope>"""
response = requests.post(
URL,
data=envelope.encode("utf-8"),
headers={"Content-Type": "text/xml; charset=utf-8", "SOAPAction": SOAP_ACTION},
timeout=300,
)
rows = parse_result(response) # see "Responses and errors"
{…} placeholder with your own value.Response
The result is an XML document inside GetEmployeeNormalWorkingHoursRawResult: a tlp:EmployeeNormalWorkingTimes root with one tlp:EmployeeNormalWorkingTime element per record. Check the response format first: the same slot also carries the empty result and errors.
Order: Employee id only; weekday order within an employee NOT guaranteed.
One element per record. Fields without a value are left out of the element, so treat every field as optional.
Example response
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetEmployeeNormalWorkingHoursRawResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
<GetEmployeeNormalWorkingHoursRawResult>
<tlp:EmployeeNormalWorkingTimes xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4">
<tlp:EmployeeNormalWorkingTime ID="1001">
<tlp:Weekday>0</tlp:Weekday>
<tlp:Name>Example </tlp:Name>
<tlp:WorkingHours>7.5000</tlp:WorkingHours>
<tlp:EmployeeID>12</tlp:EmployeeID>
<tlp:EmployeeFirstName>Anna</tlp:EmployeeFirstName>
<tlp:EmployeeLastName>Example</tlp:EmployeeLastName>
</tlp:EmployeeNormalWorkingTime>
</tlp:EmployeeNormalWorkingTimes>
</GetEmployeeNormalWorkingHoursRawResult>
</GetEmployeeNormalWorkingHoursRawResponse>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetEmployeeNormalWorkingHoursRawResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
<GetEmployeeNormalWorkingHoursRawResult>
<tlp:EmployeeNormalWorkingTimes resultEmpty="true" xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4"></tlp:EmployeeNormalWorkingTimes>
</GetEmployeeNormalWorkingHoursRawResult>
</GetEmployeeNormalWorkingHoursRawResponse>
</soap:Body>
</soap:Envelope>
Example error
Wrong credentials, or a call over plain HTTP:
HTTP/1.1 401 Unauthorized
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetEmployeeNormalWorkingHoursRawResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
<GetEmployeeNormalWorkingHoursRawResult>
<tlp:Errors xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4">
<tlp:Error>Access denied. Check siteCode, apiID, apiPassword and SSL settings</tlp:Error>
</tlp:Errors>
</GetEmployeeNormalWorkingHoursRawResult>
</GetEmployeeNormalWorkingHoursRawResponse>
</soap:Body>
</soap:Envelope>
Errors
The errors every method can return (access denied, operation failed, invalid request) are listed once in Responses and errors.
This method has no errors of its own beyond the shared ones.