Intégrations et API

Sept entrées sous Configurations relient SaleSprint au monde extérieur. Elles ne sont pas toutes au même stade.

Entrée de menu	État
Clés API	fonctionne
Webhooks	fonctionne
Fournisseurs e-facture	fonctionne — GRA Ghana
Transmissions fiscales	fonctionne
Fournisseurs comptables	enregistre des réglages, aucun moteur de synchronisation
Tâches de synchronisation comptable	met des tâches en file d’attente qui ne s’exécutent jamais
Correspondances externes	enregistre des paires que rien ne lit

Transmission fiscale (GRA Ghana)

Où

Configurations → Fournisseurs e-facture

Forfait

Professionnel et plus

Permission

Integration → Einvoice Provider

C’est la connexion réelle et fonctionnelle au système E-VAT de la Ghana Revenue Authority. Les factures sont transmises et la signature fiscale revient sur vos reçus.

Comment la mettre en place

1. Allez dans Configurations → Fournisseurs e-facture et cliquez pour en ajouter un.
2. Saisissez un Nom, et mettez Fournisseur exactement sur gra.
3. Saisissez votre Identifiant fiscal — le NIF de votre société.
4. Mettez votre clé de sécurité GRA dans Secret client, et le nom enregistré de votre société dans ID de royaume externe.
5. Choisissez l’Environnement. La production exige une URL de base personnalisée — l’adresse en production que la GRA vous délivre lors de l’inscription. Le bac à sable n’en a pas besoin.
6. Activez Transmission activée et enregistrez.
7. Utilisez Tester la connexion sur la ligne pour vérifier avant de vous y fier.

L’indication du champ Fournisseur est fausse sur cet écran

Elle suggère « e.g. quickbooks, xero ». Sur cet écran les seules valeurs valides sont gra et stub.

Rien n’est transmis tant que vous n’activez pas la facturation électronique dans les paramètres

Un fournisseur configuré, qui affiche Connecté et qui passe Tester la connexion, n’enverra malgré tout rien. La transmission est pilotée par un paramètre distinct qui est désactivé par défaut et qui ne se trouve pas sur cet écran — il est dans les paramètres de votre espace de travail.

Activez-y la facturation électronique, et indiquez quels types de documents transmettre. Rien sur l’écran du fournisseur n’en parle.

Surveiller ce qui a été envoyé

Transmissions fiscales est le journal : le document, son statut, le nombre de tentatives et la référence fiscale. Détails fiscaux sur une ligne affiche la feuille de signature complète — ID SDC, numéro de reçu, code de l’appareil et le lien QR de vérification.

Les transmissions échouées sont réessayées automatiquement, avec un délai croissant de 30 secondes à un jour, jusqu’à douze tentatives. Un document déjà déposé n’est jamais envoyé deux fois ; seule sa signature est récupérée à nouveau.

Deux boutons qui se ressemblent — un seul transmet

Transmettre est celui qui envoie réellement un document à la GRA. C’est celui-là.

Soumettre un document ne fait qu’enregistrer une transmission dans le journal. Il annonce « Transmission soumise » et n’envoie strictement rien. Ignorez-le.

L’API publique

Où

Configurations → Clés API

Forfait

Professionnel et plus

Permission

Integration → Api Key

Ces deux entrées de menu n’apparaissent jamais, pour personne

Clés API et Webhooks ne sont montrées qu’à quelqu’un qui détient une permission qui n’existe pas — le menu demande integration, qui est un nom de catégorie plutôt qu’une vraie permission, et ne peut donc jamais être accordé.

Dans une activité normale les deux entrées sont invisibles. Les écrans restent accessibles en tapant /api-keys ou /webhooks dans la barre d’adresse — mais alors les boutons Nouveau, Modifier, Révoquer et Supprimer n’apparaissent pas non plus, pour la même raison.

En pratique, seul un opérateur SaleSprint peut s’en servir aujourd’hui.

Cela dit, la fonctionnalité derrière est bien réelle.

Ce que l’API peut faire

Huit opérations, sur /public/v1 : lister et récupérer les produits, les commandes, les clients et le stock, plus la création d’un client — la seule écriture.

