Skip to main content

SuperPDP Setup Guide

SuperPDP is a French Plateforme de Dématérialisation Partenaire (PDP) certified by the French tax authorities. It enables your company to send and receive electronic invoices (e-invoices) in compliance with French e-invoicing regulations (Facture électronique).

Follow the steps below to create your SuperPDP account, verify your identity, register on the directory, and create an API application.


1. Create a SuperPDP account​

SuperPDP sign-up form
  1. Go to https://app.superpdp.com.
  2. Click Sign up.
  3. Enter your email address and choose a strong password.
  4. Fill in your company information:
    • Legal name
    • SIRET number
    • VAT number (TVA intracommunautaire)
    • Company address
  5. Accept the terms of service and click Create account.
  6. Check your email inbox and click the confirmation link to activate your account.

Once confirmed, you can log in to the SuperPDP dashboard.


2. KYB verification with ID​

SuperPDP requires a Know Your Business (KYB) verification before you can use the platform.

  1. Log in to your SuperPDP account.
  2. Go to Settings → KYB Verification.
  3. Upload the following documents:
    • Proof of identity of the legal representative (passport or national ID card)
    • K-bis extract (less than 3 months old)
    • Proof of address for the company
  4. Fill in the beneficial ownership declaration if required.
  5. Submit the documents for review.

Verification typically takes 24 to 72 hours. You will receive an email once your KYB is approved.


3. Register on the directory to receive invoices​

To receive e-invoices from other companies, your company must be registered in the Annuaire Général (central directory).

Definition

The Annuaire Général is the French central registry of companies authorised to send and receive electronic invoices. All PDPs are synchronised with it to enable invoice routing.

  1. From the SuperPDP dashboard, navigate to Directory → Register.
  2. Your SIRET and company details will be pre-filled.
  3. Select the electronic invoice address where invoices should be routed (this will be your SuperPDP inbox).
  4. Configure your invoice reception preferences:
    • Chorus Pro integration (for public sector B2G invoices)
    • Direct PDP-to-PDP reception
  5. Confirm and submit the registration.

SuperPDP will handle the synchronization with the French central directory. Once registered, other PDPs and platforms will be able to deliver invoices to your company through SuperPDP.


4. Create an Application to use the API​

To connect Invoicerr (or any other tool) to SuperPDP, you need to create an API application.

  1. In the SuperPDP dashboard, go to Developers → Applications.
  2. Click Create Application.
  3. Provide:
    • Application name (e.g., "Invoicerr")
    • Description (optional)
    • Redirect URIs (if using OAuth 2.0)
    • Scopes — select at minimum:
      • invoice:read — read incoming invoices
      • invoice:write — send invoices
      • company:read — read company info
  4. Click Create.

After creation, you will receive:

  • Client ID
  • Client Secret (save this securely — it will not be shown again)

You can now use these credentials to authenticate and call the SuperPDP API from Invoicerr or your own integrations.


5. Configure the PDP channel in Invoicerr​

Once your SuperPDP Application exists, open Settings → E-invoicing in Invoicerr. The screen has two levels: legal channels on the left, and the operators that implement the selected one on the right. France's own legal channel is Accredited platform (PDP); it opens pre-selected, since it is this company's own obligation.

Find SuperPDP in the operator list on the right (it is one of several operators implementing the same "Accredited platform (PDP)" legal channel: Billit, Iopole and Invopop are others) and click Connect. This opens a side sheet with the SuperPDP connection form:

Connect SuperPDP side sheet

Fill in the side sheet, four fields, that's the whole form:

  1. API base URL (required) — the API root of your PDP. Default: https://api.superpdp.tech.
  2. Client ID (required) — the Client ID from the SuperPDP Application you created in the Create an Application step above.
  3. Client secret (required) — the Client Secret from that same Application. It is stored encrypted at rest.
  4. Environment (required) — choose Test (sandbox) or Production. Defaults to Test.

There is no "API style" or "PDP routing ID" field on this screen. The channel always talks SuperPDP's own proprietary v1.beta API — an AFNOR-Flow-compatible PDP other than SuperPDP is not selectable from this form today. Your own routing address is not something you set either: the buyer's endpoint is resolved automatically per invoice from the client / directory.

note

Secrets are encrypted at rest. The server must have CREDENTIALS_ENCRYPTION_KEY configured, otherwise saving the channel fails with a 503 — Encryption key not configured — channel credentials cannot be saved error.

Click Connect at the bottom of the side sheet. Invoicerr will then use these credentials to send and track your e-invoices through the PDP.

6. Receiving invoices​

Once the channel is connected, Invoicerr checks your SuperPDP inbox every 5 minutes by default and imports each invoice you received as a received invoice, oldest first. Each check resumes after the last invoice already imported, so nothing is skipped, however many invoices arrived in between.

First connection

The first checks also import the invoices already waiting in your SuperPDP inbox, up to 1000 per check, until Invoicerr has caught up.

7. E-reporting declarations​

The same SuperPDP connection also carries France's e-reporting obligation (CGI art. 290 and 290 A): sales to private clients and payment data go to the tax administration through your accredited platform, not through Invoicerr directly.

Tell Invoicerr your VAT regime first. In Settings → Company, the French profile asks your company size category, your VAT regime (normal monthly, normal quarterly, simplified, or franchise en base) and, unless you are exempt, whether you opted for VAT on debits. These answers decide when your obligation starts and how often SuperPDP transmits; Invoicerr sends the regime and the debits option to SuperPDP when you save them, and again before every declaration. Without a size category, or for an SME that has not answered the VAT group question, nothing is sent: the Declarations screen shows the declaration as blocked, with the question to answer.

What is declared. Sending an invoice to a private client in France declares its data. Recording a payment on a service invoice whose VAT is due on collection declares the payment amount, split by VAT rate. An invoice to a French business client is not declared here: the PDP transmits it as part of e-invoicing. A goods-only invoice, a company that opted for VAT on debits, and a company under the franchise en base do not produce a payment declaration.

What the Declarations screen shows. Each attempt appears in Declarations, with the platform's record id and its status. SuperPDP stores the declaration immediately and aggregates it to the tax administration on your regime's schedule, so the id you see is the platform's own record, not a tax administration reference. A declaration that could not run appears as blocked with the reason (channel not connected, no adapter, missing company profile answer), never as silently missing.