4 FAQ

Question Answer

Is calculation of phone charges by dialed digit and call length possible with OHIP?

No, the functionality to calculate the phone charge amount in PMS (known as Full or Partial Call Accounting) is not possible.

The phone charge message must contain the final amount to post.

Is calculation of phone charge by transmitting units / meter pulses possible with OHIP?

No, this functionality is not available. The phone charge message must contain the final amount to post.

What are "Non-Guest-Rooms"?

Customers create pseudo reservations under Room Type Pseudo Rooms which is commonly called PM rooms.

This is usually used for sending charges from F&B Outlets, Spa, Golf, and so on.

Customers create these pseudo reservations on a daily basis where they check in and check out reservations.

It is the responsibility of customers to ensure they always assign the same room number to these pseudo reservations.

For example, a customer creates the following:

  • 9000- POS Cash

  • 9001- POS Visa

  • 9002- POS Amex

  • 9010 – Golf Tee fees

  • And many more

Partners are expected to post charges to these dummy reservations if the Guest has made the payments directly.

To counter balance (also called "Autobalance"), use the postBillingPayment API.

The above can vary from customer to customer.

Therefore, check with customers about their processes regarding posting non-room charges into PMS prior to onboarding.

With the postBillingCharges operation, I can send all sub-amounts of a guest check. Do I need to send a "total amount" of the guest-check?

The postBillingCharges operation does not have a "total amount" element like in legacy integrations (for example, FIAS or XML_POS).

In the OPERA Cloud guest account, all charges appear against its revenue transaction code.

Only the OPERA Cloud PMS guest account folio window has a total balance amount.

How can I indicate void postings?

Void postings are possible to send using the postBillingCharges containing either of the following:

negative "amount " value (-5.50) and positive "postingQuantity " value ("1")

positive "amount " value (5.50) and negative "postingQuantity " value ("-1")

A sample Void posting could be a minibar item that a guest has taken out of the minibar. The minibar automatically posts the charge after a grace time (for example, 1 minute). When a guest returns the minibar item back to that place, the minibar might recognize this and automatically sends a void posting (as the item has not been consumed).

A void or refund posting can be done for a Point-Of-Sale charge that, for example, has been closed to a wrong room.

In this case, the entire guest check must be voided by sending the postBillingCharge message containing all items to void to balance the amount from the wrong room / reservation billing.

Void/Refund a charge to a reservation.

Post the Charge to the reservation.

POST {{HostName}}/csh/v1/hotels/{{HotelId}}/reservations/164743/charges 

{
    "criteria": {
        "hotelId": "SAND01",
        "charges": [
            {
                "transactionCode": "2000",
                "articleCode": "",
                "price": {
                    "amount": 27.50,
                    "currencyCode": "USD"
                },
                "postingQuantity": 1,
                "postingReference": "Restaurant Breakfast",
                "postingRemark": "Breakfast Buffet",
                "checkNumber": "240527001",
                "arrangementCode": "",
                "applyRoutingInstructions": false,
                "usePackageAllowance": false,
                "autoPosting": true,
                "financialTransactionIdList": [
                    {
                        "id": "Vendor trans ID",
                        "type": "string"
                    }
                ],
                "folioWindowNo": 1,
                "cashierId": 113
            },
            {
                "transactionCode": "2010",
                "articleCode": "",
                "price": {
                    "amount": 10.50,
                    "currencyCode": "USD"
                },
                "postingQuantity": 1,
                "postingReference": "Restaurant Lunch Food",
                "postingRemark": "Lunch Food",
                "checkNumber": "240527001",
                "arrangementCode": "",
                "applyRoutingInstructions": false,
                "usePackageAllowance": false,
                "autoPosting": true,
                "financialTransactionIdList": [
                    {
                        "id": "Vendor trans ID",
                        "type": ""
                    }
                ],
                "folioWindowNo": 1,
                "cashierId": 113
            }
        ],

        "reservationId": {
            "url": "string",
            "type": "string",
            "instance": "string",
            "idContext": "string",
            "id": "164743",
            "idExtension": 0
        },
        "incomeAuditDate": "2021-11-22",
        "postIt": false,
        "cashierId": 113,
        "welcomeOfferPosting": true
    },
    "links": [
        {
            "href": "string",
            "rel": "string",
            "templated": false,
            "method": "GET",
            "targetSchema": "string",
            "operationId": "string",
            "title": "string"
        }
    ]
}

