A Syncee API segítségével egyedi fejlesztésű weboldallal, saját alkalmazással vagy a meglévő integrációinkon kívüli e-kereskedelmi platformmal is használhatod a Syncee-t.
Fejlesztőd így összekapcsolhatja a webáruházadat a Syncee-vel, lekérheti a termékadatokat, továbbíthatja a vásárlói rendeléseket, valamint értesítéseket fogadhat a termékek, a fizetések és a szállítás változásairól.
Az API-hozzáférés jelenleg kizárólag kérésre érhető el. A használatához aktív Syncee-előfizetés szükséges, és csapatunknak előzetesen engedélyeznie kell a funkciót a fiókodban.
Mire használhatom a Syncee API-t?
Egyedi integrációval az alábbiakat teheted:
Termékadatok lekérése: Elérheted a Syncee-katalógusaidhoz hozzáadott termékek nevét, leírását, képeit, változatait, árait, készletadatait és egyéb részleteit.
Katalógusok kezelése: Katalógusokat hozhatsz létre, és termékeket adhatsz hozzájuk vagy távolíthatsz el belőlük API-n keresztül.
Vásárlói rendelések továbbítása: Beküldheted a weboldaladon vagy alkalmazásodban leadott rendeléseket a Syncee-be.
Rendelések követése: Lekérheted a fizetési állapotot, a teljesítés részleteit és a csomagkövetési adatokat.
Frissítések fogadása: Webhookokkal értesülhet a rendszered arról, ha egy termék megváltozik vagy eltávolításra kerül, egy rendelést kifizetnek, vagy egy küldeményt feladnak.
Fejlesztődnek kell megvalósítania, hogy a weboldalad vagy alkalmazásod hogyan használja fel ezeket az adatokat, és hogyan dolgozza fel a frissítéseket.
Mire van szükségem az induláshoz?
Az alábbiak szükségesek:
Aktív Syncee-előfizetés, amely tartalmazza az API-hozzáférést.
A Syncee csapata által engedélyezett API-hozzáférés.
Fejlesztő vagy az integráció elkészítéséhez szükséges technikai tudás.
Az előfizetésed termék- és API-használati korlátai az egyedi integrációdra is érvényesek.
Hogyan kérhetek hozzáférést?
Írj a support@syncee.co címre, és jelezd, hogy szeretnéd használni a Syncee API-t.
Kérjük, add meg:
A webáruházad webcímét.
Az általad használt platformot vagy technológiát.
A Syncee-fiókodhoz tartozó e-mail-címet.
Csapatunk áttekinti a kérésedet, és segít a hozzáférés engedélyezésében.
Az előfizetés önmagában nem aktiválja automatikusan a hozzáférést. Kérjük, az integráció megkezdése előtt vedd fel velünk a kapcsolatot.
Hogyan történik a beállítás?
Miután csapatunk engedélyezte a hozzáférést:
Hozz létre egy API-tokent. A Syncee-fiókodban nyisd meg a Custom store (API) áruházhoz tartozó Settings > Developer menüpontot, és generálj egy tokent. Azonnal másold ki, mert csak egyszer jelenik meg.
Csatlakoztasd a rendszeredet. Fejlesztőd a tokennel hitelesítheti a kéréseket, és ellenőrizheti a kapcsolatot.
Válaszd ki és rendszerezd a termékeket. Keresd meg a Syncee-ben az értékesíteni kívánt termékeket, és gyűjtsd össze őket az Import Listben, vagy kezeld a katalógusokat és add hozzá a Syncee-termékazonosítókat API-n keresztül.
Készítsd el a termékintegrációt. Kérd le a termékadatokat, és valósítsd meg a termékek megjelenítését és frissítését a webáruházadban.
Állítsd be a rendeléseket és az értesítéseket. Továbbítsd a vásárlói rendeléseket a Syncee-be, és állíts be webhookokat a termék- és rendelésfrissítések fogadásához.
Egyes beszállítók jóváhagyáshoz kötik a termékeik elérését. A beszállítói hozzáférési kérelmeket és a privát katalógusok aktiválását a syncee.com felületén kell intézni.
Hogyan történik a rendelések fizetése és teljesítése?
Az API-val továbbíthatod a rendeléseket és ellenőrizheted az állapotukat. A fizetések kezelése a Syncee-fiókodban történik.
A rendeléseket manuálisan is kifizetheted a syncee.com felületén, vagy bekapcsolhatod az automatikus fizetést, így nem kell minden rendelést külön, manuálisan kifizetned.
A beállítás lépéseit ebben az útmutatóban találod: https://help.syncee.com/hu/articles/18331173-az-automatikus-rendelesfizetes-beallitasa-a-syncee-com-on
A fizetés visszaigazolása után a rendelés továbbításra kerül a beszállítónak teljesítésre. Az integrációd ezt követően API-n keresztül lekérheti a teljesítési és csomagkövetési adatokat.
Hol találja meg a fejlesztőm a dokumentációt?
A dokumentációban megtalálhatók a beállítási útmutatók, a hitelesítés, az elérhető végpontok, a webhookok, a használati korlátok és a hibaelhárítás részletei:
Az API-tokenedet kezeld bizalmasan, és kizárólag a szervereden használd. Soha ne szerepeljen nyilvánosan hozzáférhető weboldalkódban vagy mobilalkalmazásban.
Ha kérdésed van a hozzáféréssel vagy az indulással kapcsolatban, írj a support@syncee.co címre.
