Algorytm uzgadniania kontrahentów z Symfonią FK

IntegratorKSeF & JPK do Symfonii — Intuiti sp. z o.o.
Producent: Intuiti sp. z o.o., NIP: 7811882150 · tel. (61) 307 40 00 · e-mail: biuro@intuiti.pl · www.intuiti.pl
Dokument opisuje, w jaki sposób program przypisuje dokument do kontrahenta w kartotece Symfonii Finanse i Księgowość: kiedy kontrahent jest uzgadniany z istniejącym, kiedy zakładany jako nowy oraz która baza danych jest przy tym sprawdzana. Opis dotyczy wersji 2026.4.1001.0. Ilustracje mają charakter poglądowy i mogą się nieznacznie różnić od bieżącej wersji oprogramowania.
Spis treści
  1. Najważniejsze zasady
  2. Gdzie przechowywane są dane o kontrahentach
  3. Kiedy kontrahent jest uzgadniany
  4. Algorytm ustalania kontrahenta przy wysyłce dokumentu
  5. Kiedy program zakłada nowego kontrahenta
  6. Kontrahenci bez NIP
  7. Ręczne uzgodnienie i lista uzgodnień
  8. Kartoteka kontrahentów w programie
  9. Dobre praktyki

1. Najważniejsze zasady

2. Gdzie przechowywane są dane o kontrahentach

MiejsceZawartośćAktualność
Kartoteka kontrahentów Symfonia FKWłaściwa kartoteka: pozycja, kod (skrót), nazwa, NIP, adres, kraj, e-mail.Zawsze aktualna — źródło prawdy. To w niej program wyszukuje i zakłada kontrahentów przy wysyłce.
Kartoteka kontrahentów programu baza programuKopia kartoteki Symfonii FK wraz z adresami e-mail, osobno dla każdej firmy. Służy do przeglądania kontrahentów, podpowiedzi przy wysyłce e-mail i rozpoznawania kontrahentów spoza Symfonii.Aktualna na chwilę ostatniego pobrania — przy pierwszym otwarciu okna kontrahentów albo poleceniem „Odśwież”.
Uzgodnienia kontrahentów baza programuRęczne przypisania: kontrahent z dokumentu (kod, miejscowość, NIP) → pozycja w Symfonii FK.Zapamiętane do czasu usunięcia na liście uzgodnień.
Kontrahenci z faktur baza programuKontrahenci z wczytanych faktur, których nie ma w kartotece Symfonii.Tylko do przeglądu w kartotece kontrahentów — nie biorą udziału w wysyłce.

3. Kiedy kontrahent jest uzgadniany

MomentCo się dziejeSprawdzana baza
Wczytanie fakturProgram przypisuje pozycję kontrahentom, dla których istnieje zapamiętane ręczne uzgodnienie (zgodny kod, miejscowość i NIP).uzgodnienia w programie
Ręczne uzgodnienieUżytkownik wskazuje kontrahenta z kartoteki — pozycja zostaje przypisana i zapamiętana na kolejne importy. Wybór „Stwórz automatycznie” niczego nie zapamiętuje — kontrahent przejdzie zwykłe wyszukiwanie przy wysyłce.kartoteka programu (lista do wyboru)
„Uzgodnij kontrahentów z FK”Dla zaznaczonych dokumentów program sprawdza, czy kontrahent istnieje, i oznacza go: pozycja (istniejący) albo (do dodania). Nic nie jest zakładane ani zapisywane do FK.kartoteka programu, a gdy tam brak — Symfonia FK
Wysyłka do Symfonii FKPełny algorytm z rozdziału 4 — wyszukanie i ewentualne założenie kontrahenta.Symfonia FK (poza pozycjami przypisanymi wcześniej)

4. Algorytm ustalania kontrahenta przy wysyłce dokumentu

Program sprawdza kolejne warunki od góry; pierwszy, który da pozycję kontrahenta, kończy szukanie.

