Versions Compared

Key

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

...

Create a manual schedule to launch the function Process external payments and select the file to upload (i.e. the payment file received from the bank).

Warning
titlePerform a full test cycle before going live

SecuTix strongly recommends to perform the whole test cycle before sending a large number of QR invoices:

  1. Create a sales order (for example with a voucher)
  2. Print the QR invoice
  3. Pay the invoice in your mobile banking app by scanning the QR code
  4. Wait for the bank to provide you the payment file
  5. Import the payment file

Indeed, this test will ensure that the whole setting has been done properly and that the file generated by your bank may be read by SecuTix.

Order summary

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 and Spanish is provided below

View file
nameTBAI_ORDER_SUMMARY_1_en.docx
height250
   
View file
nameTBAI_ORDER_SUMMARY_1_sp.docx
height250

Order receipt

Enable the display of the TicketBAI informations

#set($showKubibai = true)

...

#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 and Spanish is provided below

View file
nameSTX_ORDER_RECEIPT_en-1.txt
height250
 
View file
nameSTX_ORDER_RECEIPT_sp.txt
height250

New interface

Create a new interface of type external manager and sub-type KUBIBAI plugin

Set the following parameters

...

  • Araba: 62b26c86-352c-44e6-980a-d89c4de762a6

...

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.