Baza wiedzy LINKSPOT › Comarch BPM - współpraca z Comarch ERP XL

Dokument ERP XL

Comarch BPM - współpraca z Comarch ERP XL · Opublikowano 2026-06-16

Spis treści artykułu

Właściwości kontrolki typu Dokument ERP XL

Kontrolka typu „Dokument ERP XL” służy do dekretacji kosztów poprzez funkcjonalność opisu analitycznego. Funkcjonalność pozwala wygenerować dokument Comarch ERP XL na podstawie danych (kontrahent, elementy dokumentu, dekretacja kosztów na opisie analitycznym) wprowadzonych w kontrolce „Dokument ERP XL”.

Uwaga

Na karcie obiegu może znajdować się tylko jedna kontrolka typu „Dokument ERP XL”.

Zakładka Ogólne

Na właściwościach tej kontrolki można zainicjować pola:

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

Zakładka Dokument ERP XL

Zakładka Dokument ERP XL zawiera kontrolki:

W sekcji „Ustawienia” dostępne są dwa parametry:

W ramach sekcji  „Pola API” dostępne są pola w strukturze API, które po przypisaniu kontrolek i wypełnieniu wartościami na dokumencie umożliwią wygenerowanie dokumentu w systemie Comarch ERP XL.

Zakładka Wartości mapowane

W zależności od ustawienia kontrolki „Tryb pracy” (na zakładce „Dokument ERP XL”) na zakładce „Wartości mapowane” dostępne są jedna (tryb „Dla nagłówka”) lub dwie (tryb „Dla elementu”) sekcje (dwie sekcje są także dostępne dla typu dokumentu (A)Faktura zakupu lub (A)Korekta faktury zakupu) :

Sekcja „Nagłówek”

W tej sekcji znajdują się kontrolki:

oraz pole „Załączniki” z linkiem „Dodaj”, który umożliwia wybór kontrolki typu załącznik, dostępnej w danym typie obiegu, z której zostanie dodany załącznik.

Kontrolki można zmapować z kontrolkami na karcie obiegu (dostępne dla wybranych dokumentów).

Kontrolki „Kontrahent” i „Płatnik” przyjmują wartości:

Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnianej na karcie obiegu do pola Kontrahent na kontrolce „Dokument ERP XL”. Gdy zostanie wybrana wartość Brak, wtedy mapowanie nie zostanie wykonane.

Kontrolka „Wartość netto” przyjmuje wartości:

Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Razem netto na kontrolce „Dokument ERP XL”.

Przeniesiona wartość traktowana jest przez aplikację jako wartość netto całego dokumentu = łączna wartość opisu analitycznego.

Do mapowania wartości zaleca się używanie kontrolek typu „Liczba stałoprzecinkowa”. Dla dokumentów typu A-vista wartość mapowana z Karty obiegu przenosi się do kolumny Cena lub Wartość netto.

Kontrolka „Waluta” przyjmuje wartości:

Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Waluta na kontrolce „Dokument ERP XL”. Gdy zostanie wybrana wartość Brak, wtedy mapowanie nie zostanie wykonane.

Kontrolka „Rachunek bankowy” (dostępna od wersji 2022.0 dla faktury zakupu w trybie nagłówkowym i elementowym, (A) faktury zakupu uproszczonej i (A) faktury zakupu) przyjmuje wartości:

Kiedy w ramach konfiguracji kontrolki ERP XL zostanie wskazana kontrolka, z której pochodzić będzie informacja o numerze rachunku bankowego do formatki ERP XL, wówczas nastąpi automatyczne wpisanie numeru rachunku do kontrolki „Rachunek bankowy” na formatce Dokument ERP XL. Aby mapowanie przebiegło poprawnie, dany rachunek bankowy musi zostać wcześniej przypisany do kontrahenta.

Kontrolka „Opis” przyjmuje wartości:

Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Nazwa na kontrolce Dokument ERP XL. Gdy zostanie wybrana wartość ‘Brak’, wtedy mapowanie nie zostanie wykonane.

Kontrolka „Numer KSeF” przyjmuje wartości:

Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Numer KSeF na kontrolce „Dokument ERP XL”.

Kontrolka „Data KSeF” przyjmuje wartości:

Funkcjonalność umożliwia przeniesienie wartości kontrolki wypełnionej na karcie obiegu do pola Data przyjęcia KSeF na kontrolce „Dokument ERP XL”.

Kontrolka „Załącznik” przyjmuje wartość:

