Countries and Languages
| Countries | Languages |
|---|---|
| Australia | English |
| Canada | English |
| France | English |
| Germany | English |
| Italy | English |
| Mexico | English |
| Spain | English |
| USA | English |
Extracted Fields
Asterisk (*) indicates a required field or field group. Values cannot be empty.
Stay Information
| Field | Description |
|---|---|
| Date* | The date when the invoice was issued by the hotel. |
| Check-in Date | The date when the guest checked into the hotel. |
| Check-out Date | The date when the guest checked out of the hotel. |
| Nights | The duration of the guest’s stay. |
Hotel Details
| Field | Description |
|---|---|
| Hotel Name | The name of the hotel. |
| Address | The address of the hotel. |
| Street | The address of the hotel. |
| City | The city component of the hotel address. |
| Postal Code | The postal code component of the hotel address. |
| State | The state component of the hotel address. |
| Country | The country component of the hotel address. |
| Phone | The phone number of the hotel. |
Financial Information
| Field | Description |
|---|---|
| Currency* | The currency of the payment. |
| Total* | The total amount of the invoice. |
| Tax Total | The total amount of tax levied on the purchase. If the Tax Total field is empty, it can be filled in automatically by the Process money fields and currency rule. |
Taxes (Repeating Group)
| Field | Description |
|---|---|
| Tax Rate | Tax details. No details will be shown if the Tax Rate and Tax Amount fields are empty. If multiple taxes have been detected, they will be displayed in multiple lines in the table. The total amount of tax will be recorded in the Tax Total field. |
| Tax Amount | Tax amount value |
Payment Details
| Field | Description |
|---|---|
| Payment Method | Payment method. Possible values: Card, Cash, Transfer, Mixed, Undefined |
| Card Type | The payment processing network of the card used for payment. Possible values: Mastercard, VISA, AmericanExpress, NationalCard, Undefined |
| Credit or Debit | Whether a credit or debit card was used. Possible values: Credit, Debit |
| Card Number | The number of the card used for payment. The number may be partially masked, with some of the digits replaced with the X character. |
Line Items (Repeating Group)
| Field | Description |
|---|---|
| SKU | The stock-keeping unit identifier of services or items provided to the guest (if present). |
| Description | The name of the purchased service or item. |
| Quantity | The quantity of the service or item purchased. |
| Price | The price per unit. |
| Amount | The total amount in the line item. |
Key Fields
- Date
- Currency
- Total
Validation Rules
To fill in a field with the calculated value, click the suggestion button in the value region of the appropriate field and select one of the suggestions from the drop-down list.| Rule | Description |
|---|---|
| Process money fields and currency | Splits the amount and the currency in the Total, Tax Total, and Tax Amount fields, and copies the currency into the Currency field if it has not been filled in. Checks that the sum of the Taxes and Tax Amount fields is equal to the value of the Total Tax field. If the values are not equal, displays an error message and suggests filling in the fields with their calculated values. If a value for the Total Tax field was not found, fills it in with its calculated value. Displays a warning message if the Total Tax field value is greater than 50% of the value in the Total field. Checks that the value of the Currency field is a known ISO currency. If the currency is not known or has not been extracted, suggests currency values for the supported countries. Currency descriptions and symbols are replaced with ISO codes. |
| Process Date | Normalizes the Date field value. Date ambiguities are resolved with the help of the Country value. |
| Process Taxes | Suggests a value for the Tax Amount field based on the Tax Rate and the net amount of the purchase, or the other way round. This is possible only if the net amount has been detected. Removes the % sign from the Tax Rate field and normalizes ambiguous values. |
| Process number of nights | Normalizes the Check-in and Check-out field values. Calculates the length of stay and fills the Nights field with the result. Date ambiguities are resolved with the help of the Country value. |
Parameters
The Hotel Invoice skill has default skill parameters that you can use to modify the field extraction process. You may want to change the values of these parameters in Vantage or Advanced Designer for certain document processing scenarios (for example, if you are only processing documents from certain countries). For more information, see Skill parameters.| Parameter | Description |
|---|---|
| PredefinedCountries | A predefined list of countries that restricts automatic country detection for hotel invoices. By default, the value of this parameter is empty. You can specify desired countries by writing in their Alpha-2 ISO country codes separated by a semi-colon. The value of this parameter will primarily affect the extraction of data from the Country, Currency, Tax Total, and Taxes fields. |
| PredefinedExpenseType | A predefined list of expense types that restricts automatic expense type detection for hotel invoices. The default value of this parameter is Hotel. Note: We do not recommend changing the value of this parameter. |