Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Validator fails on some official ZUGFeRD 2.0 and 2.2 example documents #569

Open
janwytze opened this issue Nov 21, 2024 · 4 comments
Open

Comments

@janwytze
Copy link

I'm working on an application that converts E-invoices to a standard json format, and I validate documents using mustang before converting them. But somehow lots of example documents from the ZUGFeRD 2.0.1 and 2.2 versions seem to just fail the validation. The 2.3 test documents seem to work. Is the mustangproject only compatible with the latest Factur-X spec?

@jstaerk
Copy link
Collaborator

jstaerk commented Nov 21, 2024

2.15.0 is on 2.3.2, yes, which documents fail how?

@janwytze
Copy link
Author

janwytze commented Nov 21, 2024

@jstaerk Somehow I'm not able to find the example documents of 2.2 and 2.0.1 on https://www.ferd-net.de anymore. But I can give the xml:

2.0 EN16931

XML
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!--Nutzungsrechte 
ZUGFeRD Datenformat Version 2.0, 30.11.2018
Beispiel Version 30.11.2018

Zweck des Forums für elektronische Rechnungen bei der AWV e.V („FeRD“) ist u.a. die Schaffung und Spezifizierung 
eines offenen Datenformats für strukturierten elektronischen Datenaustausch auf der Grundlage offener und nicht 
diskriminierender, standardisierter Technologien („ZUGFeRD Datenformat“)

Das ZUGFeRD Datenformat wird nach Maßgabe des FeRD sowohl Unternehmen als auch der öffentlichen Verwaltung 
frei zugänglich gemacht. Hierfür bietet FeRD allen Unternehmen und Organisationen der öffentlichen Verwaltung eine 
Lizenz für die Nutzung des urheberrechtlich geschützten ZUGFeRD-Datenformats zu fairen, sachgerechten und nicht 
diskriminierenden Bedingungen an.

Die Spezifikation des FeRD zur Implementierung des ZUGFeRD Datenformats ist in ihrer jeweils geltenden Fassung 
abrufbar unter www.ferd-net.de.

Im Einzelnen schließt die Nutzungsgewährung ein: 
=====================================

FeRD räumt eine Lizenz für die Nutzung des urheberrechtlich geschützten ZUGFeRD Datenformats in der jeweils 
geltenden und akzeptierten Fassung (www.ferd-net.de) ein. 
Die Lizenz beinhaltet ein unwiderrufliches Nutzungsrecht einschließlich des Rechts der Weiterentwicklung, 
Weiterbearbeitung und Verbindung mit anderen Produkten.
Die Lizenz gilt insbesondere für die Entwicklung, die Gestaltung, die Herstellung, den Verkauf, die Nutzung oder 
anderweitige Verwendung des ZUGFeRD Datenformats für Hardware- und/oder Softwareprodukte sowie sonstige 
Anwendungen und Dienste. 
Diese Lizenz schließt nicht die wesentlichen Patente der Mitglieder von FeRD ein. Als wesentliche Patente sind Patente 
und Patentanmeldungen weltweit zu verstehen, die einen oder mehrere Patentansprüche beinhalten, bei denen es sich um 
notwendige Ansprüche handelt. Notwendige Ansprüche sind lediglich jene Ansprüche der Wesentlichen Patente, die durch 
die Implementierung des ZUGFeRD Datenformats notwendigerweise verletzt würden. 
Der Lizenznehmer ist berechtigt, seinen jeweiligen Konzerngesellschaften ein unbefristetes, weltweites, nicht übertragbares, 
unwiderrufliches Nutzungsrecht einschließlich des Rechts der Weiterentwicklung, Weiterbearbeitung und Verbindung mit 
anderen Produkten einzuräumen. 

Die Lizenz wird kostenfrei zur Verfügung gestellt. 

