phoss-ap

June 3, 2026 · View on GitHub

If this project saved you some time or made your day a little easier, a star would mean a lot — it helps others find it too.

phoss Peppol Access Point - when looking for the SMP, see phoss SMP

A complete open-source Peppol Access Point based on phase4.

It is a Spring Boot application that handles all the relevant Peppol specifications:

Peppol AS4 specification - using phase4
Peppol SMP specification - using peppol-smp-client
Peppol Network Reporting specification - using peppol-reporting
Peppol MLS specification - using peppol-mls

Features include:

Inbound document reception with configurable forwarding (HTTP, S3, SFTP)
Outbound document sending with automatic SMP lookup and SBDH creation
Retry with exponential backoff and circuit breaker for both sending and forwarding
Optional document validation via external verification service
Duplicate detection on AS4 Message ID and SBDH Instance Identifier
MLS (Message Level Status) support with SLA monitoring
Peppol Reporting with scheduled submission
Archival of completed transactions
Sentry integration for error tracking

phoss AP is part of my Peppol solution stack. See https://github.com/phax/peppol for other components and libraries in that area.

Build

Prerequisites:

Java 21 or later
Maven 3.x

mvn clean verify

Quick Start

Set up a PostgreSQL or MySQL database (see docker-compose.yml for an example)
Copy phoss-ap-webapp/src/main/resources/application.properties and adjust for your environment
Run the application:

java -jar phoss-ap-webapp/target/phoss-ap-webapp-*.jar

Or use Docker:

docker compose up -d

See the Running phoss AP wiki page for detailed setup instructions.

Infrastructure

As the backend system a PostgreSQL or MySQL DB is required. The system can be deployed both locally as well as in a Cloud environment. Docker images are available publicly.

Documentation

Provided in the Wiki: https://github.com/phax/phoss-ap/wiki

Misc

If you like the project, a star on GitHub is always appreciated.

If you need commercial support or if you'd like to sponsor this project, please reach out to me by email (philip@helger.com).

My personal Coding Styleguide | It is appreciated if you star the GitHub project if you like it.