INTEGRACJE
Co działa dziś, co dalej.
Publiczny scorecard. Uczciwie o lukach — albo na roadmapie, albo świadomie poza zakresem. Tabela jest żywym dokumentem, nie zamkniętą roadmapą.
| Integracja | Status | Kategoria | Możliwości |
|---|---|---|---|
| Anthropic / OpenAI | ✅ Działa | AI | Router sugestii treści dla opisów ofert. Provider przełączany przez admina. Per-provider encrypted key storage. Anthropic prompt-caching podłączony. |
| Allegro | ✅ Działa | Marketplace | Pełna gama ofertowa: lister, reader, creator, status reader, field updater. OAuth, cursor-based event journal. Dane GPSR, wyszukiwanie kategorii po EAN, polityki sprzedawcy, załączniki bezpieczeństwa. |
| PrestaShop | ✅ Działa | Sklep | Katalog, magazyn, pełny cykl zamówień. Ships moduł PrestaShop (OL Dynamic Carrier) dla round-tripu wysyłki marketplace. |
| Subiekt nexo | 🚧 W toku | Fakturowanie | Fakturowanie przez bridge Sfera. Pierwszy adapter InvoicingPort. |
| InPost | 🚧 W toku | Wysyłka | Integracja ShipX: paczkomat + kurier + etykiety + webhooki. Ustanawia ShippingProviderPort. |
| Fakturownia | 📋 Planowane | Fakturowanie | Adapter fakturowania. |
| iFirma | 📋 Planowane | Fakturowanie | Adapter fakturowania. |
| inFakt | 📋 Planowane | Fakturowanie | Adapter fakturowania. |
| wFirma | 📋 Planowane | Fakturowanie | Adapter fakturowania. |
| Amazon | 📋 Planowane | Marketplace | Adapter marketplace przez SP-API. |
| Bol.com | 📋 Planowane | Marketplace | Adapter marketplace. |
| eBay | 📋 Planowane | Marketplace | Adapter marketplace przez eBay Sell API. |
| Empik Marketplace | 📋 Planowane | Marketplace | Adapter marketplace. |
| OLX | 📋 Planowane | Marketplace | Adapter marketplace. |
| DHL | 📋 Planowane | Wysyłka | Adapter wysyłki (czeka na ShippingProviderPort). |
| DPD | 📋 Planowane | Wysyłka | Adapter wysyłki (czeka na ShippingProviderPort). |
| FedEx | 📋 Planowane | Wysyłka | Adapter wysyłki (czeka na ShippingProviderPort). |
| GLS | 📋 Planowane | Wysyłka | Adapter wysyłki. |
| ORLEN Paczka | 📋 Planowane | Wysyłka | Adapter wysyłki. |
| BigCommerce | 📋 Planowane | Sklep | Adapter sklepu przez BigCommerce v3 API. |
| Magento | 📋 Planowane | Sklep | Adapter sklepu przez Magento 2 REST API. |
| Shopify | 📋 Planowane | Sklep | Adapter sklepu przez Storefront + Admin API. |
| WooCommerce | 📋 Planowane | Sklep | Adapter sklepu przez WooCommerce REST API. |
CAPABILITY PORTS
Z czego się składa integracja.
Każda integracja to zestaw "portów" — abstrakcji nad tym, co system potrafi zrobić. Adapter implementuje tylko porty, których dany klient potrzebuje. Lista portów rośnie wraz z platformą.
OrderSource
Czyta zamówienia z platformy.
OrderProcessor
Zapisuje zamówienia do platformy; aktualizacje statusów; anulacje.
OfferLister
Wystawia oferty na marketplace.
OfferCreator
Tworzy nowe oferty z produktu + kategorii.
OfferReader / OfferStatusReader
Czyta szczegóły, status i zdarzenia ofert.
OfferFieldUpdater
Aktualizuje konkretne pola istniejącej oferty.
CategoryBrowser / CategoryBarcodeMatcher
Przeglądą kategorie marketplace; dopasowuje produkty po EAN.
CategoryParametersReader
Czyta wymagane parametry kategorii.
CatalogProductReader
Czyta dane produktu z katalogu (do prefillu wystawień).
SellerPoliciesReader
Czyta zapisane polityki sprzedawcy (zwroty, wysyłka, etc.).
ResponsibleProducerReader
Czyta dane GPSR (bezpieczeństwo produktów EU).
SafetyAttachmentUploader
Wgrywa załączniki bezpieczeństwa produktów.
ShippingProviderPort
Operacje wysyłki (w trakcie rozwoju z InPostem).
InvoicingPort
Operacje fakturowania (w trakcie rozwoju z Subiekt nexo).
NAPISZ ADAPTER
Nie widzisz tego, czego potrzebujesz?
Plugin SDK pozwala napisać własny adapter — dla nowego marketplace'a, niestandardowego carriera, wewnętrznego ERP-a. Generator scaffolduje strukturę. Test-kit pozwala testować przeciwko prawdziwym kontenerom.
pnpm create-adapter my-platform
cd libs/integrations/my-platform
# Implement OrderSource, OfferLister,
# or whatever ports your platform needs.
pnpm test # → real Postgres + Redis
pnpm dev:stack:up # → see it runningBrakujący adapter? Zacznij od repo.
Kod, dokumentacja, plugin SDK — wszystko na GitHubie.