{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Seqino PA API - Introduction"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"seqino-pa-api---introduction","__idx":0},"children":["Seqino PA API - Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://seqino.com/wp-content/uploads/2022/08/SEQINO-bleu-small.png","alt":"image"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Welcome to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Seqino PA API"]}," documentation. This API provides a modern and simplified interface to France's e-Invoicing services, giving you the power of a Platform de Dรฉmatรฉrialisation Partenaire (PDP) without the burden of managing one."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For any question, ask on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.api-pdp.seqino.com/en"},"children":["Support page"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-concepts","__idx":1},"children":["Core Concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understanding the relationship between ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsors"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clients"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandates"]}," is essential to working with the Seqino PDP API."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"graph TB\n seqino[Seqino]\n seqino --> |offers grey-label API to| sponsor_gl[PDP Sponsor]\n seqino --> |offers white-label API to| sponsor_wl[PDP Sponsor]\n\n subgraph sponsors[\"๐—ฆ๐—ฝ๐—ผ๐—ป๐˜€๐—ผ๐—ฟ๐˜€\"]\n sponsor_gl[\"PDP Sponsor (ERP, OD)\"]\n sponsor_wl[\"PDP Sponsor (Bank, ...)\"]\n end\n class sponsors grouping\n class sponsor_gl sponsor\n class sponsor_wl sponsor\n\n subgraph clients[\"๐—–๐—น๐—ถ๐—ฒ๐—ป๐˜๐˜€\"]\n C1[Client A
Company 1]\n C2[Client B
Company 2 - Service X]\n C3[Client C
Company 2 - Service Y]\n end\n class clients grouping\n class C1 client\n class C2 client\n class C3 client\n\n subgraph mandates[\"๐— ๐—ฎ๐—ป๐—ฑ๐—ฎ๐˜๐—ฒ๐˜€\"]\n M1[Mandate A]\n M2[Mandate B]\n M3[Mandate C]\n M4[Mandate D]\n end\n class mandates grouping\n class M1 mandate\n class M2 mandate\n class M3 mandate\n class M4 mandate\n\n subgraph ppf[PPF]\n directory[Directory]\n einvoicing[eInvoicing]\n ereporting[eReporting]\n end\n\n class directory service\n class einvoincing service\n class ereporting service\n class ppf grouping\n\n sponsor_gl --> |manages customers| C1\n sponsor_gl --> C2\n\n C1 --> |grants permission via| M1\n C1 --> M2\n C1 --> M3\n\n M1 --> |authorizes access to| directory\n\n classDef sponsor fill:transparent,stroke:green,stroke-width:2px;\n classDef client fill:transparent,stroke:purple,stroke-width:2px;\n classDef mandate fill:transparent,stroke:#E50000,stroke-width:2px;\n classDef service fill:transparent,stroke:blue,stroke-width:2px;\n classDef grouping fill:transparent,color:black,stroke-dasharray: 4 10;\n","diagramHtml":"

PPF

๐— ๐—ฎ๐—ป๐—ฑ๐—ฎ๐˜๐—ฒ๐˜€

๐—–๐—น๐—ถ๐—ฒ๐—ป๐˜๐˜€

๐—ฆ๐—ฝ๐—ผ๐—ป๐˜€๐—ผ๐—ฟ๐˜€

offers grey-label API to

offers white-label API to

manages customers

grants permission via

authorizes access to

Seqino

PDP Sponsor (ERP, OD)

PDP Sponsor (Bank, ...)

Client A
Company 1

Client B
Company 2 - Service X

Client C
Company 2 - Service Y

Mandate A

Mandate B

Mandate C

Mandate D

Directory

eInvoicing

eReporting

","diagramHtmlDark":"

PPF

๐— ๐—ฎ๐—ป๐—ฑ๐—ฎ๐˜๐—ฒ๐˜€

๐—–๐—น๐—ถ๐—ฒ๐—ป๐˜๐˜€

๐—ฆ๐—ฝ๐—ผ๐—ป๐˜€๐—ผ๐—ฟ๐˜€

offers grey-label API to

offers white-label API to

manages customers

grants permission via

authorizes access to

Seqino

PDP Sponsor (ERP, OD)

PDP Sponsor (Bank, ...)

Client A
Company 1

Client B
Company 2 - Service X

Client C
Company 2 - Service Y

Mandate A

Mandate B

Mandate C

Mandate D

Directory

eInvoicing

eReporting

"},"children":["graph TB\n seqino[Seqino]\n seqino --> |offers grey-label API to| sponsor_gl[PDP Sponsor]\n seqino --> |offers white-label API to| sponsor_wl[PDP Sponsor]\n\n subgraph sponsors[\"๐—ฆ๐—ฝ๐—ผ๐—ป๐˜€๐—ผ๐—ฟ๐˜€\"]\n sponsor_gl[\"PDP Sponsor (ERP, OD)\"]\n sponsor_wl[\"PDP Sponsor (Bank, ...)\"]\n end\n class sponsors grouping\n class sponsor_gl sponsor\n class sponsor_wl sponsor\n\n subgraph clients[\"๐—–๐—น๐—ถ๐—ฒ๐—ป๐˜๐˜€\"]\n C1[Client A
Company 1]\n C2[Client B
Company 2 - Service X]\n C3[Client C
Company 2 - Service Y]\n end\n class clients grouping\n class C1 client\n class C2 client\n class C3 client\n\n subgraph mandates[\"๐— ๐—ฎ๐—ป๐—ฑ๐—ฎ๐˜๐—ฒ๐˜€\"]\n M1[Mandate A]\n M2[Mandate B]\n M3[Mandate C]\n M4[Mandate D]\n end\n class mandates grouping\n class M1 mandate\n class M2 mandate\n class M3 mandate\n class M4 mandate\n\n subgraph ppf[PPF]\n directory[Directory]\n einvoicing[eInvoicing]\n ereporting[eReporting]\n end\n\n class directory service\n class einvoincing service\n class ereporting service\n class ppf grouping\n\n sponsor_gl --> |manages customers| C1\n sponsor_gl --> C2\n\n C1 --> |grants permission via| M1\n C1 --> M2\n C1 --> M3\n\n M1 --> |authorizes access to| directory\n\n classDef sponsor fill:transparent,stroke:green,stroke-width:2px;\n classDef client fill:transparent,stroke:purple,stroke-width:2px;\n classDef mandate fill:transparent,stroke:#E50000,stroke-width:2px;\n classDef service fill:transparent,stroke:blue,stroke-width:2px;\n classDef grouping fill:transparent,color:black,stroke-dasharray: 4 10;\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-entities","__idx":2},"children":["Key Entities"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-the-sponsor","__idx":3},"children":["๐Ÿข ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The Sponsor"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Who"]},": A Client of Seqino that signed up for the grey-label or white-label API. Examples include ERPs, Banks, Accounting Platforms, ODs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Role"]},": Provides PDP services to their customers using Seqino APIs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsibility"]},": Gather mandates, integrate Seqino's API. Manage invoicing operations on behalf of the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clients"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creation process"]},": Contract between Sponsor and Seqino."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-the-clients","__idx":4},"children":["๐Ÿ‘ฅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The Clients"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Who"]},": A company or a department that uses the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsor"]},"'s software/service (external to Seqino) for electronic invoicing and other services."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Role"]},": Create, send, receive, pay invoices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsibility"]},":",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The client will need to sign a mandate or delegate its consent to the PDP Sponsor."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["๐Ÿค White label: the client designates the Sponsor as its PDP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["๐Ÿ–ค Grey label: the client designates Seqino as its PDP."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identifier"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-PDP-Client-Id"]}," header (required for most operations). Unique identifier."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creation process"]},": Through the Sponsor dashboard or Onboarding API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-mandate","__idx":5},"children":["๐Ÿ“‹ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandate"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What"]},":",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Mandate allows the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client"]}," to grant the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsor"]}," the right to manage PDP operation on their behalf, specifically receiving invoices and managing their lifecycle."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The scope of a mandate reflects the scope of a PPF directory entry (Ligne d'annuaire). The following types of scopes are allowed:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN + suffix (Simple flat way of separating multiple departments without using SIRET)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN + SIRET"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN + SIRET + routing_code (code routage)"]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purpose"]},": Materializes the relationship between a PDP (reception PDP) and a business entity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creation process"]},": Through the Sponsor dashboard or Onboarding API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validity period"]},":",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A mandate has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_date"]}," and an optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," is omitted the mandate does not expire. It stays active indefinitely until it is explicitly given an end date or revoked."," ","In the PPF directory, an open-ended mandate is registered with an effective end date of 9999-12-31."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," can be set, extended, shortened, or removed later via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /mandates/{id}"]}," (send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date: null"]}," to remove the expiry again)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Revoking a mandate (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /mandates/{id}"]},") is a separate action that ends it regardless of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-architecture","__idx":6},"children":["API Architecture"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers--authentication","__idx":7},"children":["Headers & Authentication"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: api-token # Required for all /api calls\nX-PDP-Client-Id: client-acme-corp # Required for client operations\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-categories","__idx":8},"children":["Endpoint Categories"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Category"},"children":["Category"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requires Client ID"},"children":["Requires Client ID"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clients"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage clients and onboarding"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configure client preferences"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gather API usage per client and invoice accordingly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage legal entities and PPF directory entries"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Drafts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and validate invoice drafts"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invoicing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send and receive electronic invoices"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reporting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send e-reporting information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lifecycle"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Polls or subscribes to lifecycle events"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"typical-workflow","__idx":9},"children":["Typical Workflow"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["๐Ÿ”— Onboarding"]},": Create onboarding link for new client"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["๐Ÿ“‹ Mandate Creation"]},": Client grants permissions via signed mandate"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["๐Ÿ“˜ Directory Setup"]},": Register company routing information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["๐Ÿ“„ Invoice Processing"]},": Send/receive electronic invoices"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["๐Ÿ“Š Monitoring"]},": Track usage and generate reports or invoices for the sponsor's clients"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"getting-started","__idx":10},"children":["Getting Started"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Obtain Credentials"]},": Get your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-PDP-Sponsor-Id"]}," from Seqino"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Onboarding"]},": Use onboarding endpoints to register new clients"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory Management"]},": Set up company routing information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Invoicing"]},": Begin sending and receiving electronic invoices"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Seqino PA API - Introduction","id":"seqino-pa-api---introduction","depth":1},{"value":"Core Concepts","id":"core-concepts","depth":2},{"value":"Key Entities","id":"key-entities","depth":2},{"value":"๐Ÿข The Sponsor","id":"-the-sponsor","depth":3},{"value":"๐Ÿ‘ฅ The Clients","id":"-the-clients","depth":3},{"value":"๐Ÿ“‹ Mandate","id":"-mandate","depth":3},{"value":"API Architecture","id":"api-architecture","depth":2},{"value":"Headers & Authentication","id":"headers--authentication","depth":3},{"value":"Endpoint Categories","id":"endpoint-categories","depth":3},{"value":"Typical Workflow","id":"typical-workflow","depth":3},{"value":"Getting Started","id":"getting-started","depth":2}],"frontmatter":{"seo":{"title":"Seqino PA API - Introduction"}},"lastModified":"2026-07-08T22:06:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}