EN|DE
Technical Guide

AIFMD II Annex IV XML: Complete Technical Guide

JL
Julian Laycock
Published 25 Feb 2025 · 12 min read
Table of Contents

If you manage an alternative investment fund in the European Union, Annex IV reporting is one of the most consequential regulatory obligations you face. It is also one of the most technically demanding. This guide covers everything you need to know — from the legal basis and filing deadlines to the XML schema structure, common validation pitfalls, and how modern tooling can eliminate manual effort entirely.

1. What Is Annex IV Reporting?

Annex IV is a standardised data template defined in Directive 2011/61/EU (the AIFM Directive). It requires Alternative Investment Fund Managers (AIFMs) to periodically report detailed information about each fund they manage to their home National Competent Authority (NCA) — for example, BaFin in Germany, the CSSF in Luxembourg, or the AMF in France.

The report covers a wide range of data points grouped into roughly 300 fields across several sections:

The purpose is systemic risk monitoring. ESMA aggregates the data across all EU NCAs and publishes statistical reports on the AIF industry. NCAs also use it for firm-level supervision.

2. Who Must File?

Every authorised or registered AIFM in the EU must file Annex IV reports. This includes:

Under AIFMD II (Directive 2024/927), the reporting scope is expanded. Key changes effective April 2026 include:

3. Filing Deadlines

Reporting frequency depends on AuM thresholds:

AuM ThresholdReporting FrequencyDeadline After Period End
< €100 M (sub-threshold)AnnualWithin 1 month (NCA-specific)
€100 M – €500 MSemi-annual30 working days
€500 M – €1 BnSemi-annual30 working days
> €1 BnQuarterly30 working days
Leveraged funds > €500 MQuarterly30 working days
Note: Some NCAs (e.g., BaFin) impose stricter deadlines or request additional data fields beyond the ESMA minimum. Always check your NCA's local guidance.

4. The XML Schema — ESMA XSD Rev 6

Annex IV reports must be submitted as XML files validated against ESMA's official XSD schema. The current production schema is AIFMD_DATAIF_V1.2.xsd, commonly referred to as "Rev 6".

4.1 Root Structure

<?xml version="1.0" encoding="UTF-8"?>
<AIFReportingInfo
  xmlns="urn:aifmd:aif:reporting"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  CreationDateAndTime="2025-06-30T14:30:00"
  Version="1.2"
  ReportingMemberState="DE">

  <AIFRecordInfo>
    <!-- One block per AIF -->
  </AIFRecordInfo>

</AIFReportingInfo>

Key attributes on the root element:

4.2 AIFRecordInfo Section

Each <AIFRecordInfo> block describes one AIF. It contains nested elements for:

4.3 Enumerations and Code Lists

ESMA defines strict enumerations for many fields. Examples:

FieldAllowed Values
AIFTypeHFND, PEQF, REST, FOFS, OTHR, NONE
PredominantAIFTypeSame as above, qualified by sub-strategy codes
MarketIdentificationMIC codes (ISO 10383)
CurrencyCodeISO 4217 three-letter codes
CountryCodeISO 3166-1 alpha-2

Using an incorrect enumeration value is the single most common cause of schema validation failure.

5. Common Validation Errors

After years of working with Annex IV filings across multiple NCAs, these are the errors we see most frequently:

5.1 Namespace Mismatch

The root element must declare the correct namespace URI. A single typo — urn:aifmd:aif:Reporting instead of urn:aifmd:aif:reporting — will cause the entire file to fail validation.

5.2 Date Format Errors

All dates must be xs:date (YYYY-MM-DD) or xs:dateTime (YYYY-MM-DDThh:mm:ss). Excel-sourced dates like 30/06/2025 will be rejected.

5.3 Decimal Precision

Many numeric fields have maximum fractional digits defined in the XSD. For example, NAV values typically allow 2 decimal places. Submitting 1234567.891 instead of 1234567.89 triggers a facet violation.

5.4 Missing Conditional Fields

Certain elements are conditionally required. For instance, if LeverageAIF is set to true, then the <LeverageGrossMethod> and <LeverageCommitmentMethod> elements become mandatory. Omitting them produces a content model error.

5.5 Percentage Fields Not Summing to 100

Several sections require percentage breakdowns that must sum to exactly 100. Rounding errors (e.g., 33.33 + 33.33 + 33.34 = 100.00 ✓ but 33.33 + 33.33 + 33.33 = 99.99 ✗) are a constant source of rejection.

5.6 Incorrect AIF National Code Format

Each NCA expects a specific format for the AIFNationalCode. BaFin uses a numeric identifier; other NCAs may use alphanumeric codes with specific prefix patterns. Misformatting causes the portal to reject the upload even if the XML is schema-valid.

6. Validation Workflow Best Practices

A robust Annex IV validation workflow should include three layers:

  1. Schema validation — validate the XML against the official XSD using a conformant parser (e.g., libxml2, xmllint, or Java's javax.xml.validation). This catches structural errors.
  2. Business rule validation — check cross-field consistency (percentage sums, conditional requirements, leverage calculations). ESMA publishes supplementary validation rules alongside the XSD.
  3. NCA-specific validation — apply any local rules your NCA enforces. BaFin's MVP-Portal, for instance, runs additional checks beyond the ESMA schema.
# Example: validate with xmllint
xmllint --noout --schema AIFMD_DATAIF_V1.2.xsd report.xml

# Expected output:
# report.xml validates

7. AIFMD II Changes to Annex IV

AIFMD II (Directive 2024/927) introduces material changes to the reporting template. While ESMA is still finalising the technical standards, the key changes are:

Fund managers should expect a new XSD version (likely Rev 7 or v2.0) to be published in 2025, with a transition period aligned to the April 2026 enforcement date.

8. How Caelith Automates Annex IV

Caelith eliminates the complexity of Annex IV reporting through a purpose-built pipeline:

Stop wrestling with XML.

Caelith generates validated Annex IV reports in under 4 minutes. Book a demo to see it in action.

Book a demo →