🤖 AI – Mapowanie pól KSeF
Moduł AI umożliwia tworzenie konfiguracji mapowań pól KSeF za pomocą opisu w języku naturalnym. Wystarczy opisać, jakie dane chcesz dodać do faktury KSeF, a AI automatycznie wygeneruje kompletną konfigurację mapowania — dobierze odpowiednią sekcję KSeF, tabele źródłowe, kroki mapowania i filtry.
Moduł korzysta z usługi Azure OpenAI i wymaga wcześniejszej konfiguracji połączenia w ustawieniach KSeF.
Wymagania wstępne
- Skonfigurowane połączenie z Azure OpenAI w sekcji AI na stronie KSeF Helper - Ustawienia.
- Aktywna funkcja KSeF Field Mapping na stronie Copilot i funkcje AI (Copilot & AI Capabilities) w Business Central.
- Zestaw uprawnień N24KSH KSeFMapAdmin przypisany użytkownikowi.
Jak uruchomić AI
- Otwórz stronę KSeF Helper — Mapowanie pól KSeF.
- Kliknij akcję Utwórz mapowanie za pomocą AI na pasku akcji.
Otworzy się okno dialogowe AI z polem opisu i podglądem wyników.
Ważne
Ta funkcja wykorzystuje AI (Azure OpenAI) do generowania konfiguracji mapowań. Wyniki generowane przez AI mogą być niedokładne lub niekompletne — zawsze sprawdź konfigurację przed zapisaniem i włączeniem mapowania.
Informacja
Opis mapowania jest ograniczony do 1500 znaków. AI obsługuje wyłącznie zapytania dotyczące konfiguracji mapowania pól KSeF — pytania niezwiązane z tym tematem zostaną odrzucone z komunikatem błędu.
Jak to działa
Krok 1 – Opisz mapowanie
W polu Opisz mapowanie wpisz w języku naturalnym, jakie dane chcesz dodać do faktury KSeF. Możesz pisać po polsku lub angielsku. Na przykład:
- „Dodaj numer telefonu nabywcy jako dodatkowy opis"
- „Mapuj zewnętrzne oznaczenie klienta jako numer zamówienia"
- „Dodaj kod GTIN z oznaczenia zapasu dla wierszy faktury"
- „Połącz nazwę dostawy, adres, miasto i kod pocztowy w jeden opis z separatorem"
- „Wyczyść kod CN w wierszach faktury"
- „Dodaj numery seryjne jako dodatkowy opis dla wierszy"
- „Dodaj wartości wymiarów MPK i PROJEKT do dodatkowego opisu w wierszach"
- „Sformatuj datę dokumentu jako miesiąc i rok"
- „Mapuj numer umowy z pola Zewn. nr dokumentu jako NrUmowy”
- „Mapuj datę dokumentu jako DataUmowy”
- „Dodaj warunki skonta z pola Opis warunków płatności jako Skonto – warunki” Możesz również wybrać jedną z gotowych podpowiedzi (Prompt Guide), które automatycznie wypełnią pole opisu przykładowym tekstem.
Krok 2 – Wybierz typ dokumentu
W polu Sprzedaż / Serwis wybierz, czy mapowanie ma dotyczyć dokumentów sprzedaży czy serwisowych.
Krok 3 – Wygeneruj konfigurację
Kliknij przycisk Generuj. AI przetworzy Twój opis w dwóch etapach:
- Odkrywanie tabel – AI analizuje opis i określa, z jakich tabel Business Central będzie potrzebować danych.
- Generowanie mapowania – AI tworzy kompletną konfigurację mapowania na podstawie opisu i dostępnych pól w tabelach.
Krok 4 – Przejrzyj wynik
Po wygenerowaniu konfiguracji zobaczysz podgląd z następującymi informacjami:
| Pole | Opis |
|---|---|
| Etykieta wyjściowa | Nazwa pola w XML KSeF — możesz ją edytować przed zapisaniem |
| Typ sekcji KSeF | Docelowa sekcja KSeF (np. DodatkowyOpis, NrZamowienia, GTIN) |
| Obszar dokumentu | Sprzedaż lub Serwis |
| Poziom zastosowania | Nagłówek lub Wiersz. Wyświetlane tylko dla sekcji DodatkowyOpis — dla pozostałych sekcji poziom jest ustalany automatycznie. |
| Typ mapowania źródła | Sposób wyznaczania wartości: Z tabel, Wyczyść wartość lub Predefiniowane (Numery seryjne / Wymiary). Sekcja Źródło wartości jest ukryta dla Numer partii towaru. |
| Łączenie wielu wartości | Czy wartości z wielu kroków są łączone separatorem |
| Wybrane wymiary | Wyświetlane tylko gdy AI wybrało typ Predefiniowane – Wymiary. Pokazuje, które wymiary skrótu (Wymiar 1–8) zostaną dodane do faktury. |
Poniżej wyświetlane są:
- Wiersze mapowania – tabela z krokami mapowania (tabela źródłowa, pole relacji, pole wynikowe, format ciągu)
- Ścieżka mapowania – czytelny opis krokowy, jak system będzie rozwiązywał wartość
Krok 5 – Opcjonalne dostosowania
Przed zapisaniem możesz:
- Zmienić etykietę wyjściową – dostosuj nazwę pola w XML KSeF.
- Włączyć/wyłączyć obsługę faktur korygujących – pole Włącz dla faktur korygujących.
- Skonfigurować filtr rekordów – kliknij pole Filtr rekordu, aby otworzyć standardowy widok filtrowania Business Central i ograniczyć mapowanie do wybranych dokumentów.
Krok 6 – Zapisz lub odrzuć
- Kliknij Zapisz mapowanie, aby zapisać wygenerowaną konfigurację. Mapowanie zostanie dodane do listy mapowań pól KSeF ze statusem Wyłączone — sprawdź je i włącz ręcznie.
- Kliknij Odrzuć, aby porzucić wynik bez zapisywania.
Informacja
Jeśli wynik nie spełnia oczekiwań, możesz zmodyfikować opis i kliknąć Wygeneruj ponownie — AI przygotuje nową propozycję.
Gotowe podpowiedzi
Okno dialogowe AI zawiera zestaw gotowych podpowiedzi, które ułatwiają rozpoczęcie pracy:
| Podpowiedź | Opis |
|---|---|
| Numer telefonu nabywcy | Dodaje nr telefonu klienta z tabeli Nabywca jako DodatkowyOpis |
| Numer zamówienia | Mapuje pole „Zewn. ozn. klienta" jako NrZamowienia |
| Data zamówienia | Mapuje datę dokumentu jako DataZamowienia |
| GTIN dla wierszy | Dodaje kod GTIN z oznaczenia zapasu |
| Indeks produktu | Dodaje indeks z oznaczenia zapasu |
| Odbiorca dostawy | Łączy dane dostawy (nazwa, adres, miasto, kod pocztowy) z separatorem |
| Wyczyść kod CN | Czyści wartość kodu CN w wierszach |
| Numery seryjne | Dodaje numery seryjne jako DodatkowyOpis |
| Nr dokumentu zewnętrznego | Mapuje nr dokumentu zewnętrznego do DodatkowyOpis |
| Wyczyść Nr partii | Czyści wartość Nr partii w wierszach |
| Komentarze sprzedaży | Dodaje komentarze z tabeli Wiersz komentarza sprzedaży |
| Tekst dodatkowy | Mapuje Opis 2 z wiersza faktury |
| E-mail nabywcy | Dodaje adres e-mail klienta do DodatkowyOpis |
| Wymiary dokumentu | Dodaje wartości skonfigurowanych wymiarów skrótu jako DodatkowyOpis |
Rozwiązywanie problemów
| Problem | Rozwiązanie |
|---|---|
| Komunikat „AI nie jest skonfigurowane" | Sprawdź, czy w ustawieniach KSeF wypełnione są pola Endpoint, Deployment i API Key Azure OpenAI, oraz czy funkcja KSeF Field Mapping jest aktywna w Copilot i funkcjach AI |
| Błąd generowania | Sprawdź poprawność endpointu, nazwy wdrożenia i klucza API w ustawieniach. Upewnij się, że zasoby Azure OpenAI są dostępne |
| AI nie znalazło tabeli lub pola | Spróbuj przeformułować opis, używając bardziej precyzyjnych nazw tabel i pól — np. „numer telefonu z tabeli Nabywca" zamiast „telefon klienta" |
| Walidacja nieudana | Przejrzyj komunikaty błędów w sekcji diagnostyki. Najczęstszą przyczyną jest błędna nazwa pola lub tabeli w odpowiedzi AI — wygeneruj ponownie |
| Komunikat „Żądanie nie jest związane z mapowaniem pól KSeF" | AI odrzuciło zapytanie jako niezwiązane z konfiguracją KSeF. Opisz, jakie dane chcesz dodać do faktury KSeF |
| Komunikat „Komunikat jest zbyt długi" | Skróć opis mapowania do maksymalnie 1500 znaków |