🤖 Copilot – Mapowanie pól KSeF
Moduł Copilot 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 Copilot automatycznie wygeneruje kompletną konfigurację mapowania — dobierze odpowiednią sekcję KSeF, tabele źródłowe, kroki mapowania i filtry.
Copilot 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 Copilot | N24KH na stronie Ustawienia KSeF.
- Aktywna funkcja KSeF Field Mapping na stronie Copilot i funkcje AI (Copilot & AI Capabilities) w Business Central.
- Zestaw uprawnień N24KH KSeFMapAdmin przypisany użytkownikowi.
Jak uruchomić Copilot
- Otwórz stronę KSeF Helper — Mapowanie pól KSeF.
- Kliknij akcję Przygotuj przy pomocy Copilot na pasku akcji.
Otworzy się okno dialogowe Copilot 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.
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"
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. Copilot 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) |
| Typ mapowania źródła | Sposób wyznaczania wartości: Z tabel, Wyczyść wartość lub Predefiniowane |
| Poziom zastosowania | Nagłówek lub Wiersz |
| Łączenie wielu wartości | Czy wartości z wielu kroków są łączone separatorem |
Poniżej wyświetlane są:
- Wiersze mapowania – tabela z krokami mapowania (tabela źródłowa, pole relacji, pole wynikowe)
- Ś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 — Copilot przygotuje nową propozycję.
Gotowe podpowiedzi
Okno dialogowe Copilot 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 |
Rozwiązywanie problemów
| Problem | Rozwiązanie |
|---|---|
| Komunikat „Copilot nie jest skonfigurowany" | 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 |