Guides

Release notes - Customers API

This page will show the changes made in the customers API version 2024v2.

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 found here.



CustomPackage - Additional Floricode Vrs packaging ID

A new optional field, floricodeVrsPackagingId, has been added to the CustomPackage model. This field provides the Floricode VRS packaging ID associated with the custom package.

Affected models:



SalesOrder - RFH afterpay

Added RFH afterpay as a new option in Floriday. This will result in a new paymentprovider value. The SalesOrder has a new property isPaid to indicate the order has been paid by the customer.

Royal Floraholland introduces a new payment method RFH Afterpay in a trial setup. Royal FloraHolland payment provider determines the buyer possibility for RFH afterpay or E-wallet only, which can be selected by Royal FloraHolland predetermined suppliers in Floriday. In Floriday the supplier pre-selects the prefered afterpay options for their buyers. The buyer can select with the sales order the new payment method.

A new enum, PaymentProviderCreate, has been added for use in add/edit commands to determine the payment provider. This enum does not include the values RFH_E_WALLET and RFH_AFTERPAY. When selecting RFH, Floriday will automatically determine whether to use the payment provider RFH, RFH_E_WALLET, or RFH_AFTERPAY.

Affected enums:

Affected models:



SalesOrder - Auction Levies and Package Rental Costs

New properties totalAuctionLevies and totalPackageRentalCosts have been added to the SalesOrderCalculatedFields model.

  • totalAuctionLevies: This field contains the total price of all auction levies calculated for the sales order, currently used only for clock presales orders.
  • totalPackageRentalCosts: This field indicates the total price of all package rental costs calculated for the order, currently used only for clock presales orders.

These new fields will not affect the existing properties orderAmount and totalPricePerPiece.

Affected models:



LoadCarrierType - New types

As part of the development process, new load carrier types have been added to the LoadCarrierType enum. These values are not yet actively used within Floriday.

Affected enums:



SalesOrder - Associate Additional Service with Customer Sticker

An optional property, stickerId, has been added to OrderedAdditionalService to associate the AdditionalService in a SalesOrder with the corresponding CustomerSticker.

Affected models:



Organization - Non-Nullable Properties

Several properties in the Organization model, which were previously nullable, have been updated to non-nullable. These properties no longer return null values as this hasn't been the case for some time.

Affected models:



AddSalesOrderCorrectionRequest - Expires At DateTime

You can now optionally set the expiresAtDateTime when creating a new correction request with the AddSalesOrderCorrectionRequest endpoint.

Affected models:



AddSalesOrderCorrectionRequest and SalesOrderCorrectionRequest - ShouldReturnPackages

A new property, shouldReturnPackages, has been added to both the AddSalesOrderCorrectionRequest and SalesOrderCorrectionRequest models. This property indicates whether the customer will return the packages or keep them when submitting a cancellation request. The option is relevant due to the deposit associated with the packages.

Affected models:



PhotoType - Webshop Friendly

New enum value, WEBSHOP_FRIENDLY, has been added to the PhotoType enum.

Affected enums:



SalesOrder - Batch Reference

A new optional property, batchReference, has been added to the SalesOrder model.

The batch reference will be set after the fulfillment request has been created and linked to a batch.

Affected models:



ContractPeriodKind - Half year and year

New enum values HALF_YEAR and YEAR have been added to the ContractPeriodKind enum.

Affected enums:



CustomerSticker - CreationDateTime

A new property, creationDateTime, has been added to the CustomerSticker model.

Affected models:



TradeItem - Additional Floricode Vrs packaging ID's

A new optional field, additionalPackagingInformationFloricodeVrsPackagingIds, has been added to the TradeItem model. This field provides the Floricode VRS packaging ID's associated with the trade item.

Affected models:


PackingConfiguration - Floricode Vrs Packaging ID

A new optional field, floricodeVrsPackagingId, has been added to the PackingConfigration model. This field provides the Floricode VRS packaging ID associated with the packing configuration.

Affected models:



SalesOrderRequest - SupplierOrganizationId

A new property, supplierOrganizationId, has been added to the SalesOrderRequest model.

The supplier organization id will be used to validate the corresponding supply line and check wallet reservations before placing the order.

Affected models: