Release notes - Suppliers API

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

Added new enums and models for Daytrade.
- Added new enum: DayTradeHub
- Added new model: ClockSupplyLinePackingConfiguration
- Added new model: PhotoWithId
- Added new model: VolumePrice

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:

AddClockSupplyLineV2

Affected models:

AddClockSupplyLineV2

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:

SetSortIndexForCollection

Affected models:

FulfillmentOrderClaims - Non-nullable

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

Affected model:

FulfillmentRequest

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

GetExcludedCustomerOrganizationIdsForGeneralDirectSalesSupply

Affected models

ExcludedCustomerOrganizationIdsForGeneralSupply

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:

AdditionalService

BatchMutationType - New types

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

Affected enums:

BatchMutationType

SalesOrder - Batch ID

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

Affected models:

SalesOrder

PaymentProvider - RFH_AFTERPAY enum rename

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

Affected enums:

PaymentProvider

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:

TrackAndTraceStatus

Warehouse - IsDefault

Added property isDefault to the Warehouse model.

Affected models:

Warehouse

Batch - SupplierOrganizationId

Added property supplierOrganizationId to the Batch model.

Affected models:

Batch

FulfillmentType - Extended enum

The FulfillmentType enum has been extended with value DAY_TRADE.

Affected enums:

FulfillmentType

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:

CustomPackages

Update 19/5/2025

Added an optional salesStrategyId property to the GetClockSupplyLineById and GetClockSupplyLinesBySequenceNumber endpoints.
Fixed a typo in the BatchMutationType enum for the RELEASED_RESERVATION value.

Update 6/6/2025

Added RHEINMAAS and PLANTION to the DaytradeHub property.

Update 20/6/2025

The VolumePrice property in the SalesStrategyPresalesPrice model has been updated to non-nullable.