KORONA Cloud POS integration

  • Updated

The KORONA Cloud POS integration connects FareHarbor and KORONA in real time, allowing FareHarbor to remain the source of truth for bookings while KORONA manages cash payments and receipt generation. This integration is designed for operators who need a compliant workflow for walk-in cash sales while keeping booking management and revenue reporting centralized in FareHarbor.

Enabling the KORONA Cloud POS integration

To enable FareHarbor’s KORONA integration, first ensure that you have Administrator permissions in your FareHarbor Dashboard.

You must also have an active KORONA Cloud POS account.

To enable the FareHarbor KORONA integration:

  1. Go to Settings.
  2. Click the cog icon in the top right corner of your screen to access your Advanced company settings.
  3. Select Integrations from the Advanced company settings menu.
  4. Check the KORONA box.
  5. Click Save changes.

Setting up the KORONA integration

After enabling the KORONA integration, navigate to the KORONA integration settings by clicking Settings in your FareHarbor Dashboard and selecting Integrations from the navigation on the left. Click the KORONA tab in the Integration settings.

In the KORONA integration settings, navigate to the KORONA Credentials section and enter the following KORONA API credentials:

  • Endpoint URL
  • Account ID
  • Login
  • Password

You can find these credentials in the APIv3 section in your KORONA dashboard under Settings > Data Exchange. After adding the required credentials, click Save Credentials. 

Note: Invalid credentials, unmapped items, and currency mistmatches will produce a warning message at the top of the KORONA integration settings page.

FareHarbor validates the connection immediately when the credentials are saved.

KORONA payment type

Select a payment type from the dropdown. The selected POS payment type determines which FareHarbor bookings should be sent to KORONA.

KORONA Checkout setup

In the Checkout setup section, select the corresponding KORONA value for your:

  • Organisational Unit: the store/location
  • Point of Sale: the specific POS terminal where walk-in orders should appear, filtered by the selected Organizational Unit
  • Cashier: the operator to associate with integration-created orders. Create a new dedicated cashier for the integration in KORONA Studio.

Mapping items

Map each FareHarbor customer type and each custom field to a KORONA product. Dropdowns are populated from your live KORONA product catalogue. 
 

Note: Unmapped required items are flagged with a warning at the top of the KORONA integration settings page.

Syncing data

Once items are mapped, each Customer Order sent to KORONA includes:

  • A unique reference number tied to the FareHarbor booking (FareHarbor booking ID, for example: FH-Booking-1083050). Use the booking ID reference number to search for customer orders on your POS terminal.
  • Customer name from booking contact info.
  • One line item per customer type (for example:  Adult, Child) with accurate pricing.
  • Separate line items for any monetisable options (for example: equipment hire, lunch).
  • Discounts surfaced per line item so the POS shows original price and discount amount.
  • Correct tax sector (from the mapped KORONA product).

Each customer order can be modified in the KORONA dashboard as needed.