Außer im Falle vorsätzlichen Verschuldens oder grober Fahrlässigkeit haftet FeRD weder für Nutzungsausfall, entgangenen 
Gewinn, Datenverlust, Kommunikationsverlust, Einnahmeausfall, Vertragseinbußen, Geschäftsausfall oder für Kosten, 
Schäden, Verluste oder Haftpflichten im Zusammenhang mit einer Unterbrechung der Geschäftstätigkeit, noch für konkrete, 
beiläufig entstandene, mittelbare Schäden, Straf- oder Folgeschäden und zwar auch dann nicht, wenn die Möglichkeit der 
Kosten, Verluste bzw. Schäden hätte normalerweise vorhergesehen werden können.--><rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:a="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:10" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" xmlns:xs="http://www.w3.org/2001/XMLSchema">
      
    <rsm:ExchangedDocumentContext>
            
        <ram:GuidelineSpecifiedDocumentContextParameter>
                  
            <ram:ID>urn:cen.eu:en16931:2017</ram:ID>
                
        </ram:GuidelineSpecifiedDocumentContextParameter>
          
    </rsm:ExchangedDocumentContext>
      
    <rsm:ExchangedDocument>
            
        <ram:ID>471102</ram:ID>
            
        <ram:TypeCode>380</ram:TypeCode>
            
        <ram:IssueDateTime>
                  
            <udt:DateTimeString format="102">20180605</udt:DateTimeString>
                
        </ram:IssueDateTime>
            
        <ram:IncludedNote>
                  
            <ram:Content>
Rechnung gemäß Bestellung Nr. 2018-471331 vom 01.03.2018. 
      
      </ram:Content>
                
        </ram:IncludedNote>
            
        <ram:IncludedNote>
                  
            <ram:Content>
Es bestehen Rabatt- und Bonusvereinbarungen.
			
      </ram:Content>
                  
            <ram:SubjectCode>AAK</ram:SubjectCode>
                
        </ram:IncludedNote>
            
        <ram:IncludedNote>
                  
            <ram:Content>Lieferant GmbH				
Lieferantenstraße 20				
80333 München				
Deutschland				
Geschäftsführer: Hans Muster
Handelsregisternummer: H A 123

      </ram:Content>
                  
            <ram:SubjectCode>REG</ram:SubjectCode>
                
        </ram:IncludedNote>
          
    </rsm:ExchangedDocument>
      
    <rsm:SupplyChainTradeTransaction>
            
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>1</ram:LineID>
                		  
                <ram:IncludedNote>
                              
                    <ram:Content>Wir erlauben uns Ihnen folgende Positionen aus der Lieferung Nr. 2018-51112 in Rechnung zu stellen:</ram:Content>
                            
                </ram:IncludedNote>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:GlobalID schemeID="0160">4012345001235</ram:GlobalID>
                        
                <ram:SellerAssignedID>KR3M</ram:SellerAssignedID>
                        
                <ram:BuyerAssignedID/>
                        
                <ram:Name>Kunstrasen grün 3m breit</ram:Name>
                        
                <ram:Description>300cm x 100 cm</ram:Description>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:GrossPriceProductTradePrice>
                              
                    <ram:ChargeAmount>4.0000</ram:ChargeAmount>
                              
                    <ram:AppliedTradeAllowanceCharge>
                                  
                        <ram:ActualAmount>0.6667</ram:ActualAmount>
                                    
                        <ram:Reason>Rabatt</ram:Reason>
                                  
                    </ram:AppliedTradeAllowanceCharge>
                            
                </ram:GrossPriceProductTradePrice>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>3.3333</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="MTK">3.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>10.00</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
            
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>2</ram:LineID>
                        
                <ram:IncludedNote>
                              
                    <ram:Content>Bestellt wurden 5 kg Schweinesteak. Mit dieser Rechnung werden nur die bereits gelieferten Steaks berechnet. Die noch offenen 4 kg Schweinesteak werden separat geliefert und berechnet.</ram:Content>
                            
                </ram:IncludedNote>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:GlobalID schemeID="0160">4000050986428</ram:GlobalID>
                        
                <ram:SellerAssignedID>SFK5</ram:SellerAssignedID>
                        
                <ram:BuyerAssignedID/>
                        
                <ram:Name>Schweinesteak</ram:Name>
                        
                <ram:Description>Schweinesteak aus Deutschland</ram:Description>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:GrossPriceProductTradePrice>
                              
                    <ram:ChargeAmount>5.5000</ram:ChargeAmount>
                            
                </ram:GrossPriceProductTradePrice>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>5.5000</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="KGM">1.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>5.50</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
            
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>3</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:GlobalID schemeID="0160">4000001234561</ram:GlobalID>
                        
                <ram:SellerAssignedID>GTRWA5</ram:SellerAssignedID>
                        
                <ram:BuyerAssignedID/>
                        
                <ram:Name>Mineralwasser Medium 
