Release notes - Suppliers API

This page will show the changes made in the suppliers API version 2025v1.

New changes are added at the top of the page and include a summary of the modified models. A summary of all model changes can be foundhere.



JSON library change

  • JSON serialization and deserialization now use System.Text.Json instead of Newtonsoft.Json.
    Unlike Newtonsoft.Json, System.Text.Json enforces stricter validation when deserializing invalid JSON. To avoid issues, ensure that the JSON you send is valid before deploying to production.


503 Error messages

  • Added a 503 error message to the responses of all endpoints.


Daytrade - General



Daytrade - Sales Strategies

  • Added new endpoints and models to add, edit, delete and sync Sales strategies for Daytrade.

Affected endpoints:


Affected models:




Daytrade - Auction

  • Added a new endpoint and model to add Daytrade Clock pre sales supply lines, including a hub location and a sales strategy.

Affected endpoints:


Affected models:



AuctionDate

  • The property AuctionDate now returns a Date in stead of a DateTime.


Collections

Several changes have been made to the models Collection, CollectionUpdate and CollectionCreate.

  • Added the properties isHighlighted, t17ThemeValueCodes and UsesTradeItemSpecificPackingConfiguration.
  • The property isActive has been changed to isVisible to better reflect the purpose of the property.
  • The property description now has a minlength of 1.
  • The property photos/AddCollectionPhoto now requires a photoId instead of a imageUrl.

For clarity purposes, sort-order has been changed to sort-index. This currently only applies to Collections.

  • The route collections/{collectionId}/sort-order has been changed to collections/{collectionId}/sort-index
  • The operation ID of this endpoint has also been changed from SetSortOrderForCollection to SetSortIndexForCollection.
  • In the model Collection, the property SortOrder has been changed to SortIndex.

Affected endpoints:


Affected models:



FulfillmentOrderClaims - Non-nullable

  • The FulfillmentOrderClaims property in the FulfillmentRequest model has been updated to non-nullable.

Affected model:



Excluded organizations in General price groups for Direct Sales

  • Added a new endpoint and model to retrieve organizationIds that are excluded from General price groups in Direct Sales.
    • Supplier organizations that use BatchPrices may use General price groups to target every customer organization working with those supply lines. A supplier organization may exclude certain organizations from a General price group. This endpoint enables retrieving these excluded customer organizations via the Floriday API.

Affected endpoints


Affected models



AdditionalService - Floricode VRS Packaging ID

A new optional field, floricodeVrsPackagingId, has been added to the AdditionalService model. This field provides the Floricode VRS packaging ID associated with the additional service.


Affected models:



BatchMutationType - New types

The BatchMutationType enum has been extended with two new types, UNCLAIMED_FROM_RESERVATION and DELETED_RESERVATION.


Affected enums:



SalesOrder - Batch ID

The batchId of a sales order is now present in the sales order model.


Affected models:



PaymentProvider - RFH_AFTERPAY enum rename

The value RFH_AFTERPAY in the PaymentProvider enum has been renamed to RFH_PAY_LATER.


Affected enums:



Track and Trace - Add and retrieve Track & Trace scans

Three new endpoints are added to add and sync track and trace scans to get insight to where your shipments currently are.


Affected endpoints:


Affected models:


Affected enums:



Warehouse - IsDefault

Added property isDefault to the Warehouse model.

Affected models:



Batch - SupplierOrganizationId

Added property supplierOrganizationId to the Batch model.

Affected models:



FulfillmentType - Extended enum

The FulfillmentType enum has been extended with value DAY_TRADE.

Affected enums:



AddContract, AddContractVersion, EditContract, Contract - TermsAndConditions

You can now specify which terms and conditions apply to a contract using the termsAndConditions property.

Affected models:



PDF shown as response type in Swagger

  • Endpoints that return a PDF file now lists application/pdf as Response content type on the Swagger page.


Update 18/4/2025

ContractPeriodKind - Extended enum

The ContractPeriodKind enum has been extended with the value DAY.


Update 30/4/2025

CustomPackages - Added property

Added property DefaultPiecesPerPackage to the CustomPackages model.

Affected models: