DematReceptionFacturesAchat batch

Important

This feature requires enabling the following feature flag Portail achats domain > Statut Fac Achat Label.

The DematReceptionFacturesAchat batch is used to import into Akuiteo the dematerialized invoices sent by suppliers through the Approved Platform. A temporary invoice is created for each Factur-X processed successfully.

Prerequisite: The communication mode must be set up beforehand from the Settings Portal (see Managing communication toward the Aggregated Platform for purchase invoices).

When creating the batch, select DematReceptionFacturesAchat in the Batch template drop-down list.

When it is run, the batch retrieves the Factur-X according to the communication method configured in the Settings Portal in order to create the corresponding dematerialized invoices in the Purchase Portal > Temporary invoices.

For the FTP/SFTP communication method, the directories entered in the Directories - Invoices section of the setup menu are used in the following order when the batch is run:

  1. The Factur-X files are first retrieved from the Directory for invoice reception.

  2. The Factur-X files being processed are then moved to the Directory for invoice processing.

  3. The processed Factur-X files are then moved to:

    • the Directory for processed invoices for Factur-X files whose temporary invoices have been created successfully.
    • the Directory for invoice errors for Factur-X files that could not be processed and for which temporary invoices were not created.

Note

The Basic data profile corresponds to Factur-X that contain essential data about the header, the footer, and lines of invoices. The Basic WL profile corresponds to the Basic profile without invoice lines.

External reference

JSON files can be placed in the FTP/SFTP directory to specify the external references of the dematerialized invoices on the approved platform.

Each JSON file must:

  • have the same name as the associated Factur-X file;
  • contain the external reference in UUID format in the externalReference key.

Example

The directory contains the Factur-X file named invoice0123.pdf.

The associated JSON file must therefore be named invoice0123.json and contain the reference in the following format:

Copier 
{
    "externalReference": "06c6e568-d143-4cd4-853d-e21a693cf98e"
}

When importing a Factur-X file:

  • if a JSON file corresponding to the Factur-X file is present, the external reference will be copied into the External reference (AP) field of the corresponding temporary invoice;
  • if no JSON file matches the Factur-X in the directory, the external reference will be randomly generated in the UUID format and specified in the External reference (AP) field of the corresponding temporary invoice.

The parameters in the following table correspond only to the parameters specific to the DematReceptionFacturesAchat batch.

Reference

To view the parameters common among batches, refer to Setting up the common parameters.

Code Description Type Required
DATE_EXECUTION

Creation date from which invoices will be processed by the batch. Any invoice dated earlier than the date specified in this parameter will be ignored by the batch.

When this parameter is left blank, all CDAR files made available through the communication method will be processed by the batch.

The current date is automatically specified in this parameter after each complete execution of the batch.

Date

Example: 07/01/2026

 No