Ghostkitchen setup

Ghostkitchen setup


What
This is a step-by-step guide to setting up a Ghostkitchen order forwarding.
Ghostkitchen is a food service establishment that specializes exclusively in preparing food for delivery and does not offer a dining room for customers. Some also have takeaway or a drive-in.

Where
Admin: Store > Stores > Access data delivery portal > Add delivery portal account > SD Ordertransmission.
Admin: Store > Stores > External order forwarding > Add order forwarding > Add forwarding to external POS system.


Setting up a Ghostkitchen feature for order forwarding

First, an "SD Ordertransmission" delivery portal account is created and then a forwarding to an external POS system is added.

The store, where the order is received first, is the Ghostkitchen source store. It then redirects directly to an existing target store.

1. Create "SD Ordertransmission" delivery portal account

1. Go to Admin: Store > Stores > Access data delivery portal.




2. Then click on "Add delivery portal account" and then select "SD Ordertransmission" from the drop-down menu.






3. Fill out the form and select the desired options.
It is recommended to add under "Description of the delivery portal account" a reference to the store(s), whose orders shall be received by this portal account.





4 After clicking on "Save", the data for the next steps will be displayed.

5. Note the "SD-ID" and the API key "SDPAK...".




2. Add forwarding to an external POS system

1. Now go back to the overview page of the stores (Admin: Store > Stores) and select the store from which the orders are to be forwarded (source store).

1.1. Then select "External order forwarding".




2. Click on "Add order forwarding" and select "Add forwarding to external POS system".




3. The following screen appears:




The following settings have to be made:

Options of the engine: For a simple forwarding (to the target store) with the complete data, set the switch for "Ghostkitchen" to "Yes". Alternatively, you can enter the word "ghostkitchen" (without quotation marks). It is sufficient to choose one of the two variants.

If the order is to be sent to an external kitchen (target store), but the payment is not to be processed there, set the switches for "Ghostkitchen" and "Fulfillment" to "Yes". A field with "Advance provision" appears next to "Fulfillment"; an amount for the fulfillment fee is entered manually here (e.g. €1.00). This will result in all prices from the forwarded order being zeroed out (i.e. a €0 order forwarding) and a new order item with the entered fulfillment fee of e.g. €1.00 is added, which is calculated and marked accordingly. Alternatively, the words "ghostkitchen, fulfillment_invoice" (without quotation marks) can be entered in the form shown here.

Store Identification: Add the 6-digit "SD-ID" that was previously received/noted when setting up the "SD Ordertransmission" (from step 5).

Endpoint (PUSH procedure): Enter the URL:"https://api.simplyapi.de/orderdata/order/deliverNewOrder" (without quotation marks, please note the exact spelling).

Authentication method (with PUSH method): Select "X-API-KEY".

Username / token (with PUSH procedure): Enter the "SDPAK..." key that was received/notated when setting up the "SD Ordertransmission" (from step 5).

Password / X-API-KEY (with PUSH method): Enter your "X-API-key" here. You will need to request the key from SIDES. Please contact our support to obtain your "X-API-key".


4. At the bottom, there are several options with which the forwarding behavior can be customized:
  1. If no options are selected (as seen in the screenshot), all orders will be forwarded.
  2. If you choose one option, you will need to choose all remaining applicable options as well!




5. If the selection is okay, click on "Save".

The Ghostkitchen order forwarding is now active.


Protocol review

If an error is suspected, the following logs can be checked:

Once under Admin: Orders > Order forwarding log.




And directly in the "SD Ordertransmission" delivery portal account entry under Admin: Store > Stores > Access data delivery portal > Show error messages.



Note:
Several settings that change the default behavior of the order processing may impact the automatic order forwarding, e.g. the option "Portal orders must be confirmed/processed upon receipt" (Admin: Store > Stores > Edit > Settings > Delivery and take away settings > Portal orders must be confirmed/processed upon receipt) affects the automatic order forwarding.



    • Related Articles

    • SendGrid setup with existing account

      What SendGrid is a cloud-based service for email marketing and transactional emails. This service can be used to send bulk emails for marketing campaigns, track email open rates and clicks, manage subscriber lists and ensure that emails are not ...
    • SOTA (number recognition) - setup of (ECSTA-)TAPI (Swisscom) (for Switzerland)

      The installation is only slightly different from the one in DE. Depending on the telecommunication system you have to install a TAPI driver (see for example with Ansitel-Cloud system). So it is with Swisscom - the IP/Cloud - telephony connection must ...
    • SIDES Pay Setup

      Create SIDES Pay Merchant Account / https://support.simplydelivery.de/portal/en/kb/articles/merchant-accounts-en Connect SIDES Pay Terminal in Admin + Configure SIDES Pay Terminal in Windows / ...
    • Wolt Drive DaaS setup

      What By connecting your stores to Wolt Drive, you gain access to a larger delivery network. Where Admin: Store > External Delivery (DaaS) > Add account. This guide describes the steps to set up Wolt Drive on the SIDES platform and some application ...
    • SendGrid setup with new account

      What SendGrid is a cloud-based service for email marketing and transactional emails. This service can be used to send bulk emails for marketing campaigns, track email open rates and clicks, manage subscriber lists and ensure that emails are not ...