Blog TGSoft

W poprzednich dokumentach opisaliśmy interaktywną pracę programu, gdzie użytkownik korzystał z wybranych funkcji do tworzenia faktur i komunikacji z KSeF.

Teraz zaprezentujemy możliwość pracy ad-hoc z innym programem ERP. W tym celu przygotujemy demonstracyjny projekt za pomocą Visual Studio i C#.

Aby program mógł przyjmować polecenia od aplikacji zewnętrznej, należy uruchomić link-Server przyciskiem [Start] z prawej strony głównej formy aplikacji. Po prawidłowym uruchomieniu usług http, napis Link Server zostanie wyświetlony kolorem niebieskim.

Aplikacja KSeF-link oferuje kilka możliwości generowania e-Faktur w formacie XML dla systemu KSeF. Struktura FA.XML (3) jest bardzo rozbudowana, posiada wielopoziomowe połączenia i dodatkowo niektóre elementy są powtarzalne, nawet wielokrotnie.

W celu uproszczenia wprowadzania danych do Excel, zachowaliśmy prostą formę tabelaryczną przy wykorzystaniu notacji CSV oraz tablic Json. Dwa ostanie sposoby stosowane są w niektórych polach wymagających więcej danych i występujących wielokrotnie.

Większość dodatkowych pól nie będzie stosowana w standardowych fakturach. Zastosowanie „kompaktowego” sposobu prezentacji danych znacznie uprości nasze tabele w zakresie wypełniania oraz wyświetlania i anali

Aplikacja KSeF-link w trybie użytkownika desktop posiada funkcję Menu/Kartoteki SQL/Faktury zakupów/[Import z KSeF].

Kreator importu jest aktywny po zalogowaniu do systemu KSeF. Standardowo importuje faktury z podanego okresu czasu i zapisuje do lokalnej bazy MS SQL Server. Taki zapis zawiera podstawowe dane z nagłówka faktury oraz pełną treść faktury w formie XML. W celu ułatwienia przetwarzania danych takich faktur, kreator zawiera domyślnie włączoną opcję: [Zapisuj szczegóły faktur Zakupu do tabel tymczasowych bazy SQL].

Podczas importu, program dekoduje zawartość XML faktury i zapisuje dane w dedykowanych polach tabel tymczasowych, tych samych które integrator m

W standardowym trybie pracy programu KSeF-link możemy importować i wysyłać seryjnie faktury w formacie Xml. Pliki faktur możesz otrzymać ze swojego systemu ERP, jeżeli ten został już dostosowany do nowego formatu, lub wygenerować w naszej aplikacji np. konwersją danych z pliku Excel.

Skorzystamy z funkcji Menu/Kartoteki SQL/Faktury sprzedaży/[Dodaj faktury]. Lista służy do obsługi faktur sprzedaży, które znajdują się w bazie danych naszej aplikacji (baza MS SQL Server). Jest to główna lokalna lista faktur, zawierająca nagłówek faktury, jej treść w formacie Xml oraz statusy przetwarzania i numery referencyjne KSeF.

Za pomocą przycisku [Dodaj faktury] otwieramy kreator importu. Można wskazać je

KSeF on-line

Aplikacja KSeF-link domyślnie pracuje jako samodzielny program w wersji desktop. Posiada szeroki zakres funkcji do obsługi serwisu KSeF API. W tym trybie, każdy użytkownik bez wiedzy informatycznej może odbierać faktury zakupów, przesyłać faktury sprzedaży, przetwarzać dane pochodzące z serwisu w formie arkuszy Excel lub wydruków. Program służy tutaj jako aplikacja pomocnicza do użytkowanego systemu ERP.

W tym dokumencie opisujemy obsługę rejestru faktur w trybie On-line.

W zakładce Menu/KSeF On-line znajdują się dwie funkcje:

1. Faktury sprzedaży
2. Faktury zakupów

Dokument przedstawia sposób na testowanie struktur Json do generowania faktur w formacie FA.XML (3).

Pod tym adresem na naszej stronie blog opublikowany jest przykład 01 zapisany za pomocą Json. Do jego wykorzystania utworzymy nowy skrypt w Menu/Narzędzia/Projektowanie API.

Dodano nowy skrypt C# API

Za pomocą przycisku [Projektuj] otwieramy Edytor kodu C# i wklejamy poniższy kod:

using System;
u

Jedną z metod generowania e-Faktur FA.XML (3) w programie KSeF-link jest przesłanie danych do naszej aplikacji w uproszczonej strukturze Json. Struktura jest zgodna ze sposobem kodowania w naszym kreatorze konwersji pliku Excel, do seryjnego generowania faktur. Przy czym tutaj przesyłamy dane tylko jednej faktury.

Do budowania i testowania struktury Json, dodaj nowy skrypt do listy: Projektowanie API

using System;
using TGSoft.Utils;
using TGSoft.Ksef;
using TGSoft.Ksef.Ver3;

namespace Szark
{
    public class Class1
    {