There are a number of common questions that are received each day regarding Theatre Manager. The goal of this section is to help the user find answers to those common questions. Below are the various categories included in this FAQ. Each category has a list of common questions and links to the appropriate answers. Please browse this section as someone may have already asked the same question that you have.
ADA (Americans with Disability Act)
The US Department of Justice has revised the Americans with Disabilities act effective March 15, 2010 with a compliance date of March 15, 2011. We have three sources for this documentation that we invite you to read:
Please make your own action plans after reading the documentation and adapting it to your venue. Concepts and suggestions presented here are only our interpretation and intended as guidance only. Please use these concepts with Theatre Manager to implement an approach for your venue consistent with the guidelines and any grandfathering that the act may imply.
Purpose of the ADA Act
The key purpose of the act is to provide equal (neither better, worse, nor different) ability to buy tickets through all avenues and see events. This means you may be affected by this act in the following manners:
Venue Setup for ADA
If tickets are to be sold online then there are some things to consider when setting up the venue. These are:
- The graphic map must identify the ADA seating area
- The best seats algorithm may need changed and you should include at least 3 additional companion seats (in the same row or close proximity)
- The seat names and/or purpose for the ADA seats should be clearly marked when presented to the patron. This can be done two different ways depending on the version of TM you are using.
- Any best seat search capability should provide direct access to one or more of the ADA seating areas so that they can be accessed quickly.
- You may need to remove some of the default venue holds on the accessible seats.
Identify ADA seating area

It is fairly easy in Theatre Manager to identify the accessible areas using colour, text, and/or an icon. We recommend changing the background area of the accessible seating to be blue (as per the image to the right) to clearly identify where they are in the venue.
You may also want to put a legend on the map for 'Price A', 'Price B' and 'ADA seats' so that it is equality and abundantly clear where each area is.
Best Seating Setup

The setup for best seating has a some strategies for you to consider.
- We recommend ADA seating be highest number in the Best Seat # column where possible. This means, the best seat algorithm will chose those seats last - every time. It lessens the effect of them being selected by any patron unwittingly.
- Name the Best Avail Area column with a clearly identifying nomenclature such as ADA or WC. If you have multiple accessible areas, then name them ADA1, ADA2, ADA3. This way they are considered separate by Theatre Manager.
Notice in or example, there are only 3 ADA seats in this area (seats 982, 983, 984) but the ADA act requires that companion seats be available as well - up to 3 companion seats per ADA seat subject to availability. If you make them in the same row, add the caption ADA to the Best Avail Area for sufficient seats to meet your ADA requirements.
These seats should always have a higher Best Seat # than the actual ADA seats. This way, in cases of sellout, you can sell those seats to able-bodied person (they do not have to be saved for companion seats)
Identify ADA seats to Patron
An ADA requirement includes identification of the ADA seat and what it may mean to the patron (see sample to the right). For a patron requiring accessible seats, it should be clear what they selected. Conversely, you can also direct those who selected the seats in error to find some others.
You cannot prevent anyone buying ADA designated seats -- because the ADA act stipulates that anybody, ablebodied or not, can buy them on behalf of another. Fraud detection must be done after the fact (according to the act).
The approach used to identify the seats to the patron changes slightly depending on the version of Theatre Manager. Version 9.06 has some built in features and offer additional benefit - so we recommend using V9.06 or later.
Using version 9.05 or earlier

- In the Section column, you may wish some distinguishing characters at the beginning of the section that ticket faces and web sales can identify. For example, these were named ADA/...... (followed by Orchestra). A mnemonic could be used for various types of seats like:
- W/ = Wheelchair
- T/ = Suitable for Transfer
- X/ = Walker Accessible
- C/ = Companion
-
Then adjust your web code (or tickets) if you wish to look for an MS_SEAT_CODE and add any warnings or additional notes as you wish. For example, if you change rowTicketEvent.html, you could add a pick statement within your web code to more clearly designate the intent of the seat.
eg: pick(int(pos(left(MS_SEAT_CODE,2),'W/T/X/C/')/2),'Wheelchair','Suitable for Transfer','Walker Accessible','Companion')
Using Version 9.07 or later
Note: The ADA requirements have been given some additional capability in version 9.07 with a separate column in the seating setup to indicate seating type comment. Instead of coding the section and the web pages as per step 3 above, you can do the following instead:
- Each and every seat in a reserved seating venue can now have a 300 character Seat Note associated with it. It can be used to explain any ADA requirements or directions. This field can also be used to indicate an special seating notes like sightline restrictions if they are of benefit to your patrons, or a tag to show a picture that will display what the view is from the seat.
- There is a column called Use which is flag to indicate if the seat note is an internal note (0) or if it can be displayed on the web site to patrons (1). Normally ADA seating notes would have a 1 in this column. Notes appear on the tooltips for a seat. You can also place comments and html tags within the seats notes if you wish.
- Update web pages. To implement any of the ADA requirements, you will have to put some words on your web pages indicating policy changes. Alternatively, upgrading the web pages to the version 9.06 standards may give you all the functionality you need without any web page coding.
Searching for Tickets

The 'Best Seat Settings' tab in the venue setup indicates how people can find tickets. If you name the seats in your accessible section 'ADA' or 'WC' or some equivalent terminology, then you can put in search areas into your web sales to help find those accessible seats.
If you have multiple accessible sections, you could call them ADA1, ADA2, etc. and provide an individual search for each one.
Ticket Prices for ADA
Ticket prices in Theatre Manager are setup under Events (or Plays, Concerts, Games, etc.). There is no difference to this process for the ADA act.
However you may need to change your seat map so that the pricing of any seats in the ADA area match the proportion of seats in the entire house. For example, if your venue has:
- 100 seats at price 'A' (50% of the house - most expensive ticket)
- 60 seats at price 'B' (30% of the venue - mid range ticket)
- 40 seats at price 'C' (20% of the venue- least expensive ticket)
The prices of the accessible seats, regardless where they are in the venue, must have at least 20% (or more) tickets at price 'C', 30% (or more) tickets at price 'B' and the rest of the accessible tickets can be price 'A' (somewhat less than 50%).
Note that our reading of the act does not state that all accessible tickets purchased by one person need be at the same price. That could mean that the accessible seats could be set up explicitly so that their prices match an exact proportion of the ticket prices in the rest of the venue.
There is also a fairness reading of how to set prices according to the act. If all your accessible seats are amongst your 'A' tickets, then you must follow the proportional pricing approach and make some price 'B' and 'C' seats available.
If all your accessible seating is amongst the 'C' area due to how the venue was constructed, then you will need to make the accessible seating at a 'C' price because you cannot arbitrarily charge more just to maintain proportionality. The principle cited in the act is that the price must be the same as if an able-bodied person was to purchase a ticket in that area.
Theatre Manager Implementation Approach
Once you have decided how many accessible tickets you want at each pricing area as appropriate for your venue, you enter that into the venue setup under the 'Seat Names' tab. Look for the column named 'Price Codes' and enter the Price codes against the ADA accessible seats - see the sample below.
Specifically, you will see in this venue that only 3 seats are marked ADA (982,983,984) and they have been given price codes A (seat 982), B (seat 983) and C (seat 984) as per proportionality and seating area for this venue.

Ticket Holds for ADA
There are 3 circumstances where accessible seating may be released for sale:
- all non-accessible seats have been sold
- all non-accessible seats in a specific area have been sold, so accessible seats in that area may also be released
- all non-accessible seats in a designated price category have been sold, so remaining accessible seat can no be released to the public
If you do hold seats that are released periodically, you will also need to hold accessible seats in proportion to the public seats that are held back. (eg, if you hold 10% of a house for later, you need to hold 10% of the accessible seats). The interpretation of the act is very specific that the venue can exclude from the held count those seats count held for promoters, actors, and others held under contract.
Implementing in Theatre Manager
Implementing this in Theatre Manager is quite straightforward.
If you do hold seats for the public, then you must also hold the proportion of accessible seats. Run the ticket inventory report called Ticket Hold Counts-Quick to help determine total counts. This report may exported to excel or copy/pasted to excel and proportional calculations run.
- If you periodically release seats, check your house and release the ADA seats at the same time, in proportion.
- If you do not hold any seats (other than those promoter, actor, contracted seats, etc seats mentioned above), then you don't have to hold any accessible seating because (by definition) you will have designed the best seat algorithm to bias ADA seats as the last to be suggested and you will have guided able-bodied patrons not to pick those seats unless they need them.
- However, having no accessible seats does seem a bit harsh, so we'd recommend keeping at a small reserve of accessible seats on hold till you release all seats to the public before the performance - as we don't think that all people who use accessible seating will be as active on the internet at the proponents of the law might anticipate.
Policy Additions for ADA
Box Office Policies
You may have to adjust some of your policies as the act (and commentary) has some specific intentions such as:
- You cannot require people who buy accessible tickets online to visit the box office to pick up the tickets if you do not require abled people to do the same thing (same rules for all). However, you can monitor who uses your accessible seats by having ushers greet people in the accessible area. You are also allowed to reseat people in the accessible seats under some circumstances.
- You may have to adjust season subscription policies for renewing seats the following year if the subscription includes accessible seats. It appears that you can ask subscribers to attest in writing that they need accessible seating (but not for single tickets)
- If you allow an able person to buy a group of tickets on behalf of others, then you must also allow that same privilege to people who buy accessible seating. Such policies would mean you cannot require accessible seating to be returned to the box office for resale. It would also mean that a fully able person may end up in the accessible seating, if those tickets are bought by a disabled person and given away - and that means the abled person is fully entitled to sit in the accessible seating.
- Ticket holders of normal seating are allowed to change to accessible seating in a comparable location if seats are available when the individual presents the tickets.
Guarding against Fraudulent use of ADA seats
Venues who are concerned with people obtaining accessible seating fraudulently have to be careful how they manage this process. For example, you cannot require that a disabled person buy the ticket in person because friends may buy a disabled ticket on behalf of a disabled person.
You can, however, use a feature in Theatre Manager web sales process to require people, at time of checkout, to read terms and conditions prior to accepting the credit card and completing the sale. Theatre Manager records that the person has validated reading the conditions.
In those terms and conditions, you may put a policy wording that is supported by the act such as people 'attest' that they need the ADA seats if they purchased some and that they agree they may be moved under circumstances provided for in the act.
You may also want to put wording about scalpers, secondary sales, a link to your your box office policies, etc in the terms and conditions. Theatre Manager records that people clicked the checkbox on the web detail screen.
Requiring people to 'accept terms and conditions' of the sale is done by:
- ensuring that all standard web page changes have been made on the TM checkout page as per version 9.05 release notes
- That you are using version 9.05 or later of Theatre Manager
- That you have enabled the 'read terms and conditions' checkbox on the company preferences window as per the picture to the right.
Secondary Market
If you provide tickets to the secondary market, you will need to have policies to provide the secondary with accessible tickets so that a patron can buy tickets from the secondary market as well. You cannot force those tickets to be purchased only through the venue. If you do not actively provide tickets to a secondary market, you are not required to make accessible seats available to scalpers.
Appendix: Excerpt from the ADA Act
While we suggest you read the entire act regarding equal accessibility to purchase tickets and visit a venue, we have excerpted a key portion about ticketing (the purchase and seating processes) for your convenience
Section (f) is about ticketing, applies directly and is reproduced below.
- (1)
-
(i) For the purposes of this section, 'accessible seating' is defined as wheelchair spaces and companion seats that comply with sections 221 and 802 of the 2010 Standards along with any other seats required to be offered for sale to the individual with a disability pursuant to paragraph (4) of this section.
- (ii) Ticket sales. A public accommodation that sells tickets for a single event or series of events shall modify its policies, practices, or procedures to ensure that individuals with disabilities have an equal opportunity to purchase tickets for accessible seating
- (A) During the same hours;
- (B) During the same stages of ticket sales, including, but not limited to, pre-sales, promotions, lotteries, wait-lists, and general sales;
- (C) Through the same methods of distribution;
- (D) In the same types and numbers of ticketing sales outlets, including telephone service, in-person ticket sales at the facility, or third-party ticketing services, as other patrons; and
- (E) Under the same terms and conditions as other tickets sold for the same event or series of events.
- (2) Identification of available accessible seating. A public accommodation that sells or distributes tickets for a single event or
series of events shall, upon inquiry
- (i) Inform individuals with disabilities, their companions, and third parties purchasing tickets for accessible seating on behalf of individuals with disabilities of the locations of all unsold or otherwise available accessible seating for any ticketed event or events at the facility;
- (ii) Identify and describe the features of available accessible seating in enough detail to reasonably permit an individual with a
disability to assess independently whether a given accessible seating location meets his or her accessibility needs; and
- (iii) Provide materials, such as seating maps, plans, brochures, pricing charts, or other information, that identify accessible seating and information relevant thereto with the same text or visual representations as other seats, if such materials are provided to the general public.
- (3) Ticket prices.
- The price of tickets for accessible seating for a single event or series of events shall not be set higher than the price for other tickets in the same seating section for the same event or series of events. Tickets for accessible seating must be made available at all price levels for every event or series of events. If tickets for accessible seating at a particular price level cannot be provided because barrier removal in an existing facility is not readily achievable, then the percentage of tickets for accessible seating that should have been available at that price level but for the barriers (determined by the ratio of the total number of tickets at that price level to the total number of tickets in the assembly area) shall be offered for purchase, at that price level, in a nearby or similar accessible location.
- (4) Purchasing multiple tickets.
- (i) General. For each ticket for a wheelchair space purchased by an individual with a disability or a third-party purchasing such a ticket at his or her request, a public accommodation shall make available for purchase three additional tickets for seats in the same row that are contiguous with the wheelchair space, provided that at the time of purchase there are three such seats available. A public accommodation is not required to provide more than three contiguous seats for each wheelchair space. Such seats may include wheelchair spaces.
- (ii) Insufficient additional contiguous seats available. If patrons are allowed to purchase at least four tickets, and there are fewer than three such additional contiguous seat tickets available for purchase, a public accommodation shall offer the next highest number of such seat tickets available for purchase and shall make up the difference by offering tickets for sale for seats that are as close as possible to the accessible seats.
- (iii) Sales limited to fewer than four tickets. If a public accommodation limits sales of tickets to fewer than four seats per patron, then the public accommodation is only obligated to offer as many seats to patrons with disabilities, including the ticket for the wheelchair space, as it would offer to patrons without disabilities.
- (iv) Maximum number of tickets patrons may purchase exceeds four. If patrons are allowed to purchase more than four tickets, a public accommodation shall allow patrons with disabilities to purchase up to the same number of tickets, including the ticket for the wheelchair space.
- (v) Group sales. If a group includes one or more individuals who need to use accessible seating because of a mobility disability or because their disability requires the use of the accessible features that are provided in accessible seating, the group shall be placed in a seating area with accessible seating so that, if possible, the group can sit together. If it is necessary to divide the group, it should be divided so that the individuals in the group who use wheelchairs are
not isolated from their group.
- (5) Hold and release of tickets for accessible seating.
- (i) Tickets for accessible seating may be released for sale in certain limited circumstances. A public accommodation may release unsold tickets for accessible seating for sale to individuals without disabilities for their own use for a single event or series of events only under the following circumstances
- (A) When all non-accessible tickets (excluding luxury boxes, club boxes, or suites) have been sold;
- (B) When all non-accessible tickets in a designated seating area have been sold and the tickets for accessible seating are being released in the same designated area; or
- (C) When all non-accessible tickets in a designated price category have been sold and the tickets for accessible seating are being
released within the same designated price category.
- (ii) No requirement to release accessible tickets. Nothing in this paragraph requires a facility to release tickets for accessible seating to individuals without disabilities for their own use.
- (iii) Release of series-of-events tickets on a series-of-events basis.
- (A) Series-of-events tickets sell-out when no ownership rights are attached. When series-of-events tickets are sold out and a public accommodation releases and sells accessible seating to individuals without disabilities for a series of events, the public accommodation shall establish a process that prevents the automatic reassignment of the accessible seating to such ticket holders for future seasons, future years, or future series, so that individuals with disabilities who require the features of accessible seating and who become newly eligible to purchase tickets when these series-of-events tickets are available for purchase have an opportunity to do so.
- (B) Series-of-events tickets when ownership rights are attached. When series-of-events tickets with an ownership right in accessible seating areas are forfeited or otherwise returned to a public accommodation, the public accommodation shall make reasonable modifications in its policies, practices, or procedures to afford individuals with mobility disabilities or individuals with disabilities that require the features of accessible seating an opportunity to purchase such tickets in accessible seating areas.
- (6) Ticket transfer.
- Individuals with disabilities who hold tickets for accessible seating shall be permitted to transfer tickets to third parties under the same terms and conditions and to the same extent as other spectators holding the same type of tickets, whether they are for a single event or series of events.
- (7) Secondary ticket market.
- (i) A public accommodation shall modify its policies, practices, or procedures to ensure that an individual with a disability may use a ticket acquired in the secondary ticket market under the same terms and conditions as other individuals who hold a ticket acquired in the secondary ticket market for the same event or series of events.
- (ii) If an individual with a disability acquires a ticket or series of tickets to an inaccessible seat through the secondary market, a public accommodation shall make reasonable modifications to its policies, practices, or procedures to allow the individual to exchange his ticket for one to an accessible seat in a comparable location if accessible seating is vacant at the time the individual presents the ticket to the public accommodation.
- (8) Prevention of fraud in purchase of tickets for accessible seating. A public accommodation may not require proof of disability, including, for example, a doctor's note, before selling tickets for accessible seating.
- (i) Single-event tickets. For the sale of single-event tickets, it is permissible to inquire whether the individual purchasing the tickets for accessible seating has a mobility disability or a disability that requires the use of the accessible features that are provided in accessible seating, or is purchasing the tickets for an individual who has a mobility disability or a disability that requires the use of the accessible features that are provided in the accessible seating.
- (ii) Series-of-events tickets. For series-of-events tickets, it is permissible to ask the individual purchasing the tickets for accessible seating to attest in writing that the accessible seating is for a person who has a mobility disability or a disability that requires the use of the accessible features that are provided in the accessible seating.
- (iii) Investigation of fraud. A public accommodation may investigate the potential misuse of accessible seating where there is good cause to believe that such seating has been purchased fraudulently.
Accounting, End of Day and Year End
This section explains a number of common questions regarding accounting setup and daily or year end balancing
Changing Tax Rates
Following are the steps for preparing and executing a change in tax rates. If your organization uses rounded number prices,
click here for some things to think about before making these changes.
In all cases of tax changes, consult your accountant for official rules

