Profesjonalny system B2B dla Magento 2 Open Source
Current version of the module v0.1.3
Kowal B2B Suite został zaprojektowany jako profesjonalna warstwa B2B dla Magento 2 Open Source. Jego zadaniem jest nie tylko dodanie kilku ekranów dla firm, ale stworzenie kompletnego środowiska sprzedaży hurtowej i kontraktowej, które może działać samodzielnie albo jako część większego ekosystemu handlowego.
Pakiet opiera się na podstawowej zasadzie: Magento pozostaje źródłem produktów, kategorii, stanów magazynowych, koszyka, zamówień i store view, a Kowal B2B Suite dodaje brakującą logikę biznesową B2B. Dzięki temu wdrożenie wykorzystuje sprawdzone mechanizmy Magento, a jednocześnie zyskuje funkcje typowe dla portali B2B: zarządzanie kontrahentami, użytkownikami firmowymi, indywidualnymi cenami, widocznością katalogu, limitami kupieckimi, dokumentami handlowymi, zapytaniami ofertowymi i integracjami.
Architektura pakietu jest modułowa. Każdy obszar B2B ma własną odpowiedzialność, własne kontrakty i własne punkty rozszerzeń. Pozwala to wdrażać system etapami, rozwijać go o kolejne funkcje i bezpiecznie integrować z ERP, PIM, WMS, CRM albo systemami księgowymi.
Kowal B2B Suite jest projektowany dla firm, które potrzebują kontroli nad procesem sprzedaży B2B, ale nie chcą utrzymywać osobnego systemu oderwanego od Magento. Jeden katalog, jedna platforma, wiele kanałów sprzedaży.
Najważniejsza wartość biznesowa
Jedna instalacja Magento dla B2C i B2B
Sprzedaż B2B działa w kontekście wybranego website_id. Oznacza to, że funkcje B2B można aktywować dla konkretnego website, bez wpływu na pozostałe kanały B2C. To właściwy model dla firm, które chcą utrzymać jeden system e-commerce, jeden katalog produktów i jedną infrastrukturę techniczną.
Pełny model kontrahenta
Pakiet dodaje domenę firm: kontrahentów, relacje firma–website, użytkowników firmowych, role, uprawnienia, adresy, kontakty i audyt zmian. Firma ma dostęp tylko do przypisanego kanału B2B, co porządkuje bezpieczeństwo danych i upraszcza wdrożenia wielokanałowe.
Ceny i katalog dopasowane do firmy
B2B rzadko działa na jednej publicznej cenie. Kowal B2B Suite wspiera cenniki, ceny kontraktowe, progi ilościowe, indeks cen i reguły widoczności katalogu. Klient widzi produkty i ceny zgodne z jego relacją handlową.
Szybszy proces zakupowy
Kupujący B2B nie zawsze przegląda sklep jak klient detaliczny. Często zna SKU, zamawia cyklicznie i oczekuje szybkiego działania. Pakiet dodaje szybkie zamówienia, listy zakupowe i walidację pozycji po SKU.
Kontrola finansowa
Limity kupieckie, terminy płatności, rezerwacja wykorzystania limitu i status kredytowy firmy pomagają kontrolować ryzyko sprzedaży z odroczoną płatnością. Moduł jest przygotowany jako fundament pod walidację checkoutu i integrację z finansami.
Zapytania ofertowe i negocjacje
RFQ pozwala obsłużyć zapytania ofertowe, pozycje oferty, komentarze, statusy, ceny oferowane, termin ważności i historię zmian. To istotne w sprzedaży kontraktowej, gdzie finalna cena lub warunki wymagają akceptacji handlowca.
Workflow akceptacji
Reguły approval umożliwiają blokowanie zamówień wymagających akceptacji, np. po przekroczeniu określonego progu kwotowego. System zapisuje requesty, approverów i decyzje, tworząc podstawę pod audyt procesu zakupowego.
Dokumenty handlowe w portalu klienta
Kontrahent może otrzymać dostęp do dokumentów handlowych powiązanych z firmą i website: faktur, korekt, dokumentów WZ i potwierdzeń zamówień. Dostęp jest kontrolowany przez kontekst B2B.
Integracje jako element architektury, nie dodatek
Pakiet zawiera warstwę integracyjną z profilami, mapowaniem identyfikatorów zewnętrznych, kolejkami, idempotencją, retry, logami i błędami synchronizacji. Konkretne adaptery ERP/PIM/WMS/CRM mogą być dodawane jako osobne rozszerzenia.
REST API i GraphQL
Kowal B2B Suite dostarcza warstwę REST API dla administracji, integracji i procesów systemowych oraz GraphQL jako fasadę dla frontendu i przyszłych kanałów API. Logika domenowa pozostaje w serwisach B2B, a API nie duplikuje zasad biznesowych.
Dla kogo
Kowal B2B Suite jest przeznaczony dla:
- dystrybutorów i hurtowni,
- producentów sprzedających przez sieć kontrahentów,
- firm z indywidualnymi cennikami i warunkami handlowymi,
- organizacji wymagających limitów kupieckich i odroczonych płatności,
- firm potrzebujących portalu zamówień dla klientów B2B,
- wdrożeń Magento Open Source, które nie chcą przechodzić na cięższe rozwiązania wyłącznie z powodu funkcji B2B,
- integratorów Magento budujących powtarzalne wdrożenia B2B.
Co wyróżnia Kowal B2B Suite
- Działa per
website_id, więc nie miesza kanałów B2C i B2B. - Wykorzystuje Magento Open Source jako fundament, zamiast tworzyć osobny system obok sklepu.
- Zachowuje natywny katalog, koszyk, zamówienia, MSI i klasyczny frontend Magento.
- Dzieli logikę na moduły o jasnej odpowiedzialności.
- Udostępnia kontrakty API przygotowane pod rozszerzenia.
- Ma osobne warstwy REST API i GraphQL.
- Jest przygotowany pod integracje ERP, PIM, WMS, CRM i systemy finansowe.
- Nie wymusza forka Magento core.
- Umożliwia budowę rozwiązania B2B etapami.
Moduły pakietu
Kowal_B2BBase
Fundament całego pakietu. Definiuje, czy B2B jest aktywne dla danego website, rozwiązuje kontekst website_id, dostarcza bazowe kontrakty, wyjątki, konfigurację, ACL i logger.
Kowal_B2BCompany
Model firm B2B: kontrahenci, relacje z website, użytkownicy firmowi, role, uprawnienia, adresy, kontakty i audyt. Moduł pilnuje, aby firma działała wyłącznie w przypisanym kanale B2B.
Kowal_B2BAdminUi
Panel administracyjny B2B w Magento Admin. Dostarcza menu, dashboard, grid firm i formularze operujące na serwisach domenowych.
Kowal_B2BApi
REST API dla procesów B2B. Udostępnia endpointy dla firm, produktów, cen, widoczności katalogu, importu/eksportu, szybkich zamówień, dokumentów, limitów, approval, zamówień, RFQ i integracji.
Kowal_B2BPricing
Moduł cen B2B. Obsługuje cenniki, ceny kontraktowe, progi ilościowe, indeks cen i resolver ceny dla konkretnej firmy, website, SKU, waluty i ilości.
Kowal_B2BCatalogPermissions
Widoczność katalogu B2B. Pozwala ograniczać produkty i kategorie per firma oraz website, buduje indeks widoczności i filtruje frontendowe kolekcje produktów.
Kowal_B2BImportExport
Import i eksport danych B2B. Zapewnia profile, zadania, logi wierszy, tryb dry-run oraz fundament pod kolejne adaptery danych.
Kowal_B2BQuickOrder
Szybkie zamawianie po SKU i listy zakupowe. Moduł waliduje widoczność, dostępność i cenę B2B, a następnie zapisuje listy zakupowe dla firm.
Kowal_B2BDocument
Dostęp do dokumentów handlowych: faktur, korekt, WZ i potwierdzeń zamówień. Dokumenty są przypisane do firmy i website, z kontrolą dostępu oraz logiem synchronizacji.
Kowal_B2BCreditLimit
Limity kupieckie, warunki płatności, rezerwacje ekspozycji kredytowej i status kredytowy firmy. Moduł tworzy podstawę pod bezpieczne zamówienia z odroczoną płatnością.
Kowal_B2BApproval
Workflow akceptacji zamówień. Reguły mogą działać per firma, website, waluta i próg kwotowy. System zapisuje approverów, requesty i decyzje.
Kowal_B2BCheckout
Integracja checkoutu Magento z regułami B2B. Waliduje firmę, uprawnienia, widoczność produktów, ceny B2B, limit kupiecki i approval, bez wpływu na website B2C.
Kowal_B2BQuote
RFQ i oferty handlowe. Obsługuje zapytania ofertowe, pozycje, komentarze, statusy, ceny negocjowane, ważność oferty i historię zmian.
Kowal_B2BIntegration
Infrastruktura integracyjna dla ERP, PIM, WMS, CRM i systemów księgowych. Dostarcza profile, mapowania zewnętrznych ID, kolejki, retry, idempotencję, logi i błędy synchronizacji.
Kowal_B2BGraphQl
Warstwa GraphQL dla frontendu i kanałów API. Udostępnia odczyty i mutacje B2B jako fasadę nad istniejącymi serwisami domenowymi.
Kowal B2B Theme
Klasyczny frontend Magento oparty o Magento/blank, przygotowany pod widoki B2B: dashboard firmy, szybkie zamówienia, listy zakupowe, dokumenty i elementy UX portalu kontrahenta.
Architektura wdrożeniowa
Kowal B2B Suite jest rozwijany jako jeden pakiet Composer składający się z modułów Magento 2 i theme. Root metapackage może wymagać wszystkich gotowych komponentów, a logika pozostaje rozbita na niezależne moduły o jasnych granicach.
W praktyce oznacza to:
- prostsze zarządzanie zależnościami,
- możliwość rozwijania pakietu jako kompletnej suite,
- czytelny podział odpowiedzialności,
- łatwiejszą diagnostykę błędów,
- bezpieczniejsze integracje,
- przygotowanie pod kolejne moduły PRO.
Zasada website scope
Najważniejszą decyzją architektoniczną pakietu jest działanie B2B per website_id.
Jeżeli B2B jest aktywne dla danego website, wszystkie jego store view działają jako B2B. Firmy, ceny, widoczność katalogu, limity, dokumenty, RFQ, approval i integracje są walidowane w tym kontekście.
Jeżeli website nie ma aktywnego B2B, moduły nie powinny zmieniać zachowania klasycznego sklepu B2C.
Integracje
Pakiet nie zakłada jednego konkretnego ERP. Zamiast tego dostarcza warstwę integracyjną, która pozwala tworzyć adaptery do różnych systemów:
- ERP,
- PIM,
- WMS,
- CRM,
- księgowość,
- systemy EDI,
- middleware i szyny integracyjne.
Mechanizmy idempotencji, mapowania identyfikatorów, kolejek, retry i logów są projektowane jako wspólny fundament dla integracji.
API-first
Kowal B2B Suite jest projektowany w podejściu API-first. Funkcje biznesowe są dostępne przez kontrakty PHP, REST API oraz GraphQL.
Dzięki temu pakiet może obsłużyć:
- klasyczny frontend Magento,
- panel klienta B2B,
- aplikacje mobilne,
- integracje middleware,
- automatyzację sprzedaży,
- importy i eksporty danych,
- headless storefront w przyszłości.
Bezpieczeństwo i kontrola dostępu
Pakiet opiera się na jawnej walidacji:
- aktywności B2B dla website,
- relacji firmy z website,
- statusu firmy,
- przypisania użytkownika do firmy,
- uprawnień firmowych,
- widoczności katalogu,
- dostępu do dokumentów,
- limitów kupieckich,
- statusów procesów workflow.
To ogranicza ryzyko przypadkowego dostępu do danych innej firmy albo innego kanału sprzedaży.
Write Your Own Review


















