Skip to main content
Download OpenAPI

Central Directory (Annuaire)

The Annuaire is the centralized public registry managed by the French government (Portail Public de Facturation - PPF) that acts as the single source of truth for routing electronic invoices. Its primary goal is to map every company operating in France to its chosen receiving platform (Plateforme Agréée), allowing sending platforms to correctly identify where an invoice must be transmitted.

In the French ecosystem, specifying the receiver’s electronic address is a mandatory field within the invoice. Since private businesses are not allowed to query the PPF Annuaire directly via API (the government only provides a public manual web browser interface), A-Cube bridges this gap by offering dedicated endpoints to programmatically query and check the directory.

To guarantee maximum performance and avoid latency issues during invoice transmission, A-Cube maintains a synchronized local copy of the entire PPF Annuaire (which is updated by the central system every 24 hours). Every query performed through our API will securely scan this updated local database.

Querying the Annuaire via API​

You can check a French customer's registration status, their active receiving platform, and their supported document formats by performing a GET request and filtering by the company's SIREN (9-digit national identifier) or SIRET (14-digit establishment identifier) number.

GET /directory/french

  • Query Parameters:

  • siren (string, optional) - The 9-digit company identifier.

  • siret (string, optional) - The 14-digit specific branch identifier.

Sample Request (Search by SIREN)​

GET /directory/french?siren=123456789

Sample Response​

{
  "found": true,
  "company_name": "Client France Target SAS",
  "siren": "123456789",
  "siret_records": [
    {
      "siret": "12345678900012",
      "interoperability_platform": "PDP_A_CUBE",
      "supported_formats": [
        "UBL",
        "FACTURE_X"
      ],
      "status": "ACTIVE"
    }
  ]
}

Key Information for Invoice Issuance: Before sending an outbound invoice, your system should use this endpoint to verify that the recipient has a valid and active electronic address setup on the Annuaire, ensuring the invoice format you are sending matches one of their supported_formats.

Last updated on