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;
using TGSoft.Utils;
using TGSoft.Ksef;
using TGSoft.Ksef.Ver3;

namespace Szark
{
    public class Class1
    {                             
        public Class1(object sender)
        {
        }
        
        public void Main(object jsonParams)
        {
            Json2Faktura j2s = new Json2Faktura(jsonParams.ToStr());
            Faktura fra = j2s.CreateFA();
            if (fra != null)
            {
                //fra.ShowInvoice();
                fra.ShowXmlDialog();                
            }
        }
    }
}

Widok z wklejonym kodem C#

Kolejny przycisk [Parametry Json] otwiera nowy Edytor, do którego wklejamy strukturę z danymi do utworzenia Faktury.XML.

Edytor kodu Json

Wykonanie skryptu przyciskiem [Wykonaj]

Podgląd wygenerowanego XML.

Wynik działania API. Program otwiera okno z wygenerowaną strukturą XML eFaktury w wersji (3). W dolnej części okna są przyciski do wykonania weryfikacji zgodności XML ze schematem XSD (na zdjęciu dolny pasek jest ukryty).

Prezentacja Video wykorzystania danych Json do utworzenia e-Faktury XML

Nagranie Video demonstruje możliwości interaktywnego tworzenia, prezentowania i weryfikowania faktury FA.XML (3). Kolejne części materiału zawierają:

• Załadowanie danych Json do dedykowanego Edytora. W oknie zmieniamy dane w celu uzyskania błędnej składni, co pokaże nam weryfikacja za pomocą przycisku [Sprawdź].
• Wykonanie skryptu powoduje utworzenie i prezentację Faktury w formacie XML, następnie przeprowadzamy kontrolę zgodności ze schematem XSD.
• Otwieramy Edytor ze strukturą Json i celowo zmieniamy dane, aby uzyskać błąd weryfikacji:
  1. Numer NIP nabywcy
  2. Adres email
  3. Datę wystawienia faktury
• Jednocześnie w Edytorze kodu C# zmieniamy na wywołanie rozbudowanego okna dialogowego do prezentacji Faktury, metoda fra.ShowInvoice();
• Prezentacja możliwości zawansowanej wizualizacji Faktury:
  1. Przeglądanie wszystkich danych w kolejnych zakładkach,
  2. Wygenerowana struktura XML,
  3. Weryfikacja zgodności ze schematem XSD w zakładce [Sprawdź Xml], program wskaże wszystkie 3 błędy, a następnie podświetli kolorem żółtym wszystkie błędne linie bezpośrednio w widoku XML,
  4. Ostatnia zakładka [Wydruk PDF] prezentuje wizualizację graficzną faktury. Wygląd faktury jest definiowalny przez użytkownika za pomocą wbudowanego generatora raportów, domyślny projekt (można rozbudować) jest dołączony do programu,
• Wracamy do danych Json i poprawiamy wszystkie błędne, pola: Nip, Email, P_1. Dodatkowo kasujemy dwie pozycje szczegółowe z listy asortymentu faktury, pozostawiamy tylko pierwszą pozycję.
• Zamknięcie Edytora Json, wykonanie projektu i widok nowej faktury z 1 pozycją szczegółową. Weryfikacja nie wykazuje już błędów.
• Uwaga. Parametry Json i wykonanie projektu można obsługiwać z listy projektów lub z okna edycji projektu C#. Podświetlony kolorem niebieskim przycisk [Parametry Json] oznacza, że załadowano strukturę Json i będzie ona przekazana do skryptu C# podczas wykonywania projektu.

Następny dokument 296 : Przeglądanie faktur zakupów i sprzedaży bezpośrednio w systemie KSeF.