Wybór wzorca wymiany
Interfejs programistyczny (API) w czasie rzeczywistym pasuje do interaktywnych operacji. Zdarzenie lub webhook powiadamia o zmianie. Synchronizacja harmonogramowa obsługuje opóźnione partie. Import i eksport plików może być właściwy dla ręcznej kontroli lub systemów bez API. W jednym rozwiązaniu często występuje kilka wzorców.
System źródłowy, identyfikatory i duplikaty
Dla każdego obiektu wskaż system źródłowy, właściciela definicji, identyfikator techniczny i klucz biznesowy. Ustal, czy mapowanie jest jeden-do-jednego, jak wykrywać duplikaty i kto rozstrzyga konflikt. Nie opieraj tożsamości na zmiennym polu, takim jak adres e-mail, bez jawnej analizy.
Ponowienia, idempotencja i uzgadnianie
Ponowienie nie może tworzyć drugiego skutku; tę własność nazywa się idempotencją. Określ limity prób, opóźnienia, kolejkę błędów, alarmy i sposób ręcznego wznowienia. Regularne uzgodnienie powinno wykrywać brakujące, podwójne i rozbieżne rekordy niezależnie od logów transportu.
Sekrety, obserwowalność i awarie
Poświadczenia potrzebują ograniczonego zakresu, bezpiecznego magazynu, rotacji i właściciela. Mierz opóźnienie, błędy, zaległość i wynik biznesowy. Dla każdej awarii zdecyduj, czy proces ma się zatrzymać, buforować, działać w ograniczonym trybie czy zostać obsłużony ręcznie, oraz jak nastąpi powrót.
KSeF i polskie systemy: status trzeba udowodnić
W sprawdzonym publicznym kodzie nie znaleziono gotowych konektorów KSeF, Comarch Optima, enova365, Symfonia, BaseLinker ani Allegro. Ich status pozostaje „nieznany” z perspektywy tego przewodnika. Publiczne API takiego systemu może umożliwić własną integrację, ale zakres, prawa dostępu, limity, certyfikacja i testy trzeba ocenić osobno.
API żądanie i odpowiedź
Natychmiastowe polecenie lub odczyt
Ryzyko awarii: Timeouty, częściowe zapisy, sprzężenie
Zdarzenie lub webhook
Asynchroniczne powiadomienie i fan-out
Ryzyko awarii: Duplikaty, kolejność, ponowienia, dead letter
Synchronizacja cykliczna
Wymiana wsadowa z uzgodnieniem
Ryzyko awarii: Rozjazd, nakładające się uruchomienia, nieaktualne dane
Import lub eksport pliku
Kontrolowana wymiana masowa i przełączenie
Ryzyko awarii: Zmiana schematu, kodowanie, ponowienie i odpowiedzialność
| Temat | Status | Granica dowodu |
|---|---|---|
| KSeF | niepotwierdzony | API dostawcy nie dowodzi konektora Open Mercato. |
| Comarch Optima | niepotwierdzony | API dostawcy nie dowodzi konektora Open Mercato. |
| enova365 | niepotwierdzony | API dostawcy nie dowodzi konektora Open Mercato. |
| Symfonia | niepotwierdzony | API dostawcy nie dowodzi konektora Open Mercato. |
| BaseLinker | niepotwierdzony | API dostawcy nie dowodzi konektora Open Mercato. |
| Allegro | niepotwierdzony | API dostawcy nie dowodzi konektora Open Mercato. |
Metoda, założenia i ograniczenia
Stan na 14 lipca 2026 r. Fakty produktowe sprawdzono zarówno w publicznym kodzie wskazanej wersji repozytorium, jak i w oficjalnej dokumentacji. Gdy dokumentacja i kod się różnią, opisujemy zachowanie potwierdzone w kodzie. Interpretacje i zalecenia dotyczą pracy wdrożeniowej, a nie gwarancji produktu.
Ten materiał nie jest ofertą, audytem, certyfikacją ani poradą prawną, podatkową lub księgową. Na wynik wpływają edycja, wybrane moduły, konfiguracja, własny kod, infrastruktura, dane, dostawcy zewnętrzni i sposób operowania systemem.
Główne zbiory źródeł: repozytorium kodu, dokumentacja, publiczne wydania.