FATCA Manual

From E-fileWiki
Revision as of 08:22, 18 March 2017 by User (talk | contribs)
Jump to navigation Jump to search
Home page Return homepage
Français Accéder à la partie française

Introduction

The Luxembourg Tax Authoritiy (Administration des contributions directes (ACD)) published on 19 January 2017 an updated version of the circular ECHA3 defining the new format that takes into account the Internal Revenue Services (IRS) FATCA XSD 2.0. Luxembourg Financial Institutions will have to use this new schema, as it will be the only one accepted as from now.


Manual filing through e-file v2

Environment

  • Select your environment:

Production environment : https://www.e-file.lu/e-file/

Homologation environment (Test) : https://homologation.e-file.lu/e-file/


Login

  • Enter your e-file login credentials (user name and password) and click the Access button.

Identification.jpg

IMPORTANT: If you do not have an e-file user account or if you do not remember your password, you might contact your e-file administrator of your company.


FATCA form

  • Click on the Report Generation icon:

Fatca ReportGen.jpg


  • Select

Select Form Fatca.jpg


Naming convention

Report :
FATCA_DateTime_Channel_MatriculeReporter_GIIN_ProdTest.xml

Feedback from ACD :
FATCA_ DateTime_Channel_MatriculeReporter_GIIN_ProdTest_Status.xml

Code Definition Structure Values
DateTime Creation date and time Number(14) AAAAMMJJhhmmss
Channel Communication channel Char(1) B (Bourse)
MatriculeReporter Social Security Identification Number Number(11) - Number(13) Code CCSS
GIIN GIIN (Global Intermediary Identification Number ) of the declarer Char(6).Char(5).Char(2).Number(3) Code GIIN XXXXXX.XXXXX.XX.XXX
ProdTest Environment type Char(1) P = Production

T = Test

Status Response status Char(3) Technical Feedback

ACK = File technically received by ACD
NAK = Error encountered during the file reception
Business Feedback
VAL = Validated and imported by ACD
WAR = Validated and imported by ACD but with small issues that raised a warning
ERR = Error in file, rejected by ACD

Examples

Report :
FATCA_20150731115912_B_11231231230_LBITA8.00002.SP.442_T.xml

FATCA report created the 31/07/2015 via Bourse’s channel, with CCSS code 11231231230 GIIIN code LBITA8.00002.SP.442, in the test environment.

Feedback from ACD :
FATCA_20150731115912_B_11231231230_LBITA8.00002.SP.442_T_ack.xml
FATCA report created the 31/07/2015 via Bourse’s channel, with CCSS code 11231231230 GIIIN code LBITA8.00002.SP.442, in the test environment and has been received by ACD.

Manual sending

Link to the video tutorial for FATCA report : https://www.e-file.lu/videos/Util_FATCA_Flex_EN.htm

Work in progress, export and import of reports

Work in progress on a report can be saved with the ExportDraft.png button. The exported .xml file will be called DRAFT_filename.xml and cannot be uploaded for FATCA filing. It can be imported for later use.
The final reported can be saved via the ExportXMLFormat.png button. This button will only be available if the green Icon GreenIcon.png appears in every section and the report has been completed. The file will be saved in xml format with the required naming convention. It will be saved on your hard drive and is available for sending to the Regulator.

The SelectReport.png button allows you to upload an existing report in .xml from your network or harddrive into the report generator.

Transmission with the Report Generator

Setup of the e-file v2 encryption module v2

A completed report can be sent with the Transmission.png button. Java version 1.7.55 is a prerequisite for the installation of the e-file v2 encryption module.
When the Transmission.png button is used for the first time, a Java application will be downloaded (.jnlp) in order to install the encryption module locally on your computer.
Please hit RunButton.png when the following window appears on your screen in order to launch the encryption module.

JavaEfileWindow.png

Warning: It is possible that the pop up blocker prevents that the .jnlp file is downloaded. Please check with your IT to allow pop ups from https://www.e-file.lu/ .

The encryption module has to be configured when it is used for the first time (or after each Java update). The path to the keystore has to be selected with the BrowseButton.png button and the key (locally or on a server) will have to be imported with the ImportButton.png button :

EncryptionConfig.png

After the import of the key, the access to the keystore is saved and does not have to be reconfigured in the future. You will be redirected to the sending screen and reports can now be sent with e-file v2. In order to be more user friendly and to speed up the sending process, the encryption module runs as a back ground process on your desktop. In order to end the process, right click on the icon in the taskbar and select “Close encryption module” :

EncryptionTaskbar.png

After the installation of the encryption module on your desktop, reports can be sent from the Report Generator with the Transmission.png button. In the following window, the file name is automatically generated and compliant to the ACD naming convention :

EncryptionGeneral.png

After entering a name for the sending (this name will also be used for search queries) and entering the keystore password, the report can be sent with the SendButton.png button. A popup window will confirm the transmission.

Automatic Sending with the Sending Service

In order to send reports with the Sending Service, the following components have to be installed on your desktop:

  • Java version 1.6.0.14 or higher
  • Sending service version 3.3.6 or higher

Access to the Sending Service

The Sending Service is accessible with the file explorer and visible as a folder including subfolders :

