Jak připojit KeyCRM k OpenCart

KeyCRM můžete připojit k OpenCart dvěma zásadně odlišnými způsoby. Prvním je běžné připojení pro přenos nových zakázek do CRM. Druhým je pokročilá obousměrná integrace, kdy si obchod a KeyCRM také vyměňují produkty, kategorie, ceny, zůstatky, zákazníky a stavy. Správné nastavení začíná nikoli tlačítkem „Nastavit“, ale přehledným seznamem dat a směrů výměny.

Nejprve definujte rozsah integrace

Oficiální keyCRM konektor pro OpenCart určené především pro příjem objednávek z webu. To stačí, pokud manažeři potřebují vidět kupujícího, objednat sklad, platbu a dodání v CRM a katalog a sklad jsou dále udržovány v OpenCart.

Pokud se má KeyCRM stát hlavním účetním systémem, je zapotřebí širší scénář: obousměrné stavy, produkty a možnosti, ceny, zůstatky, kategorie, zákazníci, anti-duplikace, CRON a zpracování odchozích webhooků. Právě tento scénář se uzavírá pokročilý modul integrace KeyCRM s OpenCart podle Build Zone.

Co si připravit na připojení

• Vytvářím záložní kopii souborů a databáze OpenCart.
• Zkušební kopie obchodu nebo dohodnuté krátké okno pro ověření.
• Aktivní účet KeyCRM a administrátorský přístup do sekce nastavení.
• KeyCRM API klíč; nelze jej odeslat ve veřejném chatu ani uložit do veřejného úložiště.
• Seznam odpovídajících stavů, způsobů platby a doručení.
• Jedinečné SKU pro každý produkt a každou možnost, pokud se plánuje katalog nebo burza.
• SSL certifikát a přístup k CRON na hostingu.

Připojení KeyCRM k OpenCart krok za krokem

1. Vytvořte zdroj v KeyCRM

V nastavení KeyCRM otevřete sekci zdrojů, přidejte OpenCart a zadejte název obchodu, jeho HTTPS adresu, měnu a odpovědného manažera. Samostatný zdroj pro každý obchod zjednodušuje analýzu a zabraňuje záměně stejných čísel objednávek.

2. Vytvořte klíč API

Pro autorizované požadavky mezi systémy je vyžadován API klíč. Přenáší se jako token nosiče a měl by být uložen pouze v nastavení zabezpečeného modulu. Po otočení klíče je nutné jej vyměnit v OpenCart, jinak API odpoví chybou autorizace. Způsob vytvoření klíče a skutečné limity jsou popsány v znalostní báze keyCRM.

3. Nainstalujte modul do OpenCart

Pro archiv formátu OpenCart 3 .ocmod.zip se stahuje přes "Rozšíření → Instalovat rozšíření". Po instalaci aktualizujte modifikátory, udělte práva skupině administrátorů a aktivujte modul. Pokud je úložiště silně změněno, otestujte proces nejprve na zkušební kopii.

4. Určete přístupy a směry výměny

Zapojte svůj zdroj a klíč API a poté povolte pouze operace, které chcete. Objednávky lze například odesílat z OpenCart do KeyCRM okamžitě, zůstatky lze přijímat z CRM podle plánu a úplný import zboží lze spustit ručně. Toto oddělení snižuje riziko náhodného přepsání správných dat.

5. Nakonfigurujte CRON a webhook

CRON je vhodný pro pravidelný import a export velkých souborů: produktů, kategorií, zákazníků a zůstatků. Odchozí webhooky KeyCRM jsou vyžadovány pro rychlou reakci na změny objednávky, stavu nebo inventáře. Webhook upozorní na událost a v případě potřeby modul načte přes API podrobná data.

6. Spusťte test, nikoli úplnou synchronizaci

Vytvořte jeden testovací produkt, zákazníka a objednávku. Zkontrolujte pole v obou systémech a poté změňte stav a zůstatek. Teprve po úspěšném dokončení scénáře spusťte hromadnou výměnu.

Mapování stavů, plateb, dodávek a SKU

Názvy entit a ID napříč systémy se automaticky neshodují. Stav "Zpracování" v OpenCart může odpovídat fázi "Nový" v KeyCRM; "Bankovní karta" — konkrétní způsob platby; jednu dodávku do několika služeb nebo tarifů. Mapování zachycuje tyto korespondence a činí výměnu předvídatelnou.

U zboží bývá hlavní klíč SKU. Každá možnost – například konkrétní velikost nebo barva – musí mít své vlastní jedinečné číslo výrobku. Pokud mají dvě varianty stejné SKU nebo je číslo artiklu prázdné, systém nebude schopen jednoznačně určit, který zůstatek aktualizovat.

Jak zkontrolovat, zda integrace funguje

1. Zadejte zkušební objednávku jako běžný zákazník.
2. Zkontrolujte jméno, telefon, e-mail, produkty, možnosti, částky, dopravu a platbu v KeyCRM.
3. Zkuste událost znovu a ujistěte se, že není vytvořen žádný duplikát.
4. Změňte stav v každém systému a zkontrolujte zadané pokyny.
5. Aktualizujte cenu a zůstatek testovacího SKU.
6. Dočasně deaktivujte CRON nebo zadejte neplatný klíč v testovacím prostředí, abyste viděli čistý záznam protokolu.
7. Po opětovném získání přístupu zopakujte neúspěšnou operaci a zkontrolujte obnovení ústředny.

Typické integrační chyby

Oficiální nebo rozšířený modul

Pro snadný přenos nových zakázek začněte se standardním konektorem KeyCRM. Pokud potřebujete pracovat s katalogem, obousměrnými stavy, zákazníky, cenami, zůstatky, opcemi, kategoriemi, CRON a webhook událostmi, využijte pokročilé řešení. Podrobný rozbor je v materiálu "Oficiální modul KeyCRM nebo pokročilá integrace".