Welcome to the 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.
For any question, ask on the Support page.
Understanding the relationship between Sponsors, Clients, and Mandates is essential to working with the Seqino PDP API.
- Who: A Client of Seqino that signed up for the grey-label or white-label API. Examples include ERPs, Banks, Accounting Platforms, ODs.
- Role: Provides PDP services to their customers using Seqino APIs.
- Responsibility: Gather mandates, integrate Seqino's API. Manage invoicing operations on behalf of the Clients.
- Creation process: Contract between Sponsor and Seqino.
- Who: A company or a department that uses the Sponsor's software/service (external to Seqino) for electronic invoicing and other services.
- Role: Create, send, receive, pay invoices.
- Responsibility:
- The client will need to sign a mandate or delegate its consent to the PDP Sponsor.
- 🤍 White label: the client designates the Sponsor as its PDP.
- 🖤 Grey label: the client designates Seqino as its PDP.
- Identifier:
X-PDP-Client-Idheader (required for most operations). Unique identifier. - Creation process: Through the Sponsor dashboard or Onboarding API.
- What:
- A Mandate allows the Client to grant the Sponsor the right to manage PDP operation on their behalf, specifically receiving invoices and managing their lifecycle.
- The scope of a mandate reflects the scope of a PPF directory entry (Ligne d'annuaire). The following types of scopes are allowed:
- SIREN
- SIREN + suffix (Simple flat way of separating multiple departments without using SIRET)
- SIREN + SIRET
- SIREN + SIRET + routing_code (code routage)
- Purpose: Materializes the relationship between a PDP (reception PDP) and a business entity.
- Creation process: Through the Sponsor dashboard or Onboarding API.
Authorization: api-token # Required for all /api calls
X-PDP-Client-Id: client-acme-corp # Required for client operations| Category | Purpose | Requires Client ID |
|---|---|---|
| Clients | Manage clients and onboarding | |
| Settings | Configure client preferences | |
| Usage | Gather API usage per client and invoice accordingly | |
| Mandates | Manage legal entities and PPF directory entries | |
| Drafts | Create and validate invoice drafts | |
| Invoicing | Send and receive electronic invoices | |
| Reporting | Send e-reporting information | |
| Lifecycle | Polls or subscribes to lifecycle events |
- 🔗 Onboarding: Create onboarding link for new client
- 📋 Mandate Creation: Client grants permissions via signed mandate
- 📘 Directory Setup: Register company routing information
- 📄 Invoice Processing: Send/receive electronic invoices
- 📊 Monitoring: Track usage and generate reports or invoices for the sponsor's clients
- Obtain Credentials: Get your
X-PDP-Sponsor-Idfrom Seqino - Client Onboarding: Use onboarding endpoints to register new clients
- Directory Management: Set up company routing information
- Start Invoicing: Begin sending and receiving electronic invoices