Skip to content
Help Center
Magyar

Kulcs-Szinkron

Queue validated orders for the documented Kulcs-Szinkron API2 download and confirmation protocol.

Where
  1. App Store
  2. Kulcs-Szinkron
Status
Beta
On this page

Queue validated orders for the documented Kulcs-Szinkron API2 download and confirmation protocol.

You prepare the orders you want to hand over. Kulcs-Ügyvitel downloads them during its order synchronization and confirms each one it imported. An order leaves the queue only once Kulcs confirms it. The app does not issue invoices and does not sync customers, products or stock.

Before you start

  • The Webshop module in Kulcs-Ügyvitel Premium or Kulcs Számla és Készlet Premium. A Kulcs-Soft specialist installs it and enters the store's synchronization addresses. Back up the Kulcs database after the module is turned on.
  • In Kulcs, the customers, products, VAT rates, payment methods and transport methods your orders use. The app refers to existing Kulcs records and creates none.
  • Product SKUs in the store that match the product codes in Kulcs.

Set up Kulcs-Szinkron

  1. Open App Store in the sidebar, choose Kulcs-Szinkron and select Install. See App Store.

  2. Under Settings, fill in the fields described in Settings and select Save. Then select Turn on.

  3. Open Kulcs-Szinkron in the Apps group of the sidebar. Under Synchronization addresses, select Generate access key. Two addresses appear: Order download and Order confirmation.

  4. Select Copy next to each address. The page shows them without your store's web address: put your store's web address (for example https://yourshop.hu) in front of each one.

  5. Send both complete addresses to the Kulcs-Soft specialist, who enters them in Kulcs-Szinkron: the first for downloading orders, the second for confirming them. Each address contains the access key, so send them only over a private channel, never in a public ticket or chat.

  6. Under Prepare order, enter an order's ID in Order UUID (the ID at the end of the order page's address) and select Prepare order. It appears in the list as Awaiting confirmation.

  7. Run order synchronization in Kulcs-Ügyvitel. After Kulcs imports the order and confirms it, its status turns to Confirmed.

Settings

Each mapping is a JSON object that pairs a store value with the name or code of an existing Kulcs record.

  • Payment provider → Kulcs payment method name (JSON): each payment provider ID of the store, with the name of a Kulcs payment method.
  • Shipping option → Kulcs transport name (JSON): each shipping option ID, with the name of a Kulcs transport method.
  • VAT percentage → Kulcs VAT name (JSON): 5, 18 and 27, each with the name of a Kulcs VAT rate, for example {"27": "27%"}.
  • Customer UUID / guest email → existing Kulcs customer code (JSON): each customer's ID, or a guest's email address, with an existing Kulcs customer code of at most 20 characters.
  • Existing Kulcs shipping service SKU: the Kulcs service product that carries the shipping fee.
  • Stable shipping service webshop UUID: a fixed UUID that stands for that shipping service in every order. Do not change it later.

A missing pairing stops the order from being prepared.

Change the access key

If an address may have reached someone else, select Replace access key. The old addresses stop working at once. Copy the new ones and send them to the Kulcs-Soft specialist again: until they are entered, Kulcs cannot download orders.

Good to know

  • Domestic orders in HUF with one shipping option, one payment provider, an existing customer code and one standard VAT rate (5, 18 or 27%) on each line.
  • A prepared order is frozen. If it changes afterwards (for example it is canceled or edited) or your pairings change, it is Held back: the order changed after preparation and stays out of the download. Select Prepare again to send its current state, or Withdraw to handle it by hand. If Kulcs already imported it, reconcile it in Kulcs.
  • Kulcs recognizes an order it already imported, so a confirmation that got lost does not create a second copy. Do not reset Kulcs's import history.
  • Store credit, foreign or special VAT, bundles, serial numbers, pickup points and changes after preparation need manual handling.

If something goes wrong

  • Kulcs cannot download orders: check that the app is turned on and that Kulcs uses the latest addresses, with your store's web address in front. After Replace access key the old addresses no longer work.
  • An order stays Awaiting confirmation: Kulcs has not confirmed it yet. Run order synchronization again and check Kulcs's import log.
  • Preparing an order fails: check the customer, VAT, payment and transport pairings and that every SKU exists in Kulcs.