This instance is currently being migrated to the new Atlassian One Confluence sytem.
If you can't find your space anymore, it should be already in the new System: https://confluence.weareplanet.com/
POS is the system used to issue the invoice to the customer.
Fiscal service is the system handling fiscal obligations as part or on behalf of the respective tax authority.
Message Description
The message sent from the invoice issuing party (POS) to the tax authority (or a system acting as deputy) must hold data which is needed to fulfil fiscalization requirements.
Basic message structure description
Header data
- CorrelationID of message exchange
- Timestamp of sending
- Version of message type
Property details
- Hotel official codes
- Hotel address
- Hotel contact
Invoice information
- Invoice Code
- Invoice recipient
- Name
- Address
- Tax numbers
- Contact information
- Charges (Services)
- Payments
- Deposits
- Totals
- Terminal information
Reservation information
- Reservation Guest information (guests of the stay)
- Date of arrival and departure
- Rooms
Invoice / Charges / Item / PostingText Invoice / Charges / Item / AdditionalText Invoice / Charges / Item / TotalAmountAfterTax Invoice / Charges / Item / TotalAmountAfterTax / Amount Invoice / Charges / Item / SingleAmountAfterTax Invoice / Charges / Item / SingleAmountAfterTax / Amount Invoice / Charges / Item / SingleAmountBeforeTax Invoice / Charges / Item / SingleAmountBeforeTax / Amount Invoice / Charges / Item / TaxInfoMessage send from POS (IO_InvoiceFiscalizeRQ)
Examples
Standard invoice issued by Hotel with Multi-Currency enabled and user logged in to CashRegister 1
Voiding invoice (w/ Reference) issued by protel with Single-Currency enabled and no user logged in to CashRegister
Charges and Batches
Field description table
IO_InvoiceFiscalizeRQ
Count Additional Information protelAir field protelAir logic / status see Generic elements for Legal & Fiscal messaging#GenericElements Mandatory message headers IO_InvoiceFiscalizeRQ/UniqueID
1..10 Identifiers of related tenant, folio, customer etc. see Generic elements for Legal & Fiscal messaging#Businessobjects Mandatory Reference IDs IO_InvoiceFiscalizeRQ/HotelInfo
1 Description of Invoice issuing company as seen on Documents CompanyName 1 Offical Company Name for invoices PropertyMasterData.Company CompanyGroupName 0..1 Name of associated company group PropertyMasterData.Group LocalCourt 0..1 Name of Court PropertyMasterData.LocalCourt TradeRegister 0..1 Name of Trade Register PropertyMasterData.TradeRegister TradeRegisterID 0..1 ID of comapny in Trade register (alphanumeric) PropertyMasterData.TradeRegisterID TaxNumber 1 Tax number of company (alphanumeric) PropertyMasterData.TaxNo TaxNumber2 0..1 2nd tax number of company (alphanumeric) IBAN 0..1 International Bank Account Number of company (alphanumeric) PropertyMasterData.IBAN SwiftCode 0..1 Code of company's bank from Society for Worldwide Interbank Financial Telecommunication (alphanumeric) PropertyMasterData.SWIFT Address 0..1 see Generic elements for Legal & Fiscal messaging#Addresses Company address PropertyMasterData.Address Contact 0..1 see Generic elements for Legal & Fiscal messaging#Persons Contact / Manager Email 0..1 see Generic elements for Legal & Fiscal messaging#Communications PropertyMasterData.Email Phone 0..1 see Generic elements for Legal & Fiscal messaging#Communications PropertyMasterData.Phone Fax 0..1 see Generic elements for Legal & Fiscal messaging#Communications PropertyMasterData.Fax Homepage 0..1 URL of the company's homepage PropertyMasterData.Homepage Invoice
1 @InvoiceCode 1 Invoice number (shown to the user) Invoice.InvoiceCode @FiscalCode 1 Fiscal code assigned to this invoice Invoice.FiscalCode @Open 1 Is this invoice open (true / false) Invoice.IsOpen @Void 1 Is this invoice voided (true / false) Invoice.IsVoid @ReferencedInvoiceCode 0..1 Reference to the Voided invoice (@InvoiceCode) ReferencedInvoice.InvoiceCode @ReferencedFiscalCode 0..1 Reference to the voided invoice (@FiscalCode) ReferencedInvoice.FiscalCode @ReferencedInvoiceDate 0..1 Reference to the voided Invoice issue date (ISO DateTime) ReferencedInvoice.InvoiceCode (DateTime) @Type 1 "Reservation", "Passerby", "Group", "Unknown" Invoice.InvoiceType @InvoiceDate 1 Time stamp of the invoice generation, stored in invoices table and printed on invoice (ISO DateTime) Invoice.InvoiceDate (DateTime) @User 1 User who initiated Invoice creation (close of the folio) Invoice.InvoiceUser (set on folio close) @UserTaxNo 0..1 Tax Number of the user who generated Invoice System.CurrentUser.GovernmentID (on folio close) Invoice / VoidReason 0..1 Voiding reason info text. Value 0..1 Textual description Invoice.VoidReasonText Invoice / TotalChargeAmount 1 Total (gross) charged amount @Amount 1 Total amount decimal Invoice.TotalChargedAmount.Amount @CurrencyCode 1 Three letter currency code Invoice.TotalChargedAmount.CurrencyCode @ExchangeRate 0..1 Exchange rate applied for conversion to hotel default currency Invoice.TotalChargedAmount.ExchangeRate Invoice / TotalPaymentsAmount 1 Total paymenst amount @Amount 1 Total amount decimal Invoice.TotalPayments.Amount @CurrencyCode 1 Three letter currency code Invoice.TotalPayments.CurrencyCode @ExchangeRate 0..1 Exchange rate applied for conversion to hotel default currency Invoice.TotalPayments.ExchangeRate Invoice / TotalDepositsAmount 1 Total deposits amount @Amount 1 Total amount decimal Invoice.DepositPayments.Amount @CurrencyCode 1 Three letter currency code Invoice.DepositPayments.CurrencyCode @ExchangeRate 0..1 Exchange rate applied for conversion to hotel default currency Invoice.DepositPayments.ExchangeRate Invoice / Charges
1 Invoice / Charges / Item
0..n @Quantity 1 Number of items charged/payed Item.Quantity @TaxRate 1 Percentage of VAT as decimal value Item.TaxLogic.Rate @TaxCode 1 Tax name as defined by the sender Item.TaxLogic.ShortName @Type 1 Type of item (Payment, Article, Expense) Item.TypeID @ServiceDate 1 Date item was posted to the invoice Item.ServiceDate (default Invoice.InvoiceDate) @CashRegisterID 1 ID of Cash register the user was logged in to Item.CashRegisterID 0..1 Value Description of the item posted 0..1 Value Additional text to the posting 1 @CurrencyCode Three letter currency code 1 Value Decimal value of the item's total 1 @CurrencyCode Three letter currency code 1 Value Decimal value of the item's single amount including VAT 1 @CurrencyCode Three letter currency code 1 Value Decimal value of the item's single amount excluding VAT 1 @Rate 1 Percentage of VAT as decimal value @SubCode1 0..1 Sub code of tax (if given) @SubCode2 0..1 Sub code of tax (if given) @ID 1 ID of tax @Code 1 Shortname of tax Value 1 Description of tax Invoice / Payments
1 Invoice / Payments / Item
0..n see Messages from POS to Fiscal Service#Invoice/Charges/Item Invoice / Deposits
1 Invoice / Deposits / Item
0..n see Messages from POS to Fiscal Service#Invoice/Charges/Item Invoice / Expenses
1 Invoice / Expenses / Item
0..n see Messages from POS to Fiscal Service#Invoice/Charges/Item Invoice / InvoiceRecipient
1 see Generic elements for Legal & Fiscal messaging#Persons 1 The legal or individual person receiving this invoice IO_InvoiceFiscalizeRQ / ReservationInfo
@ArrivalDate 1 @DepartureDate 1 @CRSNumber 1 External CRS number IO_InvoiceFiscalizeRQ / ReservationInfo / Booker
1 Booker of the reservation see Generic elements for Legal & Fiscal messaging#Persons 1 IO_InvoiceFiscalizeRQ / ReservationInfo / ReservationGuests
1..n Linked guest profiles to this reservation. see Generic elements for Legal & Fiscal messaging#Persons 1 The individual persons arriving at the hotel IO_InvoiceFiscalizeRQ / Terminal
0..1 Represents the cash register the user is currently logged in to @TerminalName 1 CashRegister Label IO_InvoiceFiscalizeRQ / Terminal / URL
0..1 CashRegister ID IO_InvoiceFiscalizeRQ / Terminal / Location
0..1 Cash Register Description IO_InvoiceFiscalizeRQ / Terminal / Notes
0..1 - XML schema of Request message