W niniejszym artykule przedstawiono aktualne uzupełnienia i zmiany w modelu obiektowym dokumentu (DOM) w poszczególnych release’ach.
Zmiany te nie mają wpływu na istniejące implementacje. Zapewniona jest kompatybilność wsteczna modelu DOM. Jeśli dana zmiana wpływa na kompatybilność wsteczną, zostanie to oddzielnie zaznaczone.
Zmiany są zazwyczaj konieczne w związku z wdrażaniem nowych krajów objętych fiskalizacją. Aby spełnić wymogi fiskalizacji w tych dodatkowych krajach za pośrednictwem RetailForce Middleware, zaleca się dostosowanie istniejących implementacji oraz przeniesienie nowych pól do RetailForce Middleware w przyszłości, o ile są one dostępne w systemie nadrzędnym.
Elementy
Poniższa tabela przedstawia, jakie zmiany w poszczególnych elementach DOM zostały wprowadzone lub usunięte w poszczególnych wersjach.
|
DOM – wersja |
Obiekt DOM | Miejsce | Zmiana | Release |
| 1.7.0 | SystemEntryDate | Dokument | Ze względu na wymogi obowiązujące w Portugalii wprowadzono pole SystemEntryDate, przeznaczone przede wszystkim dla faktur (w przypadku których data wystawienia faktury różni się od daty zaksięgowania). | 1.11.16 |
| 1.5.2 | IsBusiness | Partner | Ze względu na wymogi obowiązujące we Francji pole „partner.IsBusiness” jest sprawdzane pod kątem poprawności w wersjach przeznaczonych dla klientów francuskich. | 1.9.1 |
| 1.5.2 | BaseTaxValue2 | Pozycja ItemBase |
Wartość „BaseTaxValue2” określa wartość (przed uwzględnieniem rabatu lub dopłaty) drugiej stawki podatkowej. | 1.9.0 |
| 1.5.2 | VatPercent2 | Pozycja ItemBase |
W polu VatPercent2 można określić drugą stawkę podatku. Jest to wymagane na przykład w prowincji Quebec (Kanada). | 1.9.0 |
| 1.5.2 | AdditionalTax | Pozycja ItemBase |
Za pomocą parametru AdditionalTax można określić podatki dodatkowe, takie jak na przykład podatki nakładane w niektórych krajach na alkohol lub wyroby tytoniowe. | 1.9.0 |
| 1.5.2 | TaxValue | Pozycja ItemBase |
TaxValue2 określa wartość (po uwzględnieniu rabatu lub dopłaty) drugiej stawki podatkowej. | |
| 1.5.2 | ItemType | Pozycja ItemBase |
ItemType określa rodzaj pozycji – towary lub usługi
|
1.8.18 |
| 1.5.0 | DocumentIssueType | Dokument | Określa rodzaj wydania dokumentu (papierowy, cyfrowy, papierowy i cyfrowy, niewydany) | 1.8.8 |
| 1.5.0 | ServiceType | Dokument | Określenie rodzaju usługi (obsługa przy stoliku, obsługa przy ladzie) wraz ze szczegółowym opisem „czynności” | 1.8.8 |
| 1.5.0 | Transakcja e-commerce | Dokument | Wskazanie, czy transakcja ma charakter transakcji e-commerce | 1.8.8 |
| 1.5.0 | Unikalny ID kasy fiskalnej | Dokument |
Unikalny ID cashregistera jest zapisywany w dokumencie od wersji DOM 1.5.0, jednak pole Configuration.Cashregister.Id zostało usunięte z konfiguracji. W ramach integracji z Warrify. |
1.8.8 |
| 1.5.0 | Konfiguracja |
Nieaktualne do odwołania. W ramach integracji z Warrify. |
1.8.8 | |
| 1.5.0 | TerminalSlaveId | Dokument | Opcja umożliwiająca określenie ID stacji wejściowej (urządzenia podrzędnego) podłączonej do elektronicznego systemu rejestracji. | 1.8.8 |
| 1.5.0 | footerGraphicIndex | Dokument | Za pomocą parametru footerGraphicIndex w stopce dokumentu umieszczany jest predefiniowany element graficzny. | 1.8.8 |
| 1.5.0 | AdditionalHeader | Dokument | Dodatkowy tekst w hederze dowodu księgowego (dodany w ramach rozszerzenia funkcjonalności drukowania dokumentów we Włoszech). | 1.8.8 |
| 1.5.0 | AdditionalFooter | Dokument | Dodatkowy tekst w Footer dokumentu (dodany w ramach rozszerzenia funkcjonalności drukowania dokumentów we Włoszech). | 1.8.8 |
| 1.5.0 | Coupon | Dokument | Dodano opcję drukowania dodatkowych kuponów na paragonie (funkcja wprowadzona w ramach ulepszeń dotyczących drukowania dokumentów we Włoszech). | 1.8.8 |
| 1.5.0 | IsBusiness | Partner | Zdefiniowano, że „partner” (= klient) jest klientem biznesowym. | 1.8.8 |
| 1.5.0 | Dodatkowa identyfikacja | Partner |
Przekazywanie dodatkowych ID, takich jak:
|
1.8.8 |
| 1.5.0 | VatPercentage2 | Vat | Określenie dodatkowej stawki podatkowej (rozszerzenie dla krajów stosujących więcej niż jedną stawkę podatkową – np. GST i QST w prowincji Québec w Kanadzie). | 1.8.8 |
| 1.5.0 | VatPercent2 | Pozycja | Przekazanie dodatkowej stawki podatkowej dla danej pozycji (rozszerzenie dla krajów stosujących więcej niż jedną stawkę podatkową – np. GST i QST w prowincji Québec w Kanadzie). | 1.8.8 |
| 1.5.0 | AdditionalTaxType | Pozycja. AdditionalTax | Wskazanie podatków dodatkowych (alkohol, tytoń, NOVA (podatek samochodowy w Austrii), inne) | 1.8.8 |
| 1.5.0 | Identyfikator AdditionalTaxType | Pozycja. AdditionalTax | Szczegóły dotyczące podatku dodatkowego; pole obowiązkowe, jeśli wartość pola AdditionalTaxType wynosi „inne”. | 1.8.8 |
| 1.5.0 | TaxPercent | Pozycja. AdditionalTax | Wskazanie stawki (w procentach) podatku dodatkowego. | 1.8.8 |
| 1.5.0 | TaxValue | Pozycja. AdditionalTax | Wskazanie kwoty dodatkowej stawki podatkowej. | 1.8.8 |
| 1.5.0 | BusinessSector | FiscalClient | Określenie obszaru działalności (dziedziny działalności). | 1.8.8 |
| 1.5.0 | CardData | Płatności | można wykorzystać do drukowania potwierdzeń transakcji kartą kredytową dla klienta i akceptanta (obecnie dostępne wyłącznie we Włoszech) | 1.8.8 |
| 1.4.1 | FiscalModuleVersion | Dokument | Wersja modułu fiskalnego (Trusted Fiscal Module), który został użyty do wygenerowania danego dokumentu. Jest ustalana automatycznie przez middleware, jeśli nie została przekazana przez oprogramowanie. | 1.8.4 |
| 1.4.1 | FiscalCountryModule-Version | Dokument | Wersja modułu krajowego (Trusted Fiscal Country Module), która została wykorzystana do wygenerowania danego dokumentu. Jest ustalana automatycznie przez middleware, o ile nie została przekazana przez oprogramowanie. | 1.8.4 |
| 1.4.1 | SoftwareName | Dokument | Nazwa oprogramowania kasowego, za pomocą którego wygenerowano dany dokument. Jest ustalana automatycznie przez middleware, o ile nie została przekazana przez oprogramowanie. | 1.8.4 |
| 1.4.0 | Różnica czasu | Odniesienie do dokumentu | Należy zmienić wszystkie pola typu „DateTime” na „DateTimeOffset” w ramach przygotowań do wdrożenia systemu e-fiskalizacji w Cloud. | 1.8.0 |
| 1.3.0 | FiscalDocument – wersja | FiscalResponse – Niemcy | Element ten jest obecnie używany wyłącznie w polach AdditionalFields obiektu FiscalResponseGermany. | 1.7.7 |
| 1.3.0 | FiscalDocument-Number | fiscalResponse | Dodano parametr fiscalDocumentNumber (string ), aby umożliwić mapowanie wartości alfanumerycznych (Węgry, Serbia). | 1.7.7 |
| 1.2.0 | PayOutType | Pozycja. Księgowanie |
Dodano element umożliwiający klasyfikację płatności w kasie. Należy pamiętać, że na przykład przelew pieniężny (z kasy do banku i odwrotnie) jest już klasyfikowany za pomocą BusinessTransactionTypes. | 1.7.6 |
| 1.2.0 | ReturnReasonType | Odniesienie do dokumentu |
Wartości
|
1.7.6 |
| 1.2.0 | Płatność | Właściwość „IsCash” została usunięta z DOM. | 1.7.6 | |
| 1.1.8 | ItemSerialNumber | Position.Item | Dodano właściwość ItemSerialNumber – numer seryjny pozycji lub numer identyfikacyjny. | 1.6.4 |
| 1.1.7 | ReturnReasonType | Document-Reference | Dodano właściwość. | 1.6.1 |
| 1.1.7 | ReturnReasonText | Odwołanie do dokumentu | Dodano właściwość. | 1.6.1 |
| 1.1.7 | Barcode | Pozycja.Tekst | Dodano właściwość. Służy do drukowania Barcode za pomocą drukarek fiskalnych. | 1.6.1 |
| 1.1.7 | barcodeType | Position.Text | Dodano właściwość. Określenie typu Barcode. | 1.6.1 |
| 1.1.1 | AccountingDate | Dokument | Dodano datę zaksięgowania transakcji w księgowości finansowej. | 1.3.2 |
| 1.1.1 | ServicePeriodStart | Dokument | Dodano właściwość „Początek okresu świadczenia usługi”. | 1.3.2 |
| 1.1.1 | ServicePeriodEnd | Dokument | Koniec okresu świadczenia usługi – dodano nieruchomość. | 1.3.2 |
| 1.1.1 | PaymentTerms | Dokument | Dodano obiekt „Warunki płatności” (PaymentTerms). | 1.3.2 |
| 1.1.1 | PositionCount | Dokument | Liczba przekazanych pozycji (wystąpi błąd walidacji, jeśli liczba przekazanych pozycji nie jest zgodna z wartością w tym polu). | 1.3.2 |
| 1.1.1 | DueDateDays | PaymentTerms | Dodano właściwość „Termin płatności”. | 1.3.2 |
| 1.1.1 | Rabaty | PaymentTerms | Dodano właściwość „rabat”. | 1.3.2 |
| 1.1.1 | DiscountDueDays | PaymentTerms | Dodano właściwość „Okres rabatu”. | 1.3.2 |
| 1.1.1 |
Kara za opóźnienie w płatności – stawka |
PaymentTerms | Dodano właściwość „Odsetki za zwłokę”. | 1.3.2 |
| 1.1.0 | PrintCount | Dokument | Dodano właściwość „PrintCount” – liczba wydruków podczas tworzenia dowodu księgowego. | 1.2.11 |
| 1.1.0 | ProformaPrintCount | Dokument | Dodano właściwość ProformaPrintCount – liczba wydruków przed zapisaniem paragonu (np. wydruk informacji w branży gastronomicznej). | 1.2.11 |
| 1.1.0 | DeliveryPrintCount | Dokument | Dodano właściwość „DeliveryPrintCount” – liczba wydruków zamówień pośrednich, np.: zamówień przy stolikach lub wydruków dla kuchni/baru. | 1.2.11 |
| 1.1.0 | SalesPerson | Dokument | Dodano właściwość „SalesPerson” (typ obiektu: Użytkownik). | 1.2.11 |
| 1.1.0 | CustomerCount | Dokument | Dodano właściwość CustomerCount – liczba klientów na paragonie. | 1.2.11 |
| 1.1.0 | CreateDate | Pozycja | Dodano właściwość CreateDate – data utworzenia pozycji, o ile jest dostępna. | 1.2.11 |
| 1.1.0 | CostPrice | Pozycja.Pozycja | Dodano właściwość CostPrice – cena nabycia/cena zakupu. | 1.2.11 |
| 1.1.0 | ItemDateOfEntry | Pozycja.Pozycja | ItemDateOfEntry ItemDateOfEntry. | 1.2.11 |
| 1.1.0 | CreateDate | Płatność | Dodano właściwość CreateDate – data utworzenia płatności, o ile jest dostępna. | 1.2.11 |
| 1.1.0 | Użytkownik | Płatność | Dodano właściwość „Użytkownik” – użytkownik, który wprowadził płatność. | 1.2.11 |
| 1.1.0 | SalesPerson | Płatność | Dodano właściwość „SalesPerson” – SalesPerson, który dokonał płatności. | 1.2.11 |
| 1.1.0 | Identyfikator referencyjny terminala płatniczego | Płatność | Dodano identyfikator „PaymentTerminalReferenceId” – umożliwia podanie identyfikatora transakcji (transactionId) w przypadku podłączenia terminala płatniczego. | 1.2.11 |
| 1.1.0 | Identyfikator | Pozycja. Rabat |
Dodano identyfikator właściwości | 1.2.11 |
| 1.1.0 | FirstName | Użytkownik | Dodano właściwość „Imię”. | 1.2.11 |
| 1.1.0 | LastName | Użytkownik | Dodano właściwość „Nazwisko”. | 1.2.11 |
| 1.1.0 | Poprzednik | ReferenceType | Dodano dodatkowy typ odniesienia „poprzedni dokument” | 1.2.11 |
| 1.0.0 |
FiscalDocument – startTime |
fiscalResponse | Dodano właściwość. | 1.0.0 |
| 1.0.0 | PaymentType | Płatność | Dodano właściwość. | 1.0.0 |
| 1.0.0 |
Transakcja biznesowa – typ |
Pozycja | Dodano właściwość. | 1.0.0 |
Typy dokumentów
Poniższa tabela przedstawia, w której wersji dodano lub usunięto określone typy dokumentów (documentType).
|
DOM – wersja |
DocumentType | Zmiana / Wyjaśnienie | Release |
| 1.3.0 | Drukowanie pokwitowania | Służy do drukowania dokumentów niefiskalnych bez pozycji artykułów | 1.7.7 |
| 1.1.0 | ProformaInvoice | Dodano typ dokumentu „Faktura proforma”. Faktura proforma. | 1.2.11 |
| 1.1.0 | Inwentaryzacja | Dodano typ dokumentu „Inwentaryzacja” – przeznaczony do przeprowadzania inwentaryzacji. | 1.2.11 |
Sposoby płatności
Poniższa tabela przedstawia, w której wersji dodano lub usunięto określone typy płatności / metody płatności (PaymentType).
|
Wersja DOM |
PaymentType | Zmiana / Wyjaśnienie | Release |
| 1.1.0 | Kryptowaluta | Kryptowaluta – do płatności za pomocą BitCoina i innych kryptowalut | 1.2.11 |
| 1.1.0 | Aplikacje na telefony komórkowe | Aplikacje na telefony komórkowe – do płatności za pomocą aplikacji na telefony komórkowe. | 1.2.11 |
| 1.1.0 | BankAccount | BankAccount – Płatność przelewem bankowym. | 1.2.11 |
| 1.1.0 | KartaKlienta | Karta klienta – konto klienta. | 1.2.11 |
| 1.1.0 | Program lojalnościowy | Loyalty program – płatności za pomocą punktów i couponów. | 1.2.11 |
| 1.1.0 | Czek | Czek – płatności czekowe . | 1.2.11 |
| 1.1.0 | CreditNote | CreditNote – płatność za pomocą noty kredytowej. | 1.2.11 |
Rodzaje transakcji biznesowych
Poniższa tabela przedstawia, w której wersji dodano lub usunięto określone typy transakcji biznesowych (BusinessTransactionType).
|
DOM – wersja |
BusinessTransactionType | Zmiana / Wyjaśnienie | Release |
| 1.2.0 | Usunięto właściwość „Discount ”. | 1.7.6 | |
| 1.1.0 | GrantGenuine | Dodano właściwość GrantGenuine – prawdziwa dotacja. | 1.2.11 |
| 1.1.0 | GrantUnreal | Dodano właściwość GrantUnreal – dotacja fikcyjna. | 1.2.11 |
Inne zmiany
Pozostałe zmiany opisano poniżej.
- obecnie brak -
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.