Wprowadzenie
SISL Optima Connector to dwuczęściowy plugin który łączy sklep Magento 2.4.x z systemem Comarch ERP Optima działającym na Twoim serwerze Windows.
Co dostajesz
Sisl_Optima— moduł Magento (PHP 8.2/8.3) z panelem administracyjnym, cron-em, observerem zamówieńSisl.Sync.Service— mikrousługa .NET 8 instalowana jako Windows Service na serwerze z Optimą; odczyt z SQL Server Optimy, REST API z podpisem HMAC
Co robi
| Kierunek | Co synchronizuje | Częstotliwość (domyślna) |
|---|---|---|
| Optima → Magento | produkty (kod, nazwa, EAN, JM, cena) | co 1h (cron, dropdown w admin) |
| Optima → Magento | stany magazynowe (z dokumentów PZ/PW/MM) | co 15 min |
| Magento → Optima | zamówienia (FA) — TBD v0.4.0, w v0.3.x payload jest zrzucany do xml-out/ ale faktura w Optimie NIE powstaje |
— |
| license.sisl.pl → Magento | weryfikacja licencji | codziennie o 03:00 |
Komu się przyda
Sklepom Magento używającym Optimy do księgowości i magazynu, którzy mają dosyć drogich SaaS-owych integracji (5–15 tys. zł/rok). Self-hosted, abonament 300 zł netto / msc, kod działa wewnątrz Twojej sieci, można zrezygnować w każdej chwili.
Czego nie zrobi (v0.3)
- Realtime push z Optimy do Magento — sync jest pull-based przez cron (zmiany ceny w Optimie widać dopiero po następnym tick'u)
- Usuwania produktów oznaczonych jako "skasowane" w Optimie — pozostają w Magento jako orphans
- Pełnego dwukierunkowego sync klientów Magento → Optima (v0.3 robi tylko Optima → Magento — adres-book z Magento do Optimy nie idzie)
Funkcje dodane w v0.3 (opt-in, default OFF, opis w Konfiguracja → 5. v0.3):
- Multi-store mapping — per-website różne cenniki Optimy + SKU prefix
- Order updates / full lifecycle — automatyczne FA/PAR/WZ z Optimy → Invoice/Shipment w Magento
- Bidirectional customer sync — Optima
KntKarty→ Magentocustomer_entity
Wymagania techniczne
- Magento 2.4.7 lub nowszy, PHP 8.2 lub 8.3
- Comarch ERP Optima 2024.1+ z dostępem do bazy SQL Server (
Trusted_Connectionz konta lokalnego) - Windows Server 2019+ dla mikrousługi (.NET 8 runtime samodzielnie dostarczony w binarce)
- Łączność sieciowa między sklepem a serwerem Optimy: LAN, IPSec/OpenVPN, lub Tailscale (zalecane)
- Wychodzący HTTPS do
license.sisl.plz serwera Optimy (sprawdzanie licencji)
Następny krok: Architektura →