Page History

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Status
subtletrue
colourGreen
titleNEW V1.11
A new type of price components, called external price components, allows you to define price components who come in addition to the catalog price. External price components are available since Allalin V3. The release Bishorn V1 adds some interesting features to the external price components:

  • You may want to define "fine-grained" external price components in your price grids for accounting or revenue sharing reasons but you don't want to provide full detail to your end customers. For example, several price components should be grouped into a single "convenience fee". SecuTix provides you the ability to group external price components while displaying them on documents or Ticket Shop.
  • SecuTix allows you to modify the amount of an external price component during the sales process in the Box Office

Control the display of your external price components

Solution

External price components may be grouped in a fee type. All price components belonging to the same fee type will be displayed on a single line containing the name of the fee type. A price component doesn't need to be included in a fee type. If it doesn't belong to a fee type, it will be displayed on a separate line.

Sales on Box Office

As before, the total amount of the external price components is displayed in the "Fees" column. You can see the detail of this amount by hovering the mouse on it. This detail will take the fee types into account:

...

The Getting started section below explains you how to set up the fee types.

Sales on Ticket Shop

You can also control the display of the external price components on the Ticket Shop. The display follows the same logic as above.

...

The internet user may click on the arrow next to the fee type name in order to get a more detailed explanation, as illustrated below:

Display on documents

For PDF documents (invoice, file summary, order summary), SecuTix provides you the choice between:

  • Displaying the external price components separately without taking into account the defined fee types
  • Grouping the external price components belonging to the same fee type. Ticket fees are displayed according to the same logic as described above.

External price components are always grouped by fee type (if fee types have been defined) on order receipts.

Getting started

You first have to create the fee types in the initialisation menu of the organisation context (next to the sales price components):

...

You can enable the grouping on the documents by setting the showFeetype parameter to true in the document template, as illustrated below:

Display on documents

All external price components are displayed in the Description section of the document. as illustrated below. Simple charges will be displayed in the same way. In other words, there will be one simple charge line for each item and tariff of the order. Until now, simple charges concerning the same item but different tariffs were grouped together.

Image Removed

The external price components may also be displayed in the VAT details by setting the flag showVATBreakdownPerPriceComponent to true. See Price breakdown in invoices and other documents for further details.

Display on reports

Revenue information related to external price components are available in all reports belonging to the domain (sub-topic) Summary of fees. A new fee type, called External price components, has been added. The fee type Price components has been renamed to Internal price components to avoid any confusion.

The reports provide the same features as for the internal price components:

  • Selection of one or more external price components
  • Display the external price component in the generated report
  • Group by external price components (for example to display the total revenue for each external price component during a given sales period)

Sales on Ticket Shop

The total amount of external price components is displayed in the same way as simple charges: they are gathered under the label Booking fee.

Image Removed

External price components and simple charges

Coexistence between price components and simple charges

The new feature is fully compatible with simple charges. As a result, you can benefit from the advantages of both features by defining simultaneously external price components and a simple charge for the same product. The behaviour of the system will be quite straightforward:

  • The total fee amount (displayed for example on the Ticket Shop and Box Office) includes both simple charges and external price components
  • The fee details (for example in the documents or when hovering the mouse in the Box Office on the fee column) displays both simple charges and external price components in a similar way
  • The reports of the domain Summary of fees distinguish between simple charges and external price components as they belong to two separate fee types.

The only exception to above principle concerns the season tickets and packages. You can decide whether you want to:

  • Define simple charges at composed product level, no external price components being applied
  • Apply the external price components already defined for the products contained in your composed product. In that case, no simple charges will be applied on the composed product itself.

Example:

  • A season ticket contains two events E1 and E2. You have already defined an external price component for these events. To keep it simple, let us consider that this external price component has a fixed amount of 2€.
  • When setting up the season ticket, you may choose between:
    • Defining a simple charge applying to the whole season ticket. For example, you may define a simple charge of 3€. The total fee amount applied to the season ticket will be 3€ since the external prices component defined for E1 and E2 are ignored in this case.
    • Reusing simply the external price component defined for E1 and E2. This will lead to a fee of 2€ for each event, meaning a total of 4€.

Image Removed

Provided features

The table below compares the features provided by the simple charges and the external price components. This table represents the current state. Additional developments are planned on the external price components in the next releases.

...

Warning
titleWarning

This parameter cannot be used on order receipts. Order receipts always group external price components by fee type (if fee types have been defined)

Modify the amount of an external price component

Solution

You can now change the amount of external price components from the final cart. Just click on the pencil as shown below:

Image Added


You may modify the amounts of all external price components defined as modifiable (see Getting started section). The screen displays the initial (i.e. the amount defined in the set-up) and the current (modified) amount. The current amount must be positive or null. In contrary to the simple charges, the amount of an external price component may be greater than the initial amount.

Image Added

The pop-up displays each external price component separately, no matter if they belong to a fee type. By this way, you can always modify the amounts individually.

The new total amount of the fees (in our example, the total amount has been reduced from 26.00 to 21.00) will be highlighted in blue.

Info
titleExternal price components and charges
  • The simple charges can now also be modified from the same pop-up. This approach provides you a uniform and consolidated away to manage the amount of ticket fees, independently if they have been set-up as external price components or simple charges. Simple charges can't be modified in the temporary cart anymore.
  • Charges on packages and calculated price season tickets may be defined in two ways. You can either:
    • Define a charge at the composed product level. This amount may be modified in the temporary cart as before (but not in final cart)
    • Define charges on the products contained in your composed product. The amounts may be modified in the final cart (and not in the temporary cart), as for any simple products.


Info
titleFee amounts in reservations
  • If you are performing an order in two steps (create a reservation first and pay the reservation later), you have to modify the amounts already during the reservation phase. You won't be able to do it anymore during the payment phase. This will ensure data consistency.
  • Note that you can still modify a reservation or add some new items during the payment phase. The remark above concerns only the items that have been reserved before.

Getting started

Simply define an external price component as modifiable in the price component detail screen:

Image Added

Further developments

Following developments are foreseen in the next releases of SecuTix:

  • Grouping of external price components while displaying them on the Box Office, Ticket Shop or on documents. Define external price components in detail to match your accounting needs but present a simplified view of these external fees to your customers.
  • Allow your operators to modify the fee amounts.
  • Extend the price breakdown to services, fixed price season tickets and memberships, thus providing the external price component feature to these additional product families.

Getting started

Setting up the external price component

External price components are set-up exactly in the same way as internal price components. You can define if an external price component may be refunded or not, when the refund is requested by the end customer.

Image Removed

Entering amounts to the price grid

In order to enter the amounts of the external price components, you should follow the steps described below

Enter the catalog prices

Create the price grid and enter the amounts as usual

Create a price breakdown

You may create one or several price breakdowns, depending if the external price components amounts should depend on the sales channel or not. This step is exactly the same as for the already existing internal price components.

Select the price components to be used by the price breakdown

You may select internal price components, external price components, or both. You can override the default computation rule.

Image Removed

Modify the individual amounts

After you have clicked on the calculate price button, the breakdown is displayed with all the amounts, based on the price component selection and computation rules above.

Image Removed

...