Funkcjonalność pozwala na dołączenie załączników podpiętych do dokumentu w Comarch BPM (dawniej DMS) do wygenerowanego na podstawie kontrolki „Dokument ERP XL” dokumentu w systemie Comarch ERP XL.

Przyklad

W Comarch BPM (dawniej DMS) zdefiniowano obieg dokumentów:

Na karcie obiegu umieszczono trzy kontrolki typu załącznik: Specyfikacja, Skan dokumentu oraz Instrukcja obsługi.

We właściwościach kontrolki typu Dokument ERP XL wskazano wszystkie trzy kontrolki:

Zarejestrowano dokument w Comarch BPM (dawniej DMS), w kontrolkach typu załącznik podpięto kilka dokumentów:

W kontrolce typu Dokument ERP XL wygenerowano dokument FZ w systemie Comarch ERP XL, na dokumencie FZ na zakładce Załączniki  w Comarch ERP XL prezentowane są wszystkie pliki podpięte w kontrolkach, które wskazano we właściwościach kontrolki typu Dokument ERP XL na zakładce Wartości mapowane.

Uwaga

Należy pamiętać, aby:

oraz

w przeciwnym wypadku mapowanie załączników nie będzie możliwe.

W systemie Comarch ERP XL załączniki prezentowane są na zakładce Załączniki.

Uwaga

Aplikacja umożliwia wystawianie dokumentów korekt ręcznych tylko wartościowych zarówno z wartościami ujemnymi jak i dodatnimi.

Sekcja Elementy (dostępna w trybie pracy „Dla elementu” – chyba, że wybrano typ „Spinacz nagłówkowy faktury zakupu” lub „Nota memoriałowa” – oraz dla typów: (A)Faktura zakupu i (A)Korekta faktury zakupu, jeśli na zakładce „Dokument ERP XL” w polu „Sposób dodawania pozycji” wybrano opcję „Tabela elementów”)

W tej sekcji znajdują się kontrolki:

Sekcja Tabela VAT (od wersji 2024.1.0; dostępna tylko dla typów: (A)Faktura zakupu i (A)Korekta faktury zakupu, jeśli na zakładce „Dokument ERP XL” w polu „Sposób dodawania pozycji” wybrano opcję „Tabela VAT”)
W tej sekcji znajdują się kontrolki:

Uwaga

Jeśli operator wybrał daną kolumnę typu Liczba stałoprzecinkowa w polu „Wartość netto”, Wartość VAT” lub „Wartość brutto”, wówczas ta sama kolumna nie może zostać wybrana w pozostałych dwóch polach.

Operator powinien uzupełnić dwa z trzech pól („Wartość netto”, Wartość VAT”, „Wartość brutto”), zaś wartość w trzecim polu zostanie wyliczona na podstawie tych dwóch pól – dlatego nad tymi polami widoczna jest informacja „Wybierz dwie z poniższych wartości, trzecia zostanie automatycznie wyliczona w tabeli VAT”.

Jeśli operator uzupełni wszystkie trzy pola: Wartość netto”, Wartość VAT”, „Wartość brutto”, wówczas informacja „Wybierz dwie z poniższych wartości, trzecia zostanie automatycznie wyliczona w tabeli VAT” zostaje wyświetlona na czerwono, ponieważ wskazano już dwie wartości mapowane.

Szczegółowe informacje przedstawiono poniżej w podrozdziale Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej.

Uzupełnianie wartości formatki Dokument ERP XL wartościami z kontrolki tabelarycznej

Istnieje możliwość przenoszenia wartości wprowadzonych do kontrolek tabelarycznych na formatkę „Dokumenty ERP XL”.

Aktualnie wszystkie mechanizmy mapujące mogą działać „online” (przenoszą dane do otwartej formatki „Dokumenty ERP XL”).

Wskazówka

W mechanizmie przenoszenia wartości z kontrolki „Dane tabelaryczne” do formatki „Dokumenty ERP XL” można włączyć tryb wskazywania wierszy.

Dzięki temu tylko oznaczone elementy zostaną przeniesione do formatki „Dokumenty ERP XL”. Mechanizm można wykorzystać np. w częściowej realizacji zamówienia.

Aby włączyć tryb wskazywania wierszy, należy dodać w kontrolce typu dane tabelaryczne, z której będą mapowane wartości, kolumnę typu Wartość logiczna (np. „Czy zatwierdzono”) i wybrać opcję „Tak” w polu Wybór wierszy. Wówczas na kontrolkę typu Dokument ERP XL zostaną zmapowane wartości tylko z tych wierszy, dla których zaznaczono checkbox w kolumnie typu Wartość logiczna.

