Integrációs modul - szerviz - vásárlás on - t - for - hostcms v
Ez a modul az online áruház (a továbbiakban: áruház) integrációját valósítja meg a HostCMS v.6 alatt a "Vásárlás a Yandex.Market" (a továbbiakban: Piac) szolgáltatással.
A modul lehetővé teszi a Yandex.Market felhasználók számára, hogy megrendeléseket helyezzenek el az online áruházban közvetlenül a Market oldalairól, anélkül, hogy Ön webhelyére lépnének, a termékekre, amelyeket a piacon a szokásos árukivitelre használnak.
A modul béta tesztelési fázisban van, további bejelentést kap az értékesítésről a hivatalos HostCMS fórumon.
Ez a dokumentáció szerves részét képezi a modul elosztásának, és a disztribúciós csomag részeként, teljes körűen és teljeskörűen kell felosztani.
Az áruház feltételei és követelményei
A "Buy on Yandex.Market" szolgáltatáshoz való csatlakozáshoz a boltnak a következő követelményeknek kell megfelelnie: Yandex.Market
- Az áruház típusa - online áruház (A boltnak saját honlapján kell rendelkeznie az áru leírásával és a megrendelőlapmal);
- A boltot a Yandex.Markethez kell csatlakoztatni, és az árlistát YML formátumban kell elküldeni;
- Tárolási minősítés - 3 vagy több csillag;
- A tárolás időtartama a Yandex.Marketre a programhoz való csatlakozás előtt nem kevesebb, mint 90 nap;
- A Store és a Yandex közötti megállapodás megkötése a programban való részvételről.
Ezenkívül a HostCMS-t futtató raktárak számára fontos a következő speciális feltételek teljesítése:
- Az online áruház beállításai között szerepelnie kell az áruk fenntartásának;
- A termékkártyán feltüntetett raktárban lévő áruk mennyisége meg kell, hogy feleljen a megrendelésre rendelkezésre álló áruk tényleges mennyiségének. Ellenkező esetben a vevő nem lesz képes rendelni;
- A szállítmányozás tekintetében a piacon ajánlott szállítási módszereknél meg kell adni a szállítási költségeket minden régiónak, az Ön által kínált szállítást. Ellenkező esetben a vevő nem tud megrendelést elhelyezni. A szállítási költséget vagy egy szabálykészlet határozhatja meg, vagy dinamikusan kiszámítható a különféle kézbesítési szolgáltatások api szolgáltatásainak lekérdezésével.
A "Vásárlás a Yandex.Market" szolgáltatáshoz való kapcsolódási sorrendben
A tároló ezen modul használatával történő csatlakoztatásához a műveletek sorrendje a következő lehet:
Rendszerkövetelmények
- HostCMS site management rendszer v6.1.7 és újabb;
- A szerver kell telepíteni PHP értelmező verzió 5.2.2 vagy magasabb gyűjtött támogatást OpenSSL (db phpinfo () összhangban «regisztrált Áramlat Socket Közlekedés» legyen legalább az egyik érték ssl / SSLv2 / SSLv3);
- Hozzá kell férni a webkiszolgáló beállításaihoz, és képesnek kell lennie arra, hogy a https protokoll segítségével hozzáférjen a webhelyének oldalaihoz.
- modulok / core / http.php
- modulok / core / http / curl.php
- modulok / core / http / socket.php
- modules / core / request.php
Engedélyezési politika
A "Vásárlás a Yandex.Market" szolgáltatással való integráció modulja a webhelyek, webstúdiók, integrátorok és más harmadik felek (a továbbiakban: Vevők) ügyfeleinek történő kereskedelmi megvalósításra szolgál.
A modulok megvalósítását a modulfejlesztő, valamint a fejlesztő megfelelő megállapodással (a továbbiakban: Forgalmazók) végezheti el,
A modulkód egy meghatározott HostCMS példányhoz van kötve a kiszolgálón. A kötést a rendszer engedélyszámával végezzük. Ugyanakkor az engedélyezési irányelv nem tartalmaz korlátozásokat az ugyanazon rendszerpéldány alatt működő webhelyek és online áruházak számára vonatkozóan.
Ez azt jelenti, hogy a "Purchase on Yandex.Market" szolgáltatással rendelkező integrációs modul egy licenccel rendelkezik a HostCMS rendszer kiszolgálóra történő telepítésének egy számára, és a rendszer példájára korlátlan számú webhelyet és tárolót tartalmaz.
A modulelosztás és a licenckulcs a Vevő részére az engedély megfizetése után érhető el, a következő adatokat pedig a modul disztribútora biztosítja:
- A bejelentkezéshez, amelyhez a HostCMS licence kapcsolódik;
- Szerződés száma;
- Pin szám.
Ezen adatokra válaszul a Forgalmazó a Vevő számára egy archiválást biztosít a modul forráskódjával és a telepítésre vonatkozó utasításokkal. Licenckulcsokat generál és automatikusan integrálódik a rendszerbe, amikor a modul telepítve van.
Fontos Amikor a rendszer elvégzi a Modulhoz kapcsolódó bizonyos műveleteket, akkor időről időre automatikusan ellenőrzi a licenckulcs helyességét.
Fontos A Vevő webhelyén (weboldalain) lévő modul telepítésének munkája nem szerepel az engedélyben, de szükség esetén a forgalmazók külön fizetéssel is rendelhetők.
A modul telepítése
A modul telepítése nagyon egyszerű, két lépésből áll:

