Konektory ========= Konektory slouží k integraci aplikace s externími systémy třetích stran (například Shopify nebo Base). Umožňují obousměrnou synchronizaci dat – stahování objednávek a produktů z e-shopů a zároveň zpětné promítání informací o skladových zásobách a stavech operací do těchto systémů. Shopify ------- Pro propojení systému se Shopify je nutné vytvořit vlastní aplikaci přímo v administraci Shopify a udělit jí odpovídající oprávnění. Postup vytvoření aplikace ^^^^^^^^^^^^^^^^^^^^^^^^^ 1. Přihlaste se do administrace Shopify. 2. Přejděte do sekce Apps and sales channels. .. image:: /image/konektory/shopify_apps_chanels.png :align: center 3. Klikněte na Develop apps. 4. Zvolte možnost Create app. .. image:: /image/konektory/shopify_create_app.png :align: center 5. Vyplňte základní informace: - **App name:** Stockisimo - **App developer email:** e-mail přihlášeného uživatele (nebo jiný kontaktní e-mail dle interních pravidel) V dalším kroku je nutné aplikaci přiřadit požadovaná oprávnění (API scopes). Aplikace vyžaduje následující práva: - write_product_feeds, read_product_feeds - write_product_listings, read_product_listings - write_products, read_products - write_assigned_fulfillment_orders, read_assigned_fulfillment_orders - write_draft_orders, read_draft_orders - write_merchant_managed_fulfillment_orders, read_merchant_managed_fulfillment_orders - write_order_edits, read_order_edits - write_orders, read_orders - write_script_tags, read_script_tags - write_third_party_fulfillment_orders, read_third_party_fulfillment_orders - write_order_submission_rules, read_order_submission_rules - write_fulfillments, read_fulfillments - write_custom_fulfillment_services, read_custom_fulfillment_services - write_fulfillment_constraint_rules, read_fulfillment_constraint_rules - write_locations, read_locations - write_inventory, read_inventory - write_returns, read_returns - write_shipping, read_shipping - write_inventory_shipments, read_inventory_shipments Celkem se jedná o 38 oprávnění, která jsou nezbytná pro plnohodnotnou synchronizaci produktů, objednávek, skladových zásob a fulfillment procesů. .. image:: /image/konektory/shopify_rules.png :align: center --------- Po úspěšném vytvoření a autorizaci aplikace ve Shopify proběhne z naší strany inicializace aplikace. Součástí inicializace je: - vytvoření nové lokace ve Shopify určené pro Stockisimo, - příprava napojení na správu skladových zásob přes tuto lokaci. Jakmile je inicializace dokončena, je nutné provést ještě ruční krok na straně uživatele. --------- Přiřazení lokace Stockisimo k produktům ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Aby mohl systém správně pracovat se skladovými zásobami, je potřeba přidat lokaci **STOCKISIMO** ke všem produktům v Shopify a nastavit pro ni počáteční stav zásob. Doporučený postup (nejjednodušší varianta): 1. V administraci Shopify přejděte do sekce **Products**. 2. Přejděte do sekce **Inventory / Skladové zásoby**. .. image:: /image/konektory/shopify_inventory.png :align: center 3. Zvolte možnost hromadné úpravy (**Bulk edit**) a označte všechny produkty. .. image:: /image/konektory/shopify_bulk_edit.png :align: center 4. V tabulce najděte sloupec **Stockisimo** (odpovídající lokaci Stockisimo). .. image:: /image/konektory/shopify_bulk_edit_2.png :align: center 5. U všech produktů zaškrtněte **Stock at this location / Naskladnit v této lokalitě** (stačí zaškrtnout u prvního a poté roztáhnout na ostatní). .. image:: /image/konektory/shopify_stock_at_location.png :align: center Pokud sloupec **Stockisimo** v hromadné úpravě nevidíte: - klikněte na tlačítko **Columns / Sloupce**, - v seznamu zaškrtněte sloupec **Stockisimo**, - následně se sloupec **Stockisimo** zobrazí. .. image:: /image/konektory/shopify_add_column.png :align: center --------- Shoptet ------- Napojení na Shoptet probíhá pomocí XML exportů, které Shoptet generuje formou permanentních URL. Tyto odkazy se následně vloží do nastavení konektorů v systému a slouží ke stahování dat. Integrace je read-only z pohledu Shoptetu – systém si data pravidelně stahuje, nikoliv zapisuje zpět přes API. --------- Export produktů ^^^^^^^^^^^^^^^ Pro synchronizaci produktů je nutné vytvořit XML export produktů. 1. V administraci Shoptetu přejděte do sekce Produkty → Export. 2. V záložce Typ exportu zvolte: - systémový: Kompletní export – XML 3. U formátu vyberte XML. 4. Volitelně doporučujeme zapnout: - Exportovat popisy bez HTML znaků (zjednodušuje další zpracování dat). .. image:: /image/konektory/shoptet_export_produktu.png :align: center 5. Po uložení přejděte do záložky Export. 6. Ve spodní části stránky se zobrazí sekce Permanentní odkaz zvoleného exportu. .. image:: /image/konektory/shoptet_odkaz_exportu_produkty.png :align: center 7. Zkopírujte celý vygenerovaný URL odkaz (včetně parametrů patternId, partnerId a hash). Tento odkaz představuje zdroj dat pro produkty a bude použit v nastavení konektoru. --------- Export objednávek ^^^^^^^^^^^^^^^^^ Pro synchronizaci objednávek je nutné vytvořit XML export objednávek. 1. V administraci Shoptetu přejděte do sekce **Objednávky → Export**. 2. V záložce **Typ exportu** zvolte: - **systémový: Shoptet – XML** .. image:: /image/konektory/shoptet_export_objednavek.png :align: center 3. V sekci **Zahrnout objednávky** doporučujeme nastavit: - **Jen nové nebo změněné** Toto nastavení je důležité, protože: - výrazně snižuje objem dat, - zabraňuje opakovanému zpracování historických objednávek. 4. Ostatní volby (omezení záznamů, začátek synchronizace) ponechte výchozí, pokud nemáte specifický důvod je měnit. .. image:: /image/konektory/shoptet_odkaz_exportu_operace.png :align: center 5. Po uložení přejděte do záložky **Export**. 6. Ve spodní části stránky se zobrazí **Permanentní odkaz zvoleného exportu**. 7. Zkopírujte celý URL odkaz. Tento odkaz slouží jako zdroj dat pro objednávky. --------- Nastavení konektoru v systému ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Jakmile máte připravené oba odkazy (produkty i objednávky), je potřeba je vložit do nastavení konektoru. 1. V administraci systému přejděte do Nastavení konektorů u daného klienta. 2. Vytvořte nový konektor nebo upravte existující. 3. Vyplňte: - Product URL – odkaz na XML export produktů ze Shoptetu, - Order URL – odkaz na XML export objednávek ze Shoptetu, - Konektor – zvolte Shoptet XML. 4. Nastavení uložte. .. image:: /image/konektory/shoptet_stockisimo_sett.png :align: center Od této chvíle je konektor připraven a systém začne: - pravidelně stahovat produkty, - synchronizovat nové a změněné objednávky, - pracovat s daty dle interní logiky skladu a operací.