HomeLog In

The Floriday Model

Domain overview


  • Floriday is high level grouped by Floriday domains (Core, Match & Connect, Catalog, Stock, Supply and Orders, Fulfillment, Payment & Invoicing).

  • Every Floriday domain has one or more logically grouped Floriday services with resources usually manifested in Floriday modules (e.g. Customer delivery with Fulfillment orders, Delivery orders, Customer Stickers) and should be connected to as a module.
  • The exception are the Floriday Core domain services which contains key services with resources which are shared with (most) other Floriday services (e.g. organizations, media, additional service) and should be implemented as such.
  • Floriday services can be accessed by the Customer and Supplier ERP gateways.

Simplified Domain model


Entity relationship model

To support the design and development, Floriday provides an entity relationship model with a list of definitions.

Reading guide:

  • This model contains the entities and relationships relevant to the development. Not all possible entities and relationships are included as this would create confusion.
  • The model contains entities that are supported in this API version.
  • The model includes entities of financial service providers that are relevant for context, but not used in the API.
  • Floriday is in continuous development, as is the entity model. As soon as a new version of the API is supported, the entity model will be expanded accordingly.
  • The entity model may suggest that only supply-lines can be created based on base supply, but this is not the case. Supply-lines can also be created based on the stock domain (batch/continuous stock).


1. Organization

  • Organization - A registered company with a name, address and a logo.

    1.1. Organizations are typed, e.g. 'supplier', 'customer', 'service provider'.
    1.2. An organization may be registered as a company with Floricode.
    1.3. An organization has at least one location with an address.
    1.4. An organization's location may be registered as a company-location with Floricode.

2. Catalog

  • Base Item - The basic level of items at which stock is held. The parts of a trade item.

  • Trade Item - Describes all product characteristics. Can be configured from underlying base items.

  • Characteristic - A feature of a trade item, for instance 'stemlength' or 'potsize'.

    2.1. A trade item has a VBN productcode.
    2.2. A trade item has a list of characteristics.
    2.3. Each characteristic has a VBN code and a VBN value code.
    2.4. A trade item has at least one packing configuration.

    2.5. A trade item may consist of underlying base items.

3. Stock

  • Batch - A specific quantity of stock at a specific warehouse.

  • Warehouse - A location for stock keeping.

    3.1. A warehouse is a type of location.
    3.2. Stock at a warehouse is defined in one or more batches.
    3.3. A batch is either a quantity of a trade item, or a quantity of a base item.
    3.4. A batch has one packing configuration.

4. Packing

  • Packing Configuration - Describes the way trade items can be packed for transportation.

  • Package - Any self-contained wrapping or container which can contain trade items. Packages are used to support the transportation and protection of trade items.

  • Custom Package - A customized package with specifications given by the owner, as opposed to the standard VBN specifications.

  • Load Carrier - A logistical means used to transport trade items from one place to another. Load carriers usually consist of a rolling base and one or more layers.

    4.1. A packing configuration has one package.
    4.2. A package has a VBN package code.
    4.3. A packing configuration has one loadcarrier type.
    4.4 A package may have a custom package id.

5. Supply
Supply - Describes the commercial terms and conditions under which trade items are offered for sale.
Supply Line - Supply of a specific trade item that is allocated to one or more sales channels.
Trade Instrument - A specific trading mechanism. Examples are: clock sales, direct sales, clock presales.

5.1. A supply line has one trade instrument.
5.2. A supply line has at least one sales channel.
5.3. Stock keeping for one or more supply lines is done at the level of a batch.
5.4. A supply line has at least one packing configuration.