12 x 1,0l PET
        </ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:GrossPriceProductTradePrice>
                              
                    <ram:ChargeAmount>5.4900</ram:ChargeAmount>
                            
                </ram:GrossPriceProductTradePrice>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>5.4900</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">20.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>109.80</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
            
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>4</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:GlobalID schemeID="0160">4000001234578</ram:GlobalID>
                        
                <ram:SellerAssignedID>PFA5</ram:SellerAssignedID>
                        
                <ram:BuyerAssignedID/>
                        
                <ram:Name>Pfand</ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:GrossPriceProductTradePrice>
                              
                    <ram:ChargeAmount>2.7700</ram:ChargeAmount>
                            
                </ram:GrossPriceProductTradePrice>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>2.7700</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">20.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>55.46</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
            
        <ram:ApplicableHeaderTradeAgreement>
                  
            <ram:SellerTradeParty>
                        
                <ram:GlobalID schemeID="0088">4000001123452</ram:GlobalID>
                        
                <ram:Name>Lieferant GmbH</ram:Name>
                        
                <ram:PostalTradeAddress>
                              
                    <ram:PostcodeCode>80333</ram:PostcodeCode>
                              
                    <ram:LineOne>Lieferantenstraße 20</ram:LineOne>
                              
                    <ram:CityName>München</ram:CityName>
                              
                    <ram:CountryID>DE</ram:CountryID>
                            
                </ram:PostalTradeAddress>
                        
                <ram:SpecifiedTaxRegistration>
                              
                    <ram:ID schemeID="FC">201/113/40209</ram:ID>
                            
                </ram:SpecifiedTaxRegistration>
                        
                <ram:SpecifiedTaxRegistration>
                              
                    <ram:ID schemeID="VA">DE123456789</ram:ID>
                            
                </ram:SpecifiedTaxRegistration>
                      
            </ram:SellerTradeParty>
                  
            <ram:BuyerTradeParty>
                        
                <ram:ID>GE2020211</ram:ID>
                        
                <ram:GlobalID schemeID="0088">4000001987658</ram:GlobalID>
                        
                <ram:Name>Kunden AG Mitte</ram:Name>
                        
                <ram:PostalTradeAddress>
                              
                    <ram:PostcodeCode>69876</ram:PostcodeCode>
                              
                    <ram:LineOne>Kundenstraße 15</ram:LineOne>
                              
                    <ram:CityName>Frankfurt</ram:CityName>
                              
                    <ram:CountryID>DE</ram:CountryID>
                            
                </ram:PostalTradeAddress>
                      
            </ram:BuyerTradeParty>
                  
            <ram:BuyerOrderReferencedDocument>
                        
                <ram:IssuerAssignedID>2018-471331</ram:IssuerAssignedID>
                      
            </ram:BuyerOrderReferencedDocument>
                
        </ram:ApplicableHeaderTradeAgreement>
            
        <ram:ApplicableHeaderTradeDelivery>
                  
            <ram:ActualDeliverySupplyChainEvent>
                        
                <ram:OccurrenceDateTime>
                              
                    <udt:DateTimeString format="102">20180603</udt:DateTimeString>
                            
                </ram:OccurrenceDateTime>
                      
            </ram:ActualDeliverySupplyChainEvent>
                
        </ram:ApplicableHeaderTradeDelivery>
            
        <ram:ApplicableHeaderTradeSettlement>
                  
            <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
                  
            <ram:ApplicableTradeTax>
                        
                <ram:CalculatedAmount>7.91</ram:CalculatedAmount>
                        
                <ram:TypeCode>VAT</ram:TypeCode>
                        
                <ram:BasisAmount>113.03</ram:BasisAmount>
                        
                <ram:CategoryCode>S</ram:CategoryCode>
                        
                <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
                      
            </ram:ApplicableTradeTax>
                  
            <ram:ApplicableTradeTax>
                        
                <ram:CalculatedAmount>12.25</ram:CalculatedAmount>
                        
                <ram:TypeCode>VAT</ram:TypeCode>
                        
                <ram:BasisAmount>64.46</ram:BasisAmount>
                        
                <ram:CategoryCode>S</ram:CategoryCode>
                        
                <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                      
            </ram:ApplicableTradeTax>
                  
            <ram:SpecifiedTradeAllowanceCharge>
                        
                <ram:ChargeIndicator>
                              
                    <udt:Indicator>false</udt:Indicator>
                            
                </ram:ChargeIndicator>
                        
                <ram:BasisAmount>10.00</ram:BasisAmount>
                        
                <ram:ActualAmount>1.00</ram:ActualAmount>
                        
                <ram:Reason>Sondernachlass</ram:Reason>
                        
                <ram:CategoryTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:CategoryTradeTax>
                      
            </ram:SpecifiedTradeAllowanceCharge>
                  
            <ram:SpecifiedTradeAllowanceCharge>
                        
                <ram:ChargeIndicator>
                              
                    <udt:Indicator>false</udt:Indicator>
                            
                </ram:ChargeIndicator>
                        
                <ram:BasisAmount>115.30</ram:BasisAmount>
                        
                <ram:ActualAmount>8.07</ram:ActualAmount>
                        
                <ram:Reason>Sondernachlass</ram:Reason>
                        
                <ram:CategoryTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
                            
                </ram:CategoryTradeTax>
                      
            </ram:SpecifiedTradeAllowanceCharge>
            	    
            <ram:SpecifiedTradeAllowanceCharge>
                        
                <ram:ChargeIndicator>
                              
                    <udt:Indicator>true</udt:Indicator>
                            
                </ram:ChargeIndicator>
                        
                <ram:BasisAmount>115.30</ram:BasisAmount>
                        
                <ram:ActualAmount>5.80</ram:ActualAmount>
                        
                <ram:Reason>Versandkosten</ram:Reason>
                        
                <ram:CategoryTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>7.00</ram:RateApplicablePercent>
                            
                </ram:CategoryTradeTax>
                      
            </ram:SpecifiedTradeAllowanceCharge>
                  
            <ram:SpecifiedTradePaymentTerms>
                        
                <ram:Description>Zahlbar innerhalb 30 Tagen netto bis 04.07.2018, 3% Skonto innerhalb 10 Tagen bis 15.06.2018</ram:Description>
                      
            </ram:SpecifiedTradePaymentTerms>
                  
            <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
                        
                <ram:LineTotalAmount>180.76</ram:LineTotalAmount>
                        
                <ram:ChargeTotalAmount>5.80</ram:ChargeTotalAmount>
                        
                <ram:AllowanceTotalAmount>9.07</ram:AllowanceTotalAmount>
                        
                <ram:TaxBasisTotalAmount>177.49</ram:TaxBasisTotalAmount>
                		
                <ram:TaxTotalAmount currencyID="EUR">20.16</ram:TaxTotalAmount>
                        
                <ram:GrandTotalAmount>197.65</ram:GrandTotalAmount>
                        
                <ram:TotalPrepaidAmount>50.00</ram:TotalPrepaidAmount>
                        
                <ram:DuePayableAmount>147.65</ram:DuePayableAmount>
                      
            </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
                
        </ram:ApplicableHeaderTradeSettlement>
          
    </rsm:SupplyChainTradeTransaction>
    