Wysyłka dokumentu do Symfonii FK Brak NIP i włączone „Zawsze twórz nowego kontrahenta”? Szukaj w Symfonii FK po kodzie kontrahenta Kontrahent ma już przypisaną pozycję w FK? Użyj przypisanej pozycji (bez ponownego sprawdzenia w FK) Brak NIP i włączone „Dokumenty bez NIP przypisuj do kontrahenta”? Pozycja kontrahenta wskazanego w ustawieniach Szukaj w Symfonii FK po NIP (bez NIP — po kodzie kontrahenta) Wynik wyszukiwania w Symfonii FK Załóż nowego kontrahenta w Symfonii FK (kod zajęty — ponów z kodem + NIP) Dokument trafia do FK z pozycją kontrahenta tak nie tak nie tak nie jeden kontrahent albo kilku ze zgodnym kodem → jego pozycja brak albo kilku bez zgodnego kodu nie znaleziono znaleziono
decyzja sprawdzenie w Symfonii FK (na żywo) pozycja bez ponownego sprawdzenia w FK zapis do FK — nowy kontrahent
Ilustracja 1. Ustalanie kontrahenta w Symfonii FK przy wysyłce dokumentu — schemat logiczny
  1. Kontrahent bez NIP przy włączonym „Zawsze twórz nowego kontrahenta w kartotece”. Gdy NIP zawiera mniej niż trzy cyfry, program szuka kontrahenta w Symfonii FK po kodzie, a następnie po kodzie złożonym z nazwy, miejscowości i ulicy. Nie znaleziony — zakłada nowego (rozdział 5).
  2. Pozycja przypisana wcześniej. Gdy kontrahent ma już pozycję — z ręcznego uzgodnienia, z polecenia „Uzgodnij kontrahentów z FK” albo z wcześniejszej wysyłki tego dokumentu w tej samej sesji — jest ona używana bez ponownego wyszukiwania.
  3. Dokumenty bez NIP przypisywane do wybranego kontrahenta. Gdy ustawienie jest włączone, a NIP jest pusty lub równy jednej z fraz traktowanych jako brak NIP, dokument trafia do kontrahenta wskazanego w ustawieniach (rozdział 6).
  4. Wyszukanie w Symfonii FK. Jeden znaleziony kontrahent — dokument otrzymuje jego pozycję. Kilku z tym samym NIP-em — wybierany jest ten, którego kod jest zgodny z kodem kontrahenta z dokumentu.
  5. Brak kontrahenta — albo kilku z tym samym NIP-em bez zgodnego kodu — program zakłada nowego kontrahenta (rozdział 5).

5. Kiedy program zakłada nowego kontrahenta

Nowy kontrahent jest zakładany w kartotece Symfonii FK wyłącznie podczas wysyłki dokumentu, gdy wyszukiwanie z rozdziału 4 nie wskazało istniejącego kontrahenta. Zakładany kontrahent otrzymuje z dokumentu: kod (skrót), nazwę, miejscowość, ulicę, kod pocztowy, NIP i kod kraju; kontrahent z kraju Unii Europejskiej innego niż Polska otrzymuje status kontrahenta unijnego.

SytuacjaKod nadawany kontrahentowi
Kod z dokumentu krótszy niż 40 znakówkod z dokumentu
Kod z dokumentu dłuższy (40 znaków i więcej)25 pierwszych znaków + 4 litery miejscowości + NIP
Kod pusty lub „brak”NIP
Kod zajęty w Symfonii przez innego kontrahentakod + NIP (druga próba)
Polecenie „Uzgodnij kontrahentów z FK” nie zakłada kontrahentów — jedynie oznacza ich jako do dodania . Założenie następuje dopiero przy wysyłce dokumentu.

6. Kontrahenci bez NIP

Sposób obsługi dokumentów, których kontrahent nie ma numeru NIP, ustala się w menu Ustawienia → Ustawienia, zakładka „Kontrahenci bez NIP”:

Ustawienia — Kontrahenci bez NIP✕
Zawsze twórz nowego kontrahenta w kartotece
Kod kontrahenta będzie składać się z Imię i Nazwisko, Miasto, Ulica. Nowy kontrahent będzie tworzony za każdym razem w przypadku, kiedy nie zostanie odnaleziony wg kodu.
Dokumenty bez NIP przypisuj do wybranego kontrahenta
Funkcja pozwala wskazać kontrahenta istniejącego w Symfonii FK i przypisać do niego wszystkie dokumenty, których kontrahenci nie zawierają numeru NIP.
Pozycja kontrahenta
12
Detal — sprzedaż bez NIP
Frazy traktowane jako brak NIP
1, brak, osoba fizyczna
Ilustracja 4. Ustawienia → zakładka „Kontrahenci bez NIP”

7. Ręczne uzgodnienie i lista uzgodnień

Na liście faktur kolumna „Pozycja” kontrahenta pokazuje stan uzgodnienia: numer pozycji w Symfonii FK, symbol (kontrahent do dodania — zostanie założony przy wysyłce) albo „Do uzg.” (kontrahent jeszcze nie sprawdzany). Przycisk „Uzgodnij kontrahenta ręcznie” otwiera kartotekę kontrahentów, w której wskazuje się właściwego kontrahenta.

