O->M i Export Magik

O->M i Export Magik nie sa zwyklym przyciskiem pobierania pliku. To warstwa integracyjna dla sytuacji, w ktorej po jednej stronie system prowadzi faktury, statusy KSeF, kontrahentow i platnosci, a po drugiej stronie ksiegowosc oczekuje konkretnego formatu importu, nazw plikow, kodowania znakow i kompletu zalacznikow.

Strona jest podzielona wedlug realnych uprawnien operatora. Osoba z prawem do samego podgladu moze wejsc na ekran, ale poszczegolne sekcje pojawiaja sie dopiero wtedy, gdy rola ma prawo do konwersji, eksportu faktur albo pobrania wyciagow. Dzieki temu UI nie prowadzi uzytkownika do akcji, ktorych i tak nie moze wykonac.

Co jest obslugiwane

• Konwersja Optima do Magik przyjmuje plik XML z Comarch Optima, mapuje faktury, wplaty KP i kontrahentow, a nastepnie generuje archiwum ZIP z plikiem MAGIK_EKSPORT.

• Eksport faktur z ExKSeF pobiera zaakceptowane faktury sprzedazowe z wybranego miesiaca i buduje ten sam format wyjsciowy, z kartoteka kontrahentow oraz blokiem KSeF tam, gdzie dokument ma numer referencyjny.

• Wyciagi bankowe pobieraja z Pekao Connect pliki MT940 i PDF za poprzedni miesiac albo wskazany okres, po czym wysylaja je mailem zgodnie z konfiguracja w administracji.

Konwersja zaczyna sie od pliku .xml. System odrzuca pusty plik i inne rozszerzenia, czyta XML z wykrywaniem BOM, a potem analizuje sekcje REJESTRY_SPRZEDAZY_VAT, RAPORTY_KB i KONTRAHENCI. Jezeli w pliku nie ma rejestru sprzedazy VAT, operator dostaje komunikat zamiast pustego eksportu.

Mapper przenosi faktury jako dokumenty handlowe, zapisy kasowo-bankowe jako dokumenty finansowe KP oraz buduje kartoteke kontrahentow. Dla korekt uzywany jest symbol typu dokumentu z administracji z dodanym k, na przyklad FV i FVk. Stawki VAT sa normalizowane do kodow uzywanych przez Magik, a dane kontrahenta sa preferowane z kartoteki kontrahentow z Optimy, jezeli taka karta istnieje.

Po konwersji ekran pokazuje porownanie licznikow z pliku zrodlowego i pliku wynikowego. Widac liczbe faktur, wplat KP, kontrahentow, blokow KSeF oraz szczegolna kontrole dla WSTO_EE. To nie jest ozdobny raport, tylko szybka kontrola jakosci eksportu przed przekazaniem go dalej.

Druga czesc ekranu eksportuje faktury sprzedazowe prowadzone juz w ExKSeF. Operator wybiera miesiac i rok, a use case pobiera faktury z widoku zaakceptowanych dokumentow z danego okresu. Eksport nie bierze dokumentow roboczych, bo format dla ksiegowosci powinien odzwierciedlac dokumenty, ktore przeszly proces wystawienia.

Builder tworzy dokumenty handlowe i kartoteke kontrahentow w tym samym formacie MAGIK_EKSPORT, ktory jest uzywany przez konwersje Optimy. Dla faktur z numerem KSeF dodawany jest blok KSeF z data wyslania i akceptacji, a dla korekt generowany jest odpowiedni typ dokumentu. Pozycje VAT sa liczone z linii faktury, z uwzglednieniem ujemnych pozycji korekt.

Opcjonalnie administracja moze wlaczyc tryb jednego ZIP-a, w ktorym po konwersji pliku z Optimy system dolacza rowniez eksport faktur z bazy za ten sam okres. To usuwa reczne skladanie paczki z dwoch roznych zrodel i zmniejsza ryzyko, ze ksiegowosc dostanie niepelny miesiac.

Sekcja wyciagow wykorzystuje rachunek firmowy zapisany w profilu firmy i klienta Pekao Connect. Domyslnie pobierany jest poprzedni miesiac, ale operator moze wskazac konkretny miesiac i rok, gdy trzeba ponowic zalegly okres albo uzupelnic archiwum.

System probuje pobrac dwa typy plikow: MT940 dla importu ksiegowego oraz PDF jako czytelny wyciag. Jezeli bank nie udostepni zadnego pliku, wysylka nie jest wykonywana. Jezeli pliki zostana pobrane, trafiaja do maila dla odbiorcow ustawionych w administracji. Przy wlaczonym pakowaniu do ZIP-a wymagane jest haslo, przechowywane w bazie w postaci zabezpieczonej.

Ten sam przypadek obsluguje rowniez endpoint API /api/banking/statements, chroniony tym samym uprawnieniem. Dzieki temu logika pobierania wyciagow nie jest rozbita na osobne zasady dla weba i wywolan programistycznych.

Ustawienia O->M i Export Magik sa celowo przeniesione do administracji. Operator procesu nie wpisuje za kazdym razem typu dokumentu, kodowania, adresow e-mail ani hasla do ZIP-a. Te wartosci sa globalnymi ustawieniami aplikacji, zapisywanymi w AppSettings.

• Typ dokumentu Magik trafia do pola TYP_DOKUMENTU; korekta dostaje ten sam symbol z dopisana litera k.

• Kodowanie moze byc ustawione jako Windows-1250 albo UTF-8, co ma znaczenie przy imporcie do starszych narzedzi ksiegowych.

• Mailing eksportu Magik moze automatycznie wyslac ZIP do ksiegowosci, z tematem i trescia zawierajaca token {okres}.

• Mailing wyciagow definiuje odbiorcow, temat, tresc, pakowanie do ZIP-a i haslo dla paczki z MT940 oraz PDF.

To podejscie pokazuje wazna decyzje projektowa: konfiguracja integracji jest zarzadzana w jednym miejscu, a ekran roboczy tylko wykonuje proces zgodnie z zatwierdzonymi ustawieniami.

Modul ma oddzielne uprawnienia dla wejscia na strone, konwersji pliku, eksportu faktur i pobierania wyciagow. Widocznosc sekcji jest zgodna z tymi uprawnieniami, a same use case'y ponownie sprawdzaja dostep przed wykonaniem operacji. To chroni aplikacje rowniez wtedy, gdy akcja zostanie wywolana poza standardowa nawigacja.

Komunikaty bledu sa przygotowane pod operatora: brak pliku, zle rozszerzenie, pusty plik, brak faktur za okres, brak adresow odbiorcow wyciagow, brak hasla ZIP-a albo brak rachunku firmowego. Zamiast cichego niepowodzenia system wskazuje, co trzeba poprawic w konfiguracji lub danych.

Z perspektywy technicznej ta strona dobrze pokazuje prace na styku domeny, infrastruktury i UI: parser XML, wspolny emiter MAGIK_EKSPORT, pobieranie danych z banku, uslugi mailowe, role, konfiguracja administracyjna i kontrola wyniku sa zlozone w jeden czytelny proces.