</rsm:CrossIndustryInvoice>
Error
schema validation fails:org.xml.sax.SAXParseException; lineNumber: 57; columnNumber: 29; cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100":ActualAmount}'. One of '{"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100":ChargeIndicator}' is expected.

2.2 EN16931

XML
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- English disclaimer below.--><!--Nutzungsrechte 
ZUGFeRD Datenformat Version 2.2.0, 14.02.2022
Beispiel Version 14.02.2022
 
Zweck des Forums elektronisch Rechnung Deutschland, welches am 31. März 2010 unter der Arbeitsgemeinschaft für 
wirtschaftliche Verwaltung e. V. gegründet wurde, ist u. a. die Schaffung und Spezifizierung eines offenen Datenformats 
für strukturierten elektronischen Datenaustausch auf der Grundlage offener und nicht diskriminierender, standardisierter 
Technologien („ZUGFeRD Datenformat“).
 
Das ZUGFeRD Datenformat wird nach Maßgabe des FeRD sowohl Unternehmen als auch der öffentlichen Verwaltung 
frei zugänglich gemacht. Hierfür bietet FeRD allen Unternehmen und Organisationen der öffentlichen Verwaltung eine 
Lizenz für die Nutzung des urheberrechtlich geschützten ZUGFeRD-Datenformats zu fairen, sachgerechten und nicht 
diskriminierenden Bedingungen an.
 
