Visma Tid API
Version 2.0.4.6 - Changelog
Back to documentation
Versions
Version 2.0.4.6 Version 2.0.4.5 Version 2.0.4.4 Version 2.0.4.3 Version 2.0.4.2 Version 2.0.4.1 Version 2.0.4.0 Version 2.0.3.6 Version 2.0.3.5 Version 2.0.3.4 Version 2.0.3.3 Version 2.0.3.2 Version 2.0.3.1 Version 2.0.3.0 Version 2.0.2.2 Version 2.0.2.1 Version 2.0.2.0 Version 2.0.1.0 Version 2.0.0.2 Version 2.0.0.1 Version 2.0
Visma Tid API Changelog

Versions

Version 2.0.4.6

Released 2024-09-27
Modified
  • Changes to endpoint "GET /v1/admin/users"
    • Added the employeeNumber field to response object

Version 2.0.4.5

Released 2024-09-11
Added
Modified
  • Changes for endpoint "GET /v1/Core/TimeReports"
    • Added filter parameter "filter.createdOrUpdatedSince".
    • Filter parameter "filter.createdDateFrom" is now obsolete. Use "filter.createdOrUpdatedSince" instead.
    • Filter parameter "filter.createdDateTo" is now obsolete. Use "filter.createdOrUpdatedSince" instead.
    • Filter parameter "filter.updatedDateFrom" is now obsolete. Use "filter.createdOrUpdatedSince" instead.
    • Filter parameter "filter.updatedDateTo" is now obsolete. Use "filter.createdOrUpdatedSince" instead.
    • Changed value type of "filter.from" from "datetime" to "datetime utc"
    • Changed value type of "filter.to" from "datetime" to "datetime utc"
  • Changes for endpoint "GET /v1/Core/Contacts"
    • Changed value type of "filter.createdOrUpdatedSince" from "datetime" to "datetime utc"
  • Changes for endpoint "GET /v1/Admin/Articles"
    • Added "Type" as an optional page parameter.

Version 2.0.4.4

Released 2023-11-29
Added
  • New filter for endpoint "GET /v1/Core/Contacts"
    • Added the ability to filter contacts by phone or cell phone number

Version 2.0.4.3

Released 2023-09-27
Added
  • New create endpoint for projects "POST /v1/Core/Projects"
    • Added the ability to create projects
  • New get endpoint for projects "GET /v1/Core/Projects/nextProjectNumber"
    • Added the ability to get the next suggested project number
  • New get endpoint for project collections "GET /v1/Core/ProjectCollections/:id/nextProjectNumber"
    • Added the ability to get the next suggested project number within a project collection
  • New get endpoint for project time calculation "GET /v1/Core/Projects/:id/TimeCalculation"
    • Added the ability to get the time calculation for a specific project

Version 2.0.4.2

Released 2023-09-14
Added
  • Core resource endpoints
    • Project comments (list, create, update, delete)

Version 2.0.4.1

Released 2023-05-31
Added
  • Additions to list endpoint "GET /v1/Core/TimeReport"
    • Added property "hasAdditions" to Response object
    • Added property "hasEquipment" to Response object
    • Added property "createdBy" to Response object
    • Added property "updatedBy" to Response object
    • Added filter parameter "filter.activityId"
    • Added filter parameter "filter.hasTravelReports"
    • Added filter parameter "filter.hasAllowanceReports"
    • Added filter parameter "filter.hasAdditions"
    • Added filter parameter "filter.hasEquipment"
  • Additions to endpoint "GET /v1/Core/TimeReport/:id"
    • Added property "article" within allowanceReport to response object
    • Added property "article" within travelReport to response object
  • Additions to list endpoint "GET /v1/Core/Projects"
    • Added property "salesResponsible" to response object
  • Additions to list endpoint "GET /v1/Admin/Users"
    • Added filter parameter "filter.includeDeleted".
      Adds capability to query deleted users.
      Deleted users are returned with limited properties:
      • id
      • firstName
      • lastName
      • department
      • salaryType
      • costCenter