|
When a new tax rate becomes effective at midnight, it is very important you shut down the web listeners at midnight. Then not bring them back online until all the pricing changes and/or tax rate changes have been completed. This ensures all the web ticket sales after midnight are using the new tax rate.
|

|
If you have not stopped your web listener please do not proceed. It is imperative the web sales be stopped at midnight the morning the tax rate changes. An end of day must be done and the steps below completed before online sales can be started again.
|
Miscellaneous questions we've been asked:
- Should you shut down the web listeners before midnight? You could, however, you may find there are many patrons attempting to purchase tickets at the last minute to avoid the new tax rate change. We recommend you keep the web listeners running as long as possible to allow for ticket sales as the pre-existing rate to make your patrons happy. However, the web listener should not run past midnight the morning the tax rate changes.
- Do I need to make all the changes to the pricing/tax rates after midnight or can they wait until the next day? Making the changes to the pricing/tax rates can be made the next day, as long as the web listeners and box office do not do any activity until the changes have been put into place and 'tested'.
- What happens when tickets sold at the tax old rate are exchanged? The rules and government interpretation indicate the 'old' tickets are refunded at the old tax rate and the 'new' tickets are subject to the tax rate in effect at the time of the exchange. Theatre Manager does this automatically for you.
Steps that can be done in advance of the tax change
A. Rename the existing Tax Code to include the percentage value

|
If the tax code already indicates the percentage value move to step B.
|
- Go to Setup >> System Tables >> Tax Tables.
- Double click on the old tax code being used.
Change the name of the tax code to something that included the percentage of the rate.
For Example:
| Province |
Current Name |
New Name |
| British Columbia |
Tax or GST |
GST 5% |
| Ontario |
Tax or GST |
GST 5% |
- Click the Save button to save the changes.
B. Create a new Tax Code for the new Tax Rate
- Go to Setup >> System Tables >> Tax Tables.
- Click the New button to create a new tax code.
Set the name of the tax code to something to reflect the new rate.
For Example:
| Province |
Tax Rate |
| British Columbia |
HST 12% |
| Ontario |
HST 13% |
- Starting with the City tab, set the appropriate tax rate and G/L Accounts.
The G/L Accounts will likely be the same G/L Accounts that were used for the prior tax table.
- Repeat for the PST and GST tabs.
- Click the Save button to save the changes.
Repeat steps A & B (above) for any other Tax Codes that contain the old tax rate. In a situation where the GL Account number is different click here to learn how to create a new account number.

|
For Step B above, you can change the name of the GST tab in Tax Tables by going to Setup > System Preferences > Appearance tab and changing the right side of Federal Tax from City to HST.
|
Steps to take when the tax change occurs
The following steps must be completed after midnight on the date the tax rates are to change and prior to sales beginning.
If you are running Theatre Manager's Web Sales module, make sure to shutdown all listeners by midnight. The Web Sales listeners can be restarted after the following changes have been made.
A. Update Events
- Go to Setup >> Events.
- Search for an event that is currently on sale and double click to open it.
- Click the Accounting Tab.
- Change the "Ticket Tax Code" from the old tax rate to the new tax table.

|
Changing the tax rate on the accounting tab changes it for all performances. If you wish to only change the tax code on a few of the performances, then do not change it on this tab. Double click on only those performances that are to be sold under the new tax rate and change those on the detail window that you see.
|
- Click the Save button in the toolbar.
- Repeat these steps for all other current and future events.

