From 80d586ab2a66fc232dba1c31b534cab13e3566b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Olivi=C3=A9=20Molina?= Date: Wed, 10 Jun 2026 08:11:35 +0000 Subject: [PATCH 1/2] docs(fr): explain opening and signing the PA agreement form The France PA registration guide described the register workflow steps but never told the operator what to do when it pauses at "Wait for French agreement upload". Flag that step as a manual gate and add a "Complete the agreement" section: open the party's Meta tab, click the agreement link, and sign the mandate. Until that is done the party stays in processing and is never accepted. Co-Authored-By: Claude Opus 4.8 (1M context) --- guides/fr-pa-registration.mdx | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/guides/fr-pa-registration.mdx b/guides/fr-pa-registration.mdx index b94d5959..1761936e 100644 --- a/guides/fr-pa-registration.mdx +++ b/guides/fr-pa-registration.mdx @@ -31,7 +31,7 @@ The Annuaire requires every entry to be receive-capable, so there is no send-onl Moves the silo entry into a visible "in progress" state so operator dashboards reflect that registration is underway. - Pauses until the signed agreement is uploaded and accepted (`gov-fr.agreement.wait.approval`). + Pauses until the signed agreement is uploaded and accepted (`gov-fr.agreement.wait.approval`). This is a **manual gate** — the party stays in processing and the workflow does not advance until someone opens the agreement form and signs it. See [Complete the agreement](#complete-the-agreement) below. Marks the agreement step as completed before the directory and Peppol registrations run. @@ -59,6 +59,30 @@ The Annuaire requires every entry to be receive-capable, so there is no send-onl +## Complete the agreement + +After the workflow reaches **Wait for French agreement upload**, the party sits in processing until the PA mandate is signed. **This step is manual and required** — the party cannot be accepted, registered in the Annuaire, or published on Peppol until it is done. + +The agreement form is surfaced as a link on the party itself: + + + + In Console, open the party (silo entry) that the register workflow is running on. + + + Open the **Meta** tab. The **Sign agreement for France** step publishes an agreement link there (meta key `approval-link`). + + + Click the link to open the French PA agreement form. Review the mandate that authorises Invopop to act as the party's Plateforme Agréée, sign it, and submit. + + + +Once the signed agreement is submitted and accepted, **Wait for French agreement upload** resolves and the workflow continues to the directory and Peppol registration steps, ending in registered. + + + If you don't open the Meta tab and sign the agreement, the party stays in processing indefinitely — it is never automatically accepted. + + ## Unregistration Run the unregister workflow to revoke a party's registrations when it should no longer issue or receive invoices through Invopop. From d69d3075e153d28cfbee0b0e5385caef4cc3eef2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Olivi=C3=A9?= Date: Wed, 10 Jun 2026 15:54:37 +0000 Subject: [PATCH 2/2] docs(fr): document signing the PA agreement through the API The agreement endpoints (fetch, upload, identity, confirm) already have API reference pages but the registration guide only described the Console flow. Split the section into 'Sign in Console' and 'Sign through the API', listing the four-call sequence in the same style as the SII supplier guide. Co-Authored-By: Claude Fable 5 --- guides/fr-pa-registration.mdx | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/guides/fr-pa-registration.mdx b/guides/fr-pa-registration.mdx index 1761936e..c36fab0d 100644 --- a/guides/fr-pa-registration.mdx +++ b/guides/fr-pa-registration.mdx @@ -63,6 +63,8 @@ The Annuaire requires every entry to be receive-capable, so there is no send-onl After the workflow reaches **Wait for French agreement upload**, the party sits in processing until the PA mandate is signed. **This step is manual and required** — the party cannot be accepted, registered in the Annuaire, or published on Peppol until it is done. +### Sign in Console + The agreement form is surfaced as a link on the party itself: @@ -77,7 +79,23 @@ The agreement form is surfaced as a link on the party itself: -Once the signed agreement is submitted and accepted, **Wait for French agreement upload** resolves and the workflow continues to the directory and Peppol registration steps, ending in registered. +### Sign through the API + +You can also complete the agreement programmatically — useful when you embed the onboarding in your own product instead of sending the signer to the Invopop form. Once the workflow has paused at **Wait for French agreement upload**: + + 1. [Download the unsigned agreement PDF](/api-ref/apps/gov-fr/agreement-fetch) `GET /apps/gov-fr/v1/entry/{silo_entry_id}/agreement`
+ The mandate PDF is generated from the party's data for the signer to review and sign. + + 2. [Upload the signed agreement](/api-ref/apps/gov-fr/agreement-upload) `POST /apps/gov-fr/v1/entry/{silo_entry_id}/agreement`
+ Send the signed PDF together with the signature method: `esignature` for an electronic (PAdES) signature, or `identity` for a handwritten one. + + 3. [Upload identity images](/api-ref/apps/gov-fr/identity-upload) `POST /apps/gov-fr/v1/entry/{silo_entry_id}/identity`
+ Only required when the signature method is `identity`. Upload one image per view: `front` and `back` for an ID card, or `page` for a passport. + + 4. [Confirm the submission](/api-ref/apps/gov-fr/confirm) `POST /apps/gov-fr/v1/entry/{silo_entry_id}/confirm`
+ Marks the submission as complete and wakes the waiting workflow task. + +Whichever way the agreement is signed, once it is submitted and accepted, **Wait for French agreement upload** resolves and the workflow continues to the directory and Peppol registration steps, ending in registered. If you don't open the Meta tab and sign the agreement, the party stays in processing indefinitely — it is never automatically accepted.