Difference between revisions of "Sending Service java-less version"

From E-fileWiki
Jump to navigation Jump to search
Line 52: Line 52:
Note that you can find the prerequisites for the manual transmission there : [[Transmission_Module#System_requirements]]
Note that you can find the prerequisites for the manual transmission there : [[Transmission_Module#System_requirements]]


[[File:SDjl_1.png|395x86px|Graphical user interface, text Description automatically generated]]
= The process =


The sending service includes two executable applications:


June 2023
'''Sending Service application''' : This is the main application, used to send documents and containing all the business rules and configuration files linked to the operation of the application, such as dictionary-xsd and dictionary-workflow.
 
'''Launcher application''' : This is the application used to launch and update the main application described above. It contains proxy and environment configuration files.
 
<span id="folder-hierarchy"></span>
== Folder hierarchy ==
 
Once installation is complete, three subfolders will be present:
 
'''system''': this is the folder containing the technical elements of the application, and contains also three subfolders:
 
'''bin''': contains the main application executable
 
'''config''': contains all client configuration files
 
'''log''': contains all logs generated during application execution
 
'''sendingservice''': this is the folder containing all the sub-folders in which we will place our files for sending.<br />
For example, in the default configuration, if you want to send a KID file, you'll need to save the file in the following folder: ''sendingservice\fundregistration\luxembourg\opc''
 
'''tmp''': This is the folder containing all temporary files related to the application's operation.
 
<span id="start-the-application"></span>
== Start the application  ==
 
Once the application is installed:
 
Either double-click it [[File:SDjl_2.png|169x25px]]
 
Or, if you get this message :[[File:SDjl_3.png|264x89px|A blue screen with white text Description automatically generated with medium confidence]],
 
click the address bar in the file explorer onto the sending service folder : [[File:SDjl_4.png|409x40px]]
 
[[File:SDjl_5.png|335x33px|A blue and white rectangular sign Description automatically generated with low confidence]]
 
type ''cmd,'' [[File:SDjl_6.png|137x71px|A screenshot of a computer Description automatically generated]]
 
then type ''launcher'' [[File:SDjl_7.png|379x83px|A screenshot of a computer screen Description automatically generated with medium confidence]]
 
<span id="stop-the-process"></span>
== Stop the process ==
 
In this console mode, hit the keys Ctrl+C and confirm you want to stop by entering Y :
 
<span id="administration-interface"></span>
= Administration Interface =
 
''New : The former .properties file is no longer a file onto your disk but the data are stored in our database and you can access them through the administration interface.''
 
In the administration interface, you can retrieve all the parameters you can set up. Note that some of them have default values and some are set up when the installation is done. You can make all the changes needed.
 
Sign in as an administrator and click [[File:SDjl_8.png|194x55px|A black text on a white background Description automatically generated]]
 
then [[File:SDjl_9.png|158x37px]], you get :
 
[[File:SDjl_10.png|601x168px|A screenshot of a computer Description automatically generated]]
 
Click the name of the sending service to change, [[File:SDjl_11.png|47x39px]] to go back to the list.
 
[[File:SDjl_12.png|601x288px|A screenshot of a computer Description automatically generated]]
 
To change a value, click [[File:SDjl_13.png|60x39px|A green rectangle with white text Description automatically generated]], make your changes then save or discard.
 
[[File:SDjl_14.png|349x46px|A green rectangle with white text Description automatically generated]]
 
The ‘edit all workflows’ button, allow you to make massive changes in one shot.
 
Once the changes saves, you will get: [[File:SDjl_15.png|309x59px|A close up of a text Description automatically generated]]
 
The buttons [[File:SDjl_16.png|193x39px]], respectively exporting/importing the properties to/from .json format : to backup, to move from UAT to production or to import manual changes onto properties.
 
Note
 
* the automatic update set up:<br />
[[File:SDjl_17.png|246x46px]]<br />
This is related to the sending service’s version delivered by our IT team. Click the icon to change the automatic update’s status.
* the categories of parameters: [[File:SDjl_18.png|377x84px|A white background with black text Description automatically generated]]
* the [[File:SDjl_19.png|137x50px|A logo with text on it Description automatically generated]] button
 
[[File:SDjl_20.png|601x278px|A screenshot of a computer Description automatically generated]]
 
<span id="details-on-workflows-part"></span>
== Details on workflows part ==
 
Regarding the workflows, each one takes care of specific reports. You must enable those you want the sending service to send.
 
''For example, to send'' U11 reports'', you must enable the'' reporting_u ''workflow, the active box must be ticked, and a folder must be entered, you can keep the default one or change it. The'' intervalTimeInMinute ''is the frequency with which the directory will be scanned.''
 
[[File:SDjl_21.png|601x203px|A screenshot of a computer Description automatically generated]]
 
You can find the reports and their matching sending service workflow in our product coverage page.
 
<span id="details-on-heartbeat-system"></span>
== Details on heartbeat system ==
 
The heartbeat is a monitoring system to check whether the sending service is still up or not. It pings the sending service at the chosen frequency and send an alert e-mail if the sending service doesn’t answer.
 
In the ‘properties’ category, you can set it up or down by ticking the box or not, and choose the frequency or the monitoring.
 
[[File:SDjl_22.png|601x338px|A screenshot of a computer Description automatically generated]]
 
In the ‘Heartbeat’ section, you can find statistics on heartbeat running and you can choose who will receive an alert e-mail when needed.
 
[[File:SDjl_23.png|601x280px|A white background with lines Description automatically generated with medium confidence]]
 
<span id="section"></span>
=  =


<span id="manual-installation-using-command-prompt"></span>
<span id="manual-installation-using-command-prompt"></span>
Line 67: Line 174:
In the administration module, Sending service management – v2:
In the administration module, Sending service management – v2:


[[File:SDjl_2.png|332x231px]]
[[File:SDjl_24.png|332x231px]]


Click:
Click:


[[File:SDjl_3.png|604x172px]]
[[File:SDjl_25.png|604x172px]]


The launcher will be downloaded into your default folder:
The launcher will be downloaded into your default folder:


[[File:SDjl_4.png|262x101px]]
[[File:SDjl_26.png|262x101px]]


<span id="step-2-install-the-new-sending-service-with-the-launcher"></span>
<span id="step-2-install-the-new-sending-service-with-the-launcher"></span>
== <u>Step 2</u>: Install the new Sending Service with the launcher ==
== <u>Step 2</u>: Install the new Sending Service with the launcher ==


We advise you to copy ''launcher.exe'' into the folder where you want to install the sending service.
<span id="copy-launcher.exe"></span>
=== copy ''launcher.exe'' ===
 
into the folder where you want to install the sending service


<span id="open-launcher.exe"></span>
<span id="open-launcher.exe"></span>
=== Open launcher.exe ===
=== Open launcher.exe ===


Either double-click it [[File:SDjl_5.png|169x25px]]
Either double-click it [[File:SDjl_2.png|169x25px]]


Or, if you get this message:[[File:SDjl_6.png|264x89px|A blue screen with white text Description automatically generated with medium confidence]],
Or, if you get this message:[[File:SDjl_3.png|264x89px|A blue screen with white text Description automatically generated with medium confidence]],


click the address bar in the file explorer: [[File:SDjl_7.png|409x40px]]
click the address bar in the file explorer: [[File:SDjl_4.png|409x40px]]


[[File:SDjl_8.png|335x33px|A blue and white rectangular sign Description automatically generated with low confidence]]
[[File:SDjl_5.png|335x33px|A blue and white rectangular sign Description automatically generated with low confidence]]


type ''cmd,'' [[File:SDjl_9.png|137x71px|A screenshot of a computer Description automatically generated]]
type ''cmd,'' [[File:SDjl_6.png|137x71px|A screenshot of a computer Description automatically generated]]


then type ''launcher'' [[File:SDjl_10.png|379x83px|A screenshot of a computer screen Description automatically generated with medium confidence]]
then type ''launcher'' [[File:SDjl_7.png|379x83px|A screenshot of a computer screen Description automatically generated with medium confidence]]


You will be asked:
You will be asked:
Line 102: Line 212:
=== Enter Y (yes) or N (no) for the question: Are you using a proxy?  ===
=== Enter Y (yes) or N (no) for the question: Are you using a proxy?  ===


[[File:SDjl_11.png|222x29px|A picture containing text, font, screenshot, graphics Description automatically generated]]
[[File:SDjl_27.png|222x29px|A picture containing text, font, screenshot, graphics Description automatically generated]]


<span id="enter-the-environment-production-or-homologation"></span>
<span id="enter-the-environment-production-or-homologation"></span>
Line 108: Line 218:


The name must be entirely typed<br />
The name must be entirely typed<br />
[[File:SDjl_12.png|604x22px]]
[[File:SDjl_28.png|604x22px]]


The sending service will be downloaded, wait a little.
The sending service will be downloaded, wait a little.
[[File:SDjl_29.png|604x147px|A screen shot of a computer code Description automatically generated]]


<span id="enter-username"></span>
<span id="enter-username"></span>
Line 129: Line 241:
<span id="or-if-no-properties-config-file-is-found-on-the-server-or-you-want-to-overwrite-the-existing-one"></span>
<span id="or-if-no-properties-config-file-is-found-on-the-server-or-you-want-to-overwrite-the-existing-one"></span>
=== Or: If no properties config file is found on the server or you want to overwrite the existing one: ===
=== Or: If no properties config file is found on the server or you want to overwrite the existing one: ===
[[File:SDjl_30.png|604x15px]]


Enter Y (yes) for the question: overwrite the existing properties config file.
Enter Y (yes) for the question: overwrite the existing properties config file.
Line 169: Line 283:
This is used for O4.1 and O4.2 reports only.
This is used for O4.1 and O4.2 reports only.


<span id="enter-y-yes-or-n-no-for-the-question-close-the-app-after-installation."></span>
<span id="enter-y-yes-or-n-no-for-the-question-do-you-want-to-close-the-app-after-installation"></span>
==== Enter Y (yes) or N (no) for the question: close the app after installation. ====
==== Enter Y (yes) or N (no) for the question: Do you want to close the app after installation ? ====
 
Yes means that only the installation will be done.
 
No means that the sending service itself will be run after the installation and starts to file reports.


The process will continue, installing all the xsd files …
The process will continue, installing all the xsd files …


You must obtain: [[File:SDjl_13.png|562x30px]]
You must obtain: [[File:SDjl_31.png|562x30px]]
 
You can close the window, click the right-corned red cross.
 
<span id="update-the-sending-service"></span>
= Update the sending service =


You can close the window.
<span id="update-your-set-up"></span>
== Update your set up ==


<span id="run-the-application"></span>
You want to make changes into your set up: use the administration interface. The application checks for changes every 30 minutes and applies them automatically.
= Run the application  =


Either double-click it [[File:SDjl_5.png|169x25px]]
Note that the passwords are crypted and asked just one time at the first installation. If you have to change them, you must install the whole application again :


Or, if you get this message :[[File:SDjl_6.png|264x89px|A blue screen with white text Description automatically generated with medium confidence]],
* In the folder .\system\config, delete all the .json files
* On the root folder, launch ‘launcher’ again, overwrite the existing properties config file.


click the address bar in the file explorer onto the sending service folder : [[File:SDjl_7.png|409x40px]]
<span id="upgrade-the-application"></span>
== Upgrade the application ==


[[File:SDjl_8.png|335x33px|A blue and white rectangular sign Description automatically generated with low confidence]]
When a new version is available from out IT team: stop the application then start it again through the launcher.exe. See :


type ''cmd,'' [[File:SDjl_9.png|137x71px|A screenshot of a computer Description automatically generated]]
This feature concerns the application updates affecting the sending service (SD) itself and that are applicable to all clients / users.


then type ''launcher'' [[File:SDjl_10.png|379x83px|A screenshot of a computer screen Description automatically generated with medium confidence]]
''Short description:''


<span id="check-for-acknowledgment-and-feedbacks"></span>
Whenever the sending service starts, restarts, and every 30 minutes when it is up and running, it will check for updates. If an update is detected, and automatic update is selected (you can modify the value in the admin module page), the SD will stop the current process, reinstall the new version and rerun the process automatically. After a successful (or unsuccessful) update a notification will be sent per email.
= Check for acknowledgment and feedbacks =
 
If the client did not subscribe for automatic application updates and a new version of SD is available, an email will be sent to the client requesting them to update the SD. The client will then have to rerun the application and install the new version.
 
If the client does not update its SD in a specific timeframe, the sending service will stop running until it has been updated.


Once a report sent, you will retrieve the .trt and .acq in a subfolder called ''reporttransmitted :''
<span id="submit-a-report"></span>
= Submit a report =


[[File:SDjl_14.png|276x70px|A screenshot of a computer Description automatically generated with medium confidence]]
To send a report just copy it in the relevant folder depending on its type.


Remember, if you get a .err, an error occurred. Open the .err to check it.
See the default sending folders tree:


The feedbacks from the authority will come into ''feedbacks.''
[[File:SDjl_32.png|195x333px]]


<span id="sending-service-listeners"></span>
<span id="sending-folders"></span>
= Sending Service Listeners =
== Sending Folders ==


Here is the sending types list and where you must copy your report for them to be processed:
Here is the sending types list and where you must copy your report for them to be processed:
Line 216: Line 345:
| sendingservice/fundregistration/luxembourg/fis
| sendingservice/fundregistration/luxembourg/fis
|-
|-
| 08/371 FIS Report
| 08/371 FIS Reports
| sendingservice/fundregistration/luxembourg/fis
| sendingservice/fundregistration/luxembourg/fis
|-
|-
Line 378: Line 507:
| sendingservice/regulatoryreporting/luxembourg/reporting_o
| sendingservice/regulatoryreporting/luxembourg/reporting_o
|}
|}
<span id="check-for-acknowledgment-and-feedbacks"></span>
= Check for acknowledgment and feedbacks =
Once a report sent, you will retrieve the .trt and .acq in a auto-generated subfolder called ''reporttransmitted :''
[[File:SDjl_33.png|276x70px|A screenshot of a computer Description automatically generated with medium confidence]]
Remember, if you get a .err, an error occurred. Open the .err to check it.
The feedbacks from the authority will come into ''feedbacks.''
<span id="transmission-following"></span>
== Transmission following ==
Here are the default transmission follow up files that are created depending on the state in the transmission workflow.
{|
!width="13%"| '''File extension'''
!width="86%"| '''Description'''
|-
| '''.trt'''
|
<u>Example </u>: file processing of '''FileName.ext'''
Once the file has been dropped into the appropriate folder, the Sending Service will start processing it and rename it as follows:
'''FileName.ext_YYYYMMDDhhmmssmmm.trt'''
|-
| '''.acq'''
|
Once the processing finished an '''.acq''' file will be generated in the same folder by the Sending Service in order to confirm the transmission:
'''FileName.ext_YYYYMMDDhhmmssmmm.acq'''
|-
| '''.err'''
|
An '''.err file is created in case or an error:'''
'''FileName.ext_YYYYMMDDhhmmssmmm.err'''
Please open this file and analyse the error message.
|}
<span id="feedback-files-replies-folder"></span>
== Feedback files (Replies folder) ==
For some reporting, the administration will give you a more detailed feedback. The feedbacks from the authority will come into ''feedbacks.''
####à vérifier
<s>By default, <u>feedback files</u> are dropped into '''Replies''' sub-folders. '''Replies''' folders are created dynamically in the initial transmission folder of the files. They only appear when feedback files, sent by the supervisory authorities, have to be stored. If the folder is deleted, it will be automatically recreated upon receipt of new feedback files.</s>
The name and location of the '''Replies''' folder may be configured differently from the implementation of the solution with your company’s project coordinator 
{|
!width="10%"| '''Autority'''
!width="89%"| '''Description'''
|-
| '''CSSF'''
|
Feedback files generated and sent by the CSSF.
Please click the picture below to access the '''Naming convention for CSSF reportings''' document:
[[File:SDjl_34.png|500x135px|A close-up of a screen Description automatically generated]]
|-
| '''BCL'''
|
Feedback files generated and sent by the BCL.
The BCL sends feedback with the following naming convention :
FDBTECH_[OK/KO]_[YYYYMMDD]_[SENT FILE NAME]_[RANDOM CARACTERS].xml
With
<ul>
<li><blockquote><p>[OK/KO] : replaced either by OK (if the files has been transmitted and processed successfully) or KO (if there has been an error)</p></blockquote></li>
<li><blockquote><p>[YYYYMMDD] : replaced by the date of the feedback</p></blockquote></li>
<li><blockquote><p>[SENT FILE NAME] : replaced by the complete name of the original file (including it's extension)</p></blockquote></li>
<li><blockquote><p>[RANDOM CARACTERS] : replaced by a random and unique caracters.</p></blockquote></li></ul>
|}
<ul>
<li><blockquote><p>'''For other reporting''' (08/371 / VNI...), '''there is no additional acknowledgment'''.</p></blockquote></li></ul>
This means that only '''acq''' will be created.
'''<u>Conclusion</u>''' : '''Checking that both trt and acq files were generated is a good way to ensure the good working of the Sending Service'''. Doing this way, you can be sure that your data was properly sent and '''e-file will be in charge of forwarding them to authorities'''.

Revision as of 16:06, 31 August 2023

Back to the Top

You can click on the picture.

PurposeinterfaceInstallationStartPrerequisitesProcessFoldersSet upclickable image : form description

Purpose

The Sending Service is our solution for the automatic transmission of reports and documents to authorities.

It is an application consisting of a set of processes (called listeners) that periodically exchange files with authorities through a set of designated folders. Everything is configured via an administration interface.

This solution is useful if you have a large number of reports to submit or if the manual sending does not suit your needs.

Please be aware that, in this case you will have to provide the files yourself according to the authorities' file specifications.

This tool is compatible with most of the current operating systems (Windows / Unix / Linux) and is usually installed on a server on your side.

With a suitable network mapping, users can simply drop the file to be sent into the appropriate directory. It is then automatically encrypted and sent.

It is an application consisting of a set of processes (called listeners) that periodically exchange files with authorities through designated directories. Everything is configured via an administration interface.

Prerequisites

  • Internet access
  • If you use a proxy, authorize outgoing calls to www.e-file.lu. Port 443 (HTTPS) must be open.
  • Administrator rights to install the Sending Service on the computer (Windows Start button > Control Panel > User Accounts > Manage User Accounts).

*OS: Windows or Linux

  • Processor: Pentium 2 GHz or equivalent
  • 8 GB of RAM
  • 1 GB of free space on hard disk drive if the files are downloaded by ftp. If files are locally stored, provide a free space of above 100 MB or a regular purges.
  • 1 GB of free space on hard disk drive for logs. Regular purges are necessary as well.
  • A Sending Service user , for example: aacSD, and its password, for example: formation, have to be available => e-file administrator.
  • The e-file account of the Sending Service user has to be linked to groups/modules, for example FATCA reporting + profile "Sending Service".
  • A valid keystore (keystore.ks) and its password must be available
  • The Sending Service user has to be properly configured in the e-file user administration tool in order to be able to receive alerts (receipt of acknowledgement and feedback files).

Note that you can find the prerequisites for the manual transmission there : Transmission_Module#System_requirements

The process

The sending service includes two executable applications:

Sending Service application : This is the main application, used to send documents and containing all the business rules and configuration files linked to the operation of the application, such as dictionary-xsd and dictionary-workflow.

Launcher application : This is the application used to launch and update the main application described above. It contains proxy and environment configuration files.

Folder hierarchy

Once installation is complete, three subfolders will be present:

system: this is the folder containing the technical elements of the application, and contains also three subfolders:

bin: contains the main application executable

config: contains all client configuration files

log: contains all logs generated during application execution

sendingservice: this is the folder containing all the sub-folders in which we will place our files for sending.
For example, in the default configuration, if you want to send a KID file, you'll need to save the file in the following folder: sendingservice\fundregistration\luxembourg\opc

tmp: This is the folder containing all temporary files related to the application's operation.

Start the application

Once the application is installed:

Either double-click it SDjl 2.png

Or, if you get this message :A blue screen with white text Description automatically generated with medium confidence,

click the address bar in the file explorer onto the sending service folder : SDjl 4.png

A blue and white rectangular sign Description automatically generated with low confidence

type cmd, A screenshot of a computer Description automatically generated

then type launcher A screenshot of a computer screen Description automatically generated with medium confidence

Stop the process

In this console mode, hit the keys Ctrl+C and confirm you want to stop by entering Y :

Administration Interface

New : The former .properties file is no longer a file onto your disk but the data are stored in our database and you can access them through the administration interface.

In the administration interface, you can retrieve all the parameters you can set up. Note that some of them have default values and some are set up when the installation is done. You can make all the changes needed.

Sign in as an administrator and click A black text on a white background Description automatically generated

then SDjl 9.png, you get :

A screenshot of a computer Description automatically generated

Click the name of the sending service to change, SDjl 11.png to go back to the list.

A screenshot of a computer Description automatically generated

To change a value, click A green rectangle with white text Description automatically generated, make your changes then save or discard.

A green rectangle with white text Description automatically generated

The ‘edit all workflows’ button, allow you to make massive changes in one shot.

Once the changes saves, you will get: A close up of a text Description automatically generated

The buttons SDjl 16.png, respectively exporting/importing the properties to/from .json format : to backup, to move from UAT to production or to import manual changes onto properties.

Note

  • the automatic update set up:

SDjl 17.png
This is related to the sending service’s version delivered by our IT team. Click the icon to change the automatic update’s status.

  • the categories of parameters: A white background with black text Description automatically generated
  • the A logo with text on it Description automatically generated button

A screenshot of a computer Description automatically generated

Details on workflows part

Regarding the workflows, each one takes care of specific reports. You must enable those you want the sending service to send.

For example, to send U11 reports, you must enable the reporting_u workflow, the active box must be ticked, and a folder must be entered, you can keep the default one or change it. The intervalTimeInMinute is the frequency with which the directory will be scanned.

A screenshot of a computer Description automatically generated

You can find the reports and their matching sending service workflow in our product coverage page.

Details on heartbeat system

The heartbeat is a monitoring system to check whether the sending service is still up or not. It pings the sending service at the chosen frequency and send an alert e-mail if the sending service doesn’t answer.

In the ‘properties’ category, you can set it up or down by ticking the box or not, and choose the frequency or the monitoring.

A screenshot of a computer Description automatically generated

In the ‘Heartbeat’ section, you can find statistics on heartbeat running and you can choose who will receive an alert e-mail when needed.

A white background with lines Description automatically generated with medium confidence

Manual installation using command prompt

Step 1: Download the launcher.

Connect to e-file as an administrator.

In the administration module, Sending service management – v2:

SDjl 24.png

Click:

SDjl 25.png

The launcher will be downloaded into your default folder:

SDjl 26.png

Step 2: Install the new Sending Service with the launcher

copy launcher.exe

into the folder where you want to install the sending service

Open launcher.exe

Either double-click it SDjl 2.png

Or, if you get this message:A blue screen with white text Description automatically generated with medium confidence,

click the address bar in the file explorer: SDjl 4.png

A blue and white rectangular sign Description automatically generated with low confidence

type cmd, A screenshot of a computer Description automatically generated

then type launcher A screenshot of a computer screen Description automatically generated with medium confidence

You will be asked:

Enter Y (yes) or N (no) for the question: Are you using a proxy?

A picture containing text, font, screenshot, graphics Description automatically generated

Enter the environment: PRODUCTION or HOMOLOGATION

The name must be entirely typed
SDjl 28.png

The sending service will be downloaded, wait a little.

A screen shot of a computer code Description automatically generated

Enter username

Enter the sending service’s account user name

Enter the username password

Either: If a properties config file is found on the server and you want to use it:

Enter N (no) for the question: overwrite the existing properties config file.

Enter the password of your keystore.

Or: If no properties config file is found on the server or you want to overwrite the existing one:

SDjl 30.png

Enter Y (yes) for the question: overwrite the existing properties config file.

Enter the root folder

It is the folder where you want the sending service to be installed: it must already exist.

Entering none will take the current one.

Enter the configuration name

Choose a name for your setup.

Enter your keystore file path (optional).

Please note that you must enter your keystore to transmit to Luxembourg authorities.

Enter Authentication CSSF (optional)

This is used for O4.1 and O4.2 reports only.

Enter Authentication BCL (optional)

This is used for O4.1 and O4.2 reports only.

Enter the password (optional)

This is used for O4.1 and O4.2 reports only.

Enter authentication code (optional)

This is used for O4.1 and O4.2 reports only.

Enter Y (yes) or N (no) for the question: Do you want to close the app after installation ?

Yes means that only the installation will be done.

No means that the sending service itself will be run after the installation and starts to file reports.

The process will continue, installing all the xsd files …

You must obtain: SDjl 31.png

You can close the window, click the right-corned red cross.

Update the sending service

Update your set up

You want to make changes into your set up: use the administration interface. The application checks for changes every 30 minutes and applies them automatically.

Note that the passwords are crypted and asked just one time at the first installation. If you have to change them, you must install the whole application again :

  • In the folder .\system\config, delete all the .json files
  • On the root folder, launch ‘launcher’ again, overwrite the existing properties config file.

Upgrade the application

When a new version is available from out IT team: stop the application then start it again through the launcher.exe. See :

This feature concerns the application updates affecting the sending service (SD) itself and that are applicable to all clients / users.

Short description:

Whenever the sending service starts, restarts, and every 30 minutes when it is up and running, it will check for updates. If an update is detected, and automatic update is selected (you can modify the value in the admin module page), the SD will stop the current process, reinstall the new version and rerun the process automatically. After a successful (or unsuccessful) update a notification will be sent per email.

If the client did not subscribe for automatic application updates and a new version of SD is available, an email will be sent to the client requesting them to update the SD. The client will then have to rerun the application and install the new version.

If the client does not update its SD in a specific timeframe, the sending service will stop running until it has been updated.

Submit a report

To send a report just copy it in the relevant folder depending on its type.

See the default sending folders tree:

SDjl 32.png

Sending Folders

Here is the sending types list and where you must copy your report for them to be processed:

Sending type / type d'envoi To be copied into / à déposer dans
08/371 FIS Prospectus sendingservice/fundregistration/luxembourg/fis
08/371 FIS Reports sendingservice/fundregistration/luxembourg/fis
Non-LU UCI Registration sendingservice/fundregistration/luxembourg/fundsnotlu
Other closing docs of GFI sendingservice/fundregistration/luxembourg/gfi
Management letters of GFI sendingservice/fundregistration/luxembourg/gfi
Fin rep of GFI sendingservice/fundregistration/luxembourg/gfi
Key Investor Document sendingservice/fundregistration/luxembourg/opc
Management letters for CSSF 09/423 sendingservice/fundregistration/luxembourg/opc
CSSF Attestation sendingservice/fundregistration/luxembourg/opc
Management regulation status sendingservice/fundregistration/luxembourg/opc
Notification Full sendingservice/fundregistration/luxembourg/opc
Long forms for CSSF 09/423 sendingservice/fundregistration/luxembourg/opc
08/371 UCI Prospectus sendingservice/fundregistration/luxembourg/opc
08/371 Report sendingservice/fundregistration/luxembourg/opc
08/371 report not in 08/371 sendingservice/fundregistration/luxembourg/other
BCL report for insurances sendingservice/regulatoryreporting/luxembourg
BCL SHS sendingservice/regulatoryreporting/luxembourg
AIF Reporting sendingservice/regulatoryreporting/luxembourg
Reporting_s112-l sendingservice/regulatoryreporting/luxembourg
MIFIR reporting sendingservice/regulatoryreporting/luxembourg
Reporting U sendingservice/regulatoryreporting/luxembourg
Reporting EDIFACT sendingservice/regulatoryreporting/luxembourg
Reporting IORP sendingservice/regulatoryreporting/luxembourg
Reporting CSDR sendingservice/regulatoryreporting/luxembourg
FATCA Report sendingservice/regulatoryreporting/luxembourg
CRS Report sendingservice/regulatoryreporting/luxembourg
FINREP sendingservice/regulatoryreporting/luxembourg
SICAR Reporting sendingservice/regulatoryreporting/luxembourg
PSF Report sendingservice/regulatoryreporting/luxembourg
COREP Report sendingservice/regulatoryreporting/luxembourg
EME Report sendingservice/regulatoryreporting/luxembourg
EDP Report sendingservice/regulatoryreporting/luxembourg
Credit institution reporting sendingservice/regulatoryreporting/luxembourg
Management company report sendingservice/regulatoryreporting/luxembourg
Reporting Money Market Fund sendingservice/regulatoryreporting/luxembourg
CSSF enquiry sendingservice/regulatoryreporting/luxembourg
TAF MIFID Report sendingservice/regulatoryreporting/luxembourg
Rapport distinct solvabilité 2 du réviseur sendingservice/regulatoryreporting/luxembourg
Distinct solvency company Report sendingservice/regulatoryreporting/luxembourg
Rapport Narratif (Réviseur) sendingservice/regulatoryreporting/luxembourg
Rapport Narratif (compagnie) sendingservice/regulatoryreporting/luxembourg
Solvency II reporting sendingservice/regulatoryreporting/luxembourg
Titrisation Vehicles sendingservice/regulatoryreporting/luxembourg
Reporting TPT sendingservice/regulatoryreporting/luxembourg
Reporting securities by securities of issuing companies sendingservice/regulatoryreporting/luxembourg
Issuing companies reporting sendingservice/regulatoryreporting/luxembourg
Payment’s balance sendingservice/regulatoryreporting/luxembourg
AnaCredit sendingservice/regulatoryreporting/luxembourg
Security by Security banks sendingservice/regulatoryreporting/luxembourg
BCL statistics sendingservice/regulatoryreporting/luxembourg
Data payment collection sendingservice/regulatoryreporting/luxembourg
Reporting S sendingservice/regulatoryreporting/luxembourg
Various correspondence (OTH) sendingservice/regulatoryreporting/luxembourg/otherbcl
Other reporting for CSSF sendingservice/regulatoryreporting/luxembourg/othercssf
Reporting O sendingservice/regulatoryreporting/luxembourg/reporting_o

Check for acknowledgment and feedbacks

Once a report sent, you will retrieve the .trt and .acq in a auto-generated subfolder called reporttransmitted :

A screenshot of a computer Description automatically generated with medium confidence

Remember, if you get a .err, an error occurred. Open the .err to check it.

The feedbacks from the authority will come into feedbacks.

Transmission following

Here are the default transmission follow up files that are created depending on the state in the transmission workflow.

File extension Description
.trt

Example : file processing of FileName.ext

Once the file has been dropped into the appropriate folder, the Sending Service will start processing it and rename it as follows:

FileName.ext_YYYYMMDDhhmmssmmm.trt

.acq

Once the processing finished an .acq file will be generated in the same folder by the Sending Service in order to confirm the transmission:

FileName.ext_YYYYMMDDhhmmssmmm.acq

.err

An .err file is created in case or an error:

FileName.ext_YYYYMMDDhhmmssmmm.err

Please open this file and analyse the error message.

Feedback files (Replies folder)

For some reporting, the administration will give you a more detailed feedback. The feedbacks from the authority will come into feedbacks.

        1. à vérifier

By default, feedback files are dropped into Replies sub-folders. Replies folders are created dynamically in the initial transmission folder of the files. They only appear when feedback files, sent by the supervisory authorities, have to be stored. If the folder is deleted, it will be automatically recreated upon receipt of new feedback files.

The name and location of the Replies folder may be configured differently from the implementation of the solution with your company’s project coordinator 

Autority Description
CSSF

Feedback files generated and sent by the CSSF.

Please click the picture below to access the Naming convention for CSSF reportings document:

A close-up of a screen Description automatically generated

BCL

Feedback files generated and sent by the BCL.

The BCL sends feedback with the following naming convention :

FDBTECH_[OK/KO]_[YYYYMMDD]_[SENT FILE NAME]_[RANDOM CARACTERS].xml

With

  • [OK/KO] : replaced either by OK (if the files has been transmitted and processed successfully) or KO (if there has been an error)

  • [YYYYMMDD] : replaced by the date of the feedback

  • [SENT FILE NAME] : replaced by the complete name of the original file (including it's extension)

  • [RANDOM CARACTERS] : replaced by a random and unique caracters.

  • For other reporting (08/371 / VNI...), there is no additional acknowledgment.

This means that only acq will be created.

Conclusion : Checking that both trt and acq files were generated is a good way to ensure the good working of the Sending Service. Doing this way, you can be sure that your data was properly sent and e-file will be in charge of forwarding them to authorities.

Retrieved from "http://www.e-file.lu/wiki/index.php?title=Sending_Service_java-less_version&oldid=6675"