Modified
  • Changes for endpoint "GET /v1/Admin/Users"
    • Filter parameter "filter.query" is now capable of querying an email address of a user.

Version 2.0.4.0

Released 2023-04-19
Added
  • New list endpoint for opportunities, "GET /v1/Core/Opportunities"
  • New detail endpoint for opportunities, "GET /v1/Core/Opportunities/:opportunityId"
  • New update endpoint for opportunities, "PUT /v1/Core/Opportunities/:opportunityId"
  • New list endpoint for opportunity tags, "GET /v1/Admin/OpportunityTags"
  • New list endpoint for opportunity statuses, "GET /v1/Admin/OpportunityStatuses"
  • New list endpoint for offers, "GET /v1/Core/Offers"
  • New endpoint for downloading offers, "GET /v1/Core/Offers/:offerId/Download"

Version 2.0.3.6

Released 2023-04-12
Added
  • New list endpoint for project statuses, "GET /v1/Admin/ProjectStatuses"
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added filter parameter "filter.projectStatusIds".

Version 2.0.3.5

Released 2023-03-29
Added
  • New list endpoint for Vacation requests, "GET /v1/Core/VacationRequests"

Version 2.0.3.4

Released 2023-03-15
Added
  • New list endpoint for Material Reports, "GET /v1/Core/MaterialReports"
  • New list endpoint for Paymentplans, "GET /v1/Core/Paymentplans"
Modified
  • Removed documentation for old "material reports on project" endpoint as a new general endpoint for material reports exists and should be used as of now.
  • Removed documentation for old "paymentplans on project" endpoint as a new general endpoint for Paymentplans exists and should be used as of now.

Version 2.0.3.3

Released 2023-03-01
Added
  • Additions for endpoint "GET /v1/Core/TimeReports"
    • Added filter parameter "filter.createdDateFrom".
    • Added filter parameter "filter.createdDateTo".
    • Added filter parameter "filter.updatedDateFrom".
    • Added filter parameter "filter.updatedDateTo".

Version 2.0.3.2

Released 2023-02-15
Added
  • New list endpoint for Cost centers, "GET /v1/Admin/CostCenters".
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added property "costCenter" to response object.

Version 2.0.3.1

Released 2023-02-08
Added
  • New list endpoint for Project tags, "GET /v1/Admin/ProjectTags".
  • New list endpoint for Project categories, "GET /v1/Admin/ProjectCategories".
  • Additions for endpoint "PUT /v1/Core/Projects":
    • Added property "tagIds" to Request object
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added filter parameter "filter.projectTagIds".
    • Added filter parameter "filter.projectcategoryIds".

Version 2.0.3.0

Released 2023-01-25
Added
  • New list endpoint for Logs, "GET /v1/Core/Logs".
  • New list endpoint for Supplier invoices, "GET /v1/Core/SupplierInvoices".
  • New list endpoint for Payment plans on Project, "GET /v1/Core/Projects/:projectId/Paymentplans".
  • New list endpoint for Material reports on Project, "GET /v1/Core/Projects/:projectId/MaterialReports".
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added filter parameter "filter.createdDateFrom".
    • Added filter parameter "filter.createdDateTo".
    • Added filter parameter "filter.updatedDateFrom".
    • Added filter parameter "filter.updatedDateTo".
    • Added filter parameter "filter.projectType".

Version 2.0.2.2

Released 2022-05-03
Added
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added some additional address properties to "location" property in response object:
      • streetAddress
      • postalCode
      • city
      • countryName

Version 2.0.2.1

Released 2022-04-08
Added
  • Additions for endpoint "GET /v1/Core/Projects":
    • Added property "location" to response object:
      "location": { "objectName": "project.list.location", "longitude": 21.48181104660036, "latitude": 65.3175658912035 },