Pole „Wybór wiersza”

Wybór wierszy, które mają zostać zmapowane do kontrolki typu Dokument ERP XL – gdy wybrano opcję „TAK” w polu „Wybór wierszy” w kontrolce typu Dane tabelaryczne

Mechanizm przenoszenia wartości z kontrolki „Dane tabelaryczne” do formatki „Dokumenty ERP XL” działa na wszystkich platformach Comarch BPM (dawniej DMS).

Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL

Przyklad

Przykład przenoszenia wartości z wybranych kontrolek oraz z kontrolki typu dane tabelaryczne

Operator:

Przykładowe kolumny w kontrolce typu Dane tabelaryczne

Przykładowa kontrolka typu Comarch ERP XL- zakładka „Ogólne”

Przykładowa kontrolka typu Comarch ERP XL – zakładka „Dokument ERP XL”

Kontrolka Dokument ERP XL, wskazanie kontrolek, z których będą mapowane wartości do tworzonego dokumentu

Kontrolka Dokument ERP XL, wskazanie elementów kontrolki tabelarycznej (kolumn), z której będą mapowane wartości do tworzonego dokumentu

Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL – zakładka „Dokument” – po lewej zaznaczono kontrolki, z których mapowano wartości, a po prawej – pola, do których mapowano wartości z kontrolek

Mapowanie wartości z kontrolek do kontrolki typu Dokument ERP XL – zakładka „Opis analityczny” – po lewej zaznaczono kontrolkę, z której mapowano wartość, a po prawej – pole, do którego mapowano wartość z kontrolki

Zmapowany załącznik po wygenerowaniu dokumentu do Comarch ERP XL

W wersji 2018.1 udostępniono możliwość określania czy na danym etapie obiegu dane będą mapowane do kontrolki ‘Dokument ERP XL’.

Na zakładce Kontrolki na etapie definiowanego procesu prezentowana jest właściwość nazwa_kontrolki (mapowanie). Zaznaczenie parametru ‘Widoczna’ powoduje, że w etapie dane będą mapowane do kontrolki, odznaczenie parametru wyłącza mapowanie na tym etapie.

Etap obiegu dokumentów, włączone mapowanie danych z karty obieg

Generowanie dokumentu (S)FZ – Spinacza nagłówkowego faktury zakupu

W przypadku spinacza nagłówkowego faktury zakupu w kontrolce typu Dokument ERP XL dostępne są zakładki:

Zakładka Ogólne
Na właściwościach tej kontrolki można zainicjować pola:

Zakładka Dokument ERP XL

Zakładka Dokument ERP XL zawiera kontrolki:

Typ dokumentu w kontrolce Dokument ERP XL: Spinacz nagłówkowy faktury zakupu

W wersji 2026.0.0 wprowadzono możliwość generowania dokumentów typu (S)FZ (spinacz nagłówkowy zakupu) z poziomu Comarch BPM do Comarch ERP XL Operator może utworzyć dokument spinacza nagłówkowego, do którego można dodać jako pozycje dokumentu dokumenty PZ z Comarch ERP XL. Na formatce Dokument ERP XL widoczne są numery dokumentów oraz pozycje dokumentów, które dodano do spinacza.

Spinacz nagłówkowy faktury zakupu w aplikacji desktop Comarch BPM

Formatka spinacza nagłówkowego faktury zakupu w aplikacji desktop

Od wersji 2026.0.0 formatka spinacza nagłówkowego faktury zakupu składa się z następujących 3 zakładek:

Widok formatki spinacza nagłówkowego faktury zakupu

Zakładka „Spinacz faktury”

Zakładka, na której znajdują się:

Komunikat wyświetlony w przypadku, gdy dla danego dokumentu PZ, który operator próbuje dodać do listy elementów na formatce Dokument ERP XL, nie ustalono wartości dostawy

Zakładka „Spięte dokumenty”

Zakładka, na której może zostać wyświetlony dokument PZ.

Aby wybrać dany dokument PZ spośród dokumentów dodanych na zakładce „Spinacz faktury”, należy w ramach pola „Wyświetl dokument” wybrać daną pozycję – wówczas poniżej zostanie wyświetlona zawartość tego dokumentu.

Uwaga

Zmiana wartości w polach na dokumentach w zakładce „Spięte dokumenty” nie jest możliwa.

Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu – przed wyborem dokumentu