Void/refund the charge

POST  {{HostName}}/csh/v1/hotels/{{HotelId}}/reservations/164743/charges


{
    "criteria": {
        "hotelId": "SAND01",
        "charges": [
            {
                "transactionCode": "2000",
                "articleCode": "",
                "price": {
                    "amount": 27.50,
                    "currencyCode": "USD"
                },
                "postingQuantity": -1,
                "postingReference": "Restaurant Breakfast",
                "postingRemark": "Breakfast Buffet",
                "checkNumber": "240527001",
                "arrangementCode": "",
                "applyRoutingInstructions": false,
                "usePackageAllowance": false,
                "autoPosting": true,
                "financialTransactionIdList": [
                    {
                        "id": "Vendor trans ID",
                        "type": "string"
                    }
                ],
                "folioWindowNo": 1,
                "cashierId": 113
            },
            {
                "transactionCode": "2010",
                "articleCode": "",
                "price": {
                    "amount": 10.50,
                    "currencyCode": "USD"
                },
                "postingQuantity": -1,
                "postingReference": "Restaurant Lunch Food",
                "postingRemark": "Lunch Food",
                "checkNumber": "240527001",
                "arrangementCode": "",
                "applyRoutingInstructions": false,
                "usePackageAllowance": false,
                "autoPosting": true,
                "financialTransactionIdList": [
                    {
                        "id": "Vendor trans ID",
                        "type": ""
                    }
                ],
                "folioWindowNo": 1,
                "cashierId": 113
            }
        ],

        "reservationId": {
            "url": "string",
            "type": "string",
            "instance": "string",
            "idContext": "string",
            "id": "164743",
            "idExtension": 0
        },
        "incomeAuditDate": "2021-11-22",
        "postIt": false,
        "cashierId": 113,
        "welcomeOfferPosting": true
    },
    "links": [
        {
            "href": "string",
            "rel": "string",
            "templated": false,
            "method": "GET",
            "targetSchema": "string",
            "operationId": "string",
            "title": "string"
        }
    ]
}

This image shows the folio windows.

After a successful void posting, the charge can be sent to the correct reservation.

Is guest allowed to post charges to a room when the "reservationIndicator" shows "NOPOST"?

What does the NO POST indicator means?

The NO POST flag set active in the Payment Instructions of a reservation indicates that no automatic charges (from external systems) are allowed.

Usually a reservation will get the NO POST flag set when guests have no credit limit allowed because they might pay their bill for the whole stay in advance, or the chosen payment method for their reservation does not allow any credit = postings to the reservation account.

Only charges to this account are allowed, which are directly paid at the front desk.

The NoPost indicator can be retrieved using reservationIndicators within the getReservations operation.

getReservations

"reservationIndicators": [
                    {
                        "indicatorName": "NOPOST"
                    },

or within the NEW/UPDATE RESERVATION BusinessEvent

UPDATE RESERVATION BE

{
                        "dataElement": "NO POST",
                        "oldValue": "N",
                        "newValue": "Y"
                    },

When a reservation has the above value (indicatorName: "NOPOST" or dataElement: "NO POST" = "Y"), then the reservation has the NO POST flag active. This means that no charges can be made to the guest reservation.

Is it possible to display the Postings of one guest check in one row in the reservation Billing?

Yes, this is possible. Ensure the OPERA Cloud Controls / Cashiering Parameter "RollUp Transaction" is enabled.

A charge amount can be sent with or without tax included. How do I fine out if I need to send the tax amount with the revenue amount?

If the transaction code includes TAX, you are expected to post the Gross Amount.

If the transaction code excludes TAX, you are expected to post the NET amount. OPERA Cloud automatically posts the related tax amounts.

You can use the FrontDesk Configuration operation getTransactionCode to determine if each transaction code is Tax included or excluded.