Integracje
Integracje Symfonii: dane mają przechodzić między systemami, a nie między arkuszami
Integracja nie zaczyna się od pytania, czy jest API. Zaczyna się od ustalenia, który system jest źródłem danych, co ma przechodzić w drugą stronę, jak często i co zrobić z błędem. Łączymy rozwiązania Symfonii między sobą oraz z e-commerce, KSeF, SaldeoSMART, bankami i systemami branżowymi.
Co faktycznie integrujemy
| Połączenie | Zakres danych | Kierunek | Co ustalamy przed startem |
|---|---|---|---|
| Handel ↔ sklep / marketplace | Zamówienia, towary, stany, klienci, ceny, statusy realizacji | Kierunek zależy od kanału sprzedaży, w tym wymiana dwukierunkowa | Ustalamy, który system jest źródłem kartoteki, cen i stanów |
| Handel ↔ Mobilny Magazyn | Przyjęcia, wydania, przesunięcia, kompletacja, inwentaryzacja | Praca na danych systemu bazowego | Magazyny, oznaczenie kodami, urządzenia, moment powstania dokumentu |
| Handel ↔ Platforma B2B | Oferta, warunki handlowe, stany, zamówienia, dokumenty | Zgodnie z konfiguracją platformy | Co klient widzi i co sam wprowadza |
| Handel ↔ Detal | Towary, ceny, sprzedaż, dokumenty sprzedaży | Zgodnie z konfiguracją sklepu | Urządzenia, fiskalizacja, organizacja pracy sklepu |
| Symfonia ↔ KSeF Plus | Faktury, statusy, numer KSeF, dokumenty odbierane | Wysyłka i odbiór | Uprawnienia, uwierzytelnianie, praca w trybie offline |
| eDokumenty ↔ Symfonia / KSeF | Dokumenty, opis, status, przekazanie do księgowości | Zgodnie z przyjętym procesem | Kto akceptuje i w którym momencie dokument idzie dalej |
| SaldeoSMART → Finanse i Księgowość | Dane odczytane z dokumentów i informacje potrzebne do księgowania | Do procesu księgowego | Opis i kontrola dokumentu przed księgowaniem |
| Develogic ↔ Symfonia | Dane finansowe, handlowe i projektowe w uzgodnionym zakresie | Dwukierunkowo, przez WebAPI | Mapowanie projektów, kontraktów i danych księgowych |
| inEwi → R2Płatnik | Czas pracy w aktualnie dostępnym zakresie | Wymiana plikowa | Co i w którym momencie trafia do naliczeń płacowych |
| Symfonia ↔ bankowość | Wyciągi i dane płatnicze w zakresie danego rozwiązania | Zależnie od banku i konfiguracji | Format, częstotliwość i sposób uzgadniania |
Lista systemów nie oznacza identycznego zakresu wymiany danych w każdej konfiguracji. Przed ofertą potwierdzamy pola, kierunek i częstotliwość synchronizacji.
Sześć pytań, na które odpowiadamy przed integracją
- 01
Który system jest źródłem prawdy
Dla każdego typu danych wskazujemy jedno miejsce, w którym rekord powstaje i jest poprawiany.
- 02
W którą stronę idzie każdy typ danych
Towar, cena, stan, klient, zamówienie i status realizacji często mają różne kierunki wymiany.
- 03
Jak często ma następować wymiana
Od wymiany na żądanie po cykliczną synchronizację — z konsekwencjami dla obciążenia i dla pracy zespołu.
- 04
Po czym rozpoznajemy ten sam rekord
Bez trwałego identyfikatora integracja tworzy duplikaty przy pierwszej zmianie nazwy lub kodu.
- 05
Co się dzieje, gdy pojawi się błąd
Ustalamy, czy dokument jest wstrzymywany, ponawiany czy zgłaszany do obsługi — i kto to widzi.
- 06
Jaki zakres historii przenosimy
Zakres historii do migracji ustalamy po analizie danych źródłowych, osobno od bieżącej wymiany.
Mechanizmy standardowe
Najpierw sprawdzamy gotowe połączenia producenta: wymianę między programami Symfonii, e-faktury w KSeF, odczyt dokumentów w SaldeoSMART, sklepy i marketplace przez Integrator e-commerce oraz import danych bankowych. Standard jest tańszy w utrzymaniu i przewidywalny przy zmianie wersji.
Kiedy sięgamy po WebAPI
- Brak mechanizmu standardowego dla danego systemu.
- Nietypowy zakres danych albo nietypowy kierunek wymiany.
- Wymiana obejmująca kilka systemów jednocześnie.
- Potrzebne walidacje i mapowanie danych po drodze.
- Wymagany monitoring przebiegu i obsługa błędów.
Praktyka PATCOM
Najczęstszy błąd: integrowanie nieuporządkowanych danych
Integracja nie porządkuje danych — powiela je szybciej. Jeśli ten sam towar występuje w kartotece kilka razy, w różnych jednostkach albo z niespójnym kodem, po uruchomieniu wymiany problem pojawia się w każdym połączonym systemie.
Dlatego przed integracją porządkujemy kartoteki, jednostki, kody i cenniki, a dopiero potem uruchamiamy wymianę. Zakres danych ustalamy podczas konfiguracji integracji, na podstawie procesu, nie listy dostępnych pól.
Jak zaczynamy rozmowę o integracji
Nie potrzebujemy dokumentacji technicznej na pierwszym spotkaniu. Wystarczy opis procesu: skąd bierze się dokument lub zamówienie, kto je obsługuje, gdzie dane są dziś przepisywane i co ma się zmienić. Na tej podstawie proponujemy zakres, kierunki i kolejność prac. Powiązane rozwiązania znajdziesz na stronach Symfonia Handel, Integrator e-commerce oraz KSeF Plus.
Jak powstał ten materiał
Zakres funkcjonalny opisujemy na podstawie aktualnej dokumentacji producenta oraz materiałów produktowych Symfonii. Rekomendacje dotyczące kolejności wdrożenia, migracji, konfiguracji i organizacji pracy są opracowaniem PATCOM na podstawie praktyki wdrożeniowej. Nie opisujemy funkcji zapowiadanych w roadmapie jako dostępnych, dopóki nie potwierdza ich aktualna wersja produktu.
Źródła
- Symfonia — aktualna dokumentacja produktowa i pomoc techniczna.
- Materiały produktowe producenta dostępne partnerom — wykorzystane wyłącznie do weryfikacji zakresu funkcji.
- Ministerstwo Finansów — Krajowy System e-Faktur: aktualne zasady, terminy i dokumentacja techniczna.
- SaldeoSMART — dokumentacja produktowa i materiały dla partnerów.
- PATCOM — praktyka wdrożeniowa, migracyjna i serwisowa.