Comments on UBL v2.5 CSD02 from Coordination Office for IT-Standards (Germany)

0 views
Skip to first unread message

Kottmann, Renzo (Finanzen) 443-1

unread,
Jan 8, 2026, 6:28:09 PM (10 days ago) Jan 8
to technical-comm...@oasis-open.org, Rölker-Denker, Lars (Finanzen) 443, Dewein, Barbara (Finanzen) 443-4, Svante Schubert

Dear TC Members,

 

first of all thanks so much for your incredible and valuable work on making this new release happen.

 

Please find some comments on https://docs.oasis-open.org/ubl/csd02-UBL-2.5 below focusing on Billing :

 

  1. XSD Schema:
    1. in https://docs.oasis-open.org/ubl/csd02-UBL-2.5/xsdrt/common/UBL-CommonAggregateComponents-2.5.xsd

                                               i.     Issue: A confusing aspect and IMHO an inconsistent naming pattern is cac:BuyerReference/cbc:BuyerReference

                                              ii.     Suggestion: In order to better differentiate the intents of the two different elements (in XSD speak) I suggest to use the same naming pattern as for cac:Annotation/cbc:AnnotationContent i.e. cac:BuyerReference/cbc:BuyerReferenceContent

  1. Specification:
    1. https://docs.oasis-open.org/ubl/csd02-UBL-2.5/UBL-2.5.xml#S-MINOR-REVISION-UBL-2.4

                                               i.     Issue: “Because it preserves backward compatibility with UBL 2.3, UBL 2.2, UBL 2.1, and UBL 2.0, UBL 2.5 is technically a minor release,”

                                              ii.     I think it might read “Because it preserves backward compatibility with UBL 2.3, UBL 2.2, UBL 2.1, and UBL 2.0, UBL 2.4 is technically a minor release,”

    1. https://docs.oasis-open.org/ubl/csd02-UBL-2.5/UBL-2.5.xml#A-UBL-2.5-EXAMPLE-DOCUMENT-INSTANCES

                                               i.     Issue: Missing example for Invoice and CreditNote document types

                                              ii.     IMHO now that this release contains (for the first time in 2.x?) some new BIEs it would be very helpful to provide some new examples for 2.5 showcasing the added (and maybe also the changed) library elements.

                                             iii.     Although it was created for testing syntax binding for the upcoming EN1931 release, please find attached a 2.5 example. Each element with a correct binding has two preceding comments. One is handcrafted and the other auto-generated.

 

 

Ciao,

 

renzo

 

Mit freundlichen Grüßen
Im Auftrag
Renzo Kottmann


Freie Hansestadt Bremen
Der Senator für Finanzen
Referat 44 – Koordinierungsstelle für IT-Standards (KoSIT)
Am Tabakquartier 56
28197 Bremen
Tel.: +49 421 361 – 96420
E-Mail:
renzo.k...@finanzen.bremen.de  
Internet: www.finanzen.bremen.de / www.xeinkauf.de

Dienstleistungen und Informationen der Verwaltung unter

www.transparenz.bremen.de, www.service.bremen.de

Denken Sie an die Umwelt - bevor Sie ausdrucken!

 

01.01_comprehensive_test_ubl_invoice-with-synatx-binding-annotation.xml
Reply all
Reply to author
Forward
0 new messages