Wydruki w systemie xSale pozwalają szybko wygenerować dokument w formacie PDF na podstawie danych w systemie, na przykład dla zamówienia lub listy zamówień. To rozwiązanie przydaje się wtedy, gdy potrzebujesz czytelnego podglądu danych, wydruku do weryfikacji albo dokumentu do przekazania dalej.
Wzorcowe dane w plikach JSON
Poniżej znajdziesz plik zawierający wzorcowy zestaw danych, które możesz wykorzystać podczas samodzielnego przygotowania szablonu wydruku w pliku .jasper.
Pobierz i rozpakuj archiwum .zip. Aktualnie udostępniamy JSON dla wydruku z zamówienia oraz z listy zamówień.
Najczęściej używane pola w JSON
Dane przekazywane do Jaspera są umieszczane w węźle objectData.
Dla pojedynczego zamówienia najczęściej używane ścieżki to:
objectData.Id– ID zamówienia,objectData.ForeignNumber– numer zewnętrzny zamówienia,objectData.TotalValueNet– łączna wartość netto zamówienia,objectData.TotalValueGross– łączna wartość brutto zamówienia,objectData.Items[]– lista pozycji zamówienia,objectData.Items[].PriceNet– cena netto pozycji, jeśli jest dostępna,objectData.Items[].PriceGross– cena brutto pozycji,objectData.Items[].OrderItemArticles[]– dane artykułów powiązanych z pozycją.
Dla wydruku z listy zamówień dane zamówień znajdują się w tablicy objectData.Orders[]. Odpowiednie pola mają wtedy analogiczne ścieżki, na przykład objectData.Orders[].TotalValueNet.
Jawna wartość netto dokumentu
Jeżeli na wydruku potrzebujesz całkowitej wartości netto dokumentu, użyj pola:
objectData.TotalValueNet– dla wydruku pojedynczego zamówienia,objectData.Orders[].TotalValueNet– dla wydruku z listy zamówień.
To jest jawna wartość netto całego dokumentu przekazywana w aktualnym wzorcowym JSON.
Stawka VAT dla pozycji
W aktualnym wzorcowym JSON nie ma osobnego pola z procentową stawką VAT pozycji w rodzaju VatRate.
Dla pozycji i artykułów powiązanych dostępne są natomiast między innymi pola:
objectData.Items[].PriceNet,objectData.Items[].PriceGross,objectData.Items[].OrderItemArticles[].NetPrice,objectData.Items[].OrderItemArticles[].Price,objectData.Items[].OrderItemArticles[].VatId.
Oznacza to, że w aktualnym JSON możesz bezpośrednio odczytać identyfikator stawki VAT jako VatId, ale nie ma dedykowanego pola z jawną wartością procentową stawki, na przykład 23 lub 8.
Jeżeli potrzebujesz na wydruku pokazać procentową stawkę VAT, zwróć uwagę na dwie kwestie:
- gdy w danych pozycji dostępne są jednocześnie wartości netto i brutto, można obliczyć stawkę w samym szablonie Jaspera,
- jeżeli w danym przypadku w JSON pojawia się tylko
VatId, a nie ma odpowiadającej mu wartości procentowej, sam wzorcowy JSON nie wystarcza do wyświetlenia jawnej stawki VAT bez dodatkowego mapowania.
Ważne ograniczenie
Szablon .jasper powinien korzystać tylko z pól faktycznie dostępnych w przekazywanym JSON. Jeśli odwołasz się do pola, którego nie ma we wzorcowych danych, wydruk może się nie wygenerować poprawnie.