- át kell másolnia a rendszer gyökérmappájába, a kiszolgálón, az elosztásban lévő fájlokat és mappákat:
- a rendszer adminisztrációs központjában menjen a "Modulok" szakaszba, a legördülő menüből válassza ki a "Modul" - "Hozzáadás" elemet, töltse ki az űrlapot a következő adatokkal:
- Modulnév - vásárlás a Yandex.Market;
- Jelölőnégyzet "Aktív" - engedélyezve;
- Jelölje ki az "Index" -et;
- A modul elérési útja az üzletmarket;
- kattintson az "Apply" gombra.

A modul automatikusan elvégzi a szükséges változtatásokat az adatbázisban és csatlakoztatja a szükséges kampókat. Sőt, az összes üzletek a rendszer új fizetési rendszer „Vásárlási Yandex.market” (létre az állapota „Inaktív”, úgy, hogy elérhető a felhasználók nem) lesz hozzá, mint a rendszer új rendelés állapota, és az új CBS „Vásárlási a Yandex.Market "az" Internet-shop "csoportban.
A modul konfigurálása
A modulkonfiguráció több szakaszból áll:
1. A webszerver konfigurálása
A Yandex.Market csak biztonságos SSL-kapcsolattal működik együtt az áruházakkal, így a kiszolgálót oly módon kell konfigurálnia, hogy webhelyének oldalai megnyithatók legyenek mind a http protokollon, mind a https protokollon keresztül.
Ugyanakkor a piac nem ír elő követelményeket a tanúsítványra, hanem hivatalos, megvásárolható a tanúsító központban, vagy önálló aláírással. A tanúsítvány hitelességét a piac ellenőrzi az ujjlenyomat SHA1, amelyet a Market személyi fiókjában megadott beállítások tartalmaznak. A felhasználók számára a szokásos hozzáférést a webhelyhez http alapján érheti el.
Itt nem adok útmutatást az egyes webkiszolgálók SSL-kapcsolatait illetően (Nginx, Apache, stb.), Mert nagymértékben függnek a kiszolgáló és a hozzá telepített vezérlőpult konfigurációjától.
Az elem sikeres végrehajtásának egyik jele az, hogy webhelyének oldalai (például a főoldal) a https protokoll segítségével megnyitásra kerülnek a böngészőben. (Ha önaláírt tanúsítványt használt, akkor a böngésző figyelmeztető üzenetet küld előre, hogy a tanúsítvány nem megbízható - ez normális, és nem zavarja a modul működését)
2. A szerkezetrész létrehozása és konfigurálása

