Převod objednávek z OpenCart do KeyCRM je základní integrační scénář, ale právě tam se nejčastěji ztrácejí možnosti produktu, způsob platby, oddělení dopravy nebo historie stavu. Oficiální manuál keyCRM popisuje základní spojení, ale v praxi by spolehlivá burza neměla pouze vytvořit kartu v CRM, ale uchovat dostatek dat pro zpracování objednávky a bezpečně přežít opakující se událost.
Jak vypadá tok objednávek?
- Kupující potvrdí objednávku v OpenCart.
- Modul obdrží událost po vlastním vytvoření záznamu v databázi.
- Data jsou normalizována: kontakty, pozice, možnosti, částky, dodávka, platba a zdroj.
- Modul zkontroluje, zda je tato objednávka již propojena s KeyCRM.
- Karta objednávky je vytvořena nebo aktualizována v CRM prostřednictvím API.
- Vztah mezi OpenCart ID, zdrojem a KeyCRM UUID/ID je uložen lokálně.
- Následné změny stavu jsou zpracovávány podle nakonfigurovaného směru.
Nejlepší je zahájit výměnu ihned po vytvoření objednávky, ale neblokovat úspěšnou stránku pokladny dlouhým požadavkem API. Pokud je CRM dočasně nedostupné, operace musí zůstat v protokolu nebo ve frontě pro opětovné spuštění.
Jaká data přenést z OpenCart do KeyCRM
| Skupina | Minimální sada | Na co si dát pozor |
|---|---|---|
| Identifikace | ID objednávky, zdroj, datum | ID musí být jedinečné v rámci konkrétního obchodu. |
| Klient | Jméno, telefon, email | Normalizujte telefon na jeden formát, nevytvářejte duplicitní klienty. |
| Zboží | SKU, název, množství, cena | Možnosti převodu samostatně; částka musí odpovídat skutečné měně objednávky. |
| Doručení | Metoda, náklady, adresa/oddělení | Vlastní pole OpenCart vyžadují explicitní mapování. |
| Platba | Metoda a aktuální stav | Název metody a potvrzení platby jsou odlišné údaje. |
| Marketing | UTM, referrer, propagační kód | Výchozí konektor nemusí předat vlastní marketingová pole. |
Základní pravidlo: cokoli, co manažer používá k potvrzení, vychystávání, expedici nebo analýze, by mělo být předáno do standardního pole KeyCRM nebo mít zdokumentované vlastní pole.
Mapování stavu OpenCart a KeyCRM
V OpenCart je stav součástí historie objednávek a v KeyCRM může odpovídat fázi trychtýře. Je nebezpečné automaticky přirovnávat jména: „Zpracování“ v jednom obchodě může znamenat novou objednávku a v jiném - balíček, který již byl shromážděn.
Než začnete, vytvořte si tabulku s pokyny:
| událost | OpenCart | KeyCRM | směr |
|---|---|---|---|
| Nová objednávka | Pending | Nové | OpenCart → KeyCRM |
| Potvrzeno manažerem | Processing | Potvrzeno | KeyCRM → OpenCart |
| Doručeno | Shipped | odesláno | KeyCRM → OpenCart |
| Zrušeno | Canceled | Zrušeno | Je zvolen jeden hlavní směr |
U každé dvojice určete, kdo je zdrojem pravdy. Pokud povolíte současné vzájemné aktualizace bez pravidel, mohou oba systémy donekonečna vracet stavy zpět nebo vracet starou hodnotu.
Jak integrace chrání před duplikáty
Opakovaný webhook, obnovení stránky, časový limit odezvy nebo ruční spouštění by nemělo vytvořit druhou objednávku. K tomu musí být operace idempotentní: modul vyhledá již uložené připojení podle ID úložiště a UUID/zdrojového ID a místo opětovného vytvoření provede aktualizaci.
Pokročilý modul Build Zone ukládá odkazy na objednávky, najde je podle UUID, nevytváří duplikáty a uchovává historii změn stavu. V administračním panelu jsou k dispozici nástroje pro kontrolu a čištění servisních připojení – používají se při diagnostice, nikoli jako běžná „optimalizace“.
Události, webhook, CRON a manuální spoušť
Nové objednávky OpenCart by měly být odeslány okamžitě. Změny z KeyCRM mohou přijít prostřednictvím odchozích webhooků: změna stavu, aktualizace objednávky nebo jiná podporovaná událost. Hromadná revalidace a údržba je pohodlnější přes CRON.
- Akce OpenCart - rychle odešle novou objednávku.
- Webhook KeyCRM — obchod informuje o změnách ze strany CRM.
- CRON — provádí plánované operace a resynchronizaci.
- Ruční start — požadované pro kontrolní zkoušku a údržbu.
Ovládací skript před spuštěním
- Jedna objednávka s jednoduchým produktem.
- Jedna objednávka s povinnou opcí a slevou.
- Doručení s adresou nebo pobočkou a nenulovými náklady.
- Online platba a zpětná platba jako různé scénáře.
- Opětovné odeslání stejné události bez duplikátu.
- Změna stavu v povoleném směru.
- Dočasná chyba API a opětovné zpracování po obnovení.
Na co si dát pozor, když se objednávka nepřenese
Začněte protokolem modulu: čas požadavku, koncový bod, kód HTTP a text chyby. 401 obvykle znamená problém s klíčem API; 422 — nesprávné nebo neúplné pole; 429 — přebytek limit keyCRM API; 5xx — dočasná chyba služby nebo serveru. Výrobní deník by neměl zbytečně zobrazovat celý token nositele nebo osobní údaje kupujícího.
Dále zkontrolujte, zda se spustila událost OpenCart, zda je aktivní správný zdroj KeyCRM, zda odpovídá mapování způsobu dopravy a zda nedochází ke konfliktu s modifikátorem pokladny. Počáteční nastavení krok za krokem je popsáno v návodu "Jak připojit KeyCRM k OpenCart".
Potřebujete stabilní převod zakázek?
Modul Build Zone podporuje automatický přenos a import objednávek, obousměrné stavy, zdroje KeyCRM, UUID, historii a ochranu proti duplicitám.