Release notes

5-11-2024

The "edudexProgramUrl" property on the Course Object Model is no longer patchable. And data send on this property will be ignored. The value for this property will be set by the Edudex import and will be read-only after that. See the Course Object Model documentation for the details.

14-10-2024

The STAP subsidy has ended on 31 December 2023, this option is now deprecated and it will be removed in the future. The subsidy can no longer be set as a subsidy available for a course.

13-05-2024

The value "Maatwerk" has been deprecated and it will be removed in the future. It can be found in the "ProductType" enum of the course object. Please use the type "Incompany" instead.

15-04-2024

The property "ProductType" of our courses is no longer patchable. This has been done to prevent a course type modification after it has been created.

08-02-2024

We've split the CancellationReason used in the POST OrderStatusTransition for better clarity and specificity, particularly with the introduction of the new PurchaseAgreement order type.

Key Changes:

  • New Enumerations:

    • CourseCancellationReason: Retains original reasons.

    • PurchaseAgreementCancellationReason: Introduces specific reasons for PurchaseAgreement orders: Cancelled, PriceDoesNotMatch, and Other.


Impact and Scope:

This update only affects enumeration endpoints. The payload for POST OrderStatusTransition remains unchanged. Backend handling of enums remains intact, ensuring no disruption to existing functionalities or workflows.
We believe this change will enhance clarity in order cancellations, particularly for different order types.

09-11-2023

We are pleased to announce the release of a new PUT endpoint of our Provider API v2, packed with significant enhacements and updates that empower you to work with course data more efficiently.

  • New Endpoint: Update Course by ID (No Start Moments Info)

    • In this latest version, we have introduced an endpoint designed to make your experience even more flexible when retrieving course information by its unique ID. This new feature allows you to access course details without the inclusion of startMoments-related information, providing you with the freedom to focus exclusively on the data that matters most.

  • Existent Functionality: Individual StartMoments Update

    • We also want to remind you that, as before, our API continues to offer the flexibility of updating startMoments individually based on their ID and courseID, ensuring you have the tools to manage your course scheduling precisely.

We've implemented this update with the aim of enhancing the practicality and flexibilty of our platform, guarateeing that you have access to the tools and data required to create an improved user experience.

13-10-2023

We are excited to introduce several significant enhancements and updates in Version 2.0 of our Provider API:

  • New Endpoint: Retrieve Course by ID (No Start Moments Info)

    • In Version 2.0, we have introduced a new endpoint that allows you to retrieve course information by its unique ID. Unlike the previous version, this endpoint excludes any startMoments-related information. This change provides more flexibility when working with course data, allowing you to access only the information you need.

  • Course Model Object Update

    • We have made improvements to the course model object used in Version 1.0. The course model object now includes all properties that are currently in use, providing a more comprehensive representation of course data. Notably, we have also added language code-related properties to enhance the features of the course model.

    • Course object model v1

  • New Course Model Object (Version 2.0)

    • As part of this release, we are introducing a new course model object specific to Version 2.0. This model object encompasses all properties used in the new endpoint introduced in this version. With this addition, you can seamlessly access and manage course data with the latest features and attributes.

    • Course object model v2

These updates are designed to improve the usability and versatility of our platform, ensuring that you have the tools and data you need to create a better user experience.

31-07-2023

We are excited to announce some important changes to our web APIs, specifically related to the authentication process. With this update, we have removed the old login endpoints to improve security on our authentication services. You can now find the updated login endpoints in the API documentation (https://acc-developers.edums.nl/api-details#api=identity-server&operation=login). We highly recommend that you update your applications to use these endpoints immediately, as the old endpoints have been removed.

25-04-2022

Subsidy prices

It's possible to requests the price including a subsidy if available from the POST calculate course price endpoint. The subsidy price (if available) is also added to the assorted product index. You can find the documentation at the POST assorted product search endpoint

01-12-2021

  • A new status has been added for orders, after cancelled by account. It's a status which can be applied by admins only when an order has been cancelled by the account, but still needs to be invoiced. The new status is CancelledWithCosts.

  • Startmoments can now be deactived by updating the inactiveproperty to true.This will make sure that they are not indexed, and that they are not bookable.

  • When a chosen startmoment is not provided on the transition from Pending Provider > Accepted by Provider, the chosen startmoment field will be filled with the first choice startmoment which is present on the order.

11-10-2021

  • When approving an order (e..g setting the status to Pending Provider) you can indicate as provider which startmoment you chose to accept. This will be used picking the invoicing date and will be displayed to the student.

  • When you cancell an order as a provider you can now indicate that you cancelled it due to not enough participants. Find the option at our endpoint documentation on the Order API.

  • Our importing mechanism for Edudex courses is not importing startmoments anymore which are in the past.

27-09-21

  • For incompany courses, which have a cutoffDate defined, some new functionality has been introduced being. 1. If the cutoffDate = current dateand the min amount of participants > orders for that startmoment, the orders will be automatically declined 2. When the cutoffDate = current date and the min amount of participants < orders for that startmoment, learningMethod.planning.startMoments[n]. startGuaranteed will be set to true

  • Orders can only be accepted when a credit number is filled in at legal company level. This in order to avoid problems in the invoicing flow afterwards.

  • An value has been added for the subsidy enum on the course document, being RetrainingScheme(Omscholingsregeling)

13-09-21

  • The property "learningMethod.planning.startMoments[n].cutOffDate" has been added to the course model. This is the final date for incompany courses to decide whether their planned startmoment is happening.

  • The documentation for the Search endpoints has been updated to indicate which properties are searchable, filterable and sortable. You can find it on the respective endpoints, for example here.

05-07-2021

Implementation date ACC: 01-07-2021
Implementation date PRD: 05-07-2021

  • Courses for which the enddate is set, and the enddate is past the current date will be deleted automatically by EduMS. The "isDeleted" property will be set to true and the course will be removed from the assortment(s) (if it is in any)

21-06-2021

Implementation date ACC: 021706-2021
Implementation date PRD: 21-06-2021

  • Functionality has been created for creating merchants, therefore statusses and merchant id have been added on the legal company resource

  • The merchant id will also be stored on the order if available, you can find it on the order lines resurce