6. Sales

  • Business Transaction - An event in the business domain that is measurable in money.

  • Delivery Condition - The terms and conditions associated with a delivery to a specific location and / or customer.

  • Sales Order - An agreement between a supplier and a customer for the purchase of trade items under the supply conditions.

  • Sales Channel - A platform where customers can buy trade items. A sales channel supports one or more trade instruments

  • Additional Service - A priced, optional service, provided by a supplier, that can be included in the sales order.

  • Purchase Order - An order for one or more trade items, placed by a customer, that may result in one or more sales orders.

    6.1. A sales order is a type of business transaction.
    6.2. A business transaction reflects agreements between different organizations.
    6.3. A purchase order may lead to one or more sales orders.
    6.4. A sales order may included one or more additional services.
    6.5. A sales order is initiated in one sales channel.
    6.6. A sales order has one packing configuration.
    6.7. Fulfillment of a sales order is subject to the conditions of a delivery condition.
    6.8. A delivery condition specifies possible delivery locations.
    6.9. A delivery condition specifies timeframes for delivery.
    6.10 A sales order may be placed on a supply line ( other option = contract / blanket order see 10. )
    6.11 A sales channel supports one or more trade instruments. A trade instrument can be supported by different sales channels.

7. Fulfillment Orchestration

  • Delivery Order - Specifies the outbound batches for a (outgoing) shipment. Relates to one or more fulfillment requests.

  • Fulfillment Request - A request to prepare a batch(part) for transport ( e.g. to another warehouse or a customer ). Is triggered from several usecases, e.g. sales order fulfillment or warehouse stocking.

  • Fulfillment Order - The business transaction related to a shipment. References the fulfillment requests that are fulfiled.

    7.1. A delivery order has a despatch- and delivery location.
    7.2. A delivery order can aggregate many fulfillment requests to specify a preferred shipment.
    7.3. A delivery order specifies the outbound batches for an outgoing shipment.
    7.4. A fulfillment request specifies the quantity to fulfill from one batch.
    7.5. A fulfillment request may be the result of a sales order.
    7.6. A fulfillment order is a type of business transaction.
    7.7. A fulfillment order fulfills one or more fulfillment requests.
    7.8. A fulfillment order relates to one shipment.

8. Fulfillment

  • Loadcarrier Configuration - The specification of batch-parts and logistical means associated with one loadcarrier.

  • Logistical Means - The hardware used for transport.

  • Outbound Batch - A batch involved in an outgoing shipment.

  • Shipment - A logical unit of transport. Describes the physical stacking of (outbound) batches on loadcarriers and logistical means involved in the transport.

    8.1. A shipment specifies one or more loadcarrier configurations.
    8.2. A shipment carries one or more batches, in case of an incoming shipment.
    8.3. A shipment carries one or more outbound batches, in case of an outgoing shipment.
    8.4. An outbound batch is (part of) a batch, to be carried on an outgoing shipment.
    8.5. A loadcarrier configuration consists of one or more batch-parts.
    8.6. A loadcarrier configuration specifies the logistical means involved in transport.
    8.7. A (outbound) batch may be spread over multiple loadcarriers in different batch-parts.

9. Finance

  • Charging - The process of determining the total cost or benefit for parties involved in a Business Transaction.

  • Claim - The amount of credit reserved for settlement of a Business Transaction.

  • Consumption Item - A quantifiable and tradable item. Result of a Business Transaction.

  • Billable Item - Specifies costs of a Consumption Item. The result of charging.

  • Settlement - The financial fulfillment of a claim or part thereof.

    9.1. A business transaction results in a claim for one or more consumption items.
    9.2. A consumption item can either specify a trade item, service, logistical means or load carrier.
    9.3. A billable item is related to one consumption Item.
    9.4. À settlement involves the settlement of ( part of ) one claim.
    9.5. A settlement involves the settlement of one or more consumption Items. A consumption Item may be settled in more than one settlement.

10. Contract

  • Contract - Agreement between a supplier and a customer for the purchase of trade items in a specified period

  • Blanket Order - An order created according to the conditions of the contract, initiated either by the supplier or the customer.

    10.1. A business transaction may have one or more underlying contracts. One contract can lead to multiple business transactions.
    10.2 A blanket order will result in one or more sales orders.
    10.3 A blanket order will periodically be created according to the conditions of the contract, initiated either by the supplier or the customer.