Configuration des intégrations

Table des matières

1. Vue d'ensemble des intégrations
2. Stripe (paiements CB)
3. Prélèvement SEPA
4. Signature électronique eIDAS
5. Email (SMTP)
6. Contrôle d'accès physique
7. Export comptable FEC
8. API et webhooks
9. FAQ

Vue d'ensemble des intégrations

Boxanet s'intègre avec des services tiers pour automatiser les paiements, les signatures de contrats, les communications et le contrôle d'accès physique. Chaque intégration est configurable indépendamment et peut être activée ou désactivée selon vos besoins.

Tableau récapitulatif des intégrations

Stripe (paiements CB)

Stripe est la plateforme de paiement par carte bancaire intégrée à Boxanet. Elle permet l'encaissement automatique des loyers mensuels par CB.

Prérequis

Avant de configurer Stripe dans Boxanet, vous devez :

1. Créer un compte Stripe sur stripe.com
2. Compléter la vérification KYC de votre compte (pièces d'identité, RIB, KBIS)
3. Activer le compte en mode Production (après validation par Stripe, généralement 24-48h)

Récupérer les clés API Stripe

1. Connectez-vous à votre dashboard Stripe.
2. Allez dans Développeurs → Clés API.
3. Récupérez :

Configurer Stripe dans Boxanet

1. Allez dans Paramètres → Intégrations → Stripe.
2. Activez l'intégration Stripe (bascule "Activer").
3. Saisissez la clé publiable et la clé secrète.
4. Sélectionnez l'environnement : Test ou Production.
5. Configurez le webhook Stripe :

1. Cliquez sur "Tester la connexion". Un paiement test de 1 € est déclenché et annulé immédiatement.
2. Cliquez sur "Enregistrer".

Fonctionnement des paiements Stripe

Client saisit sa carte → Tokenisation Stripe (hors Boxanet) → Token stocké dans Boxanet
    └─► À l'échéance : Boxanet déclenche le débit via l'API Stripe
            ├─► Succès → Webhook Stripe notifie Boxanet → Facture passée en "Payée"
            └─► Échec → Webhook Stripe notifie Boxanet → Relance automatique

• J+0 : Première tentative (date d'échéance)
• J+3 : Deuxième tentative
• J+7 : Troisième tentative
• J+7+ : Passage en "En retard" + première relance Boxanet

Frais Stripe

Stripe facture des commissions sur chaque transaction. Les tarifs standards (2026) sont :

• Cartes européennes : 1,5 % + 0,25 €
• Cartes non-européennes : 2,5 % + 0,25 €
• Cartes en 3DS2 : inclus dans le tarif standard

Prélèvement SEPA

Le prélèvement SEPA (Single Euro Payments Area) permet de prélever directement le compte bancaire des clients, dans la zone euro.

Prérequis

Pour émettre des prélèvements SEPA, vous devez obtenir un Identifiant Créancier SEPA (ICS) auprès de votre banque. Cet identifiant unique vous est attribué une fois pour toutes et identifie votre organisation sur tous vos prélèvements.

Configurer le SEPA dans Boxanet

1. Allez dans Paramètres → Intégrations → SEPA.
2. Activez l'intégration SEPA.
3. Saisissez votre Identifiant Créancier SEPA (ICS).
4. Renseignez le nom du créancier tel qu'il apparaîtra sur les relevés bancaires des clients (max 70 caractères).
5. Sélectionnez votre banque partenaire (si votre banque est intégrée nativement à Boxanet) ou choisissez "Export XML" pour une remise manuelle de fichier SEPA.
6. Configurez les délais de notification :

1. Cliquez sur "Enregistrer".

Mandats de prélèvement

Chaque client doit signer un mandat de prélèvement SEPA avant le premier prélèvement. Dans Boxanet, ce mandat est intégré au processus de signature de contrat (voir Signature électronique eIDAS).

• Référence Unique du Mandat (RUM) : générée automatiquement par Boxanet
• Nom et adresse du débiteur
• IBAN et BIC du débiteur
• Date de signature

Fichiers XML SEPA

Si votre banque ne supporte pas l'envoi automatique, Boxanet génère des fichiers XML au format PAIN.008.001.02 (norme SEPA Credit Transfer pour les prélèvements).

1. Chaque mois, avant la date d'échéance, Boxanet génère automatiquement le fichier XML.
2. Allez dans Intégrations → SEPA → Fichiers en attente de remise.
3. Téléchargez le fichier XML.
4. Connectez-vous à votre interface bancaire et importez le fichier dans la section "Virements/Prélèvements SEPA".
5. Validez la remise dans Boxanet (bouton "Marquer comme remis").

Signature électronique eIDAS

Boxanet intègre un service de signature électronique conforme au règlement européen eIDAS (Electronic Identification, Authentication and Trust Services). Les contrats signés électroniquement ont la même valeur juridique qu'une signature manuscrite.

Niveau de signature utilisé

Boxanet utilise le niveau Signature Électronique Avancée (SEA) qui offre :

• Identité du signataire vérifiée (email + code OTP SMS)
• Lien indissociable entre signature et document
• Non-répudiation garantie
• Valeur probatoire devant les tribunaux français

Prestataire de signature

Boxanet est intégré avec Yousign, prestataire qualifié eIDAS. D'autres prestataires (DocuSign, HelloSign) peuvent être configurés via l'API générique de signature.

Configurer Yousign

1. Créez un compte sur yousign.com.
2. Récupérez votre clé API dans votre dashboard Yousign.
3. Allez dans Paramètres → Intégrations → Signature électronique.
4. Sélectionnez le prestataire "Yousign".
5. Saisissez votre clé API Yousign.
6. Sélectionnez l'environnement : Sandbox (test) ou Production.
7. Configurez les options de signature :

1. Cliquez sur "Tester" pour envoyer un contrat test à votre propre adresse email.
2. Cliquez sur "Enregistrer".

Processus de signature d'un contrat

Manager génère le contrat PDF dans Boxanet
    └─► Boxanet envoie le document à Yousign via API
            └─► Yousign envoie un email au client avec lien de signature
                    └─► Client signe (email + OTP SMS)
                            └─► Yousign notifie Boxanet via webhook
                                    └─► Contrat passe en statut "Signé" dans Boxanet
                                            └─► PDF signé archivé dans Boxanet + envoyé au client

Archivage légal

Les contrats signés sont archivés dans Boxanet avec leur preuve d'horodatage (certificat de signature). Pour les télécharger :

• Contrat signé PDF : Contrats → [Contrat] → Télécharger le contrat signé
• Preuve de signature (certificat horodaté) : Contrats → [Contrat] → Preuve de signature

Email (SMTP)

Par défaut, Boxanet utilise son propre serveur d'envoi d'emails. Pour une meilleure délivrabilité et une identité de marque cohérente, configurez votre propre serveur SMTP.

Pourquoi configurer son propre SMTP ?

Prestataires SMTP recommandés

Configurer le SMTP

1. Allez dans Paramètres → Intégrations → Email (SMTP).
2. Renseignez :

1. Configurez l'identité expéditeur :

1. Cliquez sur "Envoyer un email de test".
2. Vérifiez la réception de l'email test.
3. Cliquez sur "Enregistrer".

Contrôle d'accès physique

Boxanet s'intègre avec les systèmes de contrôle d'accès physique pour gérer automatiquement les badges NFC et codes PIN des clients.

Systèmes compatibles

Boxanet dispose de connecteurs natifs pour :

Configurer l'intégration contrôle d'accès

1. Allez dans Paramètres → Intégrations → Contrôle d'accès.
2. Sélectionnez votre système dans la liste.
3. Renseignez les paramètres de connexion (URL API, clé API, identifiants).
4. Configurez le mapping des zones :

1. Activez la synchronisation automatique :

1. Cliquez sur "Tester la connexion" et "Enregistrer".

Gestion manuelle des badges

Même avec une intégration active, vous pouvez gérer manuellement les badges depuis Boxanet :

• Attribuer un badge : Contrats → [Contrat] → Onglet Accès → Assigner un badge
• Désactiver temporairement : Contrats → [Contrat] → Onglet Accès → Suspendre l'accès
• Remplacer un badge perdu : Contrats → [Contrat] → Onglet Accès → Remplacer le badge

Export comptable FEC

L'export FEC (Fichier des Écritures Comptables) est une fonctionnalité native de Boxanet, sans intégration tierce requise.

Format du FEC

Le FEC généré par Boxanet est conforme à l'arrêté du 29 juillet 2013 et contient les champs réglementaires :

Générer le FEC

Voir le guide complet dans Reporting et tableaux de bord — Export FEC.

Intégration avec les logiciels comptables

Le FEC peut être importé directement dans :

• Sage 100 / Sage i7
• EBP Comptabilité
• Cegid Loop
• QuickBooks (module d'import FEC)
• MyUnisoft

API et webhooks

Boxanet expose une API REST permettant d'intégrer la plateforme avec vos propres outils (CRM, ERP, site web, etc.).

Accès à l'API

L'accès à l'API est disponible sur demande. Contactez support@boxanet.fr pour :

• Activer l'accès API sur votre compte
• Recevoir votre documentation API (format OpenAPI / Swagger)
• Obtenir une clé API de développement

Endpoints principaux

Configurer les webhooks

Les webhooks permettent à Boxanet de notifier votre système externe lorsqu'un événement survient.

1. Allez dans Paramètres → Intégrations → Webhooks.
2. Cliquez sur "+ Nouveau webhook".
3. Saisissez l'URL de réception de votre système (ex. : https://votre-crm.com/api/boxanet/hook).
4. Sélectionnez les événements à recevoir :

1. Configurez un secret de signature (chaîne aléatoire) pour valider l'authenticité des webhooks côté récepteur.
2. Cliquez sur "Enregistrer".

{
  "event": "payment.received",
  "timestamp": "2026-06-29T14:32:00Z",
  "site_id": "site_abc123",
  "data": {
    "invoice_id": "inv_xyz789",
    "amount": 144.00,
    "currency": "EUR",
    "payment_method": "stripe",
    "client_id": "cli_def456"
  }
}

FAQ