Die Spezifikation des FeRD zur Implementierung des ZUGFeRD Datenformats ist in ihrer jeweils geltenden Fassung 
abrufbar unter www.ferd-net.de.
 
Im Einzelnen schließt die Nutzungsgewährung ein: 
=====================================
 
FeRD räumt eine Lizenz für die Nutzung des urheberrechtlich geschützten ZUGFeRD Datenformats in der jeweils 
geltenden und akzeptierten Fassung (www.ferd-net.de) ein. 
Die Lizenz beinhaltet ein unwiderrufliches Nutzungsrecht einschließlich des Rechts der Weiterentwicklung, 
Weiterbearbeitung und Verbindung mit anderen Produkten.
Die Lizenz gilt insbesondere für die Entwicklung, die Gestaltung, die Herstellung, den Verkauf, die Nutzung oder 
anderweitige Verwendung des ZUGFeRD Datenformats für Hardware- und/oder Softwareprodukte sowie sonstige 
Anwendungen und Dienste. 
Diese Lizenz schließt nicht die wesentlichen Patente der Mitglieder von FeRD ein. Als wesentliche Patente sind Patente 
und Patentanmeldungen weltweit zu verstehen, die einen oder mehrere Patentansprüche beinhalten, bei denen es sich um 
notwendige Ansprüche handelt. Notwendige Ansprüche sind lediglich jene Ansprüche der Wesentlichen Patente, die durch 
die Implementierung des ZUGFeRD Datenformats notwendigerweise verletzt würden. 
Der Lizenznehmer ist berechtigt, seinen jeweiligen Konzerngesellschaften ein unbefristetes, weltweites, nicht übertragbares, 
unwiderrufliches Nutzungsrecht einschließlich des Rechts der Weiterentwicklung, Weiterbearbeitung und Verbindung mit 
anderen Produkten einzuräumen. 
 
Die Lizenz wird kostenfrei zur Verfügung gestellt. 
 
Außer im Falle vorsätzlichen Verschuldens oder grober Fahrlässigkeit haftet FeRD weder für Nutzungsausfall, entgangenen 
Gewinn, Datenverlust, Kommunikationsverlust, Einnahmeausfall, Vertragseinbußen, Geschäftsausfall oder für Kosten, 
Schäden, Verluste oder Haftpflichten im Zusammenhang mit einer Unterbrechung der Geschäftstätigkeit, noch für konkrete, 
beiläufig entstandene, mittelbare Schäden, Straf- oder Folgeschäden und zwar auch dann nicht, wenn die Möglichkeit der 
Kosten, Verluste bzw. Schäden hätte normalerweise vorhergesehen werden können.--><!--Right of use 
ZUGFeRD Data format version 2.2.0, February 14th, 2022
 
The purpose of the Forum elektronische Rechnung Deutschland (FeRD), which was founded on March 31, 2010 under the 
umbrella of Arbeitsgemeinschaft für wirtschaftliche Verwaltung e. V., is, among other things, to create and specify an 
open data format for structured electronic data exchange on the basis of open and non discriminatory, standardised 
technologies ("ZUGFeRD data format").
 
The ZUGFeRD data format is used by both companies and public administration according to the FeRD 
made freely accessible. For this purpose FeRD offers all companies and organisations of the public administration a 
License to use the copyrighted ZUGFeRD data format in a fair, appropriate and non 
discriminatory conditions.
 
