Skip to content

phax/phoss-ap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

146 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

phoss-ap

Sonatype Central javadoc

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:

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

  1. Set up a PostgreSQL database (see docker-compose.yml for an example)
  2. Copy phoss-ap-webapp/src/main/resources/application.properties and adjust for your environment
  3. 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 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.

About

phoss Peppol Access Point

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages