Integracja z WinCon

Wstęp

Integracja Symfonii Handel z system WinCon.

WinCon - to program produkcyjny dla przemysły okiennego, który pozwala na obsługę procesu obsługi zamówień (zleceń) oraz projektowania i konstruowania okien.

Integracja polega na importowaniu zleceń z bazy WinCon jako faktury do Symfonii Handel.

Dzięki tej integracji możemy zautomatyzować proces fakturowania oraz sprawne prowadzenie magazynu.

Opis funkcjonalny

Podstawą rozwiązanie jest import zleceń z systemu WinCon jako faktury w Symfonii Handel.
Import odbywa się pół-automatycznie, to znaczy użytkownik otwiera okno, na którym prezentowane są zlecenia z systemu WinCon.
Następnie użytkownik wskazuje zlecenia, które mają być wczytane do Symfonii. Zaznaczone zlecenia są grupowane wg kontrahenta i tworzone są faktury per kontrahent, gdzie każde zaznaczone zlecenie jest jedną pozycją na fakturze.
Wyjątkiem jest przypadek, gdy kontrahent ma wybrany typ dokumentu o charakterze kontraktu. W takim wypadku każde zlecenie tworzy osobny kontrakt (wraz z zaliczką do niego).

Po poprawnym wystawieniu faktury w Symfonii odpowiednie zlecenia w Wincon mają uzupełniony numer tej faktury w polu wskazanym w konfiguracji.
W przypadku kontraktów wysyłany jest numer zaliczki do kontraktu.

Na ww. oknie można wskazać dla danego kontrahenta typ dokumentu, który zostanie zapamiętany do następnych importów.

Domyślnie kontrahenci z WinCon są uzgadniani z kontrahentami w Symfonii po nipie.
Jeśli kontrahent w WinCon ma pusty nip to istnieje możliwość ręcznego uzgodnienia takiego kontrahenta na oknie importu.
Jeśli w Symfonii nie ma jeszcze odpowiedniego kontrahenta to możemy go dodać z poziomu okna importu.
Dodany kontrahent będzie miał na początku kodu kraj z WinCon (jeśli inny niż Polska).

W przypadku zleceń walutowych brany jest domyślny na dany dzień kurs waluty.
W opisie oraz notatce wygenerowanej faktury są po przecinku numery zleceń.

Jeśli podczas importu wybierzemy dla kontrahenta typ dokumentu o charakterze kontraktu to podczas importu są dodatkowo tworzone zaliczki na kwotę odczytaną z WinConu (kolumna 'Kwota zaliczki').

Uzgadnianie pozycji na dokumentach w Symfonii polega na pobraniu typu produktu pierwszej pozycji ze zlecenia w WinCon i znalezieniu w Symfonii towaru, który zawiera taką frazę w specjalnym wymiarze zdefiniowanym dla integracji. Daje to możliwość uzgodnienia wielu typów produktów z WinCon jako jeden towar w Symfonii.
Wartość pozycji brana jest z wartości netto całego zlecenia lub z dodatkowego pola zdefiniowanego w WinCon.
Stawka na pozycjach jest na podstawie stawki zlecenia w WinCon.

Okno importu jest uruchamiane spod PPM ^? Prawy Przycisk Myszy na liście dokumentów sprzedaży w Symfonii.
Dodatek mogą uruchamiać tylko użytkownicy wpisani w konfiguracji dodatku.

Instalacja funkcjonalności

1. Instalacja HPP

2. Wgranie raportów do Symfonia Handel (tylko raz z dowolnego stanowiska)

• hpp_runtime.sc - NET Runtime (BLOT)
• hpp_extr03.sc - ExtRun::WystawSp (BLOT)
• hpp_eitg_win00.sc - Integracja WinCon - Ustawienia NET (BLOT)
• hpp_eitg_win01.sc - Integracja WinCon - Import dokumentów (BLOT)

Konfiguracja dodatku

