ebinterface-ubl-mapping

Mapping ebInterface 4.x/5.x/6.x from and to UBL 2.1.

Author: Philip Helger

The reason why this project is not in the ebinterface-mappings project is the totally different software stack used and the requirement of this project to be published on Maven central. Since v4.5.0 the Maven group ID changed to at.austriapro - before that, the group ID was "com.helger".

Building

To build the project you need at least Java 11 (or newer) and Apache Maven 3.x. Build is quite easy: call mvn clean install in this directory and the final result will be in the target directory. Additionally Eclipse project files for the latest Eclipse version are contained.

Versions prior to v5 use Java 1.8 as the baseline.

Maven usage

Add the following to your pom.xml to use this artifact, replacing x.y.z with the real version:

<dependency>
  <groupId>at.austriapro</groupId>
  <artifactId>ebinterface-ubl-mapping</artifactId>
  <version>x.y.z</version>
</dependency>

News and noteworthy

v5.1.4 - 2024-02-26
- Avoid empty RelatedDocument/Comment elements in ebInterface 4.1+
- Added support for invoice type code 218 as a FinalSettlement
v5.1.3 - 2023-11-14
- ebInterface 5.0+ Discount/Comment is converted to a UBL PaymentTerms/Note element
v5.1.2 - 2023-11-09
- Fixed the mapping of ebInterface DocumentType CreditNote to UBL Invoice Type Code 381
v5.1.1 - 2023-09-26
- Fixed the DocumentCurrencyCode/@listID attribute for all ebInterface versions != 4.2
- Avoid creating empty UBL elements
v5.1.0 - 2023-04-30
- Updated to ph-ubl 8.x
v5.0.0 - 2023-03-02
- Using Java 11 as the baseline
- Updated to ph-commons 11
- Using JAXB 4.0 as the baseline
v4.8.3 - 2022-10-12
- Added mapping of BelowTheLineItem in ebInterface 6.1 as done in 4.3 and previously
- Extracted shared customization base interfaces
v4.8.2 - 2022-08-11
- Updated to peppol-commons 8.7.6
- Added support for ebInterface 6.1 from and to UBL
v4.8.1 - 2022-04-12
- Added specific support for InvoiceTypeCode mapping of 326, 386 and 389 from UBL to ebInterface
v4.8.0 - 2021-05-03
- Updated to ph-commons 10.1
v4.7.0 - 2021-03-22
- Updated to ph-commons 10
v4.6.3 - 2020-10-28
- Fixed the application of the "EnforcedSupplierEmailAddress" when converting to ebInterface 5.0 and 6.0
v4.6.2 - 2020-10-13
- Heavily extended the allowed UBL Invoice type codes. Allowed values are now: 80, 82, 84, 130, 202, 203, 204, 211, 295, 325, 326, 380, 383, 384, 385, 386, 387, 388, 389, 390, 393, 394, 395, 456, 457, 527, 575, 623, 633, 751, 780, 935
- Added support for UBLVersionID 2.3
v4.6.1 - 2020-09-17
- Updated to Jakarta JAXB 2.3.3
v4.6.0 - 2020-08-30
- Updated to ph-ubl 6.4.0
- Updated to ph-ebinterface 6.2.0
v4.5.8 - 2020-08-13
- Mapping UBL AdditionalItemProperty to ebInterface AdditionalInformation (ebInterface 5.0 or higher) on line level
v4.5.7 - 2020-07-08
- Using Invoice/DueDate as an alternative to Invoice/PaymentMeans/PaymentDueDate
v4.5.6 - 2020-05-26
- Updated to ph-ebinterface 6.1.5 with ph-xsds 2.3.0 (new Maven groupId)
v4.5.5 - 2020-05-14
- Updated to support ebInterface 6.0 from and to UBL
- Fixed a divide by zero error if payableAmount is 0
v4.5.4 - 2020-04-01
- Now ebInterface 5.0 Contact email addresses and telephone numbers are also mapped to UBL (see issue #2)
v4.5.3 - 2020-02-07
- Preferring PaymentMeans/InstructionID over PaymentMeans/PaymentID
- Changed the mapping of ebInterface from PaymentReference to PaymentMeans/InstructionID
- Updated to peppol-commons 8.x
v4.5.2 - 2019-12-17
- Made the "profile ID to process Identifier" mapping customizable
- Unified error levels between Invoice and CreditNote on the ProfileID
v4.5.1 - 2019-10-14
- Fixed a regression that payment type "41" was checked instead of "42"
v4.5.0 - 2019-10-01
- Changed all package names to at.austriapro
- Changed the Maven group at.austriapro
v4.0.1 - 2019-09-18
- Fixed potential NPE in county code mapping from ebInterface to UBL
v4.0.0 - 2019-09-13
- Added code to convert UBL Invoice/CreditNote to ebInterface 4.0, 4.1 and 5.0
- Added code to convert ebInterface 4.0, 4.1 and 5.0 to UBL Invoice
- Added check that order reference is mandatory if an order position number is used
- Improved customizability of conversion
- Improved consistency of existing conversions
v3.0.8 - 2019-03-28
- Fixed parsing of process identifiers in "Profile" element for CreditNotes to match the Invoice rules
- Added support for the UBL version "2.2"
- CreditNotes now also transform the PaymentMethod if present but fallback to NoPayment if none is provided
v3.0.7 - 2019-02-27
- Avoid creating negative Percent element values
v3.0.6 - 2019-02-25
- Improved handling of empty TaxCategory/ID and TaxScheme/ID
v3.0.5 - 2019-02-22
- Handling empty PaymentChannelCode like if it was null.
v3.0.4 - 2018-11-22
- Updated to ph-commons 9.2.0
v3.0.3 - 2018-06-21
- Fixed division by zero if BaseQuantity is 0
v3.0.2 - 2018-04-13
- Updated to peppol-commons 6.0.3
v3.0.1 - 2018-04-06
- Ignoring empty Description/Name/Note elements on line level
v3.0.0 - 2018-02-23
- Fixed potential NPE if UBL invoice has no FinancialAccount
- Updated to ph-commons 9.0.0
- Conversion of TaxExemption was added
- Some error handling details were improved
v2.2.0 - 2017-08-04
- Allow to create ebInterface 4.3 as well
- Added conversion from ebInterface 4.1/4.2/4.3 to UBL
v2.1.1 - 2016-09-27
- Requires at least ph-common 8.5.2
v2.1.0 - 2016-09-12
- Bind to ph-commons 8.5.x
v2.0.1 - 2016-08-01
v2.0.0 - 2016-07-12
- Bind to ph-commons 8.x
- Requires JDK 1.8
v1.1.0 - 2016-01-26
- Last version for JDK 6

My personal Coding Styleguide | On Twitter: @philiphelger

austriapro / ebinterface-ubl-mapping

ebinterface-ubl-mapping

Building

Maven usage

News and noteworthy

About

Languages