TimeMapAPI


Click here for a complete list of operations.

createProject

Always use Test server for test and development. All usage restrictions on test is 200 requests. Url: https://testservice.timemap.dk/timemapapi.asmx
Description:Used for importing/updatering projects
Note, Fair usage limit: 100 request per hour.
Parameters: To set values to null, specify 'null' in the parameter. Empty parameters is not updated.
  • apikey (string): Mandatory. The apikey is specified in the Company settings. Please see menu Settings->Company
  • apipwd (string): Mandatory. The api password must be specified in the Company settings. Please see menu Settings->Company
  • username (string): Mandatory. Specify the username/email of the user/developer calling this method. The user must exists in the EmployeeList.
  • projectNo: Mandatory. Project number. If project number exists the project is updated with the supplied data - othervise it's created.
  • projectName: Project name. It's recommended to specify a project name.
  • departmentNo: The department number of the project owner department. Department number must exists in TimeMap.
  • mainProjectNo: Main Project Number can be specified if the project is a subproject. Note: Main projects must exists in TimeMap
  • validFrom: Valid from date. Dateformat: yyyy.MM.dd.
  • validTo: Valid to date. Dateformat: yyyy.MM.dd.
  • completed: Specify 0 for uncompleted and 1 for completed. If no value is specified the project is set to uncompleted when creating a new project.
  • projectManagerNo: The Salary Number of the Employee that is Project Manager. If salary no is not found the TimeMap Employee Number is used. Employee must exists in TimeMap.
  • quantity: Quantities. If decimals is specified the decimal delimiter must be '.'
  • productionStart: Production start date. Dateformat: yyyy.MM.dd.
  • usePlanning: Specify planID for the plan. Specify 0 for no planning.
  • resourcesPerDay: Requires Planning. Resources Per day. If decimals is specified the decimal delimiter must be '.'
  • resourceType: Requires Planning and resources per day. Specify 'hr' for hours and 'em' for employees.
  • estimatedResources: List of salary numbers of employees that should be marked as resources on the project. Every Salary Number should be seperated by a comma. Employees must exists in TimeMap. All resources must be specified when updating.
  • estimatedHours: Estimated totals hours to be used on the project. If decimals is specified the decimal delimiter must be '.'
  • totalProjectCost: Total project cost. If decimals is specified the decimal delimiter must be '.'
  • costPerHour: Cost price per hour. If decimals is specified the decimal delimiter must be '.'
  • invoicePricePerHour: Invoice price per hour. If decimals is specified the decimal delimiter must be '.'
  • projectType: Project Type.
  • taskNos: Task numbers to be used on the project. Every Task Number should be seperated by a comma. All tasks must be specified when updating. Tasks must exists in TimeMap.
  • departmentAccessNo: Department numbers of departments that have access to the project. Every Department Number should be seperated by a comma. All departments must be specified when updating. Departments must exists in TimeMap.
  • employeeAccessNo: Employee Salary Numbers of employeess that have access to the project. Every Salary Number should be seperated by a comma. All Salary numbers must be specified when updating. Employees must exists in TimeMap.
  • showOnTerminal: If 1 is specified the project is shown on Hourregistration terminals. Specify 0 if the project should not be shown on terminals.
  • projectStatus: Specify the current Project Status. If the status specfied doesn't exists the new status is created.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TimeMapApi.asmx HTTP/1.1
Host: testservice.timemap.dk
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/createProject"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <createProject xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <projectNo>string</projectNo>
      <projectName>string</projectName>
      <departmentNo>string</departmentNo>
      <mainProjectNo>string</mainProjectNo>
      <validFrom>string</validFrom>
      <validTo>string</validTo>
      <completed>string</completed>
      <projectManagerNo>string</projectManagerNo>
      <quantity>string</quantity>
      <productionStart>string</productionStart>
      <usePlanning>string</usePlanning>
      <resourcesPerDay>string</resourcesPerDay>
      <resourceType>string</resourceType>
      <estimatedResources>string</estimatedResources>
      <estimatedHours>string</estimatedHours>
      <totalProjectCost>string</totalProjectCost>
      <costPerHour>string</costPerHour>
      <invoicePricePerHour>string</invoicePricePerHour>
      <projectType>string</projectType>
      <taskNos>string</taskNos>
      <departmentAccessNo>string</departmentAccessNo>
      <employeeAccessNo>string</employeeAccessNo>
      <showOnTerminal>string</showOnTerminal>
      <projectStatus>string</projectStatus>
    </createProject>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <createProjectResponse xmlns="http://tempuri.org/">
      <createProjectResult>string</createProjectResult>
    </createProjectResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TimeMapApi.asmx HTTP/1.1
Host: testservice.timemap.dk
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <createProject xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <projectNo>string</projectNo>
      <projectName>string</projectName>
      <departmentNo>string</departmentNo>
      <mainProjectNo>string</mainProjectNo>
      <validFrom>string</validFrom>
      <validTo>string</validTo>
      <completed>string</completed>
      <projectManagerNo>string</projectManagerNo>
      <quantity>string</quantity>
      <productionStart>string</productionStart>
      <usePlanning>string</usePlanning>
      <resourcesPerDay>string</resourcesPerDay>
      <resourceType>string</resourceType>
      <estimatedResources>string</estimatedResources>
      <estimatedHours>string</estimatedHours>
      <totalProjectCost>string</totalProjectCost>
      <costPerHour>string</costPerHour>
      <invoicePricePerHour>string</invoicePricePerHour>
      <projectType>string</projectType>
      <taskNos>string</taskNos>
      <departmentAccessNo>string</departmentAccessNo>
      <employeeAccessNo>string</employeeAccessNo>
      <showOnTerminal>string</showOnTerminal>
      <projectStatus>string</projectStatus>
    </createProject>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <createProjectResponse xmlns="http://tempuri.org/">
      <createProjectResult>string</createProjectResult>
    </createProjectResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /TimeMapApi.asmx/createProject?apikey=string&apipwd=string&username=string&projectNo=string&projectName=string&departmentNo=string&mainProjectNo=string&validFrom=string&validTo=string&completed=string&projectManagerNo=string&quantity=string&productionStart=string&usePlanning=string&resourcesPerDay=string&resourceType=string&estimatedResources=string&estimatedHours=string&totalProjectCost=string&costPerHour=string&invoicePricePerHour=string&projectType=string&taskNos=string&departmentAccessNo=string&employeeAccessNo=string&showOnTerminal=string&projectStatus=string HTTP/1.1
Host: testservice.timemap.dk

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://tempuri.org/">string</string>