Version 2.0.2.0

Released 2022-03-17

This release includes breaking changes as we have made the property "project"/"projectId" nullable on the request/response objects for all endpoints in the time reports module.

Added
  • New list endpoint for Internal projects, "GET /v1/Admin/InternalProjects".
  • New list endpoint for Absence projects, "GET /v1/Admin/AbsenceProjects".
  • Additions for endpoint "GET /v1/Core/TimeReports":
    • Added filter parameter "filter.internalProjectId".
    • Added filter parameter "filter.absenceProjectId".
    • Added filter parameter "filter.projectType".
    • Added property "internalProject" to response object.
    • Added property "absenceProject" to response object.
  • Additions for endpoint "GET /v1/Core/TimeReports/:id":
    • Added property "internalProject" to response object.
    • Added property "absenceProject" to response object.
  • Additions for endpoint "POST /v1/Core/TimeReports":
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.
  • Additions for endpoint "PUT /v1/Core/TimeReports/:id":
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.
Modified
  • Changes for endpoint "GET /v1/Core/TimeReports":
    • Property "project" in response object will now be NULL if the time report is registered to either an internal project or absence project.
  • Changes for endpoint "GET /v1/Core/TimeReports/:id";
    • Property "project" in response object will now be NULL if the time report is registered to either an internal project or absence project.
  • Changes for endpoint "POST /v1/Core/TimeReports":
    • Property "projectId" on request object is now nullable.
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.
  • Changes for endpoint "PUT /v1/Core/TimeReports/:id":
    • Property "projectId" on request object is now nullable.
    • Added property "internalProjectId" to request object.
    • Added property "absenceProjectId" to request object.

Version 2.0.1.0

Released 2021-12-29

This release includes breaking changes as we have cleaned up three naming errors and added a new endpoint to the user module.
We have renamed "Project" * to "Project collection" *, "Work order" to "Project" and "Work activity" to "Activity".

* The module "Project collection" (former "Project") does not exist yet, but some models included a "ProjectId" which is renamed to "ProjectCollectionId".

So in conclusion:

  1. 'Project' --> 'Project collection'
  2. 'ProjectId' --> 'ProjectCollectionId'
  3. 'Work order' --> 'Project'
  4. 'WorkOrderId' --> 'ProjectId'
  5. 'Work activity' --> 'Activity'
  6. 'WorkActivityId' --> 'ActivityId'

The following modules are affected: Time reports, Task boards, Tasks, Projects (formerly Work orders) and Activities.
Details are listed below.

Added
  • New detail endpoint for Users, "GET /v1/Admin/Users/:id".
Modified
  • Renamed former "Work orders" module to "Projects", "GET /v1/Core/WorkOrders" is now "GET /v1/Core/Projects".
    Other changes to this endpoint includes:
    • Property "objectName" in response model for "GET /v1/Core/Projects" has changed from "workorder.list" to "project.list".
    • Property "project" in the reponse model "project.list" has been changed to "projectCollection".
    • Property "status.objectName" in response model "project.list" has changed from "workorder.list.status" to "project.list.status".
  • Changes for endpoint "GET /v1/Core/TimeReports":
    • Filter parameter "filter.workOrderId" has been changed to "filter.projectId".
    • Property "workOrder" in the reponse model "timereport.list" has been changed to "project".
    • Property "workActivity" in the reponse model "timereport.list" has been changed to "activity".
  • Changes for endpoint "GET /v1/Core/TimeReports/:id":
    • Property "workOrder" in the reponse model "timereport.detail" has been changed to "project".
    • Property "workActivity" in the reponse model "timereport.detail" has been changed to "activity".
  • Changes for endpoint "POST /v1/Core/TimeReports":
    • Property "workOrderId" in the request model has been changed to "projectId".
    • Property "workActivityId" in the request model has been changed to "activityId".
  • Changes for endpoint "PUT /v1/Core/TimeReports/:id":
    • Property "workOrderId" in the request model has been changed to "projectId".
    • Property "workActivityId" in the request model has been changed to "activityId".
  • Changes for endpoint "GET /v1/Core/TaskBoards":
    • Filter parameter "filter.workOrderId" has been changed to "filter.projectId".
    • Property "workOrder" in the reponse model "taskboard.detail" has been changed to "project".
  • Changes for endpoint "GET /v1/Core/Tasks":
    • Property "project" in the reponse model "task.list" has been changed to "projectCollection".
    • Property "workOrder" in the reponse model "task.list" has been changed to "project".
  • Changes for endpoint "POST /v1/Core/Tasks":
    • Property "workOrderId" in the request model has been changed to "projectId".
  • Changes for endpoint "PUT /v1/Core/Tasks/:taskId":
    • Property "workOrderId" in the request model has been changed to "projectId".
  • Renamed former "Work activities" module to "Activities", "GET /v1/Admin/WorkActivities" is now "GET /v1/Admin/Activities".
    Other changes to this endpoint includes:
    • Property "objectName" in response model for "GET /v1/Admin/Activities" has changed from "workactivity.list" to "activity.list".
  • Persmission "WorkOrder_Read" has been changed to "Project_Read" (no action required).

