Current development
4.4.1-SNAPSHOT
In development- Ongoing bug fixes and dependency updates
4.x releases
4.4.0
Released March 2026- Added eDelivery2 profile support (#366)
- Removed OSGi bundle support — phase4 no longer ships OSGi manifests
- Updated GitHub Actions CI configuration
- Internal version bumps and dependency upgrades
4.3.2
- Added more fields to the sending report (outbound)
- Added new fields for SMP lookup results in the sending report
- Added example code showing how to capture sent and received messages
- Improved error messages for failed incoming message processing
- Unified method naming conventions across sender builders
- Using the central
IdentifierFactoryfor reception processing - Updated
peppol-commonsto 12.3.12
4.3.1
- Added default proxy settings support to HTTP client configuration
- Improved customizability of incoming message processing
- Updated to ph-web 11.2.2
- Improved logging to include certificate issuer information
- Replaced specific ESML usage with generic SML resolver
- Various version bump dependencies
4.3.0
Minor version bump — contains breaking API changes- Extended
IAS4ProfileValidator.validatePModewith an additionalEAS4ProfileValidationModeparameter - Extended the SPI method to contain the error list
- Added check on C2/C3 layout for Peppol
- Removed several deprecated/old methods
- Updated regex handling using
peppol-commonsutilities
4.3.0 contains breaking API changes in
IAS4ProfileValidator. If you have custom profile validators, you must update the validatePMode method signature to include the EAS4ProfileValidationMode parameter.4.2.7 – 4.2.1
- Various patch releases with dependency updates and minor fixes
- Improved resilience when receiving crappy/malformed signal messages
- Added support for technical contact consumer in DBNAlliance profile
- Added
addEbmsPropertiesconvenience method to message builders - Improved raw response data access in sender builders
4.2.0
- Added getter methods on all
SendingReportfields - Improved resilience for malformed incoming signal messages
- Added checks for unexpected response structures
- Various test improvements
4.1.1
- Patch release with minor fixes
4.1.0
- Migrated to JSpecify nullable annotations (
@NonNull,@Nullable) for improved static analysis (#345) - Increased customizability of AgreementRef handling
- Improved Peppol CA checker integration
- Fixed AgreementRef type checking
- Updated default field values in several builders
4.0.2 – 4.0.1
- Patch releases with bug fixes
4.0.0
Major version — requires Java 11+, ph-commons v12- Updated to ph-commons v12 (major dependency upgrade)
- Removed the legacy EESPA profile
- Cleaned up module structure and removed unused dependencies
- Internal package and class reorganisation
Migrating from 3.x to 4.0.0 requires updating ph-commons to v12. Check the ph-commons migration guide for details.
3.x releases
3.2.2 – 3.0.0
The 3.x series introduced the current architecture with SPI-based profile registration, theIAS4DuplicateManager interface, and the AS4DumpManager infrastructure.
Key highlights from the 3.x series
Key highlights from the 3.x series
IAS4ProfileRegistrarSPIintroduced for auto-discovery of profilesAS4DuplicateManagerInMemoryandAS4DuplicateManagerXMLimplementationsAS4DumpManagerwithIAS4IncomingDumperandIAS4OutgoingDumperHttpRetrySettingsfor configurable transport-level retriesPhase4PeppolHttpClientSettingsextracted tophase4-profile-peppolPModeReceptionAwarenesswith configurable retry and duplicate detection- DBNAlliance profile added
- BDEW profile added
- ENTSOG profile added
Configuration property changes
The following configuration key was renamed in 3.0.0:| Old key (before 3.0.0) | New key |
|---|---|
phase4.profile | phase4.default.profile |
getAsStringOrFallback.
Maven coordinates
All phase4 modules share the samegroupId and version:
Core library
phase4-libPeppol profile
phase4-profile-peppolCEF profile
phase4-profile-cefBDEW profile
phase4-profile-bdewENTSOG profile
phase4-profile-entsogDBNAlliance profile
phase4-profile-dbnallianceEUDAMED client
phase4-eudamed-client