Aby uruchomić okno z konfiguracją należy otworzyć w Symfonii Handel okno raportów (Kartoteki -> Raporty), następnie wchodzimy kolejno do Symfonia.Pro -> HPP.
Klikamy PPM na raport "Integracja WinCon - Ustawienia NET (BLOT)" i wybieramy "Wykonaj raport".

Pokaże nam się poniższe okno.

W sekcji Konfiguracja parametrów bazy PosgreSQL uzupełniamy dane dotyczące bazy WinCon działającej na serwerze PostGre.

• Nazwa ODBC - nazwa połączenia ODBC z bazą WinCon. Konfiguracja ODBC została opisana tutaj. Jedyną różnicą tutaj jest to, że trzeba użyć sterownika dla PostGreSQL.
• Nazwa pola na numer faktury - należy uzupełnić nazwę (nie opis!) dodatkowego pola dokumentu handlowego w WinCon, w którym aplikacja będzie wpisywać numer wygenerowanej faktury z Symfonii.
  Pole to musi być typu tekstowego.
• Ręczne uzgadnianie kontrahentów - pozwala na uzgodnienie kontrahenta w Symfonii wg kolumny 'Klient [Dodatkowy identyfikator]'
• Filtrowanie zleceń - pozwala na filtrowanie lub odfiltrowanie zleceń, które w kolumnie "Klient [Dodatkowy identyfikator]" mają jedną z fraz wpisanych w tym polu.
• Źródło wartości zleceń - pozwala na wskazanie skąd mamy odczytywać wartość zlecenia podczas importu (która zostanie użyta jako wartość pozycji na fakturze).

W sekcji Konfiguracja parametrów Symfonii uzupełniamy informacje dotyczące działania z bazą Symfonii.

• Użytkownicy którzy będą mogli uruchamiać import - w tym polu należy zaznaczyć użytkowników, którzy będa mogli importować zlecenia z WinCon do Symfonii. Wszyscy użytkownicy, którzy nie będą tu zaznaczeni nie będą mogli uruchamiać funkcji importu.
• Wymiar kontrahenta na ostatnio używany typ dokumentu - należy wybrać z listy wymiar typu tekstowego, w którym program będzie zapisywał typ dokumentu jaki został ostatnio użyty dla danego kontrahenta. Jeśli takiego wymiaru jeszcze nie ma to należy go najpierw utworzyć z poziomu Symfonii.
• Wymiar kontrahenta na identyfikator z WinCon - należy wybrać z listy wymiar typu liczbowego, w którym będzie przechowywany identyfikator ręcznie uzgodnionych kontrahentów. Jeśli takiego wymiaru jeszcze nie ma to należy go najpierw utworzyć z poziomu Symfonii.
• Wymiar towaru na opis zlecenia do uzgodnień - należy wybrać z listy wymiar typu tekstowego, w którym użytkownicy będą wpisywać opisy zleceń które mają być uzgadniane z danymi towarami. W jednym wymiarze towaru można wpisać kilka opisów zleceń, muszą one być po średniku. Jeśli takiego wymiaru jeszcze nie ma to należy go najpierw utworzyć z poziomu Symfonii.
• Wymiar towaru na opis zlecenia do uzgodnień - analogicznie jak "Wymiar towaru na opis zlecenia do uzgodnień", z tym że tutaj wybieramy wymiar w którym opisy zleceń wykorzystywane podczas generowania kontraktów.

Jak tworzyć wymiary dla kontrahentów i towarów zostało szczegółowo opisane w FAQ -> szczegóły

• Domyślny rejestr - kod domyślnego rejestru na wystawianych fakturach.
• Domyślna forma płatności - kod domyślnej formy płatności na wystawianych fakturach.
• Tłumaczenia krajów - lista "translacji" krajów z WinCon uzupełniana przez użytkownika. Przetłumczone kraje są wykorzystywane podczas tworzenia nowych kontrahentów.
• Towar w Symfonii jeśli stawka 8% - towar jaki ma być uzgadniany podczas importu jeśli dane zlecenie ma stawkę 8%. Ustawienie to całkowicie pomija standardowe uzgadnianie towarów.

