API Seqino PDP - Introduction

Bienvenue dans la documentation de l'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.

Pour toute question, visitez la Page Support.

Concepts Clés

Comprendre la relation entre les Sponsors, les Clients et les Mandats est essentiel pour travailler avec l'API Seqino PDP.

Entités Clés

🏢 Le Sponsor

• Qui : Un client de Seqino qui s'est inscrit pour l'API grey-label ou white-label. Exemples : ERP, Banques, Plateformes comptables, OD.
• Rôle : Fournit des services PDP à leurs clients en utilisant les API Seqino.
• Responsabilité : Collecter les mandats, intégrer l'API Seqino. Gérer les opérations de facturation au nom des Clients.
• Processus de création : Contrat entre le Sponsor et Seqino.

👥 Les Clients

• Qui : Une entreprise ou un département qui utilise le logiciel/service du Sponsor (externe à Seqino) pour la facturation électronique et autres services.
• Rôle : Créer, envoyer, recevoir, payer des factures.
• Responsabilité :
  • Le client devra signer un mandat ou déléguer son consentement au Sponsor PDP.
  • 🤍 White label : le client désigne le Sponsor comme sa PDP.
  • 🖤 Grey label : le client désigne Seqino comme sa PDP.
• Identifiant : En-tête X-PDP-Client-Id (requis pour la plupart des opérations). Identifiant unique.
• Processus de création : Via le tableau de bord Sponsor ou l'API d'Onboarding.

📋 Mandat

• Qu'est-ce que c'est :
  • Un Mandat permet au Client d'accorder au 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.
  • 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 :
    • SIREN
    • SIREN + suffixe (Méthode simple pour séparer plusieurs départements sans utiliser le SIRET)
    • SIREN + SIRET
    • SIREN + SIRET + code_routage (code routage)
• Objectif : Matérialise la relation entre une PDP (PDP de réception) et une entité commerciale.
• Processus de création : Via le tableau de bord Sponsor ou l'API d'Onboarding.

Architecture de l'API

En-têtes et Authentification

X-PDP-Client-Id: client-acme-corp        # Requis pour les opérations client

Catégories d'Endpoints

Flux de Travail Typique

1. 🔗 Onboarding : Créer un lien d'onboarding pour un nouveau client
2. 📋 Création de Mandat : Le client accorde les permissions via un mandat signé
3. 📘 Configuration Annuaire : Enregistrer les informations de routage de l'entreprise
4. 📄 Traitement des Factures : Envoyer/recevoir des factures électroniques
5. 📊 Surveillance : Suivre l'utilisation et générer des rapports ou factures pour les clients du sponsor

Pour Commencer

1. Obtenir les Identifiants : Récupérez votre X-PDP-Sponsor-Id auprès de Seqino
2. Onboarding Client : Utilisez les endpoints d'onboarding pour enregistrer de nouveaux clients
3. Gestion Annuaire : Configurer les informations de routage de l'entreprise
4. Commencer la Facturation : Commencer à envoyer et recevoir des factures électroniques

---:w