Dokumenty — Sprzedaż✕
Numer dokumentuKontrahentNIPPozycja
FV/2026/10/001Alfa Transport Sp. z o.o.52602502741245 👥
FV/2026/10/002Nowy Klient Sp. z o.o.1132456789 👥
FV/2026/10/003Beta Handel6342223344Do uzg. 👥
Ilustracja 3. Lista faktur — kolumna Pozycja kontrahenta: pozycja w FK, „+” (do dodania), „Do uzg.”

Ręcznie wskazana pozycja jest zapamiętywana i przy kolejnych importach przypisywana automatycznie kontrahentowi o tym samym kodzie, miejscowości i NIP-ie. Zapamiętane uzgodnienia można przejrzeć i usunąć w menu Kartoteki → Uzgodnienia kontrahentów z FK:

Uzgodnienia kontrahentów — lista uzgodnień kontrahentów z bazą Symfonia FK✕
Pozycja FKKodNIPAdresMiejscowośćKod kraju
3018TRANS-BUD7811882150ul. Polna 1PoznańPL
512GAMMA GMBHDE123456789Hauptstr. 3BerlinDE
Ilustracja 5. Lista zapamiętanych ręcznych uzgodnień kontrahentów z FK

8. Kartoteka kontrahentów w programie

Okno Kartoteki → Kontrahenci prezentuje kontrahentów z kartoteki Symfonii FK (oznaczonych w kolumnie „FK”) oraz kontrahentów z wczytanych faktur, których jeszcze nie ma w Symfonii. Przełącznik „Wszyscy” / „Tylko Symfonia” zawęża listę do samej kartoteki FK. W nagłówkach kolumn dostępne są pola wyszukiwania, działające łącznie z polem wyszukiwania w pasku okna.

Kontrahenci — Wszyscy kontrahenci, z Symfonii oraz z wczytanych faktur✕
WszyscyTylko Symfonia
⟳ Odśwież
PozycjaFKKodNazwaNIPMiejscowośćEmail
transport
1245FKALFA-TRANSAlfa Transport Sp. z o.o.5260250274Warszawabiuro@alfa.pl
3018FKTRANSBUDTransbud Logistyka s.c.7811882150Poznań
-1TRANSBUD, 9512345678Transbud Usługi Transportowe9512345678Kraków
Znaleziono 3 z 100 237 kontrahentówZamknij
Ilustracja 2. Kartoteka kontrahentów — widok „Wszyscy”, kolumna FK, filtr w kolumnie Nazwa

Kartoteka wczytywana jest raz w trakcie pracy z firmą — z kopii zapisanej w programie, a z Symfonii FK tylko wtedy, gdy kopii jeszcze nie ma. Aktualną kartotekę pobiera się z Symfonii przyciskiem „Odśwież”; zapisywane są wtedy wyłącznie zmiany. Adres e-mail kontrahenta z Symfonii FK jest przenoszony do kartoteki programu; adres wpisany w programie pozostaje, gdy w Symfonii e-maila brak.

Wyszukiwanie kontrahenta w kartotece — po nazwie, kodzie, NIP-ie i w pozostałych kolumnach, filtrem nad każdą z nich — zostało zoptymalizowane i przetestowane na kartotece liczącej 100 000 kontrahentów.

Okno Kontrahenci w programie z kartoteką ze 100 000 kontrahentów: kolumny Pozycja, FK, Kod, Nazwa, NIP, Adres, Kod pocztowy, Miejscowość, Kod kraju, Email, wiersz filtrów i przełącznik Wszyscy / Tylko Symfonia
Ilustracja 6. Okno „Kontrahenci” przy kartotece liczącej 100 000 pozycji — wiersz filtrów pod nagłówkami kolumn

9. Dobre praktyki

Przed poleceniem „Uzgodnij kontrahentów z FK” odśwież kartotekę (Kartoteki → Kontrahenci → „Odśwież”), jeśli w Symfonii FK dodawano lub zmieniano kontrahentów. Polecenie korzysta w pierwszej kolejności z kartoteki programu, a przypisana nim pozycja jest używana przy wysyłce bez ponownego wyszukiwania.
Usuń nieaktualne uzgodnienie (Kartoteki → Uzgodnienia kontrahentów z FK), gdy kontrahent został w Symfonii usunięty lub scalony z innym. Zapamiętana pozycja jest używana przy wysyłce bez ponownego sprawdzenia w Symfonii.
Kilku kontrahentów z tym samym NIP-em. Gdy w Symfonii FK istnieje kilku kontrahentów z tym samym NIP-em i żaden nie ma kodu zgodnego z dokumentem, program zakłada nowego kontrahenta. Aby dokument trafił do istniejącego kontrahenta, uzgodnij go ręcznie przed wysyłką.
Kontrahent dla dokumentów bez NIP wskazany w ustawieniach musi istnieć w Symfonii FK — program używa wpisanej pozycji bez jej sprawdzania.