Basics

Fresh KDS is an app that helps you to manage orders for kitchen.

Orders created on your POS will be sent to Fresh KDS. It will display information and details about an order in real time, therefore changes made on POS will be available to see in Fresh KDS. Orders cannot be edited from Fresh KDS, there you can only update order status when its ready.

Integration

Fresh KDS Token

To connect Fresh KDS to your inventory you will need an Integration Token

Follow this link https://sandbox-app.freshtechnology.com/ and enter your Fresh KDS credintials

Open Settings - Integration Tokens

image-20250213-085127.png

You will need the combination from the “Value” field. See the screenshot as an example (your tocken will have different name and value)

image-20250213-085232.png

Fresh KDS Location

At the time of writing this instruction it is possible to use one tocken for several inventories, but location has to be unique for each inventory. To create location:

  1. Open Fresh KDS webpage

  2. Open Settings

  3. Select locations (the list of existin locations will open)

image-20250407-052227.png

  1. Press “+ Create Location”

image-20250407-052358.png

  1. Select “Dejavoo” for Company field and then procced to fill all the requiered fields (marked with *)

image-20250407-053154.png

  1. After location is created go to Billing and Subscriptions

image-20250407-053430.png

  1. Find your location and press “Add subscription”

image-20250407-053534.png

  1. Scroll to the last page and Find and select Dejavoo

image-20250407-053730.png

  1. Select “Unlimiterd” tier and press “Add Subscription”

image-20250407-053910.png

  1. Select Primiry billing account and PRess “Subscribe”

image-20250407-054014.png

  1. Go to Webhooks

    image-20260724-111455.png

  2. Find Order Bumped and Order created and press Edit

image-20260724-111543.png

  1. Under the Locations select your newly created location and press Update

image-20260724-111642.png

Now you are able to select this location when setting up Fresh KDS for your inventory (location will not be on the list without subscription)

image-20250407-054317.png

Inventory Integrations page

  1. Go to Dejavoo web portal https://test.dvmms.com/denovo/account/login

  2. Enter your Dejavoo credentials

  3. When authorized find the inventory you want to integrate Fresh KDS into (use search by name if you have several inventories/locations) and enter it

  4. From the inventory page go to More - Integrations

image-20250522-052515.png

  1. Find Fresh KDS section, enter your from Fresh KDS web portal and press “Check”

image-20250606-060629.png

  1. When token is checked new “Locations” field and Save button will appear

  2. Select location (these locations were created on Fresh KDS web portal) and Save

image-20250606-060713.png

Please note that one Fresh KDS location can only be used with one single inventory. If you have more inventories you will need more locations on Fresh KDS

  1. Download Fresh KDS app on your device if not yet

  2. Open Fresh KDS

  3. Authorize in Fresh KDS using your credentials and start working with it

Mapping for Order Types

After setting up the integration the next step is to set Order Types mapping

image-20260421-023252.png

Denovo works with 3 order types from FreshKDS:

  • Pickup

  • Delivery

  • Dinein

If order type from Denovo Table is mapped to order type from FreshKDS ForHere - all created orders with order type Table will appear in FreshKDS as For here.

Inventory Peripheral page

  1. You can open Peripheral page with two ways:

1.1 More → Peripheral

1.2 More → Integration → Go to fresh KDS devices

image-20250606-062921.png

  1. You can find all created devices On fresh KDS

image-20250606-063043.png

  1. You can delete device from inventory. Press “X” near device you want to delete

  2. You can request devices from fresh KDS by pressing on “Request from Fresh KDS”: that devices that have KDS, but Inventory doesn’t, will be pulled from KDS side. When you create device in KDS it should be automatically added to this list

  3. You can assign/create new tags to device. Press Edit icon to do this. Read about tags in this section https://dejavoosystems.atlassian.net/wiki/spaces/DOC/pages/4682518178/Fresh+KDS#Tags

Workflow

On the screenshot down below you can see the main screen of Fresh KDS when there are no orders saved for kitchen. To display orders on this screen, you should assign tags and create order on DPP

image-20250130-114201.png

Tags

To work with tags you should select right position for “Use item tags to match device with tags” toggle

image-20260420-101954.png

if “Use item tags to match device with tags” = OFF:

the full order (all items) is sent to every available Fresh KDS device for that inventory

if “Use item tags to match device with tags” = ON:

To display items on Fresh KDS, you should have same tags on item/ category and KDS device (peripheral)

  1. You can create/delete new tag here:

2.1 Peripheral page

image-20260420-101849.png

2.2 Items edit page

image-20260420-101756.png

2.3 Category edit page

image-20260420-101651.png

  1. Tags should:
    3.1 be unique
    3.2 be case insensitive
    3.3 be saved only for one inventory
    3.4 have same tags on items, categories, devices screens

Order types

There are several order types in fresh KDS, but there are only 3 orders types that are compatible with DejaPay Pro for now:

  1. Hold (DPP) = For Here (Fresh KDS)

  2. Take Away/Take Out (DPP) = To Go (Fresh KDS)

  3. Order type usinf Take Away (DPP) + Postpone = Pick up (Fresh KDS)

Saving orders with any other order type, that doesn’t use the Take Away setting (i.e. Tables), will be processed by Fresh KDS as “For Here” order

Note that changing order type in Fresh KDS will not change it on your POS

Create order

An order will be sent to Fresh KDS after it is saved on you POS. Example of an order

image-20250130-120758.png

Order details that are sent to Fresh KDS include:

  • Order number

  • Operators name (the one who created the order)

  • Order type

  • Creation time

  • Timer (to track time since order was created)

  • Names of the items in the order

  • Modifiers

  • Item comment

  • Order comment

image-20250130-121258.png

Notiffications

When order is received by Fresh KDS you will get a notification on POS

image-20250130-121649.png

Statuses

The order will also acquire an extended status “in work”

image-20250130-121924.pngimage-20250522-053830.png

When order is finished press the order header in Fresh KDS.

image-20250130-122433.png

The order will disappear from the main screen. You will receive a notification on your POS. On POS order status will change to “Ready”

image-20250130-122718.pngimage-20250522-054005.png

If the order was paid before it was finished, you would need to manually change its status to “finished” in order details, for it to be removed from the list of orders

image-20250130-122900.png

If an order was finished before it was paid it will acquire status “unpaid” an “ready”

image-20250203-074815.pngimage-20250522-054227.png

Such an order will be removed from the list of orders automatically after payment

Update / cancel order

If order is cancelled/removed on POS it will change its status on “cancelled” in Fresh KDS

image-20250203-075143.png

Press the header of the cancelled order to remove it from the list

If any changes were made in the order it will get the “edited” icon next to the order number

image-20250203-075521.png

If modifiers were added to or removed from an item, the item would also have the “edited” icon next to its name. New modifier will appear under the item, and deleted modifiers will be completely removed from the order on the screen

image-20250203-080314.png

If a new item was added to the order before the order was finished in Fresh KDS, if would appear in this order with the “+” icon next to its name

image-20250203-080439.png

If an item was removed from the order, it will become red and crossed out in Fresh KDS

image-20250203-080716.png

If a new item was added to the order after it was finished in Fresh KDS, the order will appear on the screen with the same order number, but it will only include the new item in it

(order Sup-22 as an example in previous screenshot)

image-20250203-081007.png

Please note that if you add/remove modifiers from an item that is Finished it will not appear in fresh KDS