Version 2.0.0.2

Released 2021-12-09

This release includes some minor bugfixes in the Task and Contact modules.

Bugfixes
  • Fixed an issue that was caused by a historical bug in the contact registry. The issue resulted in a status 500 Internal Server Error for some consumers when calling endpoint "GET /v1/Core/Contacts".
  • Fixed a bug when fetching tasks ("GET /v1/Core/Tasks"). The issue occurred if the list of tasks contained atleast one task where either the user that created the task was deleted, if the workorder that the task was connected to was deleted or if the opportunity that the task was connected to was deleted. The result was a status 500 Internal Server Error.

Version 2.0.0.1

Released 2021-12-06

This release includes changes to the GUI of the API documentation aswell as some minor changes to the API. The changes to the API includes some new filter options for some endpoints and a new read-permission (WorkOrder_Read) for the Work order module.

Added
  • New permission "WorkOrder_Read" available for API-applications in the API management portal.
  • New property "Tags" included in "taskboard.list" response for endpoint "GET /v1/Core/TaskBoards".
  • New filter option for endpoint "GET /v1/Admin/Users":
    • Ability to filter users based on their name with "filter.query".
  • New filter options for endpoint "GET /v1/Core/Tasks":
    • Ability to filter tasks based on an array of task ids with "filter.taskIds".
    • Ability to filter tasks that belongs to a specific task board with "filter.taskBoardId".
    • Ability to filter tasks that belongs to a specific task board column with "filter.taskBoardColumnId".
Modified
  • Endpoint "GET /v1/Core/WorkOrders" now requires permission "WorkOrder_Read".
Bugfixes
  • Fixed a bug in model validation for endpoint "POST /v1/Core/Tasks" where if the value of properties "tagIds" or "memberIds" was "null" (empty array was fine) or if the properties was excluded in the request, the result would be a 500 Internal Server Error.
  • Fixed a bug in model validation for endpoint "GET /v1/Core/TimeReports/UserDayStatistics" where if none of the filters were supplied, the result would be a 500 Internal Server Error.

Version 2.0

Released 2021-11-08

This release marks the initial version of the new API.

Added
  • Core resource endpoints
    • Contact (list, detail, create, update, delete)
    • Time report (list, detail, create, update, delete)
    • Task (list, create, update, delete)
    • Task board (list only)
    • Work order (list only)
  • Admin resource endpoints
    • Countries (list only)
    • Contact tags (list only)
    • Users (list only)
    • Time codes (list only)
    • Time articles (list only)
    • Work activities (list only)
    • Allowances (list only)
    • Company cars (list only)
    • Equipments (list only)
    • Articles (list only)
    • Time additions (list only)