Skip to content

Status Codes

Invoice Status Codes

NomaUBL uses two sets of status codes stored in F564231.K74RSCD and F564235.K74RSCD:

  • PA platform codes (200-series) — assigned by the Platform Agréée during the invoice lifecycle
  • Internal 99xx codes — assigned by NomaUBL to represent the local processing workflow

The full catalog is defined in config-lists.json under the statuses template. The property value format is:

1
"<code>": "<CONSTANT>|<label_FR>|<label_EN>||<paStatus>"

Where paStatus=1 means the code comes from the PA, and paStatus=0 means it is an internal NomaUBL code.

PA platform status codes (200-series)

These codes are received from the Platform Agréée via lifecycle updates.

Code Constant Label (FR) Label (EN)
200 STATUS_DEPOSITED Déposée Deposited
201 STATUS_ISSUED Emise par la plateforme Issued by platform
202 STATUS_RECEIVED Reçue de la plateforme Received by platform
203 STATUS_MADE_AVAILABLE Mise à Disposition Made available
204 STATUS_UNDER_PROCESSING Prise en charge Under processing
205 STATUS_APPROVED Approuvée Approved
206 STATUS_PARTIALLY_APPROVED Approuvée Partiellement Partially approved
207 STATUS_DISPUTED En litige Disputed
208 STATUS_SUSPENDED Suspendue Suspended
209 STATUS_COMPLETED Complétée Completed
210 STATUS_REFUSED Refusée Refused
211 STATUS_PAYMENT_PROCESSED Paiement Transmis Payment transmitted
212 STATUS_PAYMENT_RECEIPT Encaissée Payment received
213 STATUS_REJECTED Rejetée Rejected
214 STATUS_TARGETED Visée Targeted
220 STATUS_CANCELLED Annulée Cancelled
221 STATUS_ROUTING_ERROR Erreur de routage Routing error
224 STATUS_DIRECT_PAYMENT_REQUEST Demande de Paiement Direct Direct payment request
225 STATUS_FACTORED Affacturée Factored
226 STATUS_FACTORED_CONFIDENTIAL Affacturée Confidentiel Factored confidential
227 STATUS_ACCOUNT_CHANGE Changement de Compte à Payer Payment account change
228 STATUS_NOT_FACTORED Non Affacturée Not factored
501 STATUS_IRRECOVERABLE Irrecevable Irrecoverable
600 STATUS_EMAIL Erreur Email Email error

Internal workflow codes (99xx)

These codes are set by NomaUBL to represent the processing state within the JDE/NomaUBL system, before and during PA interaction.

Code Constant Label (FR) Label (EN) Set when
9900 STATUS_CREATED Facture créée Invoice created Invoice record created in F564231
9901 STATUS_VALIDATED Validation réussie Validation successful All validation layers pass with no errors
9902 STATUS_VALIDATED_WARN Validation avec avertissements Validation with warnings Validation passes but warnings exist
9903 STATUS_SENT_TO_PA Envoi à la PA Sent to PA POST to PA succeeds, UUID received
9904 STATUS_ERROR_SENT Echec d'envoi à la PA Send failed POST to PA returns HTTP error
9905 STATUS_ERROR_VALIDATION Echec de validation Validation failed XSD or Schematron errors found
9906 STATUS_PENDING En attente de traitement par la PA Pending PA processing Awaiting PA import result
9907 STATUS_FAILED_IMPORT Echec d'import par la PA PA import failed PA returns status: failed

Normal invoice lifecycle

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
9900 (Created)
    │
    ├─ Validation errors ──► 9905 (Validation failed) [stop]
    │
9901 or 9902 (Validated)
    │
    ├─ sendToPA=N ──► [stop here, no PA interaction]
    │
9903 (Sent to PA)
    │
    ├─ HTTP error ──► 9904 (Send failed) [stop]
    │
9906 (Pending — awaiting -import poll)
    │
    ├─ PA still processing ──► [unchanged, re-poll later]
    ├─ PA import failed    ──► 9907 (PA import failed) [stop]
    │
200  (Deposited)
    │
    ├─ 201 (Issued by platform)
    ├─ 202 (Received by platform)
    ├─ 204 (Under processing)
    ├─ 205 (Approved) / 210 (Refused) / 213 (Rejected)
    ├─ 207 (Disputed)
    ├─ 211 (Payment transmitted)
    └─ 212 (Payment received) → 209 (Completed)

Status transitions in Oracle tables

At each step, the following tables are updated by InvoiceStatusCatalog.StatusTransition.apply():

Step F564231.K74RSCD F564235 row inserted
Invoice created 9900 Yes
Validation OK 9901 or 9902 Yes
Validation failed 9905 Yes + errors in F564236
Sent to PA 9903 Yes
Send error 9904 Yes
Pending 9906 —
PA deposited 200 Yes
PA subsequent update new PA code Yes
PA import failed 9907 Yes with error messages

Using InvoiceStatusCatalog

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
// Simple transitions
InvoiceStatusCatalog.created().apply(dbHandler);
InvoiceStatusCatalog.validated().apply(dbHandler);
InvoiceStatusCatalog.validatedWithWarnings().apply(dbHandler);
InvoiceStatusCatalog.sentToPA().apply(dbHandler);
InvoiceStatusCatalog.pending().apply(dbHandler);
InvoiceStatusCatalog.deposited().apply(dbHandler);  // → code 200

// Error transitions with messages
InvoiceStatusCatalog.errorValidation(errorList).apply(dbHandler);
InvoiceStatusCatalog.errorSent(httpError).apply(dbHandler);
InvoiceStatusCatalog.failedImport(errorsString).apply(dbHandler);

// Custom status (e.g. from PA response mapping)
InvoiceStatusCatalog.custom("205", "Approuvée").apply(dbHandler);