# April 2025 ## Monthly summary / tl;dr ### New features 🚀 * **Basic Central Warehouse functionality is now supported**, showing central stock levels across all relevant product searches. * **SMS messages** can now be sent directly from both order details and the customer list – communication made easier. * **Full stock visibility**: search results now show stock per warehouse, including reserved quantity and gross profit. * **Flow gift cards now support CVC**, **legacy** **card** **numbers**, and new statuses (CLEARED, ACTIVE, INACTIVE). * **Pre-payment features** are out of beta, with visible options and support for refunds via API. * **Bulk customer import added** – finally, no more one-at-a-time for large customer bases. * **Customer reservations** are now fully rolled out and visible, with better purchase linking. * **Product search** now supports **package** product availability based on lowest component stock. * Backoffice tools expanded: full receipt reports, printer/device search, invoice footer customization. * **New endpoints:** service order images, receipt handling, and Softpay integration. ### Improved 👌 * Warehouse selection and delivery flows are more intuitive, especially during sales and receivals. * Stock movements now sync better with Omnium, including delivery and reservation mapping. * UI refinements throughout: order dialogs load faster, tab/escape navigation improved, and more helpful hints in payment dialogs. * Customer management improved: external ID visibility, duplicate checks, clearer role requirements. * Receipt PDFs, invoices, and reports now include more useful data like EAN, VAT number, and campaign names. * Touch and keyboard sale views are cleaner, faster, and handle product additions more reliably. * Updated Finnish EHF schemeId and rounding rules for cash payments. * Better handling of gift cards, reservations, and price logic on order changes. * Terminal logic improvements for receipts, calendar popups, and till behavior. * Backoffice refinements to product group inheritance, tenant user editing, and mapping of delivery/payment methods. ### Fixed 🤦‍♂️ * Issues with deleting deliveries, removing items, and freezing settlements have been resolved. * Order items tied to deliveries now behave correctly when reserved, returned, or deleted. * Several bugs around stock adjustments, pricing logic, and customer creation were fixed. * Manual invoice sending now works correctly even with mixed EHF store/tenant setups. * Terminal receipts now print logos again, show correct formatting, and follow new layout logic. * Fixed problems with order previews, RMA reasons, product search barcodes, and asset loading. * Orders now open in the correct dialog regardless of status; actions vary based on settlement state. * Accurate credit/debit behavior in accounting reports and purchase order PDFs. * Purchase price default issues and supplier selections during PO creation now behave as expected. * Deprecated V1 APIs were removed, improving performance and reducing maintenance load. * much more! Check out the full list above. *** ## 2025-04-30 ### Added * **Settlement parameters** are now shown in the **settled order view**. * You can now **view the full delivery address** if an order item is on a delivery when opening the **order details dialog**. * **Product stock for all warehouses** is now shown in **product search results**. The **default warehouse** and **central warehouse** (if enabled) will appear first in the list. * It's now possible to **send SMS messages** directly from the **order details dialog**. * In **touch mode**, pressing any key (except TAB, ENTER, or arrows) in the **login view** activates the **manual login form**, with the pressed key pre-filled in the **user code** field. * **Customer note** is now shown in the **open order view** + **y**ou can now **add customer notes** to all customer types – **private**, **company** and **B2B**. * The **Counting Help dialog** now displays the **expected amount**. * Added support for **gift cards requiring CVC** to be used in **payments**. * A **date picker** is now available for selecting **delivery dates** in the **create delivery dialog**. * Holding **CMD+D** (or CTRL+D on Windows) while focused on a product in **search results** will now show its **gross profit** and **margin**. * Added support for **using legacy gift cards** in sales. * You can now **check the balance** of **legacy gift cards**. * **PIN code check** is now required for **each sale** when using **keyboard mode**. * **Bulk import of customers**, because one-by-one is just too slow when dealing with millions of records. * New endpoint `POST /tenants/{tenantUid}/customers/batch` * **Payment barcode** added to Finnish invoices – makes paying easier. * **Invoice footer text** for stores – now you can finally say something nice (or scary) at the bottom of invoices. * Backoffice **Full receipts report** for stores – perfect for those who enjoy digging into paper trails. * New payment method parameter key "CVC" for Flow gift card settlements. * **Lookup** for Flow gift card using **legacy card number** – your old cards still matter! * Masked gift card number is now shown on the gift card order line **on the receipt**. * Option to enable **Duplicate check** for **phone number** and **VAT** **number** when creating or updating customers – one customer, one number. * Rounding in Finland is now set to 5 cents as the lowest denomination for cash payments. * Gift card lookup by **legacy card number**. * Adyen card payment: added **support for “no reference” refunds**, allowing refunds to any card without needing a link to a previous sale. ### Improved * You can **tap a delivery** directly from an **order item** to view and edit the **delivery** itself. * **Products are now added** to the **bottom of the list** in the correct (non-reversed) order in both keyboard and touch mode. The list scrolls automatically if the last item is barely visible. * Enabled **printing** for **all printers** defined for the device. * Now you need to have 'Administrator' role to be able to delete customers. * Scanning an **EAN-8 or EAN-13 barcode** into the **quantity or serial number field** in a sale now opens a dialog offering to **search for the product** instead. * Improved **load time** when opening the **order details dialog**. * **Helper text** has been added to **payment amount fields** to explain how to use **percentage calculation** shortcuts. * The **customer details dialog** now shows the customer's **external ID**. * The button for **taking pre-payments** in keyboard mode has been moved **further down** in the sale menu. * The **customer order view** is now in a **separate tab** in the **customer dialog**. * **Customer type** can now be changed using a **dropdown**. The edit button now only edits the current customer type. * When **closing a till**, it is now required to use the **Counting Help dialog**. * Pressing **ESCAPE** in the **main menu** will now navigate **backward** in the menu and eventually return to the **sale view**. * Pressing **TAB** while selecting customer type in address or customer create/edit form will now move focus to the **name field**. * When marking an order item to be **purchased later**, the system will now ask if you also want to mark **all other items** as such. * If an existing item is marked as **purchased later**, and you add a **new product**, you will be asked if the new product should be marked the same way. * The **till status dialog** will now always show the **"open till"** button when using a **non-integrated cash drawer**. * The **PIN field** is now only cleared on failed login attempts – the **username stays**. * The **order handling list** now automatically updates when an item is marked as **complete**. * Only **admins** are now allowed to **delete customers**. * Manually open cash drawer from client via ESC/POS if enabled and a receipt printer exists. * Returning Flow gift cards now clears the card, instead of capturing to zero. * Flow gift card response now includes `cvcRequired`, `issuerName`, and `legacyCardNumber`. * Product lines with zero price are no longer overridden when a customer is added or removed from an order – if it’s free, it’s free. * Payments on invoices are now posted as credit on the posting list. * When returning order items, the system now checks if the original item has actually been delivered before returning it to stock – no more phantom returns. * Updated EHF schemeId in Finland from 0037 to 0216 – keeping up with the standards. * Product search now filters qtyOrdered by current store only – no more cross-store confusion. * Terminal receipt layout and logic improvements. ### Fixed * Creating multiple new **deliveries** on an open order caused issues with previous deliveries – now resolved. * An issue with email addresses stopping from creating new customers is fixed. * Reserving an order item already assigned to a **delivery** caused it to be removed – now fixed. * Fixed issue where you had to **enter the payment amount twice** when using an **external payment method** without parameters. * **Payments could freeze** while settling – added more robust error handling and ability to **force-cancel**. * Fixed issue where an **order item could not be deleted** if it was on a delivery. * **Language change** in the **main menu** now works properly after switching language from settings. * When not signed in, the **interface language** now uses the **tenant’s default**, instead of the previously signed-in user's language. * Terminal receipt formatting and content improved. * Product search now only includes purchase orders for the current store when calculating qtyOrdered. ## 2025-04-25 ### **Added** * **Central Warehouse Extension:** Now you can designate a "Central Warehouse" that appears in all product searches—displaying the stock from any warehouse defined as "Central Warehouse". * **Lots of new stock details on product searches:** Detailed stock information per warehouse now included—view stock levels, reserved quantities, cost prices, and gross profits. * **Flow Gift cards just got saver and better, with** [**CVC**](#user-content-fn-1)[^1] **and legacy card number support:** * Introduced new gift card brand parameter `"CVC"`, which can optionally be enabled, to require entering a 3-digit CVC-code alongside the gift card number. Flow gift cards just got safer! * Now you can import and use your old / existing (legacy) gift cards from your previous gift card solution. Ability to lookup Flow gift cards by legacy card number. * Flow gift cards now come with new statuses: `CLEARED`, `ACTIVE`, and `INACTIVE` - for more accurate handling of gift cards that are "used up". * **Flow Giftcard Responses:** Enhanced with new fields—`cvcRequired`, `issuerName`, and `legacyCardNumber`. * **Campaign Engine:** Items with manually overridden prices by sellers are now gracefully excluded from campaign calculations. ### **Improved** * **Webhooks:** Now returning `orderHandlingUid` instead of the old-school `handlingUid` in order handling updates. New ID, same great webhook flavor. * **Settlement Parameters:** Added `name` field in the settlement parameter responses—small addition, big clarity. * **Receipts:** Custom payment parameters now displayed clearly on receipt PDFs, and on display when looking at an order. * **Warehouse Reports:** EAN/GTIN now displayed in a new column on the XLSX report. Barcode fans, rejoice! * **Invoices:** Customer's VAT number now displayed on invoice PDFs. * **Tenant Response Extension:** Added `UID` for clearer tenant identification. No more guessing games. * **Extensions Access:** Extensions GET endpoints are now accessible via Access Tokens. Security, meet simplicity. ### **Removed** * **Flow Giftcard:** Deprecated boolean `active` status. It served well but is now happily retired, and replaced by the new statuses `ACTIVE`, `INACTIVE` and `CLEARED`. ### **Fixed** * As part of introducing support for adding assets like images to a service order (e.g. photos of the broken handle on the fridge), service-orders now properly load on all `get/list` asset queries. ## 2025-04-24 ### Fixed * Made sure **credit and debit amounts** behave as they should in the **Accounting report** – no more disappearing numbers or creative math. ## 2025-04-23 ### Added * You can now **set a price on an order item** using input like `*1.25`, which sets the price to **cost price multiplied by your input**. Perfect for those moments when you need to sell a product at cost price plus VAT – like when **giving employees a good deal** or handling internal sales. * Enabled linking of **RMA order items** to service orders - this is part of the master plan for adding functionality for warranty claims from a customer service. * **Customer reservation** is now also out of beta and always visible. This feature is actually big! * Implemented new API for handling refunding pre-payment payments:\ `POST /tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/pre-payments/refund` * **Pre-payment** is out of beta and now visible if any pre-payment methods are active in the store. * **Supplier filter** added to the product filter dialog on both the Product List and Sale pages. * **External ID** is now shown in the product info dialog. * **Manufacturer SKU** is now shown in the product info dialog. * **Order numbers** are now visible in the Purchase Request list. * **Customer names** are now displayed in the Purchase Request list. * **Seller names** are shown in the settled order view (press and hold the face icon to see them). * **Delivery info** and **serial number details** are now displayed on order lines when viewing order details. * The **order detail view** now opens the same dialog regardless of order state (OPEN, PARKED, COMPLETE, CANCELED). * Available actions still depend on settlement status. * Images now also display for settled orders. * New field: `ManufacturerSku` in the **XLSX product import**. * Backoffice Support for **searching printers and devices** to streamline setup. * Backoffice Mapping of **payment methods** and **delivery providers** to external systems is now supported. ### Improved * More efficient sort order for orders in the order handling dialog. * **Customer display name** to the purchase order request list responses. * When adding a product that is either out of stock in the default warehouse or not eligible for delivery, a **warehouse selection list** now appears during order item creation. * **EHF** invoicing is now allowed for **B2B customers**. * **Order/invoice numbers** are now shown in both subject and body of receipt emails. * Order lines will now remain **reserved until delivered**, and **prices are recalculated** if the customer on the order is changed. * **Date format** is now shown as `dd.mm.yyyy` across list views. Sorry but not sorry USA (which uses `mm.dd.yyyy`). * It's now possible to **print invoices** for EHF-enabled business customers. * General **UI improvements** throughout the client. * In the **'Create New Customer'** dialog, last name now auto-fills more accurately when only one name is entered. * A negative total in the sale view now screams red – both the button and amount – so you *really* can’t miss it. * In **sale keyboard mode**, the customer section now shows the order’s address info rather than contact details. * **Images** in the order preview dialog are now clickable for full-size view. * The **receivement view** now only shows data for the store the device is onboarded to by default. Use filters to view other stores. * **SMS button** is now disabled if the extension is not enabled. * Backoffice Account users can now edit tenant users when there's only one tenant. * Backoffice **Product groups** now correctly inherit parent scope settings; products receive appropriate sale/standard scope. * Backoffice **Edit Device** view now refreshes properly with a new link code. ### Fixed * Fixed **focus issues** in the order receipt copy dialog. * **Monthly Sales Report** now filters by settle state `COMPLETE`. * **Accounting posting list** now correctly summarizes credit/debit for customer receivables and includes minor template tweaks. * **Return notes** are now included in order receipt responses. * **Purchase Order PDFs** now display the correct `CreatedDate`. * Fixed a nil dereference when **working with assets** (in plain English: we stopped the system from tripping over invisible things. Assets now show up before we try to high-five them). * **Stock adjustments** now allow quantity changes for products that require a serial number only upon sale. * Fixed a case where an order item could appear as not fully delivered if a credit/return was made. * The **product stock adjustment field** now accepts more than three digits. ## 2025-04-09 ### Added * **Support for sending SMS** messages **to customers** directly from the Customer list page * **List** view of all **sent messages** accessible via "Reports" * Display **stock information for package products** in product search * The available quantity is determined by the component with the lowest stock level, as all components are required to fulfill the package, e.g. for a package with components A, B, and C with stock levels of 10, 5, and 2, the package will show 2 as available quantity * Its now possible to **print, download, or send order receipt after completing a pre-payment** * "**Reserve from purchase order**" column added **in keyboard mode** sale * Support for **Reitan Britannia gift card** * New action in **order handling list to preview an order** * Users can now **add or remove an order handling** on an open order * **EHF-invoice** checkbox added to **customer create/edit dialog** ### **Improved / changed** * **Improved warehouse selection** in the order delivery dialog during sale * **Week number** now shown in the time section on the app bar * **Print** button added **in the order preview** dialog * Tapping the time section in the app bar now **opens an on-screen calendar** * **External ID from a purchase order is now displayed** in both the list and open dialog - that is, if the purchase order has one (normally it has if the purchase orders are automatically created from another system like an ERP or OMS system) * Customer info dialog now allows **viewing, adding, and deleting customer groups** * **Menu layout updated in touch mode for reserving items** from a purchase order or selecting a warehouse for delivery/reservation * The current **RMA reason is now pre-filled** when changing the reason on an RMA order * Removed the (non-functional) delete button for order items in deliveries under Order Handling * The **purchase order dialog now closes automatically** when marked as "Sent to supplier" * Orders are now **automatically parked after completing a pre-payment** * When reserving an order item from a purchase order and no customer is added, the **user is now prompted to add a customer** * **Display quantity in stock** for each item based on the selected warehouse **when delivering out an order item** ### Fixed * Could not select a supplier when creating a purchase order from customer reservations if products had no assigned supplier – now all suppliers are selectable in such cases * Manual sending of invoices was always disabled when the tenant had the EHF extension, even if the store didn’t – this is now correctly handled * Opening the settled order dialog failed for orders from other stores if the user lacked access – now fixed * When adding a product to a purchase order, the purchase price input sometimes defaulted to zero despite a valid agreed purchase price being set – this is now resolved * Setting stock level of a product to zero (0) was not allowed – it now works as expected ## 2025-04-08 ### Added * Added a **warehouse filter to the stock list for stores**, making it easier to **view stock per location** * The Omnium extension now supports a “Customer Marked Groups” parameter, allowing automatic assignment of customers to specific groups during creation * **Added a `manufacturerSku` field to products** to store manufacturer-specific product identifiers * It’s now possible to **add images to service orders** – helpful for knowing what is the issue ### **Improved / changed** * All `createApi` methods in internal/services have been renamed to NewApiV2 * The API `PUT /tenants/{tenantUid}/stores/{storeUid}/purchase-orders/{purchaseOrderUid}` now supports items with received quantities * Omnium integration now sets the shipment on all order items * Deleting a delivery will also remove any connected freight line from the order * Omnium integration: added mapping for handling Click & Collect orders * Stock changes are now synced to Omnium when setting or moving stock via API * `ExternalId` is now included when searching for purchase orders using the query field * The AdjustStock interface now sends stock updates to Omnium, if the Omnium extension is active * Added support for handling special statuses for Omnium Click & Collect orders * The response from `GET /tenants/{tenantUid}/stores/{storeUid}/orders/{orderUid}/items/{orderItemUid}/addons` now includes new fields * Order search no longer includes cancelled (CANCELED) orders by default – less clutter, more clarity ### Fixed * Fixed product group accounting to correctly handle parent-child relationships and apply the right VAT codes * Corrected list stock with locations which had some faulty warehouse objects inside the response ### Removed * Removed V1 APIs ## 2025-04-04 ### Fixed * Direct SKU lookup in product search is working again – welcome back, old friend ## 2025-04-03 ### Fixed * Logo on ESCPOS printing is back ## 2025-04-01 ### Added * Verifone integration now supports additional display messages * **Store details** are now included **in Dintero** Session requests * Nets callback has improved Sentry logging with more detailed insights * New endpoint: `POST /tenants/{{tenantUid}}/devices/search` for device search * Implemented device search functionality for **easily finding devices and printers** in stores with hundres or even thousands of devices * New API endpoints for handling receipts: * `POST /tenants/{tenantUid}/stores/{storeUid}/receipts` * `DELETE /tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}` * `POST /tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements` * `GET /tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements` * `DELETE /tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements/{settlementUid}` * `GET /tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements/{settlementUid}` * **Freight** is now shown **on Purchase PDFs** * Purchase UID is included when sending notifications to recipients * `PURCHASE` is now listed under `allowedActions` on the order line * Implemented `omnium_delivery_service.ProcessGoodsReception` for updating Omnium deliveries after goods are received * **Campaign name** now appears o**n receipt item** lines * `UpdateCreateProduct` now supports `TextProperties`, `OptionProperties`, and `media` * `externalId` is now included in direct SKU lookup for product search * **Notification** search endpoint has a new query field, allowing **searches in both messages and recipients** ### **Improved / changed** * Dintero Session now sets the configuration channel to in\_store * The Get order by ordernumber endpoint has been updated to use `OrderUid` instead * Stores can now support multiple gift card brands * Sales order items with ReservationType: `REQUESTPURCHASEORDER` are no longer allowed if the product is blocked for purchase * warehouseUid is now removed when reservation type is `PURCHASEORDER` or `REQUESTPURCHASEORDER` ### Fixed * Verifone: corrected context used by `CreateOrderSettlementTransactionLog` during `startVerifoneProcessing` * Receipt generation (print, email, PDF) no longer requires a connected till * Prepayment lines are now correctly included on receipts * Order PDF now shows both prepayment and due amounts * Product search with stock info now displays available quantity for package products * Cover image is now shown for delivery order items * Settlements no longer fail if the warehouse is nil ### Removed * Deprecated V1 APIs have been removed, and dependencies are being phased out for: Brand, Category, Country, Customer, Device, Extensions, Flowbox, Flowcore, Handling, Http\_transport\_config, Imports\_convert, Import\_file, Import\_layout, Import\_template, Number\_serie, Orders, and Payment\_method [^1]: Card Verification Code, meaning a 3-digit code that is required to be entered alongside the actual gift card number. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.flowretail.com/docs/2025/april-2025.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.