iMagicSoft Support Forum Index iMagicSoft Support
iMagic Software Support
 
  SearchSearch   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

Tags for customizing receipts and confirmations

 
Post new topic   Reply to topic    iMagicSoft Support Forum Index -> iMagic Hotel Reservation
View previous topic :: View next topic  
Author Message
imagicsupport
Site Admin


Joined: 16 Dec 2006
Posts: 2110

PostPosted: Fri Jan 08, 2010 3:33 pm    Post subject: Tags for customizing receipts and confirmations Reply with quote

iMagic Hotel Reservation allows you to modify the layout of your receipts and confirmations. You can do this with any Word Processor that supports .RTF files, such as MS Word, WordPad (pre-installed in Windows), OpenOffice Writer, WordPerfect etc.

The files that you'd change are called "Template Files", by default they are located in the "Template File Folder" folder:
Documents\iMagic Hotel Reservation\Templates

The currently available Template Files are:
BookingConfirmation.rtf - guests hotel confirmation (Print Confirmation).
BookingReceipt.rtf - guests receipt (Print Receipt).
BookingList.rtf - booking report (File > Export Room Reservations).
CleaningList.rtf - cleaning list for rooms (File > Export Cleaning List).
CombineBookingReceipt.rtf
GroupBookingReceipt.rtf

In each Template File you can add "Tags", these are replaced by iMagic Hotel Reservation with the appropriate information. Tags are case sensitive so <businessname> will work but <BusinessName> will not.

Example:
A tag might be <homephone> which is replaced with the customer's home phone number when printed.

The tags currently available are:
(for the customer/guest)
<businessname>
<firstname>
<lastname>
<address1>
<address2>
<city>
<state>
<zipcode>
<country>
<homephone>
<workphone>
<email>
<fax>
<cell>

(for the booking)
<confirmationno> - each booking has it's own Confirmation Number.
<fromdate> - of the booking.
<todate>
<CommodityPlural> - the default for this would be "Rooms" but you can use iMagic Hotel to book things other than rooms.
<roomlist>
<noadults>
<nochildren>
<bookedby>
<bookingUDF> - Booking User Defined Field.
customerUDF is the name of the field. ie if you call your UDF "Birthdate" then the tag would be <Birthdate>
<bookingnotes> - any notes added to the booking.
<fromtime> - arrival time in the format set in Windows.
<totime>
<fromtime_AMPM> - arrival time in normal AM/PM format, ie 3:45 PM.
<totime_AMPM>
<fromdate_long> - this is the same as <fromdate> except that it's formatted using Windows "long" date format.
<todate_long> - as for from date above.

(for the chargeable items)
The section that lists the items is a special case since it contains multiple tags for each item (ie price, quantity), as such you need to start it with the tag:
<itemlist>

and end it with the tag:
</itemlist>

Between those two you can use the following tags:
<qty> - quantity of items ordered.
<name> - name of this item.
<saleprice> - sale price before tax.
<isubtotal> - sale price multiplied by the quantity.
<isubtotal_inctax> - same as isubtotal but also includes tax.
<item_date> - when the item was added to the customer's bill.

So a complete example of this section would be:
<itemlist>
<qty> <name> <saleprice> <isubtotal>
</itemlist>

(for the summary payment details)
<subtotal>
<taxname1>
<taxtotal1>
<taxname2>
<taxtotal2>
<tip>
<totalpayable>
<payments> - total payments made by a customer including any deposit.
<payment_total> - same as <payments> above.
<payment_nodeposit> - total payments made without the deposit.
<payment_deposit> - total deposit made.
<balancedue>
<paymentmethod>
<creditcardno> - credit card number, if one was entered.
<creditcardnox> - same as the <creditcarno> accept that most of the numbers are replaced with an "X" for security purposes.
<creditcardexpiry>
<creditcardtype>
<creditcardcsc> - you normally would not want to print this.

(for general information)
<now> - this is the date and time the Receipt/Confirmation was printed.
<now_long> - same as for <now> except that it's in the Windows "Long" format as set in the Windows Control Panel under Regional Settings. An example of a long format might by Thursday, January 26th 2017.

This post applies to the latest version of iMagic Hotel, if you're not using the latest version some tags may not be available. To check, make a note of your installed version number (shown when you launch iMagic Hotel Reservation) and compare it with the latest version number on the update page:
http://www.imagichotelreservation.com/ListUpdates

Regards, Jon
_________________
iMagic Soft Support


Last edited by imagicsupport on Wed Sep 14, 2016 9:34 am; edited 5 times in total
Back to top
View user's profile Send private message Visit poster's website
kanchanaresident



Joined: 28 Oct 2010
Posts: 4

PostPosted: Mon Nov 07, 2011 1:36 pm    Post subject: confirmation letter Reply with quote