Po uzupełnieniu danych w sekcji Konfiguracja parametrów bazy PostgreSQL możemy sprawdzić czy wszystko jest poprawnie ustawione poprzez kliknięcie guzika Przetestuj połączenie.
Spowoduje on testowe zalogowanie się serwera PostgreSQL.
Jeżeli nam się to uda to dostaniemy komunikat Połączenie poprawne! W przeciwnym przypadku dostaniemy informację o błędzie.

Kliknięcie Zapisz spowoduje zapisanie zmian na oknie i zamknięcie okna ustawień.
Kliknięcie Anuluj spowoduje zamknięcie okna ustawień bez zapisania dokonanych zmian.

Uruchomienie

Aby uruchomić okno importu należy otworzyć w Symfonii Handel kartotekę dokumentów sprzedaży, następnie klikamy PPM ^? Prawy Przycisk Myszy i wybieramy raport "Integracja WinCon - Import dokumentów (BLOT)".

Jeśli użytkownik ma uprawnienia do importu to pokaże mu się poniższe okno.

W polu Ilość zleceń do wczytania możemy wpisać ile ostatnich zleceń ma się wyświetlić na oknie. Zlecenia są zawsze wczytywane 'od najnowszego'.

Guzik Odśwież przeładowuje listę zleceń wg wpisanej obok ilości zleceń do wczytania.

W tabeli na oknie wyświetlane są informacje o zleceniach w WinCon.
Opis kolumn:

• Id zlecenia - identyfikator zlecenia WinCon.
• Id paczki - identyfikator paczki zlecenia WinCon.
• Nazwa kontrahenta - nazwa kontrahenta zlecenia WinCon.
• Uzgodniony kontrahent Symfonia - kod uzgodnionego kontrahenta w Symfonii (uzgadnianie po nipie, musi on być taki sam w WinCon oraz w Symfonii. Dla kontrahentów bez nipu wg ręcznie utworzonego uzgodnienia).
• Ostatni typ dokumentu - kod ostatnio używanego typu dokumentu dla danego kontrahenta.

Jeśli chcemy zmienić (albo ustawić po raz pierwszy) typ dokumentu dla danego kontrahenta należy kliknąć w komórkę w kolumnie Ostatni typ dokumentu (obojętnie na jakim zleceniu) i z listy wybrać typ dokumentu w Symfonii.

Tylko zaznaczone zlecenia będą importowane. Zlecenia zaznaczamy klikając w "kwadracik" w pierwszej kolumnie.

W dolnej części okna możemy wybrać Datę generowanych dokumentów, z tą datą będą wystawiane faktury.

Kliknięcie Importuj spowoduje rozpoczęcie importu zaznaczonych zleceń.

Uzgadnianie kontrahentów

Jeśli zaznaczymy kontrahentów, którzy nie są uzgodnieni w Symfonii, to podczas importu pojawi się komunikat informujący o tym oraz okno "Uzgadnianie kontrahentów".
Okno to można również ręcznie uruchomić spod PPM ^? Prawy Przycisk Myszy dla zaznaczonych zleceń.

Uzgadnianie polega na tym, że dla każdego kontrahenta na liście należy wybrać z listy kontrahenta w Symfonii (kolumna "Uzgodniony kontrahent Symfonia").
W przypadku, gdy w Symfonii nie ma jeszcze odpowiedniego kontrahenta można kliknąć guzik "+" w kolumnie "Nowy", co spowoduje założenie nowego kontrahenta i automatyczne uzgodnienie go z danym kontrahentem w WinCon.

Po uzgodnieniu wszystkich kontrahentów można kliknąć "Kontynuuj" dzięki czemu będziemy mogli wrócić na główne okno importu.