Post a Billing Charge with negative (void) postingQuantity value

POST {{HostName}}/csh/v0/hotels/{{HotelId}}/reservations/{{ReservationId}}/charges

HPI PostRequest sample for void three amounts (subtotals) to post to a reservation account sending negative postingQuantity value

/csh/v0/hotels/HotelId/reservations/ReservationId/charges

where body contains values for

  • subtotal1:
    transactionCode = 2000
    amount to post = **3.20** USD
    Quantity = -1
    Posting detail information:
    Reference = Restaurant Breakfast
    Remark = Breakfast Buffet
    POS Check number = 21120204
    FolioWindowNo = 2 (optional to send)
    cashierId = 113 (this is the PMS Cashier of the app)

  • subtotal2:
    transactionCode = 2010
    amount to post = **3.30** USD
    Quantity = -1
    Posting detail information:
    Reference = Restaurant Lunch Food
    Remark = Lunch Food
    POS Check number = 21120204
    FolioWindowNo = 2 (optional to send)
    cashierId = 113 (this is the PMS Cashier of the app)

  • subtotal3:
    transactionCode = 2011
    amount to post = **4.30** USD
    Quantity = -1
    Posting detail information:
    Reference = Restaurant Lunch Bev
    Remark = Lunch Bev
    POS Check number = 21120204
    FolioWindowNo = 2 (optional to send)
    cashierId = 113 (this is the PMS Cashier of the app)

Posting date = 2021-12-02 (incomeAuditDate)

Note for void postings:

in case a guest check needs to be voided due to reason (e.g. wrong payment or wrong reservation used) always void ALL sub amounts as to show clear postings on the guest account.

Request Body

{"criteria"=>{"hotelId"=>"SAND01", "charges"=>[{"transactionCode"=>"2000", "articleCode"=>"", "price"=>{"amount"=>59.5, "currencyCode"=>"USD"}, "postingQuantity"=>-1, "postingReference"=>"Restaurant Breakfast", "postingRemark"=>"Breakfast Buffet", "checkNumber"=>"21112301", "arrangementCode"=>"string", "applyRoutingInstructions"=>false, "usePackageAllowance"=>false, "autoPosting"=>true, "financialTransactionIdList"=>[{"id"=>"Vendor trans ID", "type"=>"string"}], "folioWindowNo"=>2, "cashierId"=>113}], "reservationId"=>{"url"=>"string", "type"=>"string", "instance"=>"string", "idContext"=>"string", "id"=>"{{ReservationId}}", "idExtension"=>0}, "incomeAuditDate"=>"2021-11-23", "postIt"=>false, "cashierId"=>113, "welcomeOfferPosting"=>true}, "links"=>[{"href"=>"string", "rel"=>"string", "templated"=>false, "method"=>"GET", "targetSchema"=>"string", "operationId"=>"string", "title"=>"string"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
x-hotelidstring
x-app-keystring