POS is the system used to issue the invoice to the customer.


Message Description


Basic message structure description

Header data

  • CorrelationID of message exchange
  • Timestamp of sending
  • Version of message type

Identification data

  • Hotel ID
  • Provider ID
  • Invoice ID from provider

Invoice and fiscal data

  • Invoice code
  • Fiscal code (number range)
  • Fiscal closure info (number range to be combined w/ fiscal code)
  • Fiscal signature data (cryptographically signed checksums)
    • Signature label
    • Signature data
    • Signature type
    • Signature format
  • Notes (Label)



Message to be sent from POS after fiscalization (IO_InvoiceFiscalizeNotfRQ)


Example w/ FiscalCode and multiple Signature elements

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<p:IO_InvoiceFiscalizeNotifRQ xmlns:p="http://protel.io/soap" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:htng="http://htng.org/2014B" CorrelationID="INV#424242#CLOSE#000001#1660559885669#236E" Version="1.0" TimeStamp="2022-08-15T10:38:09Z">
    <p:UniqueID Type="Invoice" ID="77680" ID_Context="protelIO"/>
    <p:UniqueID Type="Hotel" ID="14696" ID_Context="protelIO"/>
    <p:Invoice User="Administrative user" UserTaxNo="" InvoiceDate="2021-07-31T21:44:22+02:00" Fiscalized="false" ExternallyFiscalized="false" ExternalFiscalDate="2020-02-19T18:37:32+02:00" ExternalFiscalCode="ft3E1" ExternalFiscalClosingID="993" Type="Reservation" PastEndOfDay="true" Open="false" Void="false" InvoiceID="77680" BusinessDate="2021-07-31">
        <p:InvoiceRecipient ProfileType="Customer" ProfileID="262589">
            <p:FirstName>Emmanuel</p:FirstName>
            <p:LastName>M</p:LastName>
            <p:Nationality>ZA</p:Nationality>
            <p:Language>en_US</p:Language>
            <p:Notes></p:Notes>
            <p:Gender></p:Gender>
            <p:Addresses>
                <p:Address CountryCode="ZA" PrimaryInd="false">
                    <p:City>.</p:City>
                    <p:Notes></p:Notes>
                </p:Address>
            </p:Addresses>
            <p:EmailAddresses>
                <p:Communication Value="em.1@guest.booking.com" Type="11" Notes="" PrimaryInd="true"/>
            </p:EmailAddresses>
            <p:PhoneNumbers>
                <p:Communication Value="+20000000 6576" Type="9" Notes="" PrimaryInd="true"/>
            </p:PhoneNumbers>
        </p:InvoiceRecipient>
        <p:Charges/>
        <p:Payments/>
        <p:Deposits/>
        <p:Expenses/>
        <p:Batches/>
        <p:TotalChargeAmount CurrencyCode="ZAR">
            <p:Amount>0.00</p:Amount>
        </p:TotalChargeAmount>
        <p:TotalPaymentsAmount CurrencyCode="ZAR">
            <p:Amount>0.00</p:Amount>
        </p:TotalPaymentsAmount>
        <p:TotalDepositsAmount CurrencyCode="ZAR">
            <p:Amount>0.00</p:Amount>
        </p:TotalDepositsAmount>
        <p:VoidReason></p:VoidReason>
    </p:Invoice>
    <p:ExternalFiscalDate>2022-08-15T12:38:09+02:00</p:ExternalFiscalDate>
    <p:ExternalFiscalCode>ft3E1</p:ExternalFiscalCode>
    <p:ExternalFiscalClosingID>993</p:ExternalFiscalClosingID>
    <p:ExternalFiscalNotes>ACK Servicii WEB ANAF</p:ExternalFiscalNotes>
    <p:ExternalFiscalSignatures>
        <p:Signature Type="FINGERPRINT" Format="IO_SIG_FORMAT_TEXT" Timestamp="2022-08-12T16:37:14+02:00">
            <p:Data>ft3E0#992_zRMeYeA=</p:Data>
            <p:Label>Internal</p:Label>
        </p:Signature>
        <p:Signature Type="CERTIFICATION" Format="IO_SIG_FORMAT_HEX" Timestamp="2022-08-12T16:37:14+02:00">
            <p:Data>123456789012345678901234567890AB</p:Data>
            <p:Label>HexZoi</p:Label>
        </p:Signature>
    </p:ExternalFiscalSignatures>
</p:IO_InvoiceFiscalizeNotifRQ>

Field description table

IO_InvoiceFiscalizeNotifRQ

Element countAdditional InformationValid values
see Generic elements for Legal & Fiscal messaging#GenericElements
Mandatory Message headers




IO_InvoiceFiscalizeNotifRQ | UniqueID

0..10

see Generic elements for Legal & Fiscal messaging#Businessobjects
Mandatory Reference IDs




IO_InvoiceFiscalizeNotifRQ | ExternalFiscalCode

0..1



Text (number) to display on the invoice.
Will be sent in RQ Reference element for void operation

IO_InvoiceFiscalizeNotifRQ | ExternalFiscalClosingID

0..1



Text (number) to display on the invoice. 
Will be sent in RQ Reference element for void operation

IO_InvoiceFiscalizeNotifRQ | ExternalFiscalDate

0..1



Will be sent in RQ Reference element for void operation

IO_InvoiceFiscalizeNotifRQ | FiscalNotes

0..1



Textual information regarding the fiscalization process

IO_InvoiceFiscalizeNotifRQ | ExternalFiscalSignatures

0..1Fiscalization result w/ more complex data (e.g. QR codes & signatures)

IO_InvoiceFiscalizeNotifRQ | ExternalFiscalSignatures | Signature

0.10

@Type1Type of signature algorithm
@Format1Format of signature created
@Timestamp1ISO timestamp of signature creation

IO_InvoiceFiscalizeNotifRQ | FiscalSignatures | Signature | Label

0..1



Description of signature created

IO_InvoiceFiscalizeNotifRQ | FiscalSignatures| Signature | Data

0..1



Actual data of signature (Binary data must be Base64 encoded)

IO_InvoiceFiscalizeNotifRQ | Invoice

0..1(Optional) Copy of invoice data sent with RQ
see IO_InvoiceFiscalizeRQ message description#Invoice




  • Keine Stichwörter