errorubl-2.1

XML-002:Malformed XML structure

XML document is not well-formed.

Severity
Fatal
Rule set
ubl-2.1
Country
All EU
Fix type
BLOCKED

Engine Classification

Financial or legal field · Modification blocked by policy

Reason: The XML document has structural errors (unclosed tags, invalid nesting, etc.) that make it unparseable. Your invoicing software must generate well-formed XML. Contact your software vendor to fix the XML generation.

What is XML-002?

XML-002 is a fatal validation rule defined in the ubl-2.1 specification. It validates the XML parsing error element in the UBL invoice XML.

When this rule fires, the invoice is non-compliant and will be rejected by Peppol access points and national validation services. The sending system receives a rejection response and the invoice does not reach the buyer.

Target path: XML parsing error

This error requires manual correction — financial fields are protected by policy.Get API Access

Why This Error Matters

Malformed XML cannot be processed.

XML-002 is a hard failure. Invoices that trigger this rule are rejected at the access point and never reach the recipient. In Peppol networks, this means your sending system receives an MLR (Message Level Response) with a rejection status. The invoice must be corrected and re-sent, adding delay to your payment cycle.

Validator Behavior

  • ·Causes invoice rejection
  • ·Fails UBL schema validation
  • ·Error returned: XML-002
  • ·Specification: ubl-2.1

How to Fix It

1.

Check brackets

All tags must close properly

2.

Check quotes

Attributes must use quotes

3.

Validate

Use XML validator

XML Example

Generic example based on the rule's target XPath. Your actual XML structure may differ.

Before
<!-- Triggers validation error -->
<XML parsing error></XML parsing error>
After
<!-- Corrected -->
<XML parsing error>VALID_VALUE</XML parsing error>

Technical Reference

XPathXML parsing error
Specubl-2.1

Common Causes

  • ·Unclosed tags
  • ·Missing quotes
  • ·Invalid characters

Seeing this in production? The API handles XML-002 automatically. See the fix response →

Frequently Asked Questions

XML document is not well-formed.

Fix XML syntax errors. This error involves a protected field — Invoice Navigator flags it in your pipeline so your team can correct it at the source.

Yes, XML-002 is a critical error that must be fixed.

Related Content

Last updated: 3 March 2026

Share this guide:

Detect XML-002 Before Submission

This error involves a financial or legal field that cannot be auto-modified. The compliance engine flags it immediately with a clear diagnosis so your team can fix it at the source.