Une clé porte des portées, mais catalog:write et orders:write ne débloquent rien, parce qu’aucune opération de ce genre n’existe. Seule customers:write fait quelque chose.

Une clé ne peut jamais faire plus que la personne qui l’a créée.

Comment créer une clé

1. Allez dans Configurations → Clés API et créez-en une.
2. Donnez-lui un Nom.
3. Cochez les Portées dont elle a besoin.
4. Définissez éventuellement Expire le.
5. Enregistrez, puis copiez la clé immédiatement — la boîte de dialogue dit « Copiez votre clé API maintenant », et c’est vraiment la seule fois où elle est affichée.

La date d’expiration a besoin d’une heure

L’indication dit YYYY-MM-DD, mais saisir 2026-12-31 est rejeté. Écrivez 2026-12-31T00:00:00Z.

Révoquer une clé prend effet immédiatement.

Webhooks

Un webhook envoie un message à votre adresse quand quelque chose change.

1. Donnez-lui un Nom et une URL du point de terminaison.
2. Laissez Types d’événements vide pour tout recevoir, ou listez-les séparés par des virgules.
3. Définissez un Secret de signature afin de pouvoir vérifier que les messages viennent bien de SaleSprint.
4. Laissez Actif activé.

Il n’y a que cinq événements, et ils sont génériques

record.created, record.updated, record.deleted, record.cancelled et le fourre-tout record.changed. Une vente créée et un produit modifié arrivent tous deux comme le même événement — votre système doit regarder le type à l’intérieur du message pour les distinguer.

Le message transporte ce qui a changé, pas l’enregistrement lui-même. Vous récupérez ensuite l’enregistrement via l’API.

Le champ Types d’événements est du texte libre sans liste, donc une faute de frappe ne reçoit silencieusement rien.

Les livraisons échouées sont réessayées huit fois, avec un délai croissant de 30 secondes à six heures.

Il n’y a aucun journal de livraison consultable

SaleSprint enregistre si chaque livraison a réussi, mais rien ne l’affiche. Vous ne pouvez pas savoir depuis l’application si votre point de terminaison a jamais reçu quoi que ce soit.

Comptabilité — de simples fondations

Où

Configurations → Fournisseurs comptables

Forfait

Professionnel et plus

Permission

Integration → Accounting Provider

Il n’y a aucune synchronisation comptable. Rien n’est envoyé nulle part.

Vous pouvez ajouter un fournisseur comptable, renseigner des identifiants et appuyer sur Se connecter. La ligne dira alors Connecté — mais rien n’a été contacté et rien n’a été vérifié. Le mot a seulement été écrit.

Tâches de synchronisation comptable vous laisse mettre un document en file d’attente pour synchronisation. La tâche est créée et reste En attente pour toujours. Il n’y a aucun moteur pour l’exécuter, aucune tâche planifiée, et valider une vente ne met jamais rien en file d’attente. L’action « Mettre à jour le statut de la tâche » n’existe que pour qu’une personne saisisse un résultat à la main.

Correspondances externes enregistre des paires « notre enregistrement = le leur ». Rien ne les lit. Les deux champs d’identifiant vous demandent de taper à la main des références internes brutes, sans aucune recherche.

Aucune de ces trois choses ne fait quoi que ce soit aujourd’hui. Ne bâtissez pas une routine comptable autour d’elles.

Si vous avez besoin de vos chiffres dans un logiciel de comptabilité, exportez les rapports financiers et importez-les là-bas.

Qui peut les utiliser

Les sept demandent chacune leur propre permission. Fournisseurs comptables, Tâches de synchronisation, Correspondances externes, Fournisseurs e-facture et Transmissions fiscales ne sont protégées que par une permission et fonctionneront sur n’importe quel forfait si la permission est accordée.

Clés API et Webhooks demandent en plus un forfait incluant l’accès à l’API — grossièrement Croissance pour consulter et Professionnel pour créer — et sont soumises au problème de visibilité décrit plus haut.

À lire aussi

• Rapports financiers
• Taxe
• Paramètres — où activer la facturation électronique