JPKEksport

Instrukcja użytkownika programu do eksportu faktur z KCFirma do plików XML JPK_FA(4). Program może również korzystać z Subiekta GT jako dodatkowego źródła danych.

Windows / Win32JPK_FA(4)KCFirmaSubiekt GT — dodatkowo

1. Do czego służy JPKEksport?

JPKEksport odczytuje faktury sprzedaży i korekty z systemu źródłowego i tworzy plik XML w strukturze JPK_FA(4). Dla KCFirma dane są pobierane z bazy Microsoft Access.
Eksport ręcznyWybierasz zakres dat i uruchamiasz generowanie przyciskiem Generuj.
Eksport automatycznyProgram może raz dziennie wykonać eksport za dzień wyliczony z ustawionego opóźnienia.
Faktury i korektyW konfiguracji źródła można zdecydować, które typy dokumentów mają zostać uwzględnione.
Brak sprzedażyJeżeli w okresie nie ma dokumentów, program zapisuje osobny plik-znacznik według skonfigurowanej nazwy.

2. Wymagania

  • Windows zdolny do uruchamiania aplikacji Win32.
  • Dostęp odczytu do bazy źródłowej.
  • Dla KCFirma: sterownik Microsoft Access zgodny z aplikacją i FireDAC MSAcc.
  • Prawo zapisu do katalogu programu oraz katalogu eksportu.
  • Dla Subiekta GT: dostęp do MS SQL Server i właściwy sterownik SQL.
Przed wdrożeniem Wykonaj eksport testowy dla reprezentatywnego okresu i porównaj liczbę dokumentów oraz kwoty z systemem źródłowym.

3. Konfiguracja KCFirma

  1. Otwórz Konfiguracja → Providerzy.
  2. Wybierz kartę KCFirma.
  3. Wskaż ścieżkę do pliku bazy danych KCFirma.
  4. Zaznacz, czy eksport ma obejmować faktury, korekty lub oba rodzaje dokumentów.
  5. Na dole okna ustaw Aktywny provider: KCFirma.
  6. Zapisz konfigurację.

Program korzysta z bazy KCFirma tylko jako źródła danych do eksportu.

4. Ustawienia eksportu

UstawienieZnaczenie
Ścieżka eksportuKatalog, w którym zostaną zapisane pliki wynikowe.
Format nazwyMaska nazwy właściwego pliku XML.
Format nazwy pustyMaska pliku-znacznika tworzonego przy braku sprzedaży.
Punkt sprzedażyOpcjonalna wartość używana w nazwie pliku.
Kod urzędu i dane podmiotuDane wymagane do zbudowania nagłówka i sekcji podmiotu pliku JPK.
Czas auto-eksportuGodzina, po której może zostać wykonany dzienny eksport automatyczny.
Opóźnienie (dni)Liczba dni odejmowana od daty bieżącej przy auto-eksporcie.

Maska nazwy może korzystać m.in. z tokenów {NAZWA}, {NIP}, {PUNKT}, {OD}, {DO} i {TS}.

5. Eksport ręczny

  1. Sprawdź, czy aktywnym źródłem jest właściwy provider.
  2. W głównym oknie ustaw datę od i do.
  3. Kliknij Generuj.
  4. Sprawdź komunikaty w dzienniku programu oraz plik w katalogu eksportu.

6. Eksport automatyczny

Po włączeniu opcji automatycznej program kontroluje harmonogram i wykonuje eksport najwyżej raz dla danego dnia. Eksport dotyczy jednego dnia wyliczonego jako data bieżąca minus skonfigurowane opóźnienie.

Przykład: przy opóźnieniu 1 dzień program uruchomiony 16 sierpnia wygeneruje automatyczny eksport za 15 sierpnia.

Zamknięcie głównego okna może pozostawić aplikację działającą w zasobniku systemowym. Pełne zakończenie wykonuje się poleceniem Zakończ.

Jeżeli auto-eksport zakończy się błędem, sprawdź dziennik i wykonaj eksport ręczny. Bieżąca wersja nie wykonuje automatycznej kolejnej próby tego samego dnia.

7. Pliki wynikowe

Jeśli znaleziono dokumenty, program tworzy plik XML JPK_FA(4). Jeśli w zadanym okresie nie ma faktur, zamiast pustego JPK zapisuje plik-znacznik według osobnej maski nazwy.

Kontrola wyniku Po wdrożeniu porównuj liczbę dokumentów i wartości z raportami źródłowymi oraz waliduj plik XML w stosowanym przez Ciebie procesie księgowym.

8. Dodatkowe źródło: Subiekt GT

JPKEksport ma również provider dla Subiekta GT. Konfiguracja obejmuje serwer SQL, użytkownika, hasło, bazę, typy dokumentów oraz sposób filtrowania daty. Można również wybrać wariant pozycji netto/brutto.

Ochrona konfiguracji Dane połączenia SQL są przechowywane w pliku konfiguracyjnym programu. Ogranicz dostęp do katalogu aplikacji uprawnieniami Windows.

Obsługa Subiekta GT jest funkcją dodatkową. Głównym kontekstem publikacji tego narzędzia na stronie ADI jest współpraca z KCFirma.

9. Najczęstsze problemy

ObjawCo sprawdzić
Brak połączenia z KCFirmaŚcieżkę pliku bazy, prawa dostępu oraz właściwy sterownik Access.
Brak pliku wynikowegoKatalog eksportu, prawa zapisu oraz komunikaty w dzienniku.
Powstał plik „BRAK SPRZEDAŻY”Czy w wybranym okresie rzeczywiście istnieją dokumenty i czy właściwe typy dokumentów są zaznaczone.
Auto-eksport się nie wykonałCzy opcja jest włączona, godzinę, opóźnienie oraz dziennik. W razie błędu wykonaj eksport ręczny.
Kwoty lub dokumenty nie zgadzają sięNie używaj pliku bez weryfikacji. Porównaj zakres dat, filtry, typy dokumentów oraz raport ze źródła.