gardenlawn/wfirma

There is no license information available for the latest version (dev-master) of this package.

Integration with wFirma.pl

dev-master 2026-01-28 15:48 UTC

Requires

• php: >=8.3.0
• ext-curl: *
• ext-json: *
• magento/product-community-edition: ^2.4.8

Unknown License

• Rafał Piechota

README

Moduł integrujący sklep Magento 2 z systemem wFirma.pl. Głównym celem modułu jest automatyczna synchronizacja stanów magazynowych z wFirma do Magento przy użyciu Multi Source Inventory (MSI).

Funkcjonalności

• Synchronizacja stanów magazynowych: Pobieranie stanów z wFirma i aktualizacja w Magento (MSI) dla źródła gardenlawn_source.
• Testowanie połączenia: Formularz w panelu admina do testowania zapytań API.
• Logowanie: Szczegółowe logi operacji i błędów.

Wymagania

• PHP >= 8.3
• Magento 2.4.8+
• Atrybut produktu external_sku w Magento (służy do mapowania ID produktu z wFirma).
• Źródło magazynowe (Inventory Source) o kodzie gardenlawn_source.

Instalacja

1. Skopiuj pliki modułu do katalogu app/code/GardenLawn/WFirma.
2. Uruchom polecenia:

   bin/magento module:enable GardenLawn_WFirma
   bin/magento setup:upgrade
   bin/magento setup:di:compile

Konfiguracja

1. Zaloguj się do panelu administracyjnego Magento.
2. Przejdź do Stores > Configuration > GardenLawn > wFirma Integration.
3. W sekcji API Configuration wprowadź dane dostępowe (API Key):
   • Enabled: Tak
   • Access Key: Twój klucz dostępu
   • Secret Key: Twój sekretny klucz
   • App Key: Twój klucz aplikacji
   • Company ID: (Opcjonalnie) ID firmy
4. Zapisz konfigurację.

Użycie

Synchronizacja Stanów Magazynowych

Synchronizacja działa w oparciu o mapowanie: wFirma ID produktu -> Magento external_sku

Jeśli produkt w Magento posiada atrybut external_sku zgodny z ID produktu w wFirma, jego stan magazynowy zostanie zaktualizowany w źródle gardenlawn_source. Produkty nieistniejące w Magento są pomijane.

Automatycznie (Cron): Synchronizacja uruchamia się automatycznie co 30 minut (zadanie gardenlawn_wfirma_stock_sync).

Ręcznie (CLI): Możesz wymusić synchronizację poleceniem:

bin/magento gardenlawn:wfirma:sync

Testowanie API

Moduł udostępnia narzędzie do testowania połączenia w panelu admina:

1. Przejdź do System > Tools > wFirma API Test.
2. Wybierz metodę (np. getWarehouseStocks).
3. Kliknij Execute.
4. Wynik zapytania (JSON) pojawi się na ekranie.

Logi

Wszelkie informacje o błędach oraz przebiegu synchronizacji są zapisywane w pliku: var/log/wfirma.log