Ugrás a tartalomra
Súgó
English

Kulcs-Szinkron

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

Hol
  1. Alkalmazásbolt
  2. Kulcs-Szinkron
Állapot
Béta
Ezen az oldalon

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.

  2. A Beállítások részben töltsd ki a Beállítások 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.