- A boltja webhelyén látogasson el a HostCMS adminisztrációs központjába, és menjen a "Webhelyszerkezet" szakaszba.
- A legördülő menüben válassza a "Szekció" - "Hozzáadás"
- A megnyíló formában adja meg a következő paramétereket:
- A menü szakaszának címe - Vásárlás a Yandex.Market oldalon
- Szülő szekció - hagyja üresen az értéket (...), vagy válassza ki a kívánt szülőpartíciót
- Menü - bármilyen érték
- A "Helyi menü megjelenítése" jelölőnégyzet - nincs engedélyezve
- Elrendezés - bármilyen érték
- Szakasz neve - például shopmarket
- Hozzáférési csoport - Mind
- A "Oldalaktivitás" jelölőnégyzet be van kapcsolva
- Tick "Index" - nincs engedélyezve
- Jelölje be a "Hozzáférés HTTPS-n keresztül" - Engedélyezve (Kötelező!)
- Partíció típusa - Tipikus dinamikus oldal
- Szekció - Internetes bolt
- Oldal - Vásárlás a Yandex.Market
- Tárolja az azonosítót - a szükséges tároló azonosítóját, például a Demo tárolót [1]
- Kattintson az Alkalmaz gombra.
A struktúra létrehozott partíciója a HTTP protokoll elérésekor automatikusan átvált a https protokollra, ez a helyes viselkedés.
Fontos Amikor megnyitja az interakciós oldalt a böngészőben lévő Market alkalmazással, a TDS beállításoktól függően egy üres oldalt vagy egy hibaüzenet jelenik meg, mint a>. Ez a viselkedés helyes.
3. A szolgáltatáshoz való csatlakozás beállításainak konfigurálása a Piac személyes fiókjában



5. Az integráció konfigurálása az áruházhoz

Ezzel befejeződik a modul konfigurációja.
A modul hibakeresése
A modul hibakeresése a Yandex.Market személyes szekrényében végzett hibakeresési eszközök segítségével történik.
A HostCMS Adminisztrációs Központban végrehajtott műveletek korlátozása a Yandex.Market által rendezett megrendelésekkel
Mint már említettük, a Store és a Market közötti kölcsönhatási jegyzőkönyv követelményeinek megfelelően a Yandex.Marketen keresztül leadott megrendelések számos korlátozásnak vannak kitéve a megrendelési listán és a megrendelőlapon végrehajtott műveletek tekintetében.

A modul fejlesztői
A Modulkód és a kísérő dokumentumok minden jogai kizárólag a Fejlesztőhöz tartoznak.
A technikai segítségnyújtás és a viták rendezése
A fejlesztő csak technikai támogatást nyújt a modul disztribútoraihoz, valamint azokhoz a vásárlókhoz, akik személyesen megvásárolták a modult. Azok a vásárlók, akik a modulot más forgalmazóktól vásárolták műszaki támogatás céljából, vegye fel a kapcsolatot a forgalmazóval, akitől megvásárolták a modult.
A fejlesztő csak abban az esetben vesz részt a vitában, ha a vásárló személyesen megvásárolta a modult. Azok a vásárlók, akik megvásárolták a modult más disztribútoroktól a viták rendezéséhez, forduljanak a Disztribútorhoz, ahonnan megvásárolták a modult.
A modul "Ahogyan van", a fejlesztő nem vállal felelősséget a vásárló által a modul megvásárlásához és / vagy használatához kapcsolódó károkért.
A technikai támogatás magában foglalja az azonosított és stabilan reprodukálható hibák kiküszöbölését a modul munkájában és a modul és a Yandex.Market kölcsönhatásában. Az ilyen hibák kiküszöbölése ingyenes, kivéve a következő eseteket:
- olyan hibák, amelyek az API-paraméterek Yandex.Market oldalon történő megváltoztatásából adódtak;
- a megbízásokkal és a Modullal dolgozó Tároló Rendszergazda helytelen tevékenységéből eredő hibák;
- olyan hibák, amelyek abból erednek, hogy a Vevő megsérti a Module fenti engedélyezési politikáját.
A fejlesztő megkéri a vevők és forgalmazók kérését, hogy bővítse a modul működését, de fenntartja a döntést a konkrét kérelmek végrehajtásának lehetőségéről és ütemezéséről. A modul funkcionalitásának bővítésére irányuló munkát csak felár ellenében végzik.
A fejlesztő díj ellenében a Vevő számára biztosítja a Modul felállításához szükséges szolgáltatásokat egy adott Üzlet számára, de fenntartja a döntést az ilyen szolgáltatás nyújtásának lehetőségéről és feltételeiről.
A fejlesztő köszönöm a vásárlást és a modul használatát!
Ui A fejlesztő háláját fejezi ki a KAD Systems csapata és személyesen Artem számára a modul fejlesztésében való részvételért.