{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr-FR/guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"API Seqino PDP - Introduction"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api-seqino-pdp---introduction","__idx":0},"children":["API Seqino PDP - Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bienvenue dans la documentation de l'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Seqino PDP"]},". Cette API fournit une interface moderne et simplifiée aux services de facturation électronique français, vous donnant la puissance d'une Plateforme de Dématérialisation Partenaire (PDP) sans la charge de gestion associée."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pour toute question, visitez la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.api-pdp.seqino.com/fr"},"children":["Page Support"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"concepts-clés","__idx":1},"children":["Concepts Clés"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Comprendre la relation entre les ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsors"]},", les ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clients"]}," et les ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandats"]}," est essentiel pour travailler avec l'API Seqino PDP."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"graph TB\n seqino[Seqino]\n seqino --> |propose une API grey-label à| sponsor_gl[Sponsor PDP]\n seqino --> |propose une API white-label à| sponsor_wl[Sponsor PDP]\n\n subgraph sponsors[\"𝗦𝗽𝗼𝗻𝘀𝗼𝗿𝘀\"]\n sponsor_gl[\"Sponsor PDP (ERP, OD)\"]\n sponsor_wl[\"Sponsor PDP (Banque, ...)\"]\n end\n class sponsors grouping\n class sponsor_gl sponsor\n class sponsor_wl sponsor\n\n subgraph clients[\"𝗖𝗹𝗶𝗲𝗻𝘁𝘀\"]\n C1[Client A
Entreprise 1]\n C2[Client B
Entreprise 2 - Service X]\n C3[Client C
Entreprise 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[Mandat A]\n M2[Mandat B]\n M3[Mandat C]\n M4[Mandat 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[Annuaire]\n einvoicing[Facturation électronique]\n ereporting[Télédéclaration]\n end\n\n class directory service\n class einvoincing service\n class ereporting service\n class ppf grouping\n\n sponsor_gl --> |gère les clients| C1\n sponsor_gl --> C2\n\n C1 --> |accorde la permission via| M1\n C1 --> M2\n C1 --> M3\n\n M1 --> |autorise l'accès à| 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

𝗠𝗮𝗻𝗱𝗮𝘁𝘀

𝗖𝗹𝗶𝗲𝗻𝘁𝘀

𝗦𝗽𝗼𝗻𝘀𝗼𝗿𝘀

propose une API grey-label à

propose une API white-label à

gère les clients

accorde la permission via

autorise l'accès à

Seqino

Sponsor PDP (ERP, OD)

Sponsor PDP (Banque, ...)

Client A
Entreprise 1

Client B
Entreprise 2 - Service X

Client C
Entreprise 2 - Service Y

Mandat A

Mandat B

Mandat C

Mandat D

Annuaire

Facturation électronique

Télédéclaration

","diagramHtmlDark":"

PPF

𝗠𝗮𝗻𝗱𝗮𝘁𝘀

𝗖𝗹𝗶𝗲𝗻𝘁𝘀

𝗦𝗽𝗼𝗻𝘀𝗼𝗿𝘀

propose une API grey-label à

propose une API white-label à

gère les clients

accorde la permission via

autorise l'accès à

Seqino

Sponsor PDP (ERP, OD)

Sponsor PDP (Banque, ...)

Client A
Entreprise 1

Client B
Entreprise 2 - Service X

Client C
Entreprise 2 - Service Y

Mandat A

Mandat B

Mandat C

Mandat D

Annuaire

Facturation électronique

Télédéclaration

"},"children":["graph TB\n seqino[Seqino]\n seqino --> |propose une API grey-label à| sponsor_gl[Sponsor PDP]\n seqino --> |propose une API white-label à| sponsor_wl[Sponsor PDP]\n\n subgraph sponsors[\"𝗦𝗽𝗼𝗻𝘀𝗼𝗿𝘀\"]\n sponsor_gl[\"Sponsor PDP (ERP, OD)\"]\n sponsor_wl[\"Sponsor PDP (Banque, ...)\"]\n end\n class sponsors grouping\n class sponsor_gl sponsor\n class sponsor_wl sponsor\n\n subgraph clients[\"𝗖𝗹𝗶𝗲𝗻𝘁𝘀\"]\n C1[Client A
Entreprise 1]\n C2[Client B
Entreprise 2 - Service X]\n C3[Client C
Entreprise 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[Mandat A]\n M2[Mandat B]\n M3[Mandat C]\n M4[Mandat 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[Annuaire]\n einvoicing[Facturation électronique]\n ereporting[Télédéclaration]\n end\n\n class directory service\n class einvoincing service\n class ereporting service\n class ppf grouping\n\n sponsor_gl --> |gère les clients| C1\n sponsor_gl --> C2\n\n C1 --> |accorde la permission via| M1\n C1 --> M2\n C1 --> M3\n\n M1 --> |autorise l'accès à| 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":"entités-clés","__idx":2},"children":["Entités Clés"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-le-sponsor","__idx":3},"children":["🏢 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Le Sponsor"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Qui"]}," : Un client de Seqino qui s'est inscrit pour l'API grey-label ou white-label. Exemples : ERP, Banques, Plateformes comptables, OD."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rôle"]}," : Fournit des services PDP à leurs clients en utilisant les API Seqino."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsabilité"]}," : Collecter les mandats, intégrer l'API Seqino. Gérer les opérations de facturation au nom des ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clients"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processus de création"]}," : Contrat entre le Sponsor et Seqino."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-les-clients","__idx":4},"children":["👥 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Les Clients"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Qui"]}," : Une entreprise ou un département qui utilise le logiciel/service du ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsor"]}," (externe à Seqino) pour la facturation électronique et autres services."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rôle"]}," : Créer, envoyer, recevoir, payer des factures."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsabilité"]}," :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le client devra signer un mandat ou déléguer son consentement au Sponsor PDP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["🤍 White label : le client désigne le Sponsor comme sa PDP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["🖤 Grey label : le client désigne Seqino comme sa PDP."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identifiant"]}," : En-tête ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-PDP-Client-Id"]}," (requis pour la plupart des opérations). Identifiant unique."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processus de création"]}," : Via le tableau de bord Sponsor ou l'API d'Onboarding."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-mandat","__idx":5},"children":["📋 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandat"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Qu'est-ce que c'est"]}," :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un Mandat permet au ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client"]}," d'accorder au ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsor"]}," le droit de gérer les opérations PDP en son nom, spécifiquement la réception de factures et la gestion de leur cycle de vie."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le périmètre d'un mandat reflète le périmètre d'une entrée d'annuaire PPF (Ligne d'annuaire). Les types de périmètres suivants sont autorisés :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN + suffixe (Méthode simple pour séparer plusieurs départements sans utiliser le SIRET)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN + SIRET"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SIREN + SIRET + code_routage (code routage)"]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Objectif"]}," : Matérialise la relation entre une PDP (PDP de réception) et une entité commerciale."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processus de création"]}," : Via le tableau de bord Sponsor ou l'API d'Onboarding."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Période de validité"]}," :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un mandat a une ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_date"]}," et une ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," optionnelle."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lorsque ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," est omise, le mandat n'expire pas. Il reste actif indéfiniment jusqu'à ce qu'une date de fin lui soit explicitement attribuée ou qu'il soit révoqué. Dans l'annuaire PPF, un mandat sans fin est enregistré avec une date de fin d'effet au 9999-12-31."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," peut être définie, prolongée, raccourcie ou supprimée ultérieurement via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /mandates/{id}"]}," (envoyer ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date: null"]}," pour supprimer à nouveau l'expiration)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La révocation d'un mandat (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /mandates/{id}"]},") est une action distincte qui y met fin indépendamment de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"architecture-de-lapi","__idx":6},"children":["Architecture de l'API"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"en-têtes-et-authentification","__idx":7},"children":["En-têtes et Authentification"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"X-PDP-Client-Id: client-acme-corp # Requis pour les opérations client\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"catégories-dendpoints","__idx":8},"children":["Catégories d'Endpoints"]},{"$$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":"Catégorie"},"children":["Catégorie"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Objectif"},"children":["Objectif"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requiert l'ID Client"},"children":["Requiert l'ID Client"]}]}]},{"$$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":["Gérer les clients et l'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":["Paramètres"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configurer les préférences client"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Utilisation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Collecter l'utilisation de l'API par client et facturer en conséquence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandats"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gérer les entités légales et les entrées d'annuaire PPF"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Brouillons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Créer et valider les brouillons de factures"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Facturation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envoyer et recevoir des factures électroniques"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Télédéclaration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envoyer les informations de télédéclaration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cycle de vie"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Interroger ou s'abonner aux événements de cycle de vie"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"flux-de-travail-typique","__idx":9},"children":["Flux de Travail Typique"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["🔗 Onboarding"]}," : Créer un lien d'onboarding pour un nouveau client"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📋 Création de Mandat"]}," : Le client accorde les permissions via un mandat signé"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📘 Configuration Annuaire"]}," : Enregistrer les informations de routage de l'entreprise"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📄 Traitement des Factures"]}," : Envoyer/recevoir des factures électroniques"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📊 Surveillance"]}," : Suivre l'utilisation et générer des rapports ou factures pour les clients du sponsor"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pour-commencer","__idx":10},"children":["Pour Commencer"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Obtenir les Identifiants"]}," : Récupérez votre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-PDP-Sponsor-Id"]}," auprès de Seqino"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Onboarding Client"]}," : Utilisez les endpoints d'onboarding pour enregistrer de nouveaux clients"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gestion Annuaire"]}," : Configurer les informations de routage de l'entreprise"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Commencer la Facturation"]}," : Commencer à envoyer et recevoir des factures électroniques"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"API Seqino PDP - Introduction","id":"api-seqino-pdp---introduction","depth":1},{"value":"Concepts Clés","id":"concepts-clés","depth":2},{"value":"Entités Clés","id":"entités-clés","depth":2},{"value":"🏢 Le Sponsor","id":"-le-sponsor","depth":3},{"value":"👥 Les Clients","id":"-les-clients","depth":3},{"value":"📋 Mandat","id":"-mandat","depth":3},{"value":"Architecture de l'API","id":"architecture-de-lapi","depth":2},{"value":"En-têtes et Authentification","id":"en-têtes-et-authentification","depth":3},{"value":"Catégories d'Endpoints","id":"catégories-dendpoints","depth":3},{"value":"Flux de Travail Typique","id":"flux-de-travail-typique","depth":3},{"value":"Pour Commencer","id":"pour-commencer","depth":2}],"frontmatter":{"seo":{"title":"API Seqino PDP - Introduction"}},"lastModified":"2026-07-08T22:06:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr-fr/guides/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}