|
If tax is currently backed out of the ticket sales price the value of the ticket will need to be altered under the Pricing tab for each Event. This is done by double clicking on the Price Code, entering the base price of the ticket (including tax) and clicking on the Calculate Price Excluding Taxes button.
|
B. Update Ticket Sales Promotions
If the tax rate switch is instantaneous (i.e. it all happens on one day), then simple change the tax rate on the promotions.
However, if the tax rate is to be phased in, where an old tax rate applies to some events or performances and a new tax rate applies to other events and/or performances, you will need to create a second set of sales promotions to mirror the first and enable/disable them as appropriate.
For example, if a regular ticket can be sold with only Ontario Sales tax up till a deadline, but regular tickets for other events require HST, then you will need to rename your old 'Regular' to 'Regular RST' and add a 'Regular HST' promotion - and enable them as appropriate for performances. After the tax change is full implemented, you can merge the two sales promotions together if you wish.
- Go to Setup >> System Tables >> Sales Promotions.
- Search for an active Sales Promotion and double click to open it.
- Click on the Calculation tab.
Change the Tax Rate(s) from the old tax rate to the new tax rate. There are four
(4) tax rates per sales promotion that may or may not be effected.
- Click the Save button to save the changes.
- Repeat these steps for all other active Sales Promotions.
C. Update Memberships/Passes/Gift Certificates
In most cases, a gift certificate should not have any tax charged against it at time of sale as it is what called a 'financial instrument'. No taxes are payable buying a gift certificate and the tax is calculated at the time of exchanging the gift certificate for a ticket
Some items like a play pass or merchandise may have tax applied and could need to be changed. You will need to decide which passes/memberships or gift certificates are subject to the tax change.
- Go to Setup >> System Tables >> Member Types.
- Search for an active membership and double click to open it.
- Click on the Accounting tab.
Change the "Tax Rate" from the old tax rate to the new tax rate.
- Click the Save button to save the changes.
- Repeat these steps for all other active memberships, passes or gift certificates.
D. Update Transaction Fees
- Go to Setup >> System Tables >> Fee Tables.
- Double click on the first Fee.
- Click on the Calculation tab.
Change the Tax Rate from the old tax rate to the new tax rate.
- Close the window to save the changes.
- Repeat these steps with all other Fees.
E. Update The Facility Management Module
It may be necessary to update the tax rate on any projects where a future invoice is required. You may need to update resources and personnel for each task that spans over the date of the tax rate change for those projects that require billing.
RESOURCES
- Go to Setup >> System Tables >> Resources.
- Double click on the first Resource.
- Click on the Accounting tab.
Change the Purchase Tax Rate and the Sales Tax Code from the old tax rate to the new tax rate.
- Close the window to save the changes.
- Repeat these steps with all other Resources.
VOLUNTEER ACTIVITY
- Go to Setup >> System Tables >> Code Table.
- Select the Volunteer Activity option in the left column.
- Double click on the first activity in the column on the left.
- Select the Facility tab.
Change the Sales Tax Code from the old tax rate to the new tax rate.
- Close the window to save the changes.
- Repeat these steps with all other Resources.
Congratulations! New sales may now be processed, and all Web Sales listeners can be started.
Transitional rules: HST on Ticket Exchanges bought before HST implementation
This is a hot topic, very hot. There is general confusion reading the HST transitional rules and they are neither clear, nor pretty.
The Arts Management team are not tax accountants or experts, so Theatre Manager is designed to implement a somewhat safe interpretation of the rules. These rules were generally acceptable for the Maritime provinces HST transition some years back.
Please read the examples below that are taken from Ontario Transitional Rules and do check with your accountants. There is enough in this document to warrant taking the safer road on the taxation side. As I said, we are not tax accountants, so the actual rules may be different, or there may be specific exceptions that we are not aware of.
The approach that you can take in TM to handle exchanges is:
- new tickets (and exchanged tickets) get the new tax rate that applies to the performance
- refunded tickets are refunded at the tax rate used to buy them
- venues who want to implement what are effectively tax rebates on subscription ticket exchanges need to discount the final order difference using a negative order fee to write off the HST. It will come through the end of day as 'negative' tax, but in the end, that is good because you can track it as an input tax credit.
This assumes that it is legally valid to do that. Please please please, talk to your Accountant for your specific situation.
Background History to the TM Transitional Rules
The rules that we've been observing are are found in a published web article by the Ontario Government.
| There is a small section in this document near the bottom labelled Returns and exchanges near example 28 which is excerpted below. it is the subsequent caveat that is the most interesting.
Example 28: In July 2010, a person returns a shirt that was purchased in June 2010 for $40. The vendor exchanges the returned shirt for another shirt that costs $60. In this situation, the vendor would collect the Ontario component of the HST on $20.
If the RST did not apply to property that was purchased before July 1, 2010, and it is exchanged on or after July 1, 2010, the Ontario component of the HST would apply to the full consideration for the replacement property.
Tickets generally have no RST. By that interpretation, exchanges for events that occur after July 1,2010 would be charged the HST on the full amount, even if bought before May 1, 2010.
|
|
Example 22 speaks to tickets (albeit a circus example) and has an implication that shows across the boundary of july, but sold earlier than May (i.e. buy now, go later), should probably have HST in them in the first place. It states:
Consideration due or paid on or before October 14, 2009: Notwithstanding the general RST wind-down rules, the RSTA would apply where consideration for a sale of goods, services or admissions becomes due or is paid on or before October 14, 2009.
Example 22: In September 2009, a vendor sells tickets to a circus show to be held in July 2010. The RST would apply to the price of admission.
Interesting interpretation of this is that if you were not charging RST (because you were exempt), then you cannot use the 'difference on the exchange' from example 28. Otherwise, you might be able to take advantage of example 28 - but you would have to have been charging RST on tickets last October.
|
|
Revenue Canada speaks to a transitional rule with a ticket example using Stratford Festival. It has a specific example where tickets are purchased after May and the performance is in July. It clearly states that HST applies. Revenue Canada speaks of a transitional rule that follows:
The HST will generally apply to a service to the extent that the service is performed on or after July 1, 2010. The HST will generally not apply, however, to a supply of a service if all or substantially all (90 per cent or more) of the service is performed before July 20
Our reading of that suggests that a subscription where 10% or more of the ticket value is after July 1st suggests that HST should be applied to the initial sale.
|
| There are some exceptions to the transition rules listed in various places.
We took a representative example from Tax Tips for subscriptions. In every interpretation we've seen, this means magazine periodicals. Anything mentioning tickets refers to transportation.
Nothing specifically talks to non-profit arts organizations exchanging subscription tickets when a new tax rate applies.
|
|
Finally, there is a small note in the Ontario Transitional Rules document called 'anti-avoidance'.
It looks innocuous - but the meaning is clear - if the Government thinks you are doing something to avoid the tax (they coin it 'blatant tax avoidance arrangements', then trouble looms and the department of finance can make any rule they want. So, 'buy your pass now to avoid HST next year' may (or may not) be on that 'tax avoidance arrangement' category.
Anti-avoidance
Existing anti-avoidance rules in the ETA (Excise Tax Act) would apply to transactions to which the general transitional rules for the HST apply. Additional anti-avoidance rules may be implemented in order to maintain the integrity of the GST/HST and the RST during the period of transition to the HST in Ontario.
The legal ruling from University of Toronto is provided for your reference.
Would the Government prosecute? Might not, it may be bad press. On the other hand, Governments like their tax revenue, so they might, especially if it amounted to a significant tax influx when you consider the value of all advance subscription tickets sold for all venues in the entire Province for a year.
|
I hope these references help. If you are confused, I can understand it. Our reading is not necessarily correct, but in the absence of a very specific printed ruling, we've chosen to play safe, yet give the venues an option of using a negative order fees to effectively claim back the tax if that is what they wish to do.
Clearing Erroneous A/R
Cleaning up A/R is something that should be done once a month after your "month end" End of Day. This will keep it to a minimum and prevent you from having pages and pages of A/R to clean up at the end of the year.
Erroneous A/R entries tend to be the result of missed keystrokes in the payment process, or intentional bypassing of residual balances on patron accounts. This is not a "short" or "overage" in a cash drawer, rather it is when Theatre Manager has indicated that there is a balance due (or refund due), and the amount is not recognized by the employee. The order is closed, leaving the balance "on occount."
If you have separate orders on the same patron record, one with a credit balance and one with a debit balance, then you may need to consider creating an offsetting payment to clear the A/R balance on the matched orders. For more information on this process
click here.
Cleaning the A/R is a simple process. On the final day of the month:
- Run your regular End Of Day
Click Here to learn how.
- Stop web sales and all box office sales
Click Here to learn how.
- Run a Receivables Based on Order Balances report
Determine what is "real" A/R and what needs to be "cleaned up." Examine each receivable to determine its validity. If it is an actual receivable - meaning the patron actually owes you money for a pledge or a group sale, for example - or you owe the patron money for a refund, then you may leave it as it is. However, if the A/R is the result of an error at the box office (generally this is the result of an unpaid order fee, or a non-refunded exchange difference), then mark it on the report so you can fix it on the patron record.
- Locate the first patron with an order that needs to be corrected.
Click
here for information on how to find a patron.
- Click on the Orders
tab. Highlight the order indicated on your report and click the payment
button at the bottom of the screen
- Add a payment or a refund depending on what the order needs to bring it to $0.00.
Click Here to learn how.
- Use the payment method OTHER
Alternatively, you can create a new payment method called "A/R Write-off." To learn how to set up a new payment method, Click Here
- Repeat the process for all your erroneous receivables
- Run another End of Day, which will keep all the A/R write offs in one End of Day report
Provide the new End of Day reports to your bookkeeper to keep the records clean.
- Start Web Sales
Click Here to learn how.
- Resume sales at the Box Office
Donation Clearing Account
In Version 8, a new Default Posting Account has been added to the Code Tables called the Donation Account Donations Normally Post to. This is a split form the original Donation Bank Clearing Account to make the transfer of funds from a operating cash account to a restricted account for capital campaigns or any other donation account where the funds will be kept separately from the everyday cash. The process is simple, and uses solid accounting principles.
To set this up, you would change the BANK ACCOUNT in the Campaign setup to the restricted GL account you have assigned to the separate bank account.
In this example, let's assume your general CASH GL account is 1000, and the Capital Campaign GL account is 1008.

|
While the payments for all sales goes into the general operating account at the bank, and the majority of your campaigns are sending those funds directly to the standard 1000 GL account, the Capital Campaign is going into the 1008 account.
|
The next assumption is that a $50,000 donation is pledged - but not paid - to the capital campaign. This simply increases A/R by $50,000, and increases the Capital Campaign donation GL account (in this example, 4125).
When the donation is paid (either in part or in full), Theatre Manager will tell you through the End Of Day reporting to move the funds from where they were originally posted to the separate bank account.
To understand this report, first remove the simple transactions. The final transaction reduces the A/R and the second transaction increases the CASH account by $50,000, which is the amount of the payment. These are the same transactions we see for every payment in Theatre Manager. Reduce A/R, increase cash.
That leaves us with the two transfer GL entries.
- The first is the Transfer from (1000). It is a credit for $50,000 - meaning that you are going to take the entry for the funds OUT of the cash account.
- The second is the Transfer To, which moves them IN to the other bank account, which is 1008 (because that is where you are keeping the actual money for the capital campaign).
So - as always - if you enter the GL transactions as listed form the End Of Day reports, your financial package will track the funds as the are promised, sit as a receivable, are paid, and moved into the correct bank account. Simply follow what Theatre Manager is telling you to do. Place the payment into the correct bank account.
Donation Clearing Example Setup
The key to setting up a restricted donation clearing account is found in how one or two settings are made in Theatre Manager.
Code Table Default Accounts
The two highlighted accounts below are what makes the automatic creation of G/L entries for transferring donations to the restricted account work.
- The first is the Donation-Bank Acct. Don. Normally Post To. which really should be the same account number as the operating account. When you look at a normal donation (second picture), you will see this account is placed into the 'Bank Account' field
- The second is the Donation-Bank Transfer Clearing Account. This will be an asset clearing account - which in general means that if something gets posted to this account, you will need to make a manual GL entry in your accounting system to get it moved from this holding place to the right bank account
Typical Donation - Non Restricted
This sample shows how the bank account is entered for almost every donation campaign. Typically these would be referred to as non-restricted. Theatre Manager will put any payments received against these donations into the operating account
Special Donation - Restricted
This sample shows how the bank account is entered for a donation that is deemed to be 'restricted' - meaning the money needs to be moved to a different bank account, or accounted for in some different manner. When the donation is paid for, Theatre Manager will create a clearing entry for you to this account.
Example of an order
This picture shows an order with two donations in it, one for each of the donation campaigns described above.
Sales Posting
When the sales posting is created, you can see that each of the donations is placed into its own sales/income account. This will happen whether or not there is a payment yet.
Deposit Posting
When the payment is received at some time after the donation is entered (it could be right away, or the payments for some donations can be received in installments), running the deposit process is intelligent enough to:
- Put the entire check into the cash account
- Decrease the receivables account like any other payment
- Add two special entries that offset each other
- The first entry from Theatre Manager is telling you to put some money into the restricted bank account because a payment was received for the donation
- The second entry is in the restricted donation transfer account. Normally the total value of funds in this account is zero. However, as payments for restricted donations are received, this account will increase in size. Theatre Manager tells you which donation the funds are for. At some periodic basis (daily, weekly, monthly), you will need to clear this account to zero. To do this, you go to your web banking and transfer funds from your operating account over to the various restricted accounts as identified by the clearing account.
Using this methodology, Theatre Manager makes it very easy to track special campaigns.

End Of Day Settlement over an Extended Break
Your credit card processor (Chase Paymentech, Authorize.net, Elavon, Moneris, etc.) requires that you settle your credit card batch on a regular basis (i.e. daily). Your merchant provider sets a specified maximum frequency between settlements so that they can guarantee that the amounts they have authorized for you will still be available when you go to collect the funds. Because authorized credit cards must be settled within the pre-defined frequency, there is a "Settle Batch Frequency" setting in the Setup>>Merchant Accounts>>Settlement tab that retains the maximum days that your merchant provider indicates before a settlement is required. The maximum setting in Theatre Manager is set for seven days before settlement is required, however it is recommended that this is set at three days in order to maintain clean batches and regular settlements.

This setting applies to Box Office Sales only, and if you are running web sales over an extended break (such as the end of year holiday season), your web sales will continue to authorize credit cards beyond the time out setting in Theatre Manager.

|
For most online payment gateways (Paymentech Orbital, Authorize.net, etc.) the actual timeout may be up to 30 days or longer and having a extended break of less then 30 days may not have any impact on your non-settled authorized cards. PC Charge and its processors are generally still in the three to five day range and will require non-settled authorized cards to be settled via Theatre Manager's deposit process. Check with your credit card processor to determine the maximum period in which credit cards must be settled.
Some credit card processors offer the service of auto-closing your batch if you plan to be away for an extended period. If you choose this option, you will need to force your deposit when you return from the break, after ensuring that Theatre Manager and your processor have the same credit cards and amounts in your batch(es). Check directly with your processor (Chase Paymentech, Authoriza.net, Elavon, Moneris, et.c) to see if they offer this service.
|
On an extended break, and if you have web sales occurring, deposits still need to take place on a regular basis. Therefore, your options are:
- Option 1: Stop all sales during the break, including Box Office, Web Sales and any donation entry by the Development Department - essentially 'close the shop'
- Option 2: Come in to the office and do your deposits every few days
- Option 3: Remote into your company network from your home office and perform your deposit.

|
You do not need to perform a complete End Of Day (Deposits, Sales Entries, A/R Posting, and Reports). You only need to complete the Deposit portion of the End Of Day in order to settle the batch.
|
Option 1:
Turning off web sales means you do not need to come in at all. If this is a time of year when you do not have many online ticket sales, gift certificates, passes or donations, this may be an acceptable option for you.
Option 2:
If you can stop by the office once every few days (within the limits of the Batch Settlement Frequency), then you can run the Deposits in order to clear the open batch. You do not need to run the full End Of Day until you return from the break if you do not want to.
Option 3:
The more likely option is to remote in to your company network from your home office and perform the deposits. You can (along with your IT department's permission and direction) use a remote connection to access your company network and run the End Of Day from your home. If you are running web sales only (and have an online payment gateway), you may choose to delay the End Of Day until you return to the office, as long as it does not exceed the time specified by your processor.

|
If you choose to use remote access to log in from your home office and complete the deposits, check with your IT department to ensure that you abide by the security rules and protocols they have defined for your company network.
|
At Arts Management Systems, we use TeamViewer for its ease of use, and the fact that in most cases it does not require a firewall configuration. There are several other remote access programs available, including:
- Remote Desktop Connection
- Apple Remote Desktop
- PC Anywhere
- LogMeIn
- VNC
- Timbuktu

|
While Arts Management Systems does not directly support any of the above products, we have tested each one and know they work for remote access. Installation, licensing requirements, and operation of any remote access product is the client's responsibility.
|
End of Day Settlement Warning
The End of Day Settlement Warning is designed to remind clients to complete the deposit process within a specified time frame. The purpose of the message is to ensure transactions are not dumped by some credit card processors if a batch open for an extended period of time. The message is simply a warning and can be bypassed by clicking the Continue button.
For example, Global Payments is notoriously strict and starts removing credit card authorizations that have not been deposited within 5 days - which throws out the settlement balance (one reason we recommend not using them as credit card processors)
You can alter the 'batch settlement frequency' which is the number of days before the End of Day Settlement Warning appears'.

|
Arts Management Systems strongly recommends contacting your Merchant Provider to find out what their policies are before altering the default. The number of days the batch can remain open depends entirely on your account setup with your merchant provider.
|
- Click Setup >> System Tables >> Merchant Accounts.
- Double click on your Merchant Account to open it.
- Select the Settlement tab.
- Alter the Settle Batch Frequency field as desired.
- Click the Save button at the top of the window.
- Close the Merchant Account Detail window.

|
You may be prompted to enter contact information for your Merchant Provider prior to closing the Merchant Account Detail window. Please ensure you have a Contact Name, Phone Number and E-mail Address for your Merchant Provider ready. This is used to tell employees whom to contact if there are issues with the credit card and the phone number to call at the credit card merchant services support line.
|
How do I correct an End of Day Imbalance?
Theatre Manager is designed to handle sales 24 hours a day, 7 days a week and allow you to do end of day processing while that occurs.
If you are running into problems trying to bring the daily imbalance to zero in end-of-day, then please follow the troubleshooting steps at fixing an imbalance
How do I tell which payment method paid for a ticket and why can it only be inferred from a payment allocation report?
We are often asked how to find out how many tickets were paid for using the various payment method such as Visa, Master Card, cash, etc. There is a need to do so to calculate discounts for royalty deductions, or to charge back to renters a portion of the ticket sale when their patrons use credit cards.
There is a way to find an approximate answer for business purposes. There is no way to find an exact answer of '1 ticket paid for by visa' as will be illustrated in the example below.
Getting a reasonable approximation
The reasonable answer can be obtained using the 'Revenues by Payment Method-Ticket Based' report or looking at one of the royalty reports. The general process for these reports are to:
- Run the 'Receivables-Based on Order Balances by Event' to see if anybody owes you money for the event. If there are any receivables, clear them out or pay them off
- Find all the orders for the tickets you need the answer for. e.g. you may want to do the calculation for all tickets sold to a particular show at the end of the run to obtain credit card discounts paid - and which can be deducted from royalty payments
-
Theatre Manager then finds all the payment methods for the orders and allocates the payment method amongst the tickets in the order.
-
The allocation is then printed on the report. Please refer to the examples below to see how this might work
Why cant the number be exact?
Lets use a simple example of why the question being asked is not available in ANY accounting system. i.e. specifically what payment method paid for an item out of inventory is simply not possible in any accounting system. It can be inferred, but there is no way of ascertaining 'fact'. (you won't find an answer in quickbooks that event attempts to do this).
First, Theatre Manager uses accrual accounting. This, at its simplest, means that each payment decreases accounts receivable. Each purchase increases accounts receivable. In a perfect world of buy one ticket for $10 and pay $10 in cash, it can be inferred that 1 ticket was paid for with cash.
What if the transaction gets complicated?
Lets use a more real world example. Suppose a patron buys a play pass for $100 and donates $50 at the same time. He is sharing the pass with a friend, so you get paid $50 from the friend by visa (the friend donated separately earlier in the year) and the patron pays $100 with Mastercard.
Question: how many tickets were paid with by visa at this time?
Answer: it could be inferred
- none because it is a play pass an they are not yet used.
- In fact, if they are never used, then the answer will be zero.
- A possible answer is 50/150 = 33% of the pass because that is the exact ratio of payments made on this order and you really don't know the patrons intent.
- A possible answer is 50/100, if you knew the patrons intent.
So far, there are 4 possible answers at the get go of the transactions. All, are in fact wrong. The simple answer is that when the pass was purchased, it increased receivables because something was sold from inventory. And the payment deceased the receivable.
Lets suppose time progresses and the patron starts to use the pass to buy tickets. At this time, the payment method for the ticket is part of the pass and we are now a few steps removed from the original transaction. And a patron can pass around the pass to other patrons to complicate things.
Finally, the patron may decide that they can't use all the pass, so they turn it in for a donation receipt.
These transaction happens with amazing regularity at any theatre company.
How do other industries do this?
The answer is: they don't. If you picked another industry such as a lumber store where you buy some lumber, some screws, a new power tool and pay with a gift certificate you got for christmas and top it up with some cash in your pocket and then use a debit card, you could be asking the same question.
Did my gift certificate pay for my cool power tool, or did it pay for my screws?
again, the answer is: YOU CANT PROVIDE AN EXACT ANSWER OF WHAT PAID FOR EACH INDIVIDUAL PIECE OF INVENTORY.
Summary
- In an inventory management system, it is never possible to clearly determine how each item removed from inventory is paid for.
- There is no accounting system that we know of that provides this capability in any of its reports
- Theatre Manager recognizes that there is an advantage to being able to approximate the answer with a degree of precision and provides report to allocate payments to tickets at the end of a run for purposes of royalty deductions. These are accurate to 4 decimal places and fractions of tickets
Please verify this with your accountant or auditor if you need further clarity.
Why is there only one A/R account in TM? Can we have one for donation receivables?
There is only one
Accounts Receivable (A/R Account) in TM for a couple of reasons.
Theatre Manager
- uses pure accrual accounting -and-
- inventory management (eg tickets, donations, gift certificates) does not permit separate receivable accounts in any accounting system.
- The roots of double entry accounting and the early 15th century textbook by a franciscan monk Luca Pacioli, who documented the system used by the Venetians make interesting reading.
In any accounting application that we are aware of, A/R is A/R is A/R. It is impossible to separate donation and ticket receivables when you consider that these are managed using standard accounting notions as part of inventory control.
Corner Store Example
Here is a simple example of a transaction that might occur using a corner grocery store that illustrates the difficulty in the concept:
- Your partner sends you out to buy tomatoes, lettuce, cereal and you arrive at the checkout counter. The clerk scans everything through and indicates that you owe $100.00 for your groceries. Essentially, this increases the balance owing on the order.
- Then you dig through your wallet and find you have a visa card, some cash, and coupons for $1.00 off the box of cereal. You recall that you have not paid your visa bill yet and are unsure where the remaining limit is, so you give the coupon and as much cash as you have to the cashier. Then you pay the remaining $35.00 using your visa.
- Happy with your purchases, its off home only to find out that you were supposed to pick up some romaine lettuce instead of iceberg.
- back to the store to do an exchange of lettuce, but they are out of what you need, so you settle for arugula instead (after calling home to your partner to confirm)
- This costs more, but since have no more cash left, or limit on your visa, the clerk, who knows you well says Don't worry, pay the balance next time you are in!
This leaves a quandary for the grocer's accountant - is the receivable for lettuce, cereal, tomatoes, or for that extra cucumber that you added to the order at the last minute because you thought it would be fantastic in the salad your partner was making?
The simple answer is that there is just one receivable. You still owe the grocer money for the balance on the order and it is really unclear, in an inventory management system, if that balance is for any particular item. To the grocer's accountant, the plain and simple answer is that you own them money. True, you could probably allocate part of the amount owing to tomatoes, cucumbers, lettuce or cereal, but as soon as you pay part of the payment next time you are in, you will alter each of those allocations - which is a lot of work and isn't something you want to do in any accrual based system.
Thats how all accounting/inventory management systems work, bar none. I do not know of one that separates out receivables on any inventory item.
Using Tickets and Donations Instead
You can substitute tickets, subscriptions, donations, and gift certificates for any of the vegetables above and you will find that you cannot easily separate donations receivable, given the shear volume of transactions such as:
- exchanging tickets for donations
- paying for a subscription and an annual donation at the same time using post dated visa withdrawals
- entering that annual board gift as a receivable, only to be informed by the donor that the original (large amount) was to also include 2 subscriptions and the gala dinner
Any of the above real-life examples are analogous to the corner store example. Theatre Manager is designed to provide 100% accurate accounting and these transactions, which simply alter the balance owing on the order, are managed through the single accounts receivable control account - just like all other accounting applications
How to bend the rules
We know that venues like to try to identify receivables by inventory item, specifically donations. The A/R report for order shows an allocation of donation vs other receivables using the simple rule that donations are always paid for first before any other item in an order. This report provides backup to auditors at year end, or at any time you want to see the amount that could be considered to be in donation receivables.

The receivables report is very explicit. It tells you:
- Who owes you the money
- The due date & days overdue. Very important: this can be affected by setting the final payment due date in the 'contractual' tab on the payment window. If it s a school/group sale for tickets, or an ad sales where they wont need to pay for 6 months, then set the final payment date 6 months in the future. If you do that, then the receivable will say in the current column - so this can be VERY useful)
- It makes a darn good guess at whether the receivable is for donations or tickets using simple criteria (see donation balance and ticket/memb balance columns). If there is a donation in the order, then any payment pays for that first before paying for tickets or anything else.
- It tells you current/30/60/90+ days overdue.. and based on that, who to send reminder notices to.
- And, if you wish, there is the PO# column. This comes form the payment window at the top of the screen (above the reason to buy). Normally nothing is put there, but you could put 'Ad Sale' or some other tag there if you want.
You can also see an amount in the End-of-Day wizard under the A/R tab. These are accurate at the instant they are viewed.

However (heavy emphasis on this), it is not wise to put this breakdown into your accounting program. Any simple ticket exchange for a donation, or conversion of a donation from a pledge to fully paid because the patron dropped off a check, or any turning in of a gift certificate for a donation simply becomes a make-work project and violates the rule of 'make G/L entries in your accounting program from TM's G/L list - exactly as is - unchanged'.
Since Theatre Manager handles it fine for you, it is not worth tracking in your accounting system. As illustrated above, the better way is to use TM as the A/R sub-ledger and produce sub-ledger reports from Theatre Manager.
In addition, you can move all future donations into a liability account using the setup in the donation fund accounts and be able to track future donations that way.
Computer & Network Setup
These are some frequently asked questions about getting a computer setup or making network changees for Theatre Manager and it's associated applications.
Checklist when performance has degraded recently
Theatre Manager performance should not degrade over time given a constant set of environmental conditions. Meaning, if I have the same number of users doing the same amount of work at at given time, then each user should see performance remain at the same level.
Sometimes we are asked to identify why Theatre Manager has slowed down, or is slow after it has been installed. In almost all cases, the issue is not Theatre Manager, but some setting that has changed on the network, on the computer, or on the server. The following list contains the 'usual culprits'. Please check to see if you have been affected by one of them should you experience an abrupt change in behavior with Theatre Manager.
Finally, we are not expecting problems to occur. Usually things just run. But sometimes it is possible for things to awry and a checklist of possible culprits is useful.
Things to look at on the Server
- Make sure auto update (Microsoft) or software update (OS-X) is completely turned off. Those features should never be run automatically. Microsoft is famous for delivering them often and restarting servers. its just bad news. Plan your service outages and do them all - say - once a month. Downloads of large patches in the background might be a problem, or restarts after an upgrade may have affected Postgres's buffer pools so it needs to run a bit to get faster and determine commonly used database pages
- If there is a virus scanner on the database server, and the server is used only to hold the Theatre Manager database, please disable it. There is no need to place a virus scanner on database traffic. At the very least, disable checking all incoming traffic on port 5432 and all scanning of changes to the database folders where postgres is installed in 'live' mode. If you really must scan the database folder, it is acceptable to run a once per day scan on the database folder - but only if scheduled late at night.
- If the virus scanner is required because the database server is also a file server, then disable all scanning of traffic on port 5432 as well as any disk scan on any file the postgres database directory and below. On Windows, this is located in "Program Files\Postgres". On OS-X, it is located in "\Library\Postgres"
- Look to any service that you might have added recently. For example, if you installed another program on the server, does that take resources that affect the original installation. If so, then you may need to re-configure that application, remove the application or reconfigure the postgres server. For example, Microsoft Exchange server is known to suck the resources out of a machine and it is always recommended (even by Microsoft), that it be placed on its own server.
- Check for disk space on the server. If you have less than 15%-20% disk space left, then you might want to get rid of some old data or backups. Postgres uses the operating system to do page swapping and if there is no space left, you will see performance degradation because you filled up the dad drive. Old database backups might simply be accumulating and you may wish to save older ones and delete them from the server
- Check the performance monitor (Windows or OSX) to see where your resources are going. If CPU is being consumed, see who is using it. If disk I/O is going crazy, that could be a clue
- Perform a 'vacuum analyse' on the entire database using PGAdmin (check with Arts Management first). Quick vacuum's occur automatically for each file - but the full blown one might be needed occasionally.
- It is possible that a parameter was set up incorrectly for the server. If other items are not found to cause the problem, please contact support and we can look at the postgres database parameters for you
Things to look at on a Workstation
This kind of trouble shooting is often on a comparative basis. You want to start looking at a workstation if running TM on the server works fine, or if TM runs fine on one workstation, but not another. Things to look at in this case are:
-
Does Theatre Manager run fine if it is the only application turned on? If so, look to other applications causing the problem and the solution might simply be a case of adding ram.
- Look at ram usage anyway and the applications that are running. If many applications are running, you may find you need a minimum of 2 gigs of ram just to smooth out performance of the workstation. This is especially important if those other applications can be chatty or active in the background. For example, if you have Theatre Manager, Word, Excel, Outlook or Mail, a browser looking for RSS feeds, youTube, music playing in the background, etc. etc. and all in use at the same time, you may just need ram.
- If you are streaming high bandwith video (like YouTube) at the same time as selling tickets, it is reasonable that it might affect performance of a machine while the streaming is going on
- Does TM receive data from the server reasonably fast, but does opening windows take a long time. If so, look to the type of processor. Theatre Manager uses the floating point processor to handle some screen interface elements. That means if you are running a Celeron, it could be slow - because Celerons do not have floating point. The minimum machine is a Pentium 4 or core 2 duo. Please refer to the standard machine to see if you meet those requirements
Things to look at in the Network
Resolving network issues can be tricky because many factors are at play. Resolving these usually involved swapping things around to try to isolate the problem. Things we've seen in the past include checking:
- if performance for all clients got bad at the same time, check the ethernet card and settings on the server. Make sure that you are not dropping packets and that you are always connected at the speed you expect to connect to the network at.
- Swap the wire from the server to the hub to see if that makes a difference
- Swap the port on the hub to another port to see if that makes a difference
- If only one workstation suddenly went slower, then check the ethernet card settings for speed and performance. It could be it is bad.
- Check the cable and change it to see if that helps
- Take the slow machine to a location where a machine runs fast, and plug it into its network port to see if that makes a difference. If so, it could indicate a problem of wiring in the wall or at the post on the router where the line terminates.
-
- Try switching the port on the router for the computer to see if that makes a difference
- Did you add any more network traffic? Does the performance change during the day and happen to coincide with other events. We had one University notice that tickets sales got slow each time classes got out and students used the internet. Another venue indicated that performance slowed down when all the actors were backstage using YouTube and doing mail. In both cases, the solution was to put the high bandwidth network users on a segregated (and controlled) network.
In all cases, it is important to go into troubleshooting mode to narrow down with component might be contributing to the problem. Eg:
- Turn all components off but TM to see if that makes a difference
- Try things at the server and move progressively away from the server to see if that makes a difference
- Swap wires or ports to see where that makes a difference. If swapping a wire at the server changes everything - you have your answer. If swapping a port makes the difference, then tells you there is a router issue
- Compare machines. All machines with the same issue tends to suggest the problem is at the server. One machine with the issue tends to suggest the machine of network port
- Move the problem machine to a non-problem location. That will tell you if the problem is in the machine or not
Client or Interface Function Not Available
The 'Client or Interface Function Not Available' can take on two meanings, depending on the version of OSX that you are using. The message actually relates to a library that Theatre Manager requires in order to talk to the Postgres database. Older versions that are hanging around might, on rare occasions, lead to a machine receiving this error message.
If you are using:
- 10.4.11, you may need a different version of the libpq.dylib file and you might need to put it in a different place
- 10.5 or later, OSX might be picking up an older version of the library. If that is the case, use Activity Monitor and locate 'Theatre Manager'. Then double click to look at the list of open files. What we need to do is look to see which path name that the libpq.dylib file is found at -- and make sure that it is looking at a pathname internal to the Theatre Manager directory in applications. If it is not, then call support and we can help resolve the problem.
OSX 10.4.11 Problem Resolution
When installing Theatre Manager on OS-X 10.4 workstations, some of the workstations may experience the following error due to an incompatibility with an extension file used within the Theatre Manager application.
The error would appear as:
To resolve this situation:
- Download libpq for OSX 10.4 and save it to your desktop.
- Extract the libpq.dylib file from the OSX104_libpq_dylib_compatibility.zip file (if it did not automatically extract)
- Go into \\Macintosh HD\\Applications
- Right-Click on the Theatre Manager icon and select "Show Package Contents"
- Go into \\Contents\\MacOS
- Move the libpq.dylib file into the \\Macintosh HD\\Applications\\Theatre Manager\\Contents\\MacOS folder replacing the existing libpq.dylib file
Installing Theatre Manager on a New Workstation
For Windows2000/XP computers
1. Download the latest version of Theatre Manager and save it to your desktop
2. Double click on the installer TMSetup.exe to install Theatre Manager
3. Follow and respond to the prompts
For OSX computers
1. Download the latest version of Theatre Manager and save it to your desktop
2. Extract the Theatre Manager TMSetup.zip file (if it did not automatically extract)
3. Double click on the installer "Theatre Manager" to install Theatre Manager
4. Follow and respond to the prompts
Installing Theatre Manager's Workstation Serial Number on a New Workstation
For Windows2000/XP computers
1. Download the serial.zip file (please e-mail support@artsman.com for the link) and save it to your desktop
2. Extract the serial.txt file from the serial.zip file
3. Move the serial.txt file into the "C:\Program Files\Theatre Manager" folder replacing the existing serial.txt file
For OSX computers
1. Download the serial.zip file (please e-mail support@artsman.com for the link) and save it to your desktop.
2. Extract the serial.txt file from the serial.zip file (if it did not automatically extract)
3. Go into \\Macintosh HD\\Applications
4. Right-Click on the Theatre Manager icon and select "Show Package Contents"
5. Go into \\Contents\\MacOS
6. Move the serial.txt file into the \\Macintosh HD\\Applications\\Theatre Manager\\Contents\\MacOS folder replacing the existing serial.txt file
Starting Theatre Manager on a New Workstation
1. Start the Theatre Manager application
2. If you are presented with the "Theatre Manager Demo Login Window, click "Change Data File" in the lower left hand corner of the Login Window
3. Enter in the Exact Name of your database
4. Enter in the IP address of your server
5. Click Connect
Making internal LAN ip addresses changes
If you change the subnet inside your router, there is very little to change to get things working again. Things that need to be changed are:
- the accepted IP range in the postgres pg_hba.conf file
- the accepted IP range in Apache's httpd.conf file
- internal DNS setting to find the apache server
1. Changing the postgres pg_hba.conf file
This file is found in the postgres 'data' directory. On a PC, you can edit it with notepad. On a Mac, you might need to use 'vi' to edit the file while acting at the postgres user. You need to change (or add) a subnet range that allows people to access the database from the new IP range and/or remove the old one.
Once the subnet has been changed, you need to reload the postgres configuration. You do this by stopping and restarting the server, or if you are familiar how to do so using pgAdmin interface on the PC or the command line on the Mac, you can do it that way.
2. Changing the Apache httpd.conf file
The apache httpd.conf file is found in the 'conf' directory of the apache folder. On both Mac and PC, it can be altered by any text editor. Near the bottom is a setting that says:
SetEnv TM_LISTENER_MASK 192.168.0.255,68.145.52.251,127.0.0.1
Change the ip address range here according to the instructions in the conf file.
After, restart apache and test that it works by typing one of the following in a browser on the machine that Apache runs on:
If you do not get a response, Apache is not running and you will have to determine why it is not.
3. Changing the internal DNS server or Hosts file
For Mac listeners, there is nothing further to do. On PC networks, you many have to reset some internal DNS entries so that it points to the new computer.
For example: suppose that the setting TM is looking for is https://tickets.myvenue.org but it can't be found by machines inside the network.
- Outside the network, anybody can find https://tickets.myvenue.org because the external DNS services point it to your router.
-
Inside the network, getting things to point outside can be troublesome. the internal DNS setting for https://tickets.myvenue.org needs to point to where the apache server is at this time... at the new IP.
- You can do this in two ways:
- if you have DNS server set up on your IIS server, change the entry for tickets.myvenue.org
- if you do not have a DNS setting, you need to edit the 'hosts' file on each machine that is acting as a listener or needs access to the web listener. Typically, that is in the /windows/system32/devices/etc folder, or on the Mac, it is in /etc
For example: if the Apache server is at 192.168.0.12, then you need an entry in the hosts file that points tickets.myvenue.org to 192.168.0.12. If you are changing the IP address, then you will likely notice an entry for the old IP which needs only changed.

|
If the hosts file was edited, and you decide to implement an internal DNS server, you will have to clear the entry out of the hosts file on each computer that it was put on.
.
|
Starting and Stopping Theatre Manager
Theatre Manager consists of a few components that may be on one or more servers. It is a good idea to start and stop then in the appropriate order. If you do not and something is not working, then the best approach is to start at the beginning and perform the steps in the suggested order.
Order to Start Up components
Start the various server components of Theatre Manager in the following order:
- The postgres database server, apache, and PC Charge credit card server are independent of each other. You can really start them in any order you want. They must all be running before you can start Theatre Manager on any machines.
- Start Theatre Manager running on the web listeners
- Allow other Theatre Manager users to log in on their machines or to connect to terminal services if using it remotely
Order to Stop components
Generally, you stop the components of Theatre Manage in the reverse order that you start it up.
- Have all users quit Theatre Manager on all workstations
- Stop Theatre Manager running on the web listener machines
- Shut down or restart postgres, credit card server and apache server in any order you wish.
Some exceptions to the above
- If you want to restart apache server, you should stop all the web listeners first. You don't have to do anything special with the postgres or PC Charge servers. While the above is recommended, you can sometimes just:
- restart the apache server
- go to each web listener and click the 'stop server' button on the web listener interface
- then click the 'start server' button on the web listener interface
- If you are not processing a credit card at an exact moment in time, you can stop and start PC Charge independently if you need to. Anybody trying to process a credit card while PC Charge is stopped will get a decline message.
Theatre Manager preference file
Preference settings unique to each machine are stored in the standard preferences location defined by Microsoft and Apple. These may vary depending on operating system and version that you are using.
MyUser represents the user you are logged in as. This means that each user of Theatre Manager on a shared machine will have their own preferences:
| Operating system |
Generic Location |
Typical Path name |
| OS-X |
HOME |
~/Library/Preferences/TheatreManager/TheatreManager.plist
note: ~ refers to each users preferences, or /User/MyUser/Library/Preferences/TheatreManager |
| Win 2000 and XP |
USERPROFILE |
C:\Documents and Settings\MyUser\Application Data\TheatreManager\TheatreManager.txt |
| Vista/Win 7 |
LOCALAPPDATA |
C:\Users\MyUser\AppData\Local\TheatreManager\TheatreManager.txt |
The current contents of a sample preference file is below. These may be changed upon advice from customer support. Only the bold values can be adjusted for some of the italic fields.
<?xml version='1.0' encoding='UTF-8'?>
<theatremanager>
<key>CashDrawerDelay</key><int>0</int>
<key>CashDrawerPort</key><int>0</int>
<key>DatabaseIP</key><char>127.0.0.1</char>
<key>DatabaseName</key><char>TheatreManagerDemo</char>
<key>DatabasePort</key><int>5432</int>
<key>DebugDam</key><bool>false</bool>
<key>DebugMode</key><int>0</int>
<key>PingServer</key><bool>false</bool>
<key>Printer1</key><char>255/192.168.0.64@10001</char>
<key>Printer2</key><char>255/192.168.0.64@10001</char>
<key>PrinterType</key><char>31/0/20</char>
<key>WebLogPath</key><char>Doug's HD:Users:Shared</char>
<key>WebThreads</key><int>5</int>
<key>WebTimeSlice</key><int>20</int>
<key>WebPort</key><int>5111</int>
<key>Wireless</key><bool>false</bool>
</theatremanager>
Unable to connect to the database or print on the ticket printer.
A small analogy that might help explain how networking works for Theatre Manager and it might mean that if there is an outage, the following steps may help solve most of the connection issues.
IP Address Analogy
IP addresses are like phone numbers. Each server and machine on the network has one. Each IP based printer also has one.
-
The ones on the printers and the database server are 'fixed'. That means they should not be changed. TWe recommend putting a label on the printers inside the back of the printers to remind you what it is. You will see the one for the database server see each morning when you start theatre manager. This is at the bottom of the login screen.
- The workstations usually have 'dynamic' ip addresses. That means each morning they could be given a different one from the router. This is a good idea as it simplifies network setup and maintenance.
Everything will work well if you can 'dial' those 'fixed' phone numbers using Theatre Manager. It's like 911 and 411 - you only need to know those phone number to get help or to get directory assistance.
Every other phone number can change, but as long as those two stay the same, you can get help and find out a phone number for anybody else. In theory, as long as the network stays up, or is started normally, or is not changed, you will be able to 'dial' those phone numbers
But what If I can't Dial Those Numbers
What can get in the way of being able to 'dial' these special IP numbers from Theatre Manager.
-
If the router is not up, you simply cannot make a call. That should never go down and if it does, restart it or contact your IT support person if you need them to start it for you
-
If the router configuration is changed and starts giving out phone numbers with different area codes, you can no longer make a 'local' call to the printers or servers. Generally, that should never change.
- If they need to change, have changed the permanent phone numbers for the printer and server in advance of the change -AND- change the numbers inside Theatre Managers 'phone book' so that you don't have an issue
-
- If the power is out to any of the little routers or servers along the way - you can't complete the call
- If, for example, a rat chews a cord, then there is no wire (this really happened at a venue) and it must be replaced so you have a connection.
Those are only examples. and really, the computer network should just work with little attention. It is much like the phone system .. you can call direct anywhere in North America, Europe, and most of the world with no worry.. You should always get a dial tone.... and generally, phones just works unless there is some power issue, storm, or somebody is doing maintenance on the phone network.
Same goes for the network that Theatre Manager relies on If the network is there, then any machine should be able to dial any machine. If you cannot dial a machine or a printer, then tools at your disposal are:
- Ping to see if you can get from one machine to another.
- If ping does not work, then time to call your IT person - it is a network problem
- if ping works, then check to see that the database is started (again time to call your IT person). If the database is not started on the server, you won't be able to get to it.
General troubleshooting steps
Generally, try the following:
- Try and ping the server
- If you can, and Theatre Manager tells you that the database is not there at the server
- If everybody can use the database, except one machine, reboot the one machine
- If nobody can use the database, then reboot the server and try again at the top
- If nobody can use the printer, restart the printer
- If one person can use the printer, but another cannot, reboot the machine and go into the employee preferences in Theatre Manager and set up the printer IP address.
- Check to see that nobody turned on a firewall at the server
- Check to see that nobody turned on the Firewall on the Windows or OS-X machine to prevent outgoing connections.
If none of those work, call your IT person to see what they have to say.
If the situation is still not resolvable, then call Arts Management Systems as there may be something else at play and we'll be happy to help.
Credit Card Authorization - PCCharge
This section deals with commonly asked questions about credit card authorization and ongoing maintenance of the credit card server (PC Charge)
Credit Card Charges do not show up in Deposit.
Sometimes you just know that there are credit card charges that have been done throughout the day and you cannot see them in the deposit window during End Of Day process. There are two possible reasons:
No Employee Permissions to deposit credit cards
Depositing credit card batches is a responsibility that is not necessarily given to every employee. If you do not have the ability in your employee preferences to deposit credit card batches, you will not see any credit cards in the deposit list. It means you cannot deposit them inadvertently. The benefits to this are to allow certain employees the ability to deposit credit cards as part of the accounting procedures, while preventing others from making unscheduled deposits throughout the day.
No Internet Access
For your own protection, Theatre Manager will not show any credit cards to deposit if it detects that the internet is not available. This prevents a venue attempting to settle a batch in Theatre Manager and force closing it, without the corresponding batch being closed at PC charge and/or the bank.
Theatre Manager assumes if it cannot talk to the internet, then PC charge cannot talk to the Internet. If both cannot talk to the internet, then money might not make it to the bank which, after all, is the goal of everything.
It is far harder to recover money if you close Theatre Manager without closing PC charge and sending the batch to the the bank. So having a valid internet connection ensures all are in sync.

|
"Internet Access" is simply defined as being able to ping our mail server. Having that pathway open is sufficient enough for Theatre Manager to think it can talk to the internet.
|
Missed Settling PC Charge within the Required Time Period
The following steps may need to be followed if the settlement process in PC Charge has not been completed within the required time period and credit cards previously authorized are no longer valid and are required to be re-authorized again. The maximum time period between settlements is determined by your merchant provider, not PC Charge nor Theatre Manager.

|
It is required to force settle PC Charge and Theatre Manager at the end of this process even though the merchant totals and Theatre Manager will be in balance, because of the missed settlement timeline. In PC Charge, it will appear (as appearance only) that the batch totals are higher for the total credit cards that you were required to re-authorize and they will appear (as appearance only) that those cards were charged twice.
|
Follow the steps below to:
- Determine the starting batch totals from the merchant provider via PC Charge
- Determine which credit cards need to be re-authorized in Theatre Manager
- Authorize the credit cards in PC Charge
- Verify the batch totals from the merchant provider via PC Charge
- Manually Settle PC Charge
- Force Settle Theatre Manager
Determine the starting batch totals from the merchant provider via PC Charge

|
The steps for your merchant provider may be different, but in most cases the following steps are the same. If the following menu options are unavailable, please contact Arts Management Support.
|
- In PC Charge goto Batch >> Inquire >> Open Batch
- Click OK
- Write down all the numbers presented on the screen. The key value that will be used to balance to, is 'Total Balance $'
- Click Close Form to close the window
Determine which credit cards need to be re-authorized in Theatre Manager
- Log into Theatre Manager as an employee with 'master user' access
- Go to Accounting >> End of Day Wizard >> Deposit tab >> Deposit Funds
- Enter today's date
- Click Deposit
- Select ALL non-credit card payments
- Click Remove in the window toolbar. This will just 'remove' the payments that we do not need to deal with at this time -- they have not been deleted.
- Click Summary by Patron
- Maximize the window size in order to view more columns easily
- Sort by the 'Date Received' Column (do this by clicking on the column header)
- Start at the BOTTOM of the list and start multi-line selecting each credit card one at a time. At the bottom of the window, there will be a 'total' payments displayed. When this 'total' matches the PC Charge Batch 'Total Balance $' that you determined in the prior step, then STOP. You now have the credit cards authorizations that the bank has.
- Click Remove in the window toolbar. This will just 'remove' the credit card payments that we do not need to re-authorize at this time -- they have not been deleted.
- The credit card payments on the screen, are the payments that need to be re-authorized as their 'authorization number' provided by the bank is no longer valid.
- Click Print in the window toolbar to get a printed report of the payments that need to be re-authorized or use the list on the window as a reference if PC Charge is close by.
Authorize the credit cards in PC Charge
- In PC Charge go to Transactions >> Credit Card >> Sale tab
- Enter in the credit card information, Amount, Ticket Information (order number), and Zip Code (for Canadian clients, enter 99999)
- Click Process
Repeat the above steps for each credit card that is required to be re-authorized.
Verify the batch totals from the merchant provider via PC Charge

|
The steps for your merchant provider may be different, but in most cases the following steps are the same. If the following menu options are unavailable, please contact Arts Management Support.
|
- In PC Charge go to Batch >> Inquire >> Open Batch
- Click OK
- The batch totals should now match the total credit cards in Theatre Manager.
If the totals match, then carry onto the next step. If the totals do not match, then you missed entering or double entered (depending on the total difference) a credit card -- go and correct the mistake.
Manually Settle PC Charge

|
The steps for your merchant provider may be different, but in most cases the following steps are the same. If the following menu options are unavailable, please contact Arts Management Support.
|
- In PC Charge go to Batch >> Settle
- Click OK
- The batch will now be settled with the merchant provider.
Force Settle Theatre Manager
- Log into Theatre Manager as an employee with 'master user' access
- Go to Accounting >> End of Day Wizard >> Deposit tab >> Deposit Funds
- Enter today's date
- Click Deposit
- Proceed with the deposit as normal.
- At the end of the process, you will get warning messages that the PC Charge could not be settled -- this is ok, as you have manually settled it. You will be asked if you should 'force' the deposit, click the buttons to proceed with a forced deposit -- there will be multiple warnings.
PC Charge database is approaching limit
Every time you start Theatre Manager, it checks to see if it can find the credit card server and inquires about its health. After many credit cards have been authorized, you may see a message that indicate that PC Charge's PCCW.MDB database is approaching its recommended maximum.

|
This is an advisory message only and not an error message. The warning starts appearing when the PC Charge Database is approximately 75% of its maximum recommended size of 20 MB.
|
You will continue to get this notice each time you start Theatre Manager, until you archive the PC Charge data file. You can exceed the manufacturers recommended maximum and can still process credit cards, however, you may see authorizations and reports slow down and other odd behaviour as the file gets bigger. We recommend taking care of this situation as soon as practical.
To shrink the size of the PCCW.MDB database
Pause all Web listeners to prevent any sales while you are performing the following steps. The time required might be 5 minutes.
- Pause all Web Listeners on all machines.
- Complete your End of Day Deposit process in Theatre Manager.
- Close Theatre Manager.
Steps at PC Charge machine
Go to the machine that has PC Charge on it and open the PC Charge interface. Perform the next steps at that machine.
- Click the EOD button.
Ensure the batch totals are zero. If they are not, start the instructions at the top of the page.

|
If there are still batches (or intermediate batches), please call support and do not continue.
|
- Click the Cancel button.
Close out of PC Charge completely(do not minimize).
- Open My Computer.
Navigate to c:\Program Files\Active-Charge
Look for the file called PCCW.MDB. Verify that its size is about the same as reported by Theatre Manager.
- Right-click on the pccw.mdb file.
- Select Send To >> Compressed Zipped Folder.
Allow the file to zip.
- Right-click on the zipped copy of the pccw file (it will be a yellow folder with a zipper on it).
Select Rename.
Add the date to the end of the file name but before the .zip extension.
- Right-click on the original pccw.mdb file.
Select Delete.

|
Optionally, you can copy the zipped pccw file to a location for storage and backup (the BoxOffice\Backups folder containing daily backups is a good option).
|
- Start up PC Charge.
When you start PC Charge, a new pccw.mdb file is created. This file will continue to store future transactions for you.
You can now start Theatre Manager, resume sales and start any web listeners.
Form letters, batch merges and email blasts
The form letter portion of Theatre Manager can be used for sending out letters or mass emails. With the addition of google analytics to the bottom of your page, you can gain a wealth of statistics.
Most important, when the letter or email is sent from Theatre Manager, you get absolute tracking of the correspondence. You know when it was set, to whom it was sent, and an exact copy of what was sent is attached to the patron for later viewing.
Creating a mail list for eblast that excludes all household members for a condition
There are some cases where a client may wish to create a mail list to merge with a letter for eblast that will include patrons in the database with email addresses, but exclude patrons and their associated household members if that patron or one household member meets a particular condition. For example, you may wish to eblast everyone in your database with an email address, except attendees to a recent event and any of that attendee's household members.
For step-by-step instructions on how to build a mail list, click here. For steps on how to create a form letter in Theatre Manager for eblast, click here. And for steps on how to merge a form letter with a mail list, click here.
The following steps will specifically arrive at a mail list for the above example. Similar steps could be used to fit other cases (exclude patrons in a household where one member has donated, or exclude patrons in a household where one member has a particular marketing flag set).
- Start by creating a new mail list. If you need steps for doing so, reference the link above for instructions.
- On the description tab, set the patron selection drop-down to "All patrons in household"
- On the Criteria Tab, ADD a group to the mail list with the following:
Marketing Primary Email Unique # is greater than or equal to 1
Make sure to check the box to exclude patrons marked "do not email" if you wish to exclude those patrons who have asked for no email contact
- Then add a REMOVE group where the
Event # is one of the event in question - The Rolling Stones

- Execute the mail list
The same instructions could be used to create any number of mail lists. The only variable you would need to change is the REMOVE group.
Post Office CASS certification (USA)
CASS certification is required by the US post office to obtain bulk rates and is based on the content of your data. There is a web page at USPS that explains this.
Theatre Manager provides the tools to help your database become CASS certified
- bar code printing with supplied font
- conversion of the text within the address to uppercase
- conversion of items like Road to RD and Street to ST
- export of data from TM
- import of corrections into TM
CASS certification is not actually for the software, it is for CONTENTS OF THE DATA in a database.
It means that each database of addresses needs to be CASS certified and verified annually. When that is done, you get a certificate about YOUR DATA that allows your venue to have the bulk rate for subsequent mailings. This means you can do it once a year.
The process is generally to:
What can I do to view html emails prior to sending
Composing html emails to send to people needs a little bit of knowledge of design, but very little when it comes to composing html emails.
In Theatre Manager, you have two options for sending out HTML formatted emails. You can either:
- Format the emails in Theatre Manager an send them out as is. They will be sent in 'what-you-see-is-what-you-get' format (if selected during export).
- Or you can have total control over the contents of the HTML and use and external tool to design a web page and then paste the resultant HTML into the form letter
Theatre Manager WYSIWYG email
When using Theatre Manager's WYSIWYG option, you will need to do a one-time setup to connect to the Apache server 'htdocs' folder. Then just create your email blast letter inside Theatre Manager.
Using externally composed HTML
For the option of designing web pages externally, an excellent tool is Dreamweaver. If you have your non-profit id, this can be purchased for $25 at Tech Soup. Its handy for editing things and viewing web pages.
Or, your web designer, can post the page on the internet and you can view it with internet explorer, firefox, safari of other browsers. Or they could email the HTML and if you save the file on the desktop, just drag it onto your web browser to see it.
This this, every venue has the software to view an html email it on every workstation in the office.
Before sending, make sure the images are visible.... if they are, then:
- copy the email into a theater manager letter
- and blast it out.
- make sure you do a test blast to yourself first to make sure its right
- ... then send it to all people on a mail list
HST Calculation and Theatre Manager
Often we receives questions concerning the calculation of taxes in Theatre Manager and that Theatre Manager's calculation doesn't always match to those calculations outside of the program. The following is an example of how Theatre Manager builds and calculates taxes, specifically related to the compound harmonized tax rate of 5% and 7%.
Theatre Manger is built to calculate tax on each entity of an order: the ticket price, ticket fee #1, ticket fee #2, ticket fee #3, membership/passes, order and exchange fees. And as a result truly a more accurate account of taxation.
Lets consider a very common ticket sale transaction which consists of 5 tickets: 2 Adult, 2 Senior and 1 Student. The tickets are priced as follow: 2 @ $15.00, 2 @ $13.00 and 1 a $12.00 to then which taxes are them applied. If one were to add that up on "paper" one would add: $15.00 + $15.00 + $13.00 + $13.00 + $12.00 to equal $68.00. Then take $68.00 x 5% = $3.40 + $68.00 x 7%= $4.76 for a grand total of $76.16. but that is not accurate.
Theatre Manager does however calculate tax as:
- 15.00 x 5% = 0.75, then 15.00 x 7% = 1.05
- 13.00 x 5% = 0.65, then 13.00 x 7% = 0.91
- 12.00 x 5% = 0.60, then 12.00 x 7% = 0.84
- 15.00 + 0.75 + 1.05 = $16.80
- 13.00 + 0.65 + 0.91 = $14.56
- 12.00 + 0.60 + 0.84 = $13.44
- 2 tickets @ $16.80 = $33.60
- 2 tickets @ $14.56 = $29.12
- 1 ticket @ $13.44 = $13.44 for a Grand Total of $76.38 * not $76.16 as calculated on the total.
It is indeed more tax but more accurate as Theatre Manager treats each ticket individually. It is necessary calculate in the manner if you have occasion to refund one of those tickets or exchange and upgrade one of those tickets in this example.
Limited Profile Patron Feature
A significant new feature has been added to Theatre Manager called 'Limited Profile Patron'. We heard that some venues may not always want capture name and address information on every patron during a web sale. This feature allows you to accept a web sale and specify which data is mandatory before allowing the patron check out. It can range from as little as name/email to the same full requirements as the box office.
In the Web Sales Module
This feature is designed to allow a patron to buy tickets, provide only sufficient information to get them their tickets, and checkout. If they buy again, they would need to provide the same information they provided the first time. For example: if all tickets are print at home or held at will call, you only need the patron name. If you still want to mail tickets, you will need to make address mandatory.
If the 'Limited Profile Patron' feature is enabled in System Preferences, the following will apply:
- Patron still has the option of logging in to an existing account to see prior purchases.
- A new patron will always be created if they choose the quick checkout process and provide their name, email, address, etc. again
- Theatre Manager always makes a check using the email address. If it already exists in the database, this 'new' patron will be added to the existing household. If the email does not exist, a brand new household will be created.
- A patron who checks out as a 'Limited Profile Patron' has no login credentials. Ordinarily, this means they cannot log in and see past purchase history. However, if they visit the web site and ask for their password to be emailed, they can log in with their email and password and purchase again. If they do that, they will be required to complete the patron information that they did not complete the first time (thereby becoming a full profile patron). If they never log in and simply buy again (they don't ask for their password), they will have to provide their name each time they checkout.
- At the box office, 'Limited Profile Patrons' are indicated on the patron list using a new icon. If you edit the patron contact card for one of those patrons at the box office, you will then have to complete the missing information before the data can be saved.
- You will need to implement a feature to find and merge 'Limited Profile Patrons' on an ongoing basis if you allow the feature. This is because several records may be created for the same patron if they never log in.
Instructions for enabling Limited Profile Patrons follows here.
Enabling Limited Profile Patrons
To enable limited profile patrons, go to Setup > System Preferences and choose the Mandatory Data tab.
Allow Limited Profile Patrons On
- Web sales checkout - checking this box enables patrons with limited patron data to buy tickets.
- Web sales mail list add - checking this box enables patrons to sign up for mail lists giving only essential information (email address, name). Click here for more information about this feature.
- Credit card swipe - checking this box will enable patrons to purchase using the information on their credit card (name on the card). This is most useful for auctions and is described further here.
Limited Profile Web Sales Checkout Patron Data
This is where you set the minimum data patrons must provide to access the web sales checkout.

|
If you mail tickets, please make patron address, city, state and zip code mandatory.
|
If all tickets are held for will call or print at home, then set as many of these options as you'd like (even none).
"Quick Add" to a Mail List online
The limited profile patron feature can be used to allow patrons to do a "quick add" to a Mail List online using a quick submit form. This will allow them to be added to a Mail List without providing all the standard patron data normally required for a full log in. Instead, all that will be required is name, address and email.
The form can be placed either within the Theatre Manager web pages, or outside on your main shell site, depending on where you want to display the form and capture the data. The form is not a standalone page, but rather is incorporated into another page, whether on 'www.yourtheatre.org' or 'tickets.yourtheatre.org'.

|
The concepts in this topic are designed for the more experienced user. Please contact your web designer if you want to implement this advanced web feature.
|
- To use this feature, you must let the mail list be visible on the internet. For information on how to do this, click here.
- You must allow limited profile patrons to be added using mail lists. To learn more about this setting click here.
- If the patron's email address already exists within the database, creating a limited profile patron will create a new patron within the database. Your Box Office staff will need to be vigilant about merging duplicate patrons.
- At minimum (when used on the main website such as 'www.yourorganization.org'), the form will need to collect three fields in order to subscribe the patron to the Mail List:
- First Name
- Last Name
- Email Address
A sample file can be found in your WebPageEN directory in tmTemplates/tmMailListQuickAddInsert.html. If you need assistance locating this file, please contact your web designer. The sample file shows how you can use hidden parameters, checkboxes and lists all around a form that is submitted.
Examples:
The entire form would appear like the example below:
< form ACTION="http://tickets.yourvenue.org/login" METHOD=POST name=form>
*** Insert form parameters here (see below) ***
< INPUT NAME=C_FIRST_NAME TYPE=text VALUE="" SIZE=30>
< INPUT NAME=C_LAST_NAME TYPE=text VALUE="" SIZE=30>
< INPUT TYPE=text NAME=e VALUE="" SIZE=60>
< input type=submit name="btnAccountMailListAdd" value="Subscribe to Selected Mail Lists">
< /form>
When building the form, it must open with the following framing code:
< form ACTION="http://tickets.yourvenue.org/login" METHOD=POST name=form>
Then enter the form contents.
If you wish to pass a parameter for a hidden input (for example, adding the patron to a specified Mail List), the code would be:
Click < input type=hidden name="PM_SEQ" value=5> to add me to the Comedy mail list.
where '5' is the sequence number of the Comedy Mail List. The sequence number of the Mail List can be found within the Mail List window or on the List of Mail Lists search window. This will produce a listing on your form such as :
Click [button] to add me to the Comedy mail list.
A similar line can be used to create a checkbox (as in the sample provided), by using the code:
Click on one or more of the following:
< input type=checkbox name="PM_SEQ" value="5"> Comedies
< input type=checkbox name="PM_SEQ" value="10"> Dramas
< input type=checkbox name="PM_SEQ" value="12"> Musicals
which would create a checkbox to add the patron to Mail List 5, 10, and/or 12.
Click on one or more of the following:
[ ] Comedies
[ ] Dramas
[ ] Musicals
The file also provides List support, where a list of options can be displayed:
Choose from the following options:
< select name="PM_SEQ" size="10" multiple id="PM_SEQ">
< option value="5">Mail List #5
< option value="10">Mail List #10
Choose from the following options:
[The names for Mail List 5 and Mail List 10 will appear in the drop down]
And finally, close the form by collecting the First Name, Last Name and Email Address fields:
< INPUT NAME=C_FIRST_NAME TYPE=text VALUE="" SIZE=30>
< INPUT NAME=C_LAST_NAME TYPE=text VALUE="" SIZE=30>
< INPUT TYPE=text NAME=e VALUE="" SIZE=60>
< input type=submit name="btnAccountMailListAdd" value="Subscribe to Selected Mail Lists">
< /form>
As stated above, if the form is used OUTSIDE Theatre Manager - meaning it is not on the tickets.yourserver.org web site but rather on the shell site of 'www.yourserver.org,' then you have to make sure that the form includes the three fields for name and email.
However, if the form is served up by Theatre Manager from within the Apache server, then you can end the form after the options by adding the form closing code:
< input type=submit name="btnAccountMailListAdd" value="Subscribe to Selected Mail Lists">
< /form>
and the patron will be added to the selected mail lists.
Quick Mail List Sign-up Online
Limited profile patrons also allows quick sign up to any number of mail lists by providing only name and email info (rather than the usual new sign up or sign in process).
Quick Add Setup
- This feature is a simple form on your web sales site. Users can select which mail lists they'd like to receive from a list defined by the venue.
- You need to set up a form to tell TM which mail lists to include on the form that users will select from.
- Please refer to the samples in the web page tmMailListQuickAddInsert.html. You can find this page (and others new to Version 8.15) by clicking here.
- Double-click that file to preview what it will look like, then open it with a script editor (WordPad on a PC, Apple Script Editor on a Mac) to make the changes to it representative of your venue (ie. add your mail lists to it in place of the samples). For example, this is the page opened for preview:

And this is the same page opened in a script editor:

- So using the example in a script editor, you would change the name of the mail list at the end of each line to match a mail list you have set up in your database.
- Save the edited file then place it in your web pages folder under TMtemplates.
Confirmation Email
If the patron was not logged in when they subscribed to a mail list (the only gave their name and email), they will receive an email asking them to confirm their subscription to the mail list. Patrons who follow the usual sign-in routine will not be subject to this confirmation process.
If they do not confirm their subscription to the mail list(s), they will automatically be removed from the mail list after a specified number of hours (default 24) in Company Preferences. This occurs during the end of day process when other web information is purged.
- To change the default setting go to Setup > Company Preferences and open the End of Day tab.
- In the bottom left, there's a section for Web, Logs & Shopping Cart Retention Policy settings.
- Set the Purge unconfirmed mail list number of hours to the desired setting.
If the email address a patron uses here exists in the database already, the patron in the database will be added to the mail list. If the email address does not exist, then a new 'limited profile patron' record will be created for the patron.
Credit Card Swipe
There is a convenient quick-add feature that creates a patron by swiping their credit card. This might be best used during the admittance process for Auctions. The process works as follows:
- You start by setting the Patron List window to search by credit card. For more info on the Patron List window, click here.
- Then, when you swipe a credit card, it will find the patron if that card number is in the database.
- If the card number does not exist in the database, TM gives you the option to quick add the patron attending the auction.
- Patrons added in this way will be 'limited profile patrons'. That is, the name on the card along with their credit card on file stored in the database.
- In an auction setting, if there are bid packets, you can give the patron the patron number created during the swipe.
- You can now sell auction items to this patron using the auction process.

|
As with any limited profile patron, if you edit their actual address data, you will be required to provide the minimum information normally required of the box office.
|
Section 508 of the Rehabilitation Act of 1973 (Rev. 1986)
Note: This page is under construction.
The Wikipedia synopsis of the act reads
An accessible information technology system is one that can be operated in a variety of ways and does not rely on a single sense or ability of the user. For example, a system that provides output only in visual format may not be accessible to people with visual impairments and a system that provides output only in audio format may not be accessible to people who are deaf or hard of hearing. Some individuals with disabilities may need accessibility-related software or peripheral devices in order to use systems that comply with Section 508.
And out of that, we, as a Company, infer that it comes down to roles and responsibilities as follows:
Does each application need to provide multiple sensory formats such as speak/listen/look etc?
No, that is not the responsibility of the application. It is, instead, the responsibility of the operating system utilized by the end user.
Apple and Microsoft both have tools built into the Operating System that let:
- Visually impaired people see 'large text' and/or zoom in to parts of the screen.
- Speak highlighted text on a screen - again a function of the operating system.
How does one facilitate that feature and make sure that ANY application can use it?
If the user turns on the feature in the operating system that allows them to see/hear what is on the screen, all a venue needs to do is make sure that this data is presented on a screen in a way that the operating system can interpret.
The web browser (not theatre Manager) will speak/magnify the text on the screen using the operating system toolset. As long as the web site uses the techniques that are outlined in the points 'a' through 'p' in the "Detail" section below.
ArtsManagement Systems provides web pages that help you satisfy those requirements because they are simple HTML with no javascripting or pictures required to complete a sale.
For example, in Theatre Manager, the sales process:
- Lists events. Any of which can be spoken by the operating system
- By clicking on an event, and selecting seats, the user can fill out a form. The data is all text, so it can be spoken
- The seats that are offered are also text format, so those can be spoken
There are no pictures, plug-ins or other items in our web pages that obviate compliance with 508.
The focus of the act, then, is that if you modify the web pages, you need to take care how you embellish the standard web pages with any added customizations.
All this argues for the design of a simpler web interface than making some really complicated ones. That, again, is why we provide simple samples. Using the samples and being cognizant about any customizations will be enough to satisfy Section 508.
AMS has provided information and a number of features to support the ADA act changes. For more information on these changes, click here.
Our reading of the items below indicate that there are no further Theatre Manager changes required to provide support for this specific legislation and that you may want to examine the web pages yourself and make one or two adjustments. Our standard web pages are really quite simple and basic on purpose - which makes it easy to alter as you need.
The recap is:
- The Operating System on the end users machine is responsible for supporting their disability (or lesser able capability if you prefer) by magnifying or speaking the text.
- The end user is responsible for picking a machine that supports his/her handicap. You cannot be required (and are not required) to provide a machine to somebody so that they can buy tickets from you.
- Theatre Manager provides all web pages in a format and structure that the Operating System and browser can deal with it.
- The venue is responsible for modifying those pages in a way they see fit and at the same time, taking into account the requirements of Section 508 for any changes that are made (e.g., we don't need pictures, but if you add a picture, you need to create the speakable text as part of the 'alt' tag - if it is pertinent to the sales process). Note that random pictures for marketing purposes could be argued as not being germane to the sales process. Again, all the end user needs to hear is 'event', 'seat', 'price', etc. and it is far better if those are text.
- The browser will speak/magnify items for the user -- using Operating System functions as they are invoked by the user.
In Detail:
§ 1194.22 Web-based intranet and internet information and applications.
(a) A text equivalent for every non-text element shall be provided (e.g., via “alt”, “longdesc”, or in element content).
In the html tags, add alt='some text' to describe the field. We may put some standard text in future web pages to explain what a field is, but your organization will need to do this for any of your own pictures.
However, every data entry field on the default web pages has text that precedes it indicating what the field is for - which may, or may not be sufficient.
For example, the word 'address' precedes the address field on the patron input. The word Password precedes the input field for password.
(b) Equivalent alternatives for any multimedia presentation shall be synchronized with the presentation.
This item is not applicable
(c) Web pages shall be designed so that all information conveyed with color is also available without color, for example from context or markup.
The ArtsManagement Systems standard template web pages do not require color on any part of the sales process to complete the sale. Everything, including the seating maps, can be interpreted without color impacting the meaning.
(d) Documents shall be organized so they are readable without requiring an associated style sheet.
The standard style sheets AMS provides primarily affect font, size, and/or color. None of our standard provided style sheets affect placement of text - which essentially means that if the style sheets are absent, text falls into reasonable places.
(e) Redundant text links shall be provided for each active region of a server-side image map.
AMS does not use server side image maps in our standard pages
(f) Client-side image maps shall be provided instead of server-side image maps except where the regions cannot be defined with an available geometric shape.
AMS doesn’t use client side image maps in our standard pages.
(g) Row and column headers shall be identified for data tables.
These are in all tables in the standard template pages.
(h) Markup shall be used to associate data cells and header cells for data tables that have two or more logical levels of row or column headers.
Our interpretation of this is that it does not impact the template pages.
(i) Frames shall be titled with text that facilitates frame identification and navigation.
The standard template pages do not use frames.
(j) Pages shall be designed to avoid causing the screen to flicker with a frequency greater than 2 Hz and lower than 55 Hz.
There is no screen refresh in any web pages.
(k) A text-only page, with equivalent information or functionality, shall be provided to make a web site comply with the provisions of this part, when compliance cannot be accomplished in any other way. The content of the text-only page shall be updated whenever the primary page changes.
This is not applicable as there is no need.
(l) When pages utilize scripting languages to display content, or to create interface elements, the information provided by the script shall be identified with functional text that can be read by assistive technology.
We don't use scripts to create interface elements
(m) When a web page requires that an applet, plug-in or other application be present on the client system to interpret page content, the page must provide a link to a plug-in or applet that complies with §1194.21(a) through (l).
There are no plug-ins in the standard web page templates.
(n) When electronic forms are designed to be completed on-line, the form shall allow people using assistive technology to access the information, field elements, and functionality required for completion and submission of the form, including all directions and cues.
This is up to your organization to provide.
(o) A method shall be provided that permits users to skip repetitive navigation links.
This is not applicable to the standard web page templates.
(p) When a timed response is required, the user shall be alerted and given sufficient time to indicate more time is required.
There are no timed responses anywhere in the web sales. There is only one overall cart timeout that is specified by a venue, which will cause tickets to be released is the user ceases to do anything on the web site. This timer is reset with every access to the server. The default out-of-the-box value is 15 minutes of doing absolutely nothing. This setting can be adjusted by going to Setup>>Company Preferences>>Web Options tab, and adjusting the Timeout setting.
Web Sales
Use this section to answer a number of common questions about web sales issues.
Can Patrons Select their Own Seats?
Although giving patrons the ability to select their own seats seems like a good idea, it has some major drawbacks; reasons why we have not implemented online seat selection.
Here are three general problems with having patrons select their own seats:
- Marketing: If you wanted to display your live venue map online for patrons to select their seats from, patrons would be able to see how well, or more importantly how poorly, sales are going for a particular performance. If sales are going poorly and it is displayed online, it may not make for good marketing as patrons may delay making purchasing decisions. Our intuition suggests that sometimes you want to display available seats, and sometimes you don't.
- Single Seats: When selecting their own seats, patrons would always pick what they see as the best seats and because of this there would be many single seats created by patrons. For example, if there are three available seats in your best row, a patron buying two tickets is likely to buy two of the three available in the best row, and it would be very hard for the box office to sell the single seat left behind. By design, Theatre Manager's web listener will not allow tickets to be sold that will leave single seats.
- Application Development Priority: Picking seats online is a relatively complex development issue considering that each browser supports the same technology in a different way:
- Syntax for Javascript can change depending whether your patrons are using Internet Explorer, Safari, FireFox, Opera or some other browser.
- While there is a 'W3C' standard body, browser makers can implement the HTML standards how they see fit.
- Mobile platforms (iPhone, Android, Windows Mobile etc) further muddy the mix.
The slight differences from each of the above increases the amount of development effort significantly. Due to these factors, application development effort is currently focused on other features we believe to be more important to our customers. However, we are watching for technology convergence and may undertake efforts for this feature at a later date.
What can you change in your listener to help
In the web sales module, you have a fair degree of latitude to help users get to the seats they want without actually letting them pick them. To help your customer get seats near where they want you can implement one or more of the following:
- Have more granularity in your sections to narrow down where a patron may want to search
- Use the feature that shows what seats are taken by masking out the sold seats. This will help user make decisions on sections and know that they have been given good seats.
- Implement a feature that lets people break up their seats. This means that if TM cannot find 5 together, it would be enabled to offer 2 and 3 seats or 2, 2 and 1 seats. This feature would be good in high sales column situations, or where the seating arrangement in venues just do not support group style sales.
Clearing the Cache for Online Sales
Clearing the Cache on the Web Listener
- Locate the machine(s) that act as the web listener(s).
- Click the Clear Cache button toward the top left of the Web Listener window.
Clearing the Cache within Theatre Manager
- Click Setup >> Company preferences.
- Select the Apache tab.
- Click the green button to the right of the Last Cache Clear field.
Emails are not being sent by the web listener
Sometimes the patron may tell you that they are not receiving e-mails from Theatre Manager or you are seeing 'Connection Timed Out' messages on the web listener log.
If their email address is correct, it may indicate a set up problem.
Each day, you should review the email error log in Theatre Manager that displays any emails in error status. Errors can come from a few sources.
Check the Patron Email Address
Sometimes, the error is because the user spelled their email address wrong when setting it up in Theatre Manager. If this is the case, then send a test email to the patron from your email client program (eg apple mail or outlook). If they receive it, then make sure that the
primary email address on the patron record matches what they just gave you.
If you notice that the email address is blank in the error log, it means that the primary email address may not have been set for some reason. To fix those, then
- edit the patron record
- go to the Contact Info tab
-
- click on an email address (there probably is only one, but if there is more, select the most appropriate one)
- click on the Make Primary button to set that email address as the primary address
- you may also have to edit the employee's preferences (the gear on the main toolbar) and set the SMTP settings, password, authentication, etc as required
Then proceed to check the error log daily
Check the email settings in Company Preference
An email will not be sent to anybody unless the SMTP email settings in Setup->
Company Preferences are correct (on the first tab).
i.e. This must specify a valid email address, mail server, login account, password (if required), smtp port. These settings are generally similar to your internal email in outlook, entourage, apple mail, web mail, or whatever email client you are using. The email address is generally the outgoing boxoffice@myvenue.com or tickets@myvenue.com. Please decide on a generic email address for your venue as you do not want all rejected emails coming back to your personal account.
Once the settings are correct, use the 'Test Email' to send a test email from this account to yourself. Verify that the email was sent successfully at the bottom of the Company Preferences screen. If not, adjust the email server parameters until the email is sent successfully. If there is an error using the test email button, you will see the entire STMP dialog which should give you all the information needed to identify the issue.
In some cases, you will see errors like Unable to send email. SMTP: 550 ..... These typically mean that a setting needs adjusted on the SMTP server. Typical errors and actions are:
- SMTP 535 - usually means that the password is incorrect.
- SMTP 550 - usually means that the SMTP server will not allow relaying the email from the listener to the outside world. We see it most often with MS Exchange servers where somebody tightened down the security. This can be remedied by contacting your IT person, showing them the message and asking them to allow relay of emails from the listener to the outside. Alternatively, you may need to specify another SMTP server address
- SMTP 5xx - For other SMTP errors, please read the entire message. This usually tells you why the email could not be sent. The mail box might not be reachable, or there may be no mailbox on the remote mail server for this user (eg: they changed or cancelled their email address).
Once Theatre Manager is able to send emails, then you should change emails in error to not done to send them.
Ensure Pause Email Option is not set at Web Listener
There is a feature in the web listener that allows you to pause the sending of emails. You might want to do this if:
- You did an email blast and discovered that there was an issue with the content of the eblast as it was sending. Since eblasts are merged with each patron as they are sent, you have an opportunity to:
- Stop the sending of emails
- fix the eblast contents
- resume sending of emails
- There is an large on-sale day an you want to give more time to the processing of tickets and let emails dribble out a few hours later
There are reasons to stop or delay emails being sent. This means it is possible to forget that email sending has been paused and this should be checked if you find that emails are not being received by patrons.
You can do this by going to the listener and looking for the icon Pause Sending Email. If the button says this, then emails are currently being sent from the listener. Instead, if the same button says Resume Sending Email, then click it to resume sending emails and toggle the state of the button. In other words, the correct state for this button to ensure that emails are being sent is Pause Sending Emails.
After making sure it says 'Pause Sending Emails', you may want to click the button that says 'Send All EMail' so that any backlog begins to be sent. (Also make sure that the listener is started - if it s stopped it will not send emails either).

Verify Email Error Log Daily
It is entirely possible that emails may not get sent to the user because of their own issue, or perhaps a system setup has changed.. Situations where this could happen include:
- your email server is not working at the current time (reboot it, or call your ISP)
- the email server is working, but you can't contact it (a rare situation - call your ISP)
- the customer typed in a goofy email address like bob@yahho.com (this is spelt wrong, but a patron is apt to do that).
- There is a valid domain for the email address, but the name is wrong. e.g. the patrons name is b smith but they typed bsmth@myemailserver.com or the email address is just plain wrong. (change the email to as best a guess as you have.
Under such circumstances, there is nothing that you can do to make the mail get sent without reviewing the error list and fixing the problem. This is similar to sending from your own personal outlook account ... you can get the same errors from outlook and so, by analogy, you would take the same action.
How to fix email addresses in Theatre Manager?
- Use the menus to go to Patron Sales->Web Sales Module->Pending/Unsent Emails
- Search for all pending emails
- Look at the 'Error' message column. Based on the error message:
- change the patron's email address to correct it by clicking on the line then click on the patron icon on the menu bar. Make sure it is their primary email address, or if the email address in this list is blank, set it as a primary email address.
- if emails do not send because your outgoing email credentials are wrong, then fix them in company preferences (Step 2 above)
- if you are getting SMTP: 550 Requested..... messages for most emails, see step 2 above
- if you are getting SMTP: 535 Incorrect authentication data yet test emails work, it is probably because you were sending test emails to someone inside the mail server, rather than outside. In that case make sure you email server allows relay from the inside of the network to the world.
- After correcting the problem, change the status of all the emails from Error to Not Done using the tools on the window.
- Alternately, if you can't figure out why a specific email will not sent, change the status to Done
- The web sales listener will pick up all the Not Done messages and try to resend them after a few minutes.
it is advised to check this window frequently (daily is recommended).
Verify that Ports are open to the SMTP server
It may be one of the simplest answers to review the
port settings in the firewall to ensure that they are open and allow access to the SMTP server.
If the ports are not open or there are firewall rules in place that prevent an email being sent, it wont get there no matter how hard we try.
Warning of pending emails that have not been sent yet
If you are receiving an error that emails have not been sent by the Web Listener, there are, at first, two possible conditions under which the emails may not have been sent. You can determine which condition is occurring by double clicking on the email in the Web Listener Email Log.
Condition #1 reports on those that are actually in error, and will give you the reason why the email was not sent. Examples include: an incorrect or 'bad' email address, an SMTP Error, Pause Email settings in Theatre Manager, or specific router ports that need to be opened.
Condition #2: refers to emails that are pending but may not have been sent yet. This results from either timed emails in a blast email setup, or notifications that are scheduled but have not yet reached their scheduled time to go out. If this is not expected (you do not have any scheduled 'future' email blasts or notifications), please verify that the web listeners are active.
This check happens only once per day and it occurs in the morning. Given that most venues send eblasts overnight, seeing something in the morning is indicative of possible issues from the night before.
Port 80 Already In Use
It's possible for a network to be setup in such a way that Port 443 is forwarded to the Apache machine for online sales and Port 80 is not. Often Port 80 is in use by another application within the network. The online sales will run however this can impact the patrons ability to access the online sales.
The Patron can click on a direct link to the website (https://tickets.yourvenue.org) and reach the online sales site. However, if they try to type tickets.yourvenue.org in the address bar by default the browser will take them to http://tickets.yourvenue.org.
Notice there is no S after the http. The http uses Port 80 to connect to Apache. Apache then redirects the site to httpS://tickets.yourvenue.org/TheatreManager/1/login which then hands the connection over to Port 443 since the link is now using httpS.
It is recommend that Port 80 is also forwarded so that when someone tries to type the address of the online sales site into their browser they are more likely to get to the ticketing site rather then experience errors indicating the site may not be working.
Options for working around a network where Port 80 is already in use are listed below:
- Change the exchange server settings to use a port other than 80. This becomes a case of what is more important, that end customers can reach web sales on a standard HTTP port, or staff use an alternate port when using exchange from home. Arts Management Systems believes the customers and standard should prevail and so the answer is change Port 80 for exchange to something else.
- Get another external IP dedicated to the exchange server so that both can use Port 80. One will be through tickets.yourvenue.org:80, the other will be a different external ip.
- Do some HTTP magic on the IIS server to redirect the path. On apache, there is a module called mod-rewrite, or you can create proxy settings so that anything with /TheatreManager/..... in the http path name in it gets sent off to Port 80 on the web listener. There should be something similar in IIS.
- Don't serve exchange on the outside so that its not a problem any more and leave Port 80 on the single IP for customer web purchases
Starting Theatre Manager to Automatically Log in as a Web Listener
Any
web listener can be set to auto log in. You will need to:
- Goto the workstation that you want to have auto logged in as a web listener
- Log into Theatre Manager as the Master User
- Go to Setup->Users and Access->Employee List
- Find the web listener user ID
- Double click (edit) the Web Listener user ID
- Click the 'Box Office' tab.
- Click the 'Set Auto-Login' button to set up the auto login process with the current password
- Repeat the above steps on each machine that is to act as a dedicated web listener
If you are running a Windows machine:
- Create a shortcut of the c:\Program Files\Theatre Manager\Theatre.exe application
- Move that shortcut into the Windows Startup Folder
Upon reboot of the computer, the machine will now auto login into Theatre Manager.
Stopping Theatre Manager from Automatically Logging in as a Web Listener
If Theatre Manager is automatically logging in as the web listener for a certain user profile on a particular machine, and you wish to stop it from doing so, follow these steps:
- Close Theatre Manager if it is open.
- Locate and open the application preferences file for the appropriate user profile on the particular machine.
Refer to the following table to find the application preferences file on your operating system.
| Operating System |
Generic Location |
Typical Path Name |
| OS-X |
HOME |
~/Library/Preferences/TheatreManager/TheatreManager.plist
note: ~ refers to each users preferences, or /User/MyUser/Library/Preferences/TheatreManager |
| Win 2000 and XP |
USERPROFILE |
C:\Documents and Settings\MyUser\Application Data\TheatreManager\TheatreManager.txt |
| Vista |
LOCALAPPDATA |
C:\Users\MyUser\AppData\Local\TheatreManager\TheatreManager.txt |
- Delete the web listener login.
In the file, delete the lines containing "WebServerPassword" and "WebServerUserID".
- Save the changes made to the application preferences file.
- Restart Theatre Manager.
You will now be prompted to select a user to login as.