Facturino / Documentation / Seqino

Connecter Seqino

Seqino est une Plateforme Agréée française SecNumCloud, immatriculée DGFiP sous le n°0048. L'authentification est à deux headers : une clé API d'application et un Client ID propre à votre entreprise.

Immatriculation
PA n°0048
Registre DGFiP
Certification
SecNumCloud
Hébergement souverain
Authentification
2 headers
Authorization + X-PDP-Client-Id

1. Obtenir un accès Seqino

  1. Remplissez le formulaire de contact Seqino. L'éditeur revient vers vous sous 48 h.
  2. Connectez-vous au portail développeur et créez une application.
  3. Récupérez les deux identifiants :
    • Votre clé API — envoyée par Facturino dans l'en-tête Authorization (sans « Bearer »)
    • X-PDP-Client-Id — identifie votre entreprise dans le tenant Seqino

2. Connecter Facturino

La connexion d'une PA se gère depuis l'interface Facturino — les identifiants sensibles ne transitent jamais par l'API publique.

  1. Ouvrez Paramètres → Facturation électronique et choisissez Seqino.
  2. Collez votre clé API dans le champ Clé API.
  3. Collez votre X-PDP-Client-Id dans le champ Client ID.
  4. Cliquez sur Connecter — Facturino injecte les deux headers sur chaque appel sortant.

Les deux champs sont obligatoires. Seqino rejette toute requête où l'un des headers manque (401 Unauthorized). Si la connexion échoue avec pa_credentials_invalid, vérifiez en priorité que vous n'avez pas inversé les deux identifiants.

3. Suivi des statuts (polling)

Seqino n'émet pas de webhook entrant vers Facturino : le suivi du cycle de vie se fait par interrogation périodique. Après un dépôt, Facturino interroge Seqino et met à jour le statut de la facture automatiquement — vous n'avez aucun webhook à configurer côté Seqino.

4. Tester votre première facture

curl -X POST https://facturino.com/api/v1/invoices/inv_xxx/send \
  -H "Authorization: Bearer fac_test_..."

Seqino accuse réception et fait progresser la facture par deposited → transmitted → available (statuts relevés par polling).

Limites connues

  • Les routes d’émission du contrat 0.30.3 sont intégrées : accept (205), refuse (210), mark_as_paid côté acheteur (211) et mark_as_cashed côté vendeur (212). Pour « Encaissée », Seqino retient la date de saisie du statut (émission), avec les montants par taux. L’intégration reste à qualifier en bac à sable.
  • Le portail développeur Seqino est sur un sous-domaine .dev distinct du domaine de production — n'utilisez ses clés que pour des tests fonctionnels.

Questions fréquentes

Faut-il un contrat Seqino avant de connecter Facturino ?

Oui. Vous obtenez vos identifiants via le formulaire de contact Seqino (réponse sous 48 h), puis créez une application sur leur portail développeur. Facturino ne fournit pas les accès Seqino : le modèle est BYOPA (vous apportez votre propre plateforme).

Pourquoi deux identifiants ?

Seqino authentifie à deux niveaux : la clé API identifie l'application (envoyée dans Authorization, sans « Bearer ») et le X-PDP-Client-Id identifie votre entreprise dans le tenant Seqino. Les deux sont obligatoires.

Puis-je marquer une facture « approuvée » ou « payée » depuis Facturino ?

Oui. L’approbation, le refus et les paiements passent par la file durable de Facturino et déclenchent une tâche immédiate. Le paiement acheteur (211) reste distinct de l’encaissement vendeur (212), daté à son émission chez Seqino. La lecture des statuts reste périodique.

Qu'apporte la certification SecNumCloud ?

SecNumCloud est le référentiel de l'ANSSI pour l'hébergement de confiance : données hébergées en France, sous protection contre les législations extraterritoriales. Un critère pertinent pour les données de facturation sensibles.

Ressources

Toutes les Plateformes Agréées Tester l'API