Error creating thumbnail: Image type not supported

The standard file structure includes a «FATCA» subfolder (by default, a subfolder for each type of reporting is included).

Sending frequency

During the setup of the sending service, the sending frequency can be individually set for each subfolder by your e-file administrator within the setup file. The default sending frequency is every 30 minutes but it can be tailored according to your needs.

Report transmission

In order to send a report with the Sending Service, the exported .xml report has to be copied into the …/ServiceDeposant/ReportingDiffusion/FATCA subfolder.

Files created by the Sending Service

During and at the end of the sending, the Sending Service generates various files in the subfolder that has been used for the sending. Three type of files are generated:

  • .trt file : indicates the start of the transmission

In order to be able to send the original file, the Sending Service transforms the latter into a .trt file and adds a timestamp. Eg «OriginalName.xml» is transformed into OriginalName.xml.timestamp.trt:

FATCA_20150731115912_B_11231231230_LBITA8.00002.SP.442_T.xml becomes
FATCA_20150731115912_B_11231231230_LBITA8.00002.SP.442_T.xml_20150731122616366.trt

  • .acq file : the transmission has been successfully completed

Example of a successful transmission :
Before the transmission :

FatcaFileXml.png

After the transmission:
FatcaFileAcq.png

  • .err file : indicates that an error has occurred during the sending

The error file contains technical messages designed to help find the root cause of the error, eg naming errors.


Transmission follow up

Get the feedbacks

Manual access

First connect on https://www.e-file.lu/e-file with your credentials.
Select the "Document management" module as follow :

IconModules.png


Select "Transmission follow up" tab :

TransmissionFU.png

The search can be defined between 2 dates and will display all the reports sent during that period.
Each report has a status to have a quick overview of your sendings.

  • "Transmitted" means that the report is currently dispatched to the ACD.
  • "Feedback Received" means that at least one feedback has been received. It also means that the ACD was able to read your report.
  • "To validate" means that the report needs to be validated by the declarant on E-file V2. This is a really specific case.


ResultSearch.png

To see the reports and its feedback, click on the blue icon on the right.

ListFiles.png

The files are displayed with a type:

  • FATCA = Original report
  • FDBTEC = Technical feedback
  • FDBBUS = Business feedback


To read one of these files, click on the green icon on the right.
As the document is encrypted it will launch our encryption module V2.

ModuleDL2.png
Finally the keystore password is requested to either save the file or directly open it.

Access from Sending Service

ACD's feedbacks can be found in the sub-folder "Replies" from the following path .../ServiceDeposant/ReportindDiffusion/FATCA/Replies/.
Each feedback has a specifical status (see #Naming_convention : Status) which can be seen in the file name (ex : ack).

FeedbackSendingService.png

The "Replies" folder is created upon feedback receipt. Please check the Sending Service's configuration whether it cannot be found. In the configuration file, the variable corresponding to "Configuration of connection for feedback" and the the one corresponding to "Configuration of connection for authority acknowledgement" should be set to "up".

FATCA FAQ

What is the AEOI reference ?

The AEOI reference is a unique reference that needs to be set up for your report. It's a free text you can fill with the text/number of your choice. It is used to identify reports if you need to make a reference.

How to modify an existing report ?

In order to modify an existing report the Report Generator's form has to be completed with the new information. The type of modification to apply is set up in the "Reporting FI" section in "Document Specification" and in "Reporting Group" section in "Account Report" when clicking AddAccount.png.
The different types are the following :

  • FATCA1 : Initial sending. The file contains only new information
  • FATCA2 : Asked modifications. The file contains only corrections asked by american's authorities (IRS)
  • FATCA3 : Cancellations. The file contains only cancellations concerning previously changed information
  • FATCA4 : Modifications. The file contains only corrections concerning the previously changed information on declarer's initiative

To chose the report to modify, its reference has to be entered in the document reference ID to correct and message reference ID to correct.
RefDoc.png

Why the GIINs do not appear on the form ?

To register your GIINs the contact form of our Client Service has to be fill up.
After the registration of your GIINs you will receive a confirmation mail within few days, if you haven't received the email yet please contact fatca_onboarding@fundsquare.net.

Error message : The process takes too much time. Please restart the encryption module.

ErrorTransmission.png
The error message occurs when the encryption module is not started in time.
Please check that the pop up are enable for the site https://www.e-file.lu.
When clicking the "Transmission" button the file EfileCrypto.jnlp should be downloaded in order to launch the encryption module. You have to open this file with Java Web Start Launcher to run the module.

Message : Waiting files to transmit...

WaitingFile.png

This error might occur when there is a connection problem between your proxy and the encryption module V2.

Close the encryption module :
EncryptionTaskbar.png

Open the Java console (See http://www.e-file.lu/wiki/index.php/Encryption_Module#Show_the_console_in_case_of_other_Java_issue) and check the logs.
If an error 407 appears, it means that the encryption module is not able to authenticate on your proxy.
As a consequence all communications with E-file are blocked.

In that case the solutions to resolve this problem are the following :

  • Add the group "NoAuthenticated exception group" to your proxy for www.e-file.lu
  • By-pass the proxy for the communication with www.e-file.lu

For more information please call the Helpdesk.