The specification of the FeRD for the implementation of the ZUGFeRD data format is, in its currently valid version 
available at www.ferd-net.de.
 
In detail, the grant of use includes 
=====================================
 
FeRD grants a license for the use of the copyrighted ZUGFeRD data format in the respective 
valid and accepted version (www.ferd-net.de). 
The license includes an irrevocable right of use including the right of further development, 
Further processing and connection with other products.
The license applies in particular to the development, design, production, sale, use or 
other use of the ZUGFeRD data format for hardware and/or software products and other 
applications and services. 
This license does not include the essential patents of the members of FeRD. The essential patents are patents 
and patent applications worldwide which contain one or more claims that are 
necessary claims. Necessary claims are only those claims of the essential patents which are 
the implementation of the ZUGFeRD data format would necessarily be violated. 
The Licensee is entitled to provide its respective group companies with an unlimited, worldwide, non-transferable, 
irrevocable right of use including the right of further development, further processing and connection with 
other products. 
 
The license is provided free of charge. 
 
Except in the case of intentional fault or gross negligence, FeRD is not liable for loss of use, loss of 
Profit, loss of data, loss of communication, loss of revenue, loss of contracts, loss of business or for costs 
damages, losses or liabilities in connection with an interruption of business, nor for concrete, 
incidental, indirect, punitive or consequential damages, even if the possibility of 
costs, losses or damages could normally have been foreseen.--><rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" xmlns:xs="http://www.w3.org/2001/XMLSchema">
      
    <rsm:ExchangedDocumentContext>
            
        <ram:GuidelineSpecifiedDocumentContextParameter>
                  
            <ram:ID>urn:cen.eu:en16931:2017</ram:ID>
                
        </ram:GuidelineSpecifiedDocumentContextParameter>
          
    </rsm:ExchangedDocumentContext>
      
    <rsm:ExchangedDocument>
            
        <ram:ID>9314110911/00/M/00/N</ram:ID>
            
        <ram:TypeCode>387</ram:TypeCode>
            
        <ram:IssueDateTime>
                  
            <udt:DateTimeString format="102">20181001</udt:DateTimeString>
                
        </ram:IssueDateTime>
            
        <ram:IncludedNote>
                  
            <ram:Content>MUSTER-Autovermietung GMBH
Musterstr. 99
99199 MUSTERHAUSEN
Geschäftsführung:
Maxima Musterfrau
USt-IdNr: DE136695976
Telefon: +49 711-50885524
www.musterlieferant.de
HRB Nr. 372876
Amtsgericht Musterstadt
GLN 4304171000002
      </ram:Content>
                  
            <ram:SubjectCode>REG</ram:SubjectCode>
                
        </ram:IncludedNote>
            
        <ram:IncludedNote>
                  
            <ram:Content>Bei Rückfragen:
