This article shows current additions and changes to the document object model (DOM) in the respective releases.
Existing implementations remain unaffected by these changes. The downward compatibility of the DOM is ensured. If a change affects downward compatibility, this will be pointed out separately.
Changes are usually necessary in the course of implementing new fiscalisation countries. In order to meet the fiscalisation requirements in these additional countries via the RetailForce Fiscal Middleware, it is recommended to adapt existing implementations and to transfer the new fields to the middleware in the future, provided they are available in the upstream system.
Elements
The following table shows which changes to certain elements of the DOM have been implemented or removed in which version.
|
DOM- |
DOM-Objekt | Place | Change | Release |
| 1.5.0 | DocumentIssueType | Document | Defines the type of document issuance (paper, digital receipt, paper and digital, not issued) | 1.8.8 |
| 1.5.0 | ServiceType | Document | Specification of the type of service (table service, counter service), detailing of the "activity" | 1.8.8 |
| 1.5.0 | IsEcommerce Transaction | Document | Indication of whether the transaction is an e-commerce transaction | 1.8.8 |
| 1.5.0 | UniqueCashRegister Id | Document |
The unique cash register ID is saved in the document from DOM version 1.5.0, but the Configuration.CashRegister.Id field is removed from the configuration. As part of Warrify integration. |
1.8.8 |
| 1.5.0 | Configuration |
Obsolete until further notice. As part of Warrify integration. |
1.8.8 | |
| 1.5.0 | TerminalSlaveId | Document | Option to specify an ID of an input station (slave) connected to the electronic recording system. | 1.8.8 |
| 1.5.0 | FooterGraphicIndex | Document | A predefined graphic element is placed in the footer of a document via footerGraphicIndex. | 1.8.8 |
| 1.5.0 | AdditionalHeader | Document | Additional text in the header of a voucher (added as part of the functional enhancement for document printing Italy). | 1.8.8 |
| 1.5.0 | AdditionalFooter | Document | Additional text in the footer of a voucher (added as part of the functional enhancement for document printing Italy). | 1.8.8 |
| 1.5.0 | Coupon | Document | Added the option to print additional coupons on the receipt (added as part of the functional enhancement for document printing in Italy). | 1.8.8 |
| 1.5.0 | IsBusiness | Partner | Definition that the "partner" (= customer) is a business customer. | 1.8.8 |
| 1.5.0 | Additional Identification | Partner |
Transmission of additional IDs such as:
|
1.8.8 |
| 1.5.0 | VatPercentage2 | Vat | Specification of an additional tax rate (extension for countries with more than one tax rate - e.g. GST and QST in Québec/Canada). | 1.8.8 |
| 1.5.0 | VatPercent2 | Position | Transmission of an additional tax rate for the respective item (extension for countries with more than one tax rate - e.g. GST and QST in Québec/Canada). | 1.8.8 |
| 1.5.0 | AdditionalTaxType | Position. AdditionalTax | Indication of additional taxes (alcohol, tobacco, NOVA (car in AT), others) | 1.8.8 |
| 1.5.0 | AdditionalTaxType Identification | Position. AdditionalTax | Details of the additional tax, mandatory if AdditionalTaxType is "other". | 1.8.8 |
| 1.5.0 | TaxPercent | Position. AdditionalTax | Indication of the rate (per cent) of an additional tax rate. | 1.8.8 |
| 1.5.0 | TaxValue | Position. AdditionalTax | Indication of the amount of an additional tax rate. | 1.8.8 |
| 1.5.0 | BusinessSector | FiscalClient | Definition of the business area (field of activity). | 1.8.8 |
| 1.5.0 | CardData | Payment | can be used to print credit card receipts for customer and merchant (currently only available for Italy) | 1.8.8 |
| 1.4.1 | FiscalModuleVersion | Document | Version of the fiscal module (Trusted Fiscal Module) that was used to generate the respective document. Is set automatically by the middleware if not transmitted by the software. | 1.8.4 |
| 1.4.1 | FiscalCountryModule-Version | Document | Version of the country module (Trusted Fiscal Country Module) that was used to generate the respective document. Is automatically set by the middleware if not transmitted by the software. | 1.8.4 |
| 1.4.1 | SoftwareName | Document | Name of the POS software with which the respective document was generated. Is automatically set by the middleware if not transmitted by the software. | 1.8.4 |
| 1.4.0 | DateTimeOffset |
Document- Reference |
Change all DateTime fields to DateTimeOffset in preparation for cloud fiscalisation. |
1.8.0 |
| 1.3.0 | FiscalDocument-Revision | FiscalResponse-Germany |
The element is now only used in the AdditionalFields of the FiscalResponseGermany. |
1.7.7 |
| 1.3.0 | FiscalDocument-Number | FiscalResponse |
FiscalDocumentNumber (string) added to be able to map alphanumeric values (Hungary, Serbia). |
1.7.7 |
| 1.2.0 | PayOutType | Position. Booking |
Element added to be able to classify payments at the cash desk. Please note that, for example, a money transfer (cash register/bank and vice versa) is already classified via the BusinessTransactionTypes. |
1.7.6 |
| 1.2.0 | ReturnReasonType | Document-Reference |
The values
|
1.7.6 |
| 1.2.0 | IsCash | Payment |
IsCash property has been removed from DOM. |
1.7.6 |
| 1.1.8 | ItemSerialNumber | Position.Item |
ItemSerialNumber property added - serial number of the item or identity number. |
1.6.4 |
| 1.1.7 | ReturnReasonType | Document-Reference |
Property added. |
1.6.1 |
| 1.1.7 | ReturnReasonText | Document-Reference |
Property added. |
1.6.1 |
| 1.1.7 | BarCode | Position.Text |
Property added. Used for printing barcodes via fiscal printers. |
1.6.1 |
| 1.1.7 | BarCodeType | Position.Text |
Property added. Specification of the BarCode type. |
1.6.1 |
| 1.1.1 | AccountingDate | Document |
Date when the transaction is booked in financial accounting added. |
1.3.2 |
| 1.1.1 | ServicePeriodStart | Document | Start of service period - property added. | 1.3.2 |
| 1.1.1 | ServicePeriodEnd | Document | End of service period - property added. | 1.3.2 |
| 1.1.1 | PaymentTerms | Document | Payment terms object PaymentTerms added. | 1.3.2 |
| 1.1.1 | PositionCount | Document | Number of transferred items (validation error if the number of transferred items does not match this field). | 1.3.2 |
| 1.1.1 | DueDateDays | PaymentTerms | Property "Payable by" added. | 1.3.2 |
| 1.1.1 | Discount | PaymentTerms | Property "discount" added. | 1.3.2 |
| 1.1.1 | DiscountDueDays | PaymentTerms | "Discount period" property added. | 1.3.2 |
| 1.1.1 | LatePaymentPenalty- Rate |
PaymentTerms | Property "Interest on arrears" added. | 1.3.2 |
| 1.1.0 | PrintCount | Document |
PrintCount property added - number of prints when creating the voucher. |
1.2.11 |
| 1.1.0 | ProformaPrintCount | Document |
Property ProformaPrintCount added - number of prints before saving the receipt (e.g.: information printing in the catering industry). |
1.2.11 |
| 1.1.0 | DeliveryPrintCount | Document |
Property DeliveryPrintCount added - number of prints of intermediate orders / e.g.: table orders or kitchen/bar print. |
1.2.11 |
| 1.1.0 | SalesPerson | Document |
SalesPerson property added (object type: User). |
1.2.11 |
| 1.1.0 | CustomerCount | Document |
CustomerCount property added - number of customers on a receipt. |
1.2.11 |
| 1.1.0 | CreateDate | Position |
Property CreateDate added - creation date of the item, if available. |
1.2.11 |
| 1.1.0 | CostPrice | Position.Item |
CostPrice property added - cost price/purchase price. |
1.2.11 |
| 1.1.0 | ItemDateOfEntry | Position.Item |
ItemDateOfEntry Entry date of the item. |
1.2.11 |
| 1.1.0 | CreateDate | Payment |
Property CreateDate added - creation date of the payment, if available. |
1.2.11 |
| 1.1.0 | User | Payment |
User property added - the user who entered the payment. |
1.2.11 |
| 1.1.0 | SalesPerson | Payment |
Property SalesPerson added - the seller who made the payment. |
1.2.11 |
| 1.1.0 | PaymentTerminal-ReferenceId | Payment |
Property PaymentTerminalReferenceId added - allows the specification of a TransactionId when a payment terminal is connected. |
1.2.11 |
| 1.1.0 | Identifier | Position. Discount |
Property identifier added |
1.2.11 |
| 1.1.0 | FirstName | User |
Property for "First name" added. |
1.2.11 |
| 1.1.0 | LastName | User |
Property for "Surname" added. |
1.2.11 |
| 1.1.0 | Predecessor | ReferenceType |
Additional reference type " preceding document" added |
1.2.11 |
| 1.0.0 | FiscalDocument- StartTime |
FiscalResponse |
Property added. |
1.0.0 |
| 1.0.0 | PaymentType | Payment |
Property added. |
1.0.0 |
| 1.0.0 | BusinessTransaction- Type |
Position |
Property added. |
1.0.0 |
Document types
The following table shows in which version certain document types (DocumentType) were added or deleted.
|
DOM- Ver. |
DocumentType |
Change / Explanation |
Release |
| 1.3.0 | PrintingReceipt | Used to print non-fiscal documents without article items | 1.7.7 |
| 1.1.0 | ProformaInvoice |
Document type ProformaInvoice added. Proforma invoice. |
1.2.11 |
| 1.1.0 | Inventory |
Inventory document type added - for inventories. |
1.2.11 |
Bezahlarten
The following table shows in which version certain payment types / payment methods (PaymentType) were added or deleted.
|
DOM- Ver. |
PaymentType |
Change / Explanation |
Release |
| 1.1.0 | CryptoCurrency |
CryptoCurrency - for payments with BitCoin & co. |
1.2.11 |
| 1.1.0 | MobilePhoneApps |
MobilePhoneApps - for payments with mobile phone applications. |
1.2.11 |
| 1.1.0 | BankAccount |
BankAccount - Payment by bank transfer. |
1.2.11 |
| 1.1.0 | CustomerCard |
CustomerCard - customer account. |
1.2.11 |
| 1.1.0 | Loyalty |
Loyalty - Zahlung mit Punkten, Coupons. |
1.2.11 |
| 1.1.0 | Check |
Check - cheque payments. |
1.2.11 |
| 1.1.0 | CreditNote |
CreditNote - payment with credit note. |
1.2.11 |
Types of business transation types
The following table shows in which version certain types of business cases (BusinessTransactionType) were added or deleted.
|
DOM- Ver. |
BusinessTransactionType |
Change / Explanation |
Release |
| 1.2.0 | Discount |
Discount property has been removed. |
1.7.6 |
| 1.1.0 | GrantGenuine |
Property GrantGenuine - real grant - added. |
1.2.11 |
| 1.1.0 | GrantUnreal |
Property GrantUnreal - unreal grant - added. |
1.2.11 |
Other changes
Other changes are described below.
- currently none -
Comments
0 comments
Please sign in to leave a comment.