Integracje

FlowOMS obsługuje 6 marketplace + 8 kurierów + 4 księgowości + 3 AI providery, wszystkie konfigurowalne w UI.

Filozofia

Zero hardcoded parametrów. Każda integracja ma:

• Settings UI w /settings/integrations/{type} (formularz z pól per integracja)
• Sekrety szyfrowane Fernet (klucze wyciągasz z panelu serwisu, wpisujesz w UI, my szyfrujemy w bazie)
• Test connection button — sprawdzasz że klucze działają przed save
• Fallback do Superadmin — admin może ustawić globalne klucze (np. fallback Gemini key)

Marketplace

Integracja	Status	Auth
Allegro	✅ Native	OAuth2
Amazon SP-API	✅ Native	LWA OAuth
eBay	✅ Native	OAuth2
Temu	🔧 Scaffold	App key + secret
Kaufland	🔧 Scaffold	HMAC-SHA256
Empik	🔧 Scaffold	API key

Kurierzy

Integracja	Status	Auth
InPost	✅ Native	API token
Allegro WzA	✅ Native	(z Allegro OAuth)
DPD	🔧 Scaffold	login + password + FID
GLS	🔧 Scaffold	username + password (SHA-512)
UPS	🔧 Scaffold	OAuth2 + shipper_number
FedEx	🔧 Scaffold	OAuth2 + account
Pocztex	🔧 Scaffold	login + password
ORLEN Paczka	🔧 Scaffold	API token

🔧 Scaffold = architektura + pełen UI + tests gotowe; brakuje finalnego HTTP wiringu (dorabiamy z creds).

Księgowość

Integracja	Status	Auth
wFirma	🔧 Scaffold	OAuth2
iFirma	🔧 Scaffold	2 klucze HMAC-SHA1
Fakturownia	🔧 Scaffold	API token + subdomain
KSeF	🔧 Scaffold	NIP + token MF

AI

Provider	Status	Default model
Google Gemini	✅ Native	gemini-2.0-flash
OpenAI	✅ Native	gpt-4o-mini
Anthropic Claude	✅ Native	claude-haiku-4-5

Patrz: AI Provider (BYOK).

Bridge przez BaseLinker

Jeśli masz konto BL z kontami kurierów (DPD/GLS/Pocztex...), możesz używać BL bridge zamiast native:

1. Włącz integrację BaseLinker w /settings/integrations/baselinker
2. W panelu wysyłki kliknij "Pokaż wszystkie 399 BL kurierów"
3. Wybierz dowolny — paczka idzie przez BL.createPackage

Plus: każdy z 399 kurierów BL od razu działa. Minus: wymaga konta BL (płatne), zostajesz w ekosystemie BL.

Native = strategia długoterminowa (nie zależymy od BL).