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. |
| inFakt | ✅ Działa | Fakturowanie | Adapter fakturowania/księgowości z pośrednictwem KSeF — wystawia dokumenty i odczytuje status clearance. |
| KSeF | ✅ Działa | Fakturowanie | Krajowy System e-Faktur (API KSeF 2.0). Wystawianie FA(3) + clearance, numer KSeF + UPO, korekty KOR — model async: wysyłka → poll → UPO. |
| Subiekt nexo | ✅ Działa | Fakturowanie | Fakturowanie przez bridge Sfera (usługa Windows): faktury i paragony, korekty, status + PDF. Pierwszy adapter InvoicingPort. |
| 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. |
| ERLI | ✅ Działa | Marketplace | Polski marketplace. OfferManager (tworzenie/aktualizacja ofert, stany, status, zwrot stanu przy anulacji) + OrderSource (webhook + poll). Drugi działający marketplace. |
| DPD | ✅ Działa | Wysyłka | DPD Polska — etykiety i śledzenie przez DPDInfoServices, zamawianie kuriera. Na ShippingProviderPort. |
| InPost | ✅ Działa | Wysyłka | Integracja ShipX: paczkomat + kurier + etykiety + webhooki. Ustanawia ShippingProviderPort. |
| PrestaShop | ✅ Działa | Sklep | Katalog, magazyn, pełny cykl zamówień. Ships moduł PrestaShop (OL Dynamic Carrier) dla round-tripu wysyłki marketplace. |
| WooCommerce | ✅ Działa | Sklep | Źródło + cel + magazyn. Pobieranie zamówień, publikacja produktów (też masowa), przez WooCommerce REST API. Kreator konfiguracji. |
| Fakturownia | 📋 Planowane | Fakturowanie | Adapter fakturowania. |
| iFirma | 📋 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 na ShippingProviderPort. |
| FedEx | 📋 Planowane | Wysyłka | Adapter wysyłki 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. |
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 — działa z InPostem i DPD.
InvoicingPort
Operacje fakturowania — działa z Subiekt nexo, KSeF i inFakt.
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.