---
title: "Kulcs-Szinkron"
description: "Ellenőrzött rendelések átadása a dokumentált Kulcs-Szinkron API2 letöltési és visszaigazolási protokollal."
url: "https://docs.poltura.com/hu/apps/kulcs-soft/"
lang: hu
alternates:
  en: "https://docs.poltura.com/en/apps/kulcs-soft/"
  hu: "https://docs.poltura.com/hu/apps/kulcs-soft/"
---

# Kulcs-Szinkron

Ellenőrzött rendelések átadása a dokumentált Kulcs-Szinkron API2 letöltési és visszaigazolási protokollal.

- Hol: Alkalmazásbolt → Kulcs-Szinkron
- Állapot: Béta

Ellenőrzött rendelések átadása a dokumentált Kulcs-Szinkron API2 letöltési és visszaigazolási protokollal.

Te készíted elő az átadandó rendeléseket. A Kulcs-Ügyvitel a rendelésszinkronkor letölti őket, és visszaigazolja mindegyiket, amelyet beolvasott. Egy rendelés csak a Kulcs visszaigazolása után kerül ki a várakozó sorból. Az alkalmazás nem állít ki számlát, és nem szinkronizál vevőket, termékeket vagy készletet.

## Mielőtt elkezdenéd

- Webáruház modul a Kulcs-Ügyvitel Premium vagy a Kulcs Számla és Készlet Premium programban. A modult a Kulcs-Soft szakembere telepíti, és ő adja meg a bolt szinkronizálási címeit is. A modul bekapcsolása után ments a Kulcs-adatbázisról.
- A Kulcsban legyenek meg a rendelésekben szereplő vevők, termékek, áfakulcsok, fizetési és szállítási módok. Az alkalmazás meglévő Kulcs-adatokra hivatkozik, újat nem hoz létre.
- A bolti termékek cikkszáma egyezzen a Kulcsban lévő termékkódokkal.

## A Kulcs-Szinkron beállítása

1. Nyisd meg az oldalsávon az **Alkalmazásbolt** oldalt, válaszd a **Kulcs-Szinkron** alkalmazást, és kattints a **Telepítés** gombra. Lásd: [Alkalmazásbolt](https://docs.poltura.com/hu/apps/#install).
2. A **Beállítások** részben töltsd ki a [Beállítások](https://docs.poltura.com/hu/apps/kulcs-soft/#settings) alatt leírt mezőket, és kattints a **Mentés** gombra. Ezután kattints a **Bekapcsolás** gombra.
3. Nyisd meg az oldalsáv **Alkalmazások** csoportjában a **Kulcs-Szinkron** oldalt. A **Szinkronizálási címek** résznél kattints a **Hozzáférési kulcs készítése** gombra. Két cím jelenik meg: **Rendelések letöltése** és **Rendelések visszaigazolása**.
4. Mindkét címet másold ki a mellette lévő **Másolás** gombbal. Az oldal a bolt webcíme nélkül mutatja őket, ezért mindegyik elé írd oda a bolt webcímét (például `https://webshopod.hu`).
5. Küldd el a két teljes címet a Kulcs-Soft szakemberének, aki beírja őket a Kulcs-Szinkronba: az elsőt a rendelések letöltéséhez, a másodikat a visszaigazoláshoz. Mindkét cím tartalmazza a hozzáférési kulcsot, ezért csak bizalmas csatornán küldd el őket, soha ne nyilvános hibajegyben vagy csevegésben.
6. A **Rendelés előkészítése** résznél a **Rendelés UUID** mezőbe írd be a rendelés azonosítóját (a rendelés oldalának címében a végén látod), és kattints a **Rendelés előkészítése** gombra. A rendelés **Visszaigazolásra vár** állapottal jelenik meg a listában.
7. Indítsd el a rendelésszinkront a Kulcs-Ügyvitelben. Miután a Kulcs beolvasta és visszaigazolta a rendelést, az állapota **Visszaigazolva** lesz.

## Beállítások

Minden párosítás egy JSON-objektum, amely egy bolti értékhez egy meglévő Kulcs-adat **nevét** vagy **kódját** rendeli.

- **Fizetési szolgáltató → Kulcs fizetési mód neve (JSON)**: a bolt minden fizetési szolgáltatójának azonosítója, mellette egy Kulcs fizetési mód neve.
- **Szállítási opció → Kulcs szállítási mód neve (JSON)**: minden szállítási opció azonosítója, mellette egy Kulcs szállítási mód neve.
- **Áfakulcs → Kulcs áfa neve (JSON)**: az `5`, a `18` és a `27`, mindegyik mellett egy Kulcs áfakulcs neve, például `{"27": "27%"}`.
- **Ügyfél UUID / vendég e-mail → meglévő Kulcs ügyfélkód (JSON)**: minden vevő azonosítója vagy a vendégvásárló e-mail-címe, mellette egy legfeljebb 20 karakteres, már létező Kulcs ügyfélkód.
- **Szállítási díj meglévő cikkszáma**: az a Kulcs szolgáltatás-termék, amelyen a szállítási díj szerepel.
- **Szállítási szolgáltatás állandó webes UUID-ja**: rögzített UUID, amely minden rendelésben ezt a szállítási szolgáltatást jelöli. Később ne változtasd meg.

Ha egy párosítás hiányzik, a rendelést nem lehet előkészíteni.

## A hozzáférési kulcs cseréje

Ha egy cím illetéktelen kézbe kerülhetett, kattints a **Hozzáférési kulcs cseréje** gombra. A régi címek azonnal megszűnnek. Másold ki az újakat, és küldd el őket ismét a Kulcs-Soft szakemberének: amíg nincsenek beírva, a Kulcs nem tud rendeléseket letölteni.

## Jó tudni

- Belföldi, forintos rendelések adhatók át, egy szállítási opcióval, egy fizetési szolgáltatóval, létező ügyfélkóddal és tételenként egy szokásos áfakulccsal (5, 18 vagy 27%).
- Az előkészített rendelés tartalma rögzül. Ha utána megváltozik (például törlik vagy módosítják), vagy megváltoznak a párosítások, **Visszatartva: a rendelés az előkészítés után módosult** állapotba kerül, és kimarad a letöltésből. Az **Újra előkészítés** gombbal a jelenlegi állapotát küldöd el, a **Visszavonás** gombbal kézi kezelésre veszed ki. Ha a Kulcs már beolvasta, ott egyeztesd.
- A Kulcs felismeri a már beolvasott rendelést, így egy elveszett visszaigazolás miatt sem lesz belőle második példány. A Kulcs importelőzményeit ne töröld.
- A jóváírások, a külföldi vagy különleges áfa, a termékcsomagok, a sorozatszámok, a csomagpontok és az előkészítés utáni módosítások kézi kezelést igényelnek.

## Ha valami nem működik

- **A Kulcs nem tud rendeléseket letölteni**: ellenőrizd, hogy az alkalmazás be van-e kapcsolva, és hogy a Kulcs a legfrissebb címeket használja-e, előttük a bolt webcímével. A **Hozzáférési kulcs cseréje** után a régi címek már nem működnek.
- **Egy rendelés Visszaigazolásra vár állapotban marad**: a Kulcs még nem igazolta vissza. Futtasd újra a rendelésszinkront, és nézd meg a Kulcs importnaplóját.
- **Nem sikerül előkészíteni a rendelést**: ellenőrizd az ügyfél-, áfa-, fizetési és szállítási párosítást, és hogy minden cikkszám létezik-e a Kulcsban.