Telefon: +49 711-50885524
E-Mail : info@muster-autovermietung.de
      </ram:Content>
                
        </ram:IncludedNote>
            
        <ram:IncludedNote>
                  
            <ram:Content>Übergabe am 29.09.2018/ 10:35
	  Ort: Frankfurt a. M.
	  km: 17791
      </ram:Content>
                
        </ram:IncludedNote>
        	    
        <ram:IncludedNote>
                  
            <ram:Content>Rückgabe am 01.10.2018/ 10:19
	  Ort: Frankfurt a. M.
	  km: 18664
      </ram:Content>
                
        </ram:IncludedNote>
        	
        <ram:IncludedNote>
                  
            <ram:Content>Übernahme: Frankfurt
	  Datum: 01.10.2018
	  Zeit: 10:19
	  km/out: 177791
	  km/in: 18664
	  km gefahren: 873
	  Kennzeichen: M-MM 0000
	  CO2: 150
	  Bruttolistenpreis: 68300
      </ram:Content>
                
        </ram:IncludedNote>
          
    </rsm:ExchangedDocument>
      
    <rsm:SupplyChainTradeTransaction>
            
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>1</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:Name>Miettage</ram:Name>
                		
                <ram:ApplicableProductCharacteristic>
                    		
                    <ram:Description>Fahrzeug-Kennzeichen</ram:Description>
                    		
                    <ram:Value>M-MM 0000</ram:Value>
                    		
                </ram:ApplicableProductCharacteristic>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>86.5500</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="DAY">2.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>173.10</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
            
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>2</ram:LineID>
                		
                <ram:IncludedNote>
                              
                    <ram:Content>Inklusiv-Kilometer waren: 873</ram:Content>
                            
                </ram:IncludedNote>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:Name>Navigationssystem - Garantie</ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>5.0400</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">2.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>10.08</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
        	    
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>3</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:Name>Vollkasko</ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>23.1000</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">2.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>46.20</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
        	
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>4</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:Name>minimale Selbstbeteiligung</ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>15.5500</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">2.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>31.10</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
        	
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>5</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:Name>Personen-Unfallversicherung</ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>7.9800</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">2.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>15.96</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
        	
        <ram:IncludedSupplyChainTradeLineItem>
                  
            <ram:AssociatedDocumentLineDocument>
                        
                <ram:LineID>6</ram:LineID>
                      
            </ram:AssociatedDocumentLineDocument>
                  
            <ram:SpecifiedTradeProduct>
                        
                <ram:Name>Choice Upgrade</ram:Name>
                      
            </ram:SpecifiedTradeProduct>
                  
            <ram:SpecifiedLineTradeAgreement>
                        
                <ram:NetPriceProductTradePrice>
                              
                    <ram:ChargeAmount>5.0400</ram:ChargeAmount>
                            
                </ram:NetPriceProductTradePrice>
                      
            </ram:SpecifiedLineTradeAgreement>
                  
            <ram:SpecifiedLineTradeDelivery>
                        
                <ram:BilledQuantity unitCode="C62">2.0000</ram:BilledQuantity>
                      
            </ram:SpecifiedLineTradeDelivery>
                  
            <ram:SpecifiedLineTradeSettlement>
                        
                <ram:ApplicableTradeTax>
                              
                    <ram:TypeCode>VAT</ram:TypeCode>
                              
                    <ram:CategoryCode>S</ram:CategoryCode>
                              
                    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                            
                </ram:ApplicableTradeTax>
                        
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                              
                    <ram:LineTotalAmount>10.08</ram:LineTotalAmount>
                            
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
                      
            </ram:SpecifiedLineTradeSettlement>
                
        </ram:IncludedSupplyChainTradeLineItem>
            
        <ram:ApplicableHeaderTradeAgreement>
                  
            <ram:SellerTradeParty>
                		
                <ram:ID>549910</ram:ID>
                        
                <ram:GlobalID schemeID="0088">4333741000005</ram:GlobalID>
                		
                <ram:Name>MUSTER-Autovermietung</ram:Name>
                        
                <ram:PostalTradeAddress>
                              
                    <ram:PostcodeCode>99199</ram:PostcodeCode>
                              
                    <ram:LineOne>Musterstr. 99</ram:LineOne>
                              
                    <ram:CityName>MUSTERHAUSEN</ram:CityName>
                              
                    <ram:CountryID>DE</ram:CountryID>
                            
                </ram:PostalTradeAddress>
                		
                <ram:URIUniversalCommunication>
                              
                    <ram:URIID schemeID="0088">1234567890128</ram:URIID>
                            
                </ram:URIUniversalCommunication>
                        
                <ram:SpecifiedTaxRegistration>
                              
                    <ram:ID schemeID="VA">DE136695976</ram:ID>
                            
                </ram:SpecifiedTaxRegistration>
                      
            </ram:SellerTradeParty>
                  
            <ram:BuyerTradeParty>
                        
                <ram:ID>9314110911</ram:ID>
                        
                <ram:Name>MUSTER-KUNDE GMBH</ram:Name>
                        
                <ram:PostalTradeAddress>
                              
                    <ram:PostcodeCode>40235</ram:PostcodeCode>
                              
                    <ram:LineOne>KUNDENWEG 88</ram:LineOne>
                              
                    <ram:CityName>DUESSELDORF</ram:CityName>
                              
                    <ram:CountryID>DE</ram:CountryID>
                            
                </ram:PostalTradeAddress>
                		
                <ram:URIUniversalCommunication>
                              
                    <ram:URIID schemeID="9958">04 0 11 000 - 12345 12345 - 35</ram:URIID>
                            
                </ram:URIUniversalCommunication>
                      
            </ram:BuyerTradeParty>
                  
            <ram:BuyerOrderReferencedDocument>
                        
                <ram:IssuerAssignedID>B123456789</ram:IssuerAssignedID>
                      
            </ram:BuyerOrderReferencedDocument>
                
        </ram:ApplicableHeaderTradeAgreement>
            
        <ram:ApplicableHeaderTradeDelivery>
                  
            <ram:ActualDeliverySupplyChainEvent>
                        
                <ram:OccurrenceDateTime>
                              
                    <udt:DateTimeString format="102">20180929</udt:DateTimeString>
                            
                </ram:OccurrenceDateTime>
                      
            </ram:ActualDeliverySupplyChainEvent>
            	  
            <ram:DespatchAdviceReferencedDocument>
                        
                <ram:IssuerAssignedID>L87654321012345</ram:IssuerAssignedID>
                      
            </ram:DespatchAdviceReferencedDocument>
                
        </ram:ApplicableHeaderTradeDelivery>
            
        <ram:ApplicableHeaderTradeSettlement>
                  
            <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
                  
            <ram:ApplicableTradeTax>
                        
                <ram:CalculatedAmount>54.44</ram:CalculatedAmount>
                        
                <ram:TypeCode>VAT</ram:TypeCode>
                        
                <ram:BasisAmount>286.52</ram:BasisAmount>
                        
                <ram:CategoryCode>S</ram:CategoryCode>
                        
                <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
                      
            </ram:ApplicableTradeTax>
            	  
            <ram:SpecifiedTradePaymentTerms>
                        
                <ram:Description>
          Die Leistung wurde erbracht im Zeitraum zwischen Übergabe und Rückgabe. Der Rechnungsbetrag wird über Ihre MasterCard-Kreditkarte abgebucht. Dies ist keine Aufforderung zur Zahlung. Rechnung für Ihre Unterlagen.
        </ram:Description>
                      
            </ram:SpecifiedTradePaymentTerms>
            	  
            <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
                        
                <ram:LineTotalAmount>286.52</ram:LineTotalAmount>
                        
                <ram:ChargeTotalAmount>0.00</ram:ChargeTotalAmount>
                        
                <ram:AllowanceTotalAmount>0.00</ram:AllowanceTotalAmount>
                        
                <ram:TaxBasisTotalAmount>286.52</ram:TaxBasisTotalAmount>
                		
                <ram:TaxTotalAmount currencyID="EUR">54.44</ram:TaxTotalAmount>
                        
                <ram:GrandTotalAmount>340.96</ram:GrandTotalAmount>
                        
                <ram:TotalPrepaidAmount>0.00</ram:TotalPrepaidAmount>
                        
                <ram:DuePayableAmount>340.96</ram:DuePayableAmount>
                      
            </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
                
        </ram:ApplicableHeaderTradeSettlement>
          
    </rsm:SupplyChainTradeTransaction>
    
</rsm:CrossIndustryInvoice>
Errors
Value of '@schemeID' is not allowed. [ID FX-SCH-A-000031] from /xslt/ZF_232/FACTUR-X_EN16931.xslt)

[BR-CL-25]-Endpoint identifier scheme identifier MUST belong to the CEF EAS code list [ID BR-CL-25] from /xslt/en16931schematron/EN16931-CII-validation.xslt)

These are just two failing files, in total there are more official examples that fail the validation.

Is it expected behaviour that older ZUGFeRDs fail, and mustang only focussed on the latest version? If that is the case, is there a way to also validate ZUGFeRD 2.0, 2.1 and 2.2 within the same codebase?

@SabineMa
Copy link

Examples.zip

This are the examples from 22. HTH

@jstaerk
Copy link
Collaborator

jstaerk commented Dec 3, 2024

Is anything actually not failing against the current standard but still raises a message? which ones?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants