Connect KORONA.studio
Use this to connect your ToucanTix account to a KORONA.studio account so that products, prices, and point-of-sale master data stay in sync. Set this up before selling anything that should appear on a KORONA POS.
Before you start
Confirm:
- you have the KORONA.studio API credentials: username, password, account ID, and service URL
- you have back-office access to Admin > Integrations
- the KORONA.studio account is the one that should own this ToucanTix account's master data
Steps
- In the back office, open Admin > Integrations.
- In the KORONA.studio integration section, select Enable KORONA.studio integration.
- Select Edit credentials to unlock the credential fields.
- Enter Username, Password, Account ID, and URL.
- Select Save and synchronize. A confirmation appears when the synchronization succeeds, and the section header shows Last successful synchronization with a timestamp. Until the first import completes it shows Not synchronized.
- After the first successful synchronization, select a Default cashier and an Economic zone, then select Update to save.
What synchronizes in each direction
From KORONA.studio into ToucanTix:
- products and their prices
- payment methods, currencies, and sales taxes
- points of sale, cashiers, organizational units, and sectors
- tags, ticket definitions, customer groups, and economic zones
- voucher configurations and vouchers, when the voucher package is active in the KORONA account
- receipts, imported on a recurring schedule
From ToucanTix to KORONA.studio:
- invoices and fiscal delivery notes
- customer records attached to orders
- tags created in ToucanTix
Each import runs as a whole: if part of it fails, no partial data is applied. After the first synchronization, imports repeat approximately every 15 minutes and exports run continuously, so changes should appear within minutes without pressing Synchronize.
External system calls
Once the integration is enabled, the External system calls section shows a Login, a Password, and Display URLs for Orders, Offers, and Agenda. Use these values in the KORONA POS configuration so POS terminals can open the matching ToucanTix screens directly.
Expected result
The KORONA.studio integration section shows Last successful synchronization with a recent timestamp, imported products and points of sale appear in ToucanTix, and new invoices are exported to KORONA.studio.
Troubleshooting
| Problem | What to check |
|---|---|
| Synchronization fails immediately | Username, Password, Account ID, and URL are correct, and the KORONA.studio credentials were not changed recently. |
| Section shows Not synchronized | Whether Enable KORONA.studio integration is selected and the first Save and synchronize completed without an error message. |
| Products or prices are outdated | When Last successful synchronization last updated; correct the data in KORONA.studio, then wait for the next import or select Synchronize. |
| A record exists in KORONA.studio but not in ToucanTix | Whether the last import succeeded; a failed import applies no partial data. |