W wersji 2026.1.0 wprowadzono funkcjonalność automatycznego uzupełniania dokumentów typu Spinacz nagłówkowy faktury zakupu (S)FZ danymi z dokumentów magazynowych (PZ i PZK). Rozwiązanie to przenosi ciężar weryfikacji i wprowadzania danych z poziomu systemu Comarch ERP XL bezpośrednio do zamodelowanego procesu obiegu dokumentów w Comarch BPM .
Głównym celem zmiany jest automatyzacja procesu rozliczeń poprzez zastąpienie ręcznego mapowania dokumentów w systemie Comarch ERP XL automatycznym mapowaniem na podstawie listy przygotowanej w aplikacji Comarch BPM.
Konfiguracja kontrolki typu Dane tabelaryczne
Zalecana jest następująca konfiguracja kontrolki typu Dane tabelaryczne „ DokumentyPZ“ (identyfikator: DokumentyPZ):
- „ListaPZ” (identyfikator kolumny: ListaPZ) – typ Lista; w polu „Listy” należy wybrać listę „ListaPZ” skonfigurowaną zgodnie z poniższym opisem;
- „PZ” (identyfikator kolumny: PZ) – typ Dokument elektroniczny; w polu „Typ” należy wybrać „Przyjęcie zewnętrzne”
- „Kontrahent” (identyfikator kolumny: Kontrahent) – typ Kontrahent
- „Netto” (identyfikator kolumny: Netto) – typ Liczba stałoprzecinkowa
- „Waluta” (identyfikator kolumny: Waluta) – typ Tekst (symbol waluty)
- „KosztUstalono” (identyfikator kolumny: KosztUstalono) – typ Wartość logiczna; mapowana z pola TrN_KosztUstalono, informująca o ustaleniu kosztu dostawy.
Konfiguracja kontrolki typu Dane tabelaryczne – zakladka „Ogólne“
W ramach zakładki „Listy” należy dodać listę o nazwie „ListaPZ”, a następnie w ramach konfiguracji tej listy:
- w polu „Inicjowanie” wybrać „SQL ERP”
- w polu „Rodzaj identyfikatora” wybrać „Int”
- kliknąć w przycisk „Ustaw” i wprowadzić podstawowe zapytanie SQL pobierające listę dokumentów PZ/PZK:
SELECT
trn_gidnumer,
cdn.numerdokumentu(trN_GIDTyp, TrN_SpiTyp, Trn_TRNTyp, TrN_TrNNumer, TrN_TrNRok, TrN_TrNSeria, TrN_trNMiesiac)
FROM
cdn.TraNag
WHERE
Trn_GIdTyp IN (1489, 1497)
AND TrN_SpiTyp = 0
AND TrN_TrNTyp = 2
AND TrN_Stan = 5
AND TrN_SpiNumer = 0
AND TrN_SpiFirma = 0
AND TrN_SpiLp = 0
AND TrN_KosztUstalono = 1
- w polu „Tryb pracy” wybrać „Lista”
Konfiguracja kontrolki typu Dane tabelaryczne – zakladka „Listy“
W ramach zakładki „Inicjowanie wartości”:
- w polu „Kontrolki powiązane” kliknąć „Dodaj” i wybrać kontrolkę „DokumentyPZ”
- w polu „Wzór na wartość” wybrać „SQL ERP”, a następnie kliknąć „Ustaw” i wprowadzić następujące zapytanie:
IF @DokumentyPZ_Column@ = 1
BEGIN
/*[1] Zapisanie GID dokumentu PZ do kolumny PZ_ID w celu dalszych zapytań*/
UPDATE @DokumentyPZ@ SET [PZ_ID] = (
SELECT [ListaPZ] FROM @DokumentyPZ@ WHERE POS = @DokumentyPZ_Row@
)
WHERE POS = @DokumentyPZ_Row@
/* [2] Pobranie Kontrahenta (Knt_GidNumer) z tabel nagłówkowych ERP XL*/
UPDATE @DokumentyPZ@ SET [Kontrahent] =(
SELECT Knt_GidNumer FROM cdn.TraNag
JOIN cdn.kntkarty ON TrN_KntNumer = Knt_GIDNumer
WHERE TrN_GIDNumer = [ListaPZ]
)
WHERE POS = @DokumentyPZ_Row@
/*[3] Pobranie Wartości Netto (TrN_NettoP) z tabel TraNag/TraElem*/
UPDATE @DokumentyPZ@ SET [Netto] = (
SELECT TOP 1 TrN_NettoP
FROM cdn.TraNag
JOIN cdn.TraElem ON TrE_GIDNumer = TrN_GIDNumer
WHERE TrN_GIDNumer = [ListaPZ]
)
WHERE POS = @DokumentyPZ_Row@
/*[4] Pobranie Wartości Waluta (TrN_Waluta) z tabel TraNag/TraElem*/
UPDATE @DokumentyPZ@ SET [Waluta] = (
SELECT TrN_Waluta
FROM cdn.TraNag
WHERE TrN_GIDNumer = [ListaPZ]
)
WHERE POS = @DokumentyPZ_Row@
/*[5] Pobranie Wartości KosztUstalono (TrN_KosztUstalono) z tabel TraNag/TraElem*/
UPDATE @DokumentyPZ@ SET [KosztUstalono] = (
SELECT TrN_KosztUstalono
FROM cdn.TraNag
WHERE TrN_GIDNumer = [ListaPZ]
)
WHERE POS = @DokumentyPZ_Row@
/* [6] Odświeżenie wiersza w kontrolce Dane tabelaryczne */
SELECT * FROM @DokumentyPZ@
END
Konfiguracja kontrolki typu Dane tabelaryczne – zakladka „Inicjowanie wartości“
Po poprawnym skonfigurowaniu kontrolki typu Dane tabelaryczne należy przejść do konfiguracji kontrolki typu Dokument ERP XL (zob. Zmiany w konfiguracji kontrolki typu Dokument ERP XL).
Zmiany w konfiguracji kontrolki typu Dokument ERP XL
W wersji 2026.1.0 w aplikacji desktop Comarch BPM, w definicji kontrolki typu Dokument ERP XL o typie „Spinacz nagłówkowy faktury zakupu”, na zakładce „Wartości mapowane” dodano nową sekcję Elementy . W jej ramach dostępne są dwa pola:
- Lista Elementów – pole, w którym należy wybrać kontrolkę typu Dane tabelaryczne (DT) zawierającą listę dokumentów PZ/PZK .
- Spięte dokumenty – pole, w którym należy wybrać kolumnę typu Dokument elektroniczny, dla której w polu „Typ” wybrano „Przyjęcie zewnętrzne” (typ 1489 w Comarch ERP XL). Kolumna znajduje się w kontrolce typu Dane tabelaryczne wybranej w polu „Lista Elementów” i służy jako podstawa do mapowania pozycji. Lista dostępnych kolumn zostanie wyświetlona po wybraniu kontrolki typu Dane tabelaryczne w polu „Lista Elementów”
Definicja kontrolki typu Dokument ERP XL, zakładka „Wartości mapowane“, sekcja „Elementy“ – przed uzupełnieniem
Definicja kontrolki typu Dokument ERP XL, zakładka „Wartości mapowane“, sekcja „Elementy“ – po przykładowym uzupełnieniu
Zasady walidacji i mapowania
Proces mapowania jest ściśle powiązany z etapem obiegu dokumentu i ze statusem dokumentów źródłowych. Walidacja odbywa się na otwartym szkicu dokumentu w Comarch BPM, gdy w kontrolce typu Dane tabelaryczne dodawany jest nowy rekord lub następuje aktualizacja dotychczasowego . Aby dokument został poprawnie dołączony do spinacza, musi spełniać następujące kryteria:
- Odpowiedni typ dokumentu: System akceptuje wyłącznie typy 1489 (PZ) oraz 1497 (PZK) – inne typy dokumentów są odpinane i wyświetlony zostaje komunikat o błędzie.
- Zgodność waluty: Waluta dokumentu magazynowego musi być identyczna z walutą spinacza – w innym przypadku nie następuje mapowanie i zostaje wyświetlony komunikat o błędzie.
- Parametr VAT: Parametr „VAT liczony od” musi być zgodny na obu dokumentach – PZ i spinaczu– w innym przypadku nie następuje mapowanie i zostaje wyświetlony komunikat o błędzie.
- Koszt dostawy: Dokument PZ musi mieć ustalony koszt dostawy (TrN_KosztUstalono = 1 w tabeli cdn.TraNag) – w innym przypadku nie następuje mapowanie i zostaje wyświetlony komunikat o błędzie.
- Unikalność powiązania: Dokument PZ nie może być wcześniej spięty z innym spinaczem.
Procedura dodawania korekt (PZK)
Aby poprawnie zmapować dokument korekty, należy zachować odpowiednią kolejność:
- w pierwszej kolejności do listy w kontrolce typu Dane tabelaryczne należy dodać dokument źródłowy (PZ)
- następnie należy dodać docelowy dokument PZK.
System blokuje mapowanie niepowiązanych korekt, sprawdzając czy pole TrN_IdOrg na dokumencie PZK odpowiada polu TrN_GIDNumer na dokumencie PZ znajdującym się na liście. Dokument PZK, który nie ma dołączonego pliku źródłowego, zostaje odpięty.
Mechanizm synchronizacji i aktualizacji danych mapowanych
Funkcjonalność zapewnia dynamiczną wymianę danych między systemami :
- Automatyczne przeliczanie: Każda zmiana w kontrolce typu Dane tabelaryczne (dodanie lub usunięcie wiersza) skutkuje natychmiastowym przeliczeniem wartości netto i brutto w nagłówku spinacza na formatce Dokument ERP XL .
- Aktualizacja zakładek: Dane są mapowane równolegle do dwóch obszarów dokumentu: zakładki „Spinacz faktury” oraz zakładki „Spięte dokumenty” .
- Blokada interfejsu: W momencie aktywnego mapowania, przyciski ręcznego dodawania i usuwania pozycji na zakładce „Spięte dokumenty” na formatce Dokument ERP XL stają się niewidoczne.
Zakres przesyłanych danych mapowanych
W procesie mapowania na zakładkę „Spinacz faktury” system automatycznie uzupełnia następujące pola w tabeli:
- Spięte dokumenty,
- Kontrahent,
- Wartość netto,
- Wartość VAT
- Wartość brutto.
Dane te są pobierane bezpośrednio z dokumentów magazynowych wskazanych w Comarch BPM.
Widok formatki „Dokument ERP XL“ w aplikacji desktop po zmapowaniu danych z tabeli „DokumentyPZ“ – zakładka „Spinacz faktury“
Widok formatki „Dokument ERP XL“ w aplikacji desktop po zmapowaniu danych z tabeli „DokumentyPZ“ – zakładka „Spięte dokumenty“, po wyborze jednego ze spiętych dokumentów
Widok formatki „Dokument ERP XL“ w aplikacji web po zmapowaniu danych z tabeli „DokumentyPZ“ – zakładka „Spinacz faktury“
Widok formatki „Dokument ERP XL“ w aplikacji web po zmapowaniu danych z tabeli „DokumentyPZ“ – zakładka „Spięte dokumenty“, po wyborze jednego ze spiętych dokumentów
Obsługa błędów i komunikacja z operatorem
System generuje przejrzyste komunikaty zbiorcze zarówno w aplikacji Web, jak i Desktop . W przypadku walidacji zbiorczej (podczas otwierania szkicu), operator otrzymuje listę wszystkich dokumentów wraz z podaniem konkretnej przyczyny odrzucenia (np. niezgodność waluty lub brak ustalonego kosztu dostawy). Wiersze z błędnymi rekordami są automatycznie usuwane z kontrolki typu Dane tabelaryczne.