E-Invoicing Template

The e-invoicing template is a reserved system template that configures the connection to the Platform Agréée (PA), UBL validation asset paths, and the optional mock mode for testing.

Platform Agréée API

Property	Description	Example
`paApiBaseUrl`	Base URL of the PA REST API	`https://api.myplatform.fr`
`paApiLoginEndpoint`	Login endpoint path (relative to base URL)	`/api/v1/auth/login`
`paApiUsername`	Username for PA authentication	`my_user`
`paApiPassword`	Password for PA authentication	`mypassword`
`paApiImportEndpoint`	Endpoint for submitting invoices	`/api/v1/sale/invoices/import`
`paMode`	Set to `API` to enable PA submission; leave empty to skip	`API`
`sendToPA`	`Y` to send invoices, `N` to generate UBL only without sending	`Y`

UBL validation paths

Property	Description	Example
`ublXsdPath`	Path to the UBL 2.1 XSD schema	`%APP_HOME%/validation/xsd/main/UBL-Invoice-2.1.xsd`
`ublSchematronPath`	Path to the EN16931 Schematron rules	`%APP_HOME%/validation/schematron/EN16931-UBL-validation-preprocessed.sch`
`ciusFrSchematronPath`	Path to the CIUS-FR Schematron rules	`%APP_HOME%/validation/schematron/BR-FR-Flux2-Schematron-UBL.sch`

Bundled validation assets

If the paths are not set or not found on disk, NomaUBL falls back to bundled versions inside the JAR at validation/xsd/ and validation/schematron/.

Mock mode

Mock mode lets you test the full processing pipeline without connecting to a real Platform Agréée.

Property	Description	Values
`paUseMock`	Enable mock mode	`true` / `false`
`paMockBehavior`	Controls what the mock returns	`SUCCESS`, `PENDING`, `FAILED`, `ERROR`

`paMockBehavior` value	Simulated PA response
`SUCCESS`	Returns `{"uuid": "mock-uuid", "status": "pending"}` then transitions to `success`
`PENDING`	Always returns `status: pending`
`FAILED`	Returns `status: failed` with sample errors
`ERROR`	Simulates a network/HTTP error

"paUseMock": "true",
"paMockBehavior": "SUCCESS"

Authentication flow

NomaUBL uses TokenManager to manage JWT bearer tokens:

On first API call, TokenManager calls paApiLoginEndpoint with paApiUsername / paApiPassword
The token is cached for 55 minutes
On HTTP 401, the token is refreshed once automatically before giving up
On subsequent calls within the 55-minute window, the cached token is reused

FTP settings (optional)

If invoices need to be delivered via SFTP in addition to (or instead of) the REST API:

Property	Description	Example
`paFtpHost`	SFTP hostname for PA delivery	`ftp.myplatform.fr`
`paFtpUser`	SFTP username	`pa_user`
`paFtpPassword`	SFTP password	—
`paFtpPort`	SFTP port	`22`
`paFtpRemotePath`	Remote path where UBL files are deposited	`/inbox`