Jak synchronizovat zůstatky KeyCRM s OpenCart

Synchronizace zůstatku mezi KeyCRM a OpenCart je vyžadována, když se stejná položka prodává prostřednictvím webu, tržišť nebo manažerů. Jeho účelem není jen zkopírovat číslo, ale správně spárovat produkt a variantu, zohlednit rezervu, vybrat sklad a nepřepsat novější hodnotu starými údaji.

Proč převod příkazů není totéž jako synchronizace zůstatků

Nativní integrace keyCRM s OpenCart převádí objednávku, ale zpětná aktualizace zůstatků na webu vyžaduje implementaci API. To je přímo uvedeno ve skutečnosti oficiální pokyny keyCRM pro váhy.

Rozbaleno Modul KeyCRM pro OpenCart automatizuje tuto výměnu: aktualizuje inventář a ceny, podporuje varianty a možnosti, import/export produktů, události CRON a webhook. Ale i u hotového modulu je třeba nejprve definovat účetní pravidla.

Vyberte si zdroj pravdy

Před zahájením se rozhodněte, kde má manažer právo změnit zůstatek:

• KeyCRM → OpenCart. CRM spravuje zásoby, zásoby a prodej ze všech kanálů; stránka zobrazuje pouze dostupné množství.
• OpenCart → KeyCRM. Obchod je hlavním katalogem a předává aktuální zůstatek do CRM.
• Dvoustranná výměna. Vyžaduje se verzování záznamů, jasné události a pravidlo řešení konfliktů. Pouhé „poslední příspěvek vyhrává“ často nestačí.

SKU položky a možnosti – klíč mapování

KeyCRM a OpenCart mají svá vlastní interní ID, takže je nelze přímo porovnávat. SKU je stabilní obchodní klíč. Mělo by to být:

• u každého produktu není prázdná;
• unikátní v rámci celého katalogu;
• samostatně pro každou možnost — velikost, barvu nebo konfiguraci;
• totéž v KeyCRM a OpenCart;
• nezměněné po navázání nebo synchronní změně spojení v obou systémech.

Ve standardní konfiguraci OpenCart může být pole SKU pouze v nadřazeném produktu. Synchronizace možností často vyžaduje další pole článku na úrovni hodnoty možnosti. Bez něj CRM nerozezná např. tričko M od trička L.

Množství, rezerva a několik skladů

Fyzické množství a rezerva jsou k dispozici v KeyCRM. Vitrína obvykle vyžaduje dostupné množství spíše než celou fyzickou rovnováhu. Vzorec závisí na obchodním procesu, ale nejčastěji to je:

Pokud existuje více skladů, zaznamenejte, který z nich obsluhuje stránku: jeden konkrétní, součet vybraných nebo jednotlivé zůstatky podle umístění. Neshrnujte šrot, přepravu nebo offline inventář bez výslovného obchodního rozhodnutí.

API, CRON a webhook: co je za co zodpovědné

Robustní schéma kombinuje webhook pro rychlost a CRON pro sladění. Pokud k jedné události nedojde, naplánovaný proces nesrovnalost opraví.

Limity API, pauza a fronta

pro aktuální nápovědu keyCRM, jeden klíč API má limit až 20 požadavků za minutu; doporučená pauza je asi tři sekundy. Nadměrné výnosy 429. Katalog s tisíci položkami tedy nelze synchronizovat v paralelní smyčce bez omezení rychlosti.

Správný postup:

1. přijímá stránku dat nebo malý paket;
2. zařazuje úkoly do řízené fronty;
3. zpracovává je s danou pauzou;
4. s 429 čeká a opakuje operaci;
5. zaznamená poslední úspěšnou pozici, aby se zabránilo zahájení importu od nuly.

Bezpečné spuštění synchronizace

1. Zálohujte a deaktivujte hromadné ruční úpravy pro první odsouhlasení.
2. Exportujte tabulku SKU z obou systémů a najděte prázdné a duplicitní SKU.
3. Vyberte 5–10 produktů: žádné opce, opce, nulový zůstatek a rezerva.
4. Spusťte výměnu pouze pro testovací sadu.
5. Porovnejte množství v KeyCRM, OpenCart a ve výloze.
6. Simulujte prodej na webu a změnu v CRM.
7. Zkontrolujte opakování události, 429, dočasná nedostupnost API a log.
8. Teprve poté spusťte celý adresář v dávkách.

Typické příčiny nesprávného vyvážení

• stejné SKU v několika produktech nebo možnostech;
• článek obsahuje neviditelný prostor nebo jiné pouzdro;
• fyzikální veličina je použita bez odečtení rezervy;
• je zvolena špatná slabika nebo jsou sečteny nadbytečné slabiky;
• současně běží dvě úlohy CRON;
• stará dávková aktualizace přepíše novější událost;
• API odpovídá 429, ale integrace neopakuje dotaz;
• cache OpenCart zobrazuje starou hodnotu po aktualizaci databáze.