Widok zakładki „Spięte dokumenty” na formatce spinacza nagłówkowego faktury zakupu – po wyborze dokumentu

Zakładka „Opis analityczny”

Zakładka działa analogicznie jak dotychczas na dokumencie spinacza faktury. W ramach tej zakładki operator może utworzyć i dodać opis analityczny do tworzonego dokumentu (S)FZ. Opis analityczny może być aktualizowany oraz uzupełniany również po wygenerowaniu dokumentu (S)FZ do Comarch ERP XL. W ramach opisu analitycznego uwzględnione są pozycje wszystkich dokumentów PZ, które dodano do spinacza faktury.

Widok zakładki „Opis analityczny” na formatce spinacza nagłówkowego faktury zakupu – uwzględnione są wszystkie spięte dokumenty PZ

Generowanie dokumentu (S)FZ do Comarch ERP XL z poziomu aplikacji desktop

Od wersji 2026.0.0 proces generowania dokumentu (S)FZ do Comarch ERP XL w aplikacji desktop Comarch BPM ma następujący przebieg:

Uwaga

W odróżnieniu od pracy z dokumentem (S)FZ w wersjach wcześniejszych niż 2026.0.0 operator:

W przypadku, jeżeli:

Komunikat wyświetlany, gdy próbowano dodać dokument, który dodano już do innego spinacza nagłówkowego

Komunikat wyświetlany, gdy próbowano dodać dokument z bufora do spinacza nagłówkowego

Komunikat wyświetlany, gdy próbowano dodać dokument inny niż PZ do spinacza nagłówkowego

Dołączanie dokumentu (S)FZ z Comarch ERP XL do kontrolki typu Dokument ERP XL w aplikacji desktop Comarch BPM

Dołączanie dokumentu spinacza nagłówkowego faktury zakupu (wiązanie dokumentów) jest analogiczne jak w przypadku innych typów dokumentów, a mianowicie:

Widok komunikatu pokazującego różnice pomiędzy dokumentem w Comarch BPM i w Comarch ERP XL

W ramach komunikatu, który porównuje wartości na danym dokumencie w Comarch ERP XL i Comarch BPM, sprawdzane są następujące wartości:

W wersji 2026.0.1 udostępniono opcję dodawania dokumentów PZK do dokumentów typu spinacz nagłówkowy faktury zakupu generowanych z Comarch BPM do Comarch ER XL.

Operator może dodać dokument PZK analogicznie jak PZ, w tabelce „Spięte dokumenty” na zakładce „Spinacz faktury” na formatce „Dokument ERP XL” (aplikacja desktop) lub w tabeli „Dokumenty“ na formatce „Dokument ERP XL” (aplikacja web). Podobnie, jak w przypadku dokumentu PZ, może również podejrzeć zawartość dokumentu na zakładce „Spięte dokumenty” i dodać dla niego opis analityczny na zakładce „Opis analityczny”.

Widok zakładki „Spinacz faktury“ na formatce „Dokument ERP XL“, gdy w tabeli „Spięte dokumenty“ dodano dokument PZK (aplikacja desktop)

Widok zakładki „Spięte dokumenty“ na formatce „Dokument ERP XL“, gdy w polu „Spięty dokument“ wybrano dokument PZK (aplikacja desktop)

Widok zakładki „Opis analityczny“ na formatce „Dokument ERP XL“, gdy wybrano pozycje dla dokumentu PZK (aplikacja desktop)

Generowanie dokumentu z poziomu formatki „Dokument ERP XL” bez opisu analitycznego

W kontrolce „Dokument ERP XL” istnieje opcja generowania dokumentów z opisem analitycznym.

Po zaznaczeniu na właściwościach kontrolki opcji „Generowanie dokumentu bez OA”, system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego.

Jeżeli opis zostanie wprowadzony, dokument zostanie wygenerowany z opisem analitycznym.

Przy odznaczonej opcji „Generowanie dokumentu bez OA” system wymaga aby opis analityczny był wprowadzony.

Ustawienia kontrolki „Dokument ERP XL” – parametr „Generowanie dokumentu bez OA”

Przy odwiązywaniu dokumentu z formatki „Dokument ERP XL” pozostaw w dokumentach powiązanych

Z poziomu formatki „Dokument ERP XL” istnieje możliwość odwiązania dokumentu ERP XL za pomocą przycisku .

Funkcjonalność ta jest powiązana z kontrolką typu „Dokumenty związane” oraz formatką ERP XL „Historia związanych”.

W momencie odwiązywania dokumentu usuwane są informacje o powiązaniu obu dokumentów.

