Skip to content

Getting Started

NomaUBL

NomaUBL is a Java 17 integration layer between Oracle JD Edwards and the French e-invoicing ecosystem. It automates the full invoice lifecycle: from JDE XML output to validated UBL 2.1 e-invoices, submission to a Platform Agréée (PA), and lifecycle tracking in Oracle tables.

What it does

  • Transforms JDE XML output into UBL 2.1 e-invoices via XSLT stylesheets
  • Validates invoices against XSD schemas and Schematron rules (EN16931 + CIUS-FR)
  • Submits invoices to a certified French e-invoicing platform (Platform Agréée)
  • Tracks the full invoice lifecycle in Oracle tables (F564230–F564236)
  • Polls the PA for status updates and reconciles them back to JDE
  • Provides a React web interface served by an embedded HTTP server
  • Provides a CLI for batch processing and automation

Architecture overview

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
JDE (XML spool output)
        │
        ▼
  ScheduleUBL (CLI entry point)
        │
        ├─ XSLT Transform ──► UBL 2.1 XML
        │
        ├─ UBL Validation ──► XSD + EN16931 + CIUS-FR Schematron
        │
        ├─ PPF Directory Check ──► DirectoryApiClient (non-blocking)
        │
        ├─ PA Submission ──► PlatformApiClient (REST, Java 11 HttpClient)
        │
        └─ Oracle DB Update ──► F564230, F564231, F564235, F564236

Key components

Component Description
ScheduleUBL CLI entry point — orchestrates all processing modes
CustomUBL Core per-invoice processor (Callable<Integer>)
UBLValidator XSD + Schematron validation (EN16931, CIUS-FR)
PlatformApiClient REST client for the Platform Agréée
DirectoryApiClient PPF directory lookup (non-blocking)
TokenManager JWT bearer token with 55-min cache + auto-refresh
ImportStatusHandler Polls PA for pending invoice status updates
UBLDatabaseHandler All Oracle DB writes (F564230–F564236)
Web interface React + TypeScript, served by embedded WebServer

Quick start

1. Build the application

1
bash build.sh

2. Verify the build

1
java -jar nomaubl.jar -help

3. Open the web interface

1
java -jar nomaubl.jar -config config.properties

Then open your browser at http://localhost:8080.

4. Process invoices from CLI

1
java -jar nomaubl.jar -run config.properties my_template output.xml UBL 1001

Configuration required

Before running, you must configure the config.properties file with your Oracle database connection and Platform Agréée credentials. See the Configuration section.