FatcaNilReporter is a Windows desktop tool for building FATCA nil-reporting payloads and IDES-style packages for funds. This guide describes setup, the main window, and each workflow. For the ZIP download, see Products.
The application reads reporting-entity data from a fixed Excel workbook (fatca_reporting_entity.xlsx) placed next to the executable. You choose a GIIN and entity row, then generate or revise FATCA XML payloads and package them for your submission process. Outputs are written under a data folder, organized by GIIN and job.
lib.fatca_reporting_entity.xlsx according to your process; the app expects it in the same folder as FatcaNilReporter.exe.D:\FatcaNilReporter).fatca_reporting_entity.xlsx next to FatcaNilReporter.exe.FatcaNilReporter.exe. If the workbook is missing, the app shows an error and exits.
lib dependencies, and the Excel workbook beside the exe.After the workbook loads, use the GIIN drop-down to select a reporting entity. Read-only fields show address, reporting period, and other attributes from the sheet. DocRef/Message identifiers may show as auto-generated placeholders until you run a workflow.
Actions (labels may vary slightly by build):
Select the correct GIIN and entity, then start New message. The app opens a generate dialog where you can review XML, then produce signed artifacts and the final IDES ZIP using the on-screen steps.
For Amend or Void, the app asks for the job folder that contains the relevant unsigned payload XML from a prior run. The folder picker starts under data\<GIIN> when that directory exists. The tool reads MessageRefId and DocRefId values from that file to populate correction fields—ensure you select the folder that matches the submission you intend to correct.
Use Read IRS reply to choose a reply ZIP from IRS; the app can unpack and present contents for review.
Packaged jobs are stored under data\<GIIN>\<job folder>. Each job folder typically includes the payload (unsigned/signed as applicable), metadata XML, key material, and the final ZIP named for submission. Keep a clear mapping between each ZIP you transmit and its job folder for traceability.
data → GIIN → job folder with payload and metadata.Disclaimer. FatcaNilReporter is a software tool only. It does not provide legal, tax, or regulatory advice. You are responsible for validating outputs against applicable rules, schemas, and your internal policies. Use at your own risk.