...
- The box office doesn't allow neither partial refunds nor exchanges
- The batch to cancel a single performance or product will only refund orders that don't contain any other performance or product
- The on-line self exchange features are disabled
Getting started
| Info | ||
|---|---|---|
| ||
You don't have to wait until the 01.01.2022 to enable this feature. Indeed, the TicketBAI service is already available in production but will store the signed orders "for real" from the 1st of January. |
How does it work?
When the feature is enabled, SecuTix calls an external service provided by a partner, that in turn, calls the TicketBAI service. This partner is called KubiBAI. In fact, there exist multiple TicketBAI services, more precisely one for each Basque region. The reason of using an external service is to reduce the complexity in SecuTix, for example by hiding the differences related to each Basque region.
...
Please add following information to your order summary template:
Invoice number:
{#if($document.order.invoiceNumber)}Invoice number: {$document.order.invoiceNumber}
{#else}Invoice number: Not available
{#end}
Invoice date:
Invoice date: {$document.order.orderCreationDate}
TBAI identifier and QR code:
{#if($document.order.externalIdentifier)}
{$document.order.externalIdentifier}
{#else}TBAI identifier not available
QR code not available
{#end}
A complete example of document template in English, Spanish and Spanish Basque is provided below
...
...
...
...
...
...
Order receipt
Enable the display of the TicketBAI informations
#set($showKubibai = true)
Display if the document is a duplicate or not:
#if($showKubibai == true)
#display($orderReceipt.documentType, 17, 'LEFT')#if($orderReceipt.solutionVersion.length() > 0) #display($orderReceipt.solutionVersion, 15, 'LEFT')#end
#if($orderReceipt.isDuplicate == true)#set($duplicataStr = "DUPLICATE") #else #set($duplicataStr = 'ORIGINAL') #end
#display("Nb impressions: ", 18, 'LEFT')#display($duplicataStr,12, 'LEFT')
#end
Display TBAI identifier and QR code
#if($showKubibai == true)
#if($orderReceipt.fiscalSignatureRestitutionStr.length() > 7)
#display($orderReceipt.fiscalSignatureRestitutionStr.substring(0, 32), 32, 'LEFT')
#display($orderReceipt.fiscalSignatureRestitutionStr.substring(32, $orderReceipt.fiscalSignatureRestitutionStr.length()), 32, 'LEFT')
#else
#display('TBAI identifier not available', 32, 'LEFT')
#end
#if($orderReceipt.fiscalSignatureRestitution.length() > 0)
<QR>$orderReceipt.fiscalSignatureRestitution|6|CENTER<QR>
#else
#display('QR code not available', 32, 'LEFT')
#end
#end
A complete example of document template in English, Spanish and Spanish Basque is provided belowView file
...
...
...
...
New interface
Create a new interface of type external manager and sub-type KUBIBAI plugin
...
| Parameter | Value |
|---|---|
| URL | |
| Client API key | Provided by KubiBAI on SecuTix' request |
| TBAI Territory id |
● Gipuzkoa: dded8ad1-0574-4ee4-b4f7-36687cba73b 36687cba73b9 |
| Certificate password | Provided with the certificateNot necessary |
| CIF | Código de Identificación Fiscal |
You don't have anything to do to get the detail per real tariff. If you want to keep the old behaviour, you can create a service request. Our service team will set the institution parameter Analytics Attend New Ver to false.
Please be aware that the detail per tariff will only be available after the first complete rebuild of the domains following the feature delivery (22.11.2021). Complete rebuilds (occurring once per week) should not be confused with incremental refreshes (occurring every 5 minutes).
...
| title | Important notice for our customers using their own BI tool |
|---|
SecuTix provides temporarily 2 versions of the attendance domain.
- D_ANALYTICS_ATTEND_V1_0 is the old domain on which your BI tool is based (if you are using attendance information)
- D_ANALYTICS_ATTEND_V2_0 is the new domain providing the detail per tariff
...
New function schedule
The schedule is only needed to check that the information have been stored successfully in TicketBAI and to recall KubiBAI in case of failures.
Schedule the Order recovery function belonging to the interface created previously with following parameters:
- It's recommended to use an automatic schedule, for example once per day
- Enter a date in the Date from field. The date has to be in the recent past. You should update this field from time to time, especially in case of heavy sales.
- You can ignore the File to upload parameter.