Po zaznaczeniu na właściwościach kontrolki „Dokument ERP XL” opcji „Po odwiązaniu pozostaw w dokumentach związanych”, informacja o związaniu dokumentów nie jest usuwana.

Ustawienia kontrolki „Dokument ERP XL” – Parametr  „Po odwiązaniu pozostaw w dokumentach związanych”

Dokument ERP XL przed odwiązaniem dokumentu, przy zaznaczonym parametrze „Po odwiązaniu pozostaw w dokumentach związanych”

Dokument ERP XL po odwiązaniu dokumentu, przy zaznaczonym parametrze „Po odwiązaniu pozostaw w dokumentach związanych”

W sytuacji, gdy w kontrolce Dokument ERP XL za pomocą przycisku nastąpi próba odpięcia dokumentu wygenerowanego w systemie Comarch ERP XL, wyświetlany jest komunikat jak poniżej:

Komunikat wyświetlany w aplikacji desktop po kliknięciu w przycisk „Odwiąż dokument”

Wybranie odpowiedzi „Tak”, spowoduje odwiązanie dokumentu, wybranie odpowiedzi „Nie” lub kliknięcie poza komunikatem spowoduje zamknięcie komunikatu i powrót do edycji dokumentu.

Edycja wartości w kontrolce Dokument ERP XL

W Comarch BPM (dawniej DMS) umożliwiono edycję wartości w kolumnach:

na dokumencie ERP XL.

Zmiana wartości w jednej z tych kolumn powoduje przeliczenie wartości w pozostałych kolumnach.

Funkcjonalność dostępna jest dla typów dokumentów:

Od wersji 2024.1.0 dla typów dokumentów: (A)Faktura zakupu i (A)Korekta faktury zakupu w przypadku, jeśli w ramach pola „Sposób dodawania pozycji” na zakładce „Dokument ERP XL” wybrano opcję „Tabela VAT”, możliwa jest również edycja wartości w kolumnach:

Dokument ERP XL – edycja wartości

Parametr ‘Cena z dokładnością do groszy’

Na dokumencie ERP XL udostępniono parametr ‘Cena z dokładnością do groszy’.

Zaznaczenie parametru powoduje zaokrąglanie wprowadzonej ceny netto i brutto do dwóch miejsc po przecinku.

Odznaczenie parametru pozwala użytkownikowi na wprowadzenie ceny netto i ceny brutto z dokładnością do sześciu miejsc po przecinku.

W przypadku, gdy:

i

dla dokumentów:

cena będąca podstawą naliczania VAT będzie zaokrąglana analogicznie jak w Systemie Comarch ERP XL.

Zaznaczenie w Comarch ERP XL parametru ‘Rabaty liczone od ceny’ umożliwi wprowadzanie wartości z dokładnością do sześciu miejsc po przecinku.

Zaznaczony parametr "Rabaty liczone od ceny" w Comarch ERP XL

Parametr "Cena z dokładnością do groszy"

Dokument ERP XL i (A)FZ gdy zaznaczono ‘Rabaty liczone od ceny’  w Comarch ERP XL i  odznaczono ‘Cena z dokładnością do groszy’ w Comarch BPM (dawniej DMS)

Prezentacja numeru rachunku bankowego kontrahenta w kontrolce Dokument ERP XL

Uwaga

Funkcjonalność dostępna jest w Comarch DMS w wersji 2019.0 we współpracy z Comarch ERP XL do wersji 2018.2.
Funkcjonalność jest znowu dostępna od wersji Comarch DMS 2020.2.2. we współpracy z Comarch ERP XL w wersjach nowszych niż 2019.0.

W kontrolce typu Dokument ERP XL prezentowany jest numer rachunku bankowego. Dane płatnika pobierane są na podstawie informacji zawartych na karcie kontrahenta wskazanego w polu Kontrahent.

Pole zawierające Rachunek bankowy zostało udostępnione dla dokumentów: FZ, (A)FZ i dla uproszczonej (A)FZ.

W przypadku, gdy na karcie kontrahenta ustawiono płatnika będącego urzędem, pracownikiem lub bankiem pole Rachunek bankowy jest nieaktywne i nie prezentuje danych.

W przypadku, gdy do kontrolki typu Dokument ERP XL dowiązano istniejący dokument z systemu Comarch ERP XL, pole Rachunek bankowy jest nieaktywne i nie prezentuje danych.

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

+ Mam problem z tym tematem Otwórz w portalu bazy wiedzy »