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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
x-hotelid | string | ||
x-app-key | string |