As of May 1st, the Floriday Customer API Summer main release 2023v1 is stable and available. This means that your software vendor can add new features and/or improve existing features in the software you're using in combination with Floriday.
Below is a brief overview of the major improvements in this release. Afterwards, the features available to software vendors are described per module. These features are accompanied by a link to the associated Helpcenter article if available.
For an overview of main features (to be) supported by software vendors, please visit our Software overview page.
Functional improvements
Adjustable weekly prices: As of October 1st 2024, suppliers will be able to adjust the weekly prices of plants during the week. After a price adjustment of a supply line in a weekly list, a 24-hour time lock comes into effect. This means that a subsequent price adjustment of that specific supply line can only take place 24 hours after the previous price adjustment.
The tools required to implement these chanes have already been made available in the 2024v1 version of your software. This allows your software vendor to timely start preparations for this new feature.
For more information on the Adjustable weekly prices, please read this article.
Contracts: Several improvements and adjustments to the Contract module have been made.
You are now able to add End customers to contracts when using the API.
Trade items variants can be used when creating Blanket orders.
When creating a contract, you can now enter a percentage or a fixed amount when entering the margin for the price of the number of pieces.
You are no longer allowed to edit the customer in a contract, if the contract is already finalized.
A supplier may now create groups of trade items when adding a Contract. Instead of adding a single trade item, adding a group of trade items allows for more flexibility when creating Blanket orders.
A group of trade items consists of one Primary trade item and one or more substitute trade items. Both growers and customers may choose any trade item from the group of trade items when creating Blanket orders.For more information about Contracts, please read this article.
Order requests: When creating an order request for a supplier, you can now also indicate that stickers are included in the supply line. This allows for more accurate order requests.
Trade settings: You are now able to view Trade settings when using the API. Previously, you could only view your Trade settings or those of suppliers on the Floriday web site.
Managing your Trade settings can still only be done on the web site, which allows you to configure how you wish to trade with your suppliers on Floriday.
The trade settings of growers may be integrated in your software to optimize your workflows. For instance, you could check ahead if a grower automatically accepts Sales order corrections or if a grower works with Contracts.
For more information about Trade settings, please read this article.
Plant Passports: You are now able to download PDFs for Plant Passports. You can download the PDFs based on Sales orders and Sales channel (i.e. Direct and Clock).
Technical improvements:
For a more efficient performance of the API, several technical improvements have been made.
Nullable to non-nullable: Previously, the API documentation included several fields that were indicated as 'optional', even though the fields were always filled. These specific 'optional' fields have now been made 'required'. This makes it more clear for your software vendor when data is available or not.
Clearer error messages: It is now clearer when an incorrect value is entered in a field where this value is not allowed.
Overview of Floriday Customer API features
Trade items
Collection of items
Retrieve, create and delete selected favourite items and favourite load configurations
Read more in this article
Own packages
Collection of own packages.
Additional services
Collection of additional services
Read more in this article
Supply
Collection of direct supply sales
Collection of clock (presale) offer based on sales orders.
Purchase & sales orders
Retrieve, place and remove purchase orders for matching on supply through the Floriday purchasing dashboard
Retrieve, create and delete order requests
Collect, place and cancel sales orders on supply
Retrieve insight into financial invoicing status delivered sales orders
Retrieve insight into dynamic delivery costs of sales orders within an order/delivery window
Collection of clock and clock presale sales orders
Read more in this article
Call-off orders
Retrieve, create, update, accept/reject/finalise call-off orders.
Read more in this article
Contracts (enhanced)
Retrieve, create, accept/reject and delete contracts and contract attachments.
Read more in this article
Customer stickers
Retrieve, create, remove customer stickers from a sales order.
Read more in this article
Correction requests
Fetch, create, delete correction requests on sales orders
Read more in this article
Delivery terms
Get delivery terms
Logistics
Deliveries
Retrieve letter numbers belonging to a sales order (temporary solution until the ASN is available).
Collection of plant passports for propagation
Retrieve delivery announcements (ASN) for logistical planning and indoor notification of deliveries
Marking deliveries received
Marking received batches
Requests for quotes (improved)
Retrieve and create requests for quotes.
Retrieve and create requests for quotes for a trade item.
Read more in this articleRetrieve and create requests for a trade item's load configuration.
Read more in this article
Match & Connect
Fetch, create and delete connections with suppliers.
Learn more in this article
Network - Trade settings
Retrieving your own trade settings and retrieving customer trade settings.
Organisations
Retrieve vendor organisations and certificates.
Stock locations
Retrieve stock locations.
Read more in this article
Insights auction prices
Retrieve average auction prices per day for each VBN product code auctioned by the grower. An Insights subscription is required.
Read more about Insights