This topic lists the available tags but does not tell how to link back to the customer details on the reservation so that this information appear on the confirmation letter
Back to top
View user's profile Send private message
imagicsupport
Site Admin


Joined: 16 Dec 2006
Posts: 2110

PostPosted: Tue Nov 08, 2011 8:48 am    Post subject: Reply with quote

Any tags listed in the Confirmation Template File will be added to the Confirmation automatically by iMagic Hotel, when the "Print Confirmation" button is pressed.

Regards, Jon
_________________
iMagic Soft Support
Back to top
View user's profile Send private message Visit poster's website
kanchanaresident



Joined: 28 Oct 2010
Posts: 4

PostPosted: Tue Nov 08, 2011 3:37 pm    Post subject: confirmation template Reply with quote

I understand that any tag listed in the template will automatically be added by the system.

My question is how do you add a tag to the template so that the system recognizes it. I have added <business name> to the template and when I print the confirmation all the system prints is <business name> and not the information I typed in the business name tag.

thanks


Greg
Back to top
View user's profile Send private message
imagicsupport
Site Admin


Joined: 16 Dec 2006
Posts: 2110

PostPosted: Wed Nov 09, 2011 8:51 am    Post subject: Reply with quote

Try <businessname> rather than <business name>.

Regards, Jon
_________________
iMagic Soft Support
Back to top
View user's profile Send private message Visit poster's website
kanchanaresident



Joined: 28 Oct 2010
Posts: 4

PostPosted: Wed Nov 09, 2011 11:18 am    Post subject: confirmation tags Reply with quote

Thanks Jon. That worked. Any chance you can add tags for
Flight number
Arrival Time
Booking Source

Thanks
Back to top
View user's profile Send private message
imagicsupport
Site Admin


Joined: 16 Dec 2006
Posts: 2110

PostPosted: Wed Nov 09, 2011 11:49 am    Post subject: Reply with quote

If these are custom fields then you can add them in using the custom field tags.

Regards, Jon
_________________
iMagic Soft Support
Back to top
View user's profile Send private message Visit poster's website
CarmenChew



Joined: 04 Sep 2015
Posts: 2

PostPosted: Wed Sep 09, 2015 11:13 am    Post subject: Reply with quote

1) I did add Vehicle License Plat in Custom Field, and add <Vehicle License Plat> /<VehicleLicensePlat> doesn't work. Please advice what should I tag in the report? Crying or Very sad

2) I would like to add night as quantity in the report, however <qty> doesn't work, What should I tag? Crying or Very sad

3) I would like to identify the current user that take care of guest check out, how to tag in the report? <username> doesn't work.. Help please? Crying or Very sad
Back to top
View user's profile Send private message
imagicsupport
Site Admin


Joined: 16 Dec 2006
Posts: 2110

PostPosted: Wed Sep 09, 2015 12:41 pm    Post subject: Reply with quote

Hi Carmen,

Thanks for the post.

1) Did you add this as a Custom Customer Field? If so, I would expect that to work. Can you email me over your Template File and I'll take a look? You can find my email address on this page - http://www.imagichotelreservation.com/HotelSupport

2) At present we don't have a specific tag for the nights of the booking, you could however add the <fromdate> and <todate> tags to indicate to the guest the length of the booking.

3) If you mean the 'booked by' field (as entered on Step 1) then you can use the <bookedby> tag.

But yes probably best to email me over the Template File you have and I can go through and fix any issues for you.

Regards, Jon
_________________
iMagic Soft Support
Back to top
View user's profile Send private message Visit poster's website
CRVTP



Joined: 29 Aug 2015
Posts: 1

PostPosted: Sun Oct 04, 2015 1:27 pm    Post subject: <item_date> tag doesn't seem to work Reply with quote

I have entered this tag but I don't get the information displayed, just the tag. I have cut and pasted from your page, just incase the format was wrong.

This tag is important as we add items to the bill during their stay.
Back to top
View user's profile Send private message
imagicsupport
Site Admin


Joined: 16 Dec 2006
Posts: 2110

PostPosted: Tue Oct 06, 2015 1:25 pm    Post subject: Reply with quote

Hi CRVTP,

Thanks for the post.

I can't think of any obvious reason why the <item_date> wouldn't work for you, it just needs to be between the item tags. If you can email me your template file I can take a look, my email address is on the support page here:
http://www.imagichotelreservation.com/HotelSupport

Regards, Jon
_________________
iMagic Soft Support
Back to top
View user's profile Send private message Visit poster's website
Display posts from previous:   
Post new topic   Reply to topic    iMagicSoft Support Forum Index -> iMagic Hotel Reservation All times are GMT + 8 Hours
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
iMagic Hotel Reservation home page


Powered by phpBB © 2001, 2005 phpBB Group