Intégrations comptables

Connectez StockCraft directement à votre plateforme de comptabilité et augmentez automatiquement les recettes, les dépenses et le coût des marchandises. Disponible sur le plan Plus (5$ par mois).

Fournisseurs pris en charge

Connecter un fournisseur

Chaque fournisseur utilise le flux d'autorisation standard OAuth 2.0. Vous ne communiquez jamais le mot de passe de votre compte à StockCraft. Au lieu de cela, vous accordez l'autorisation directement via la page de connexion du fournisseur.

Étape par étape : connectez Xero

1. Naviguez vers Finances → Connexions API dans StockCraft
2. Trouvez le Xéro carte et cliquez « Connecter »
3. Vous serez redirigé vers la page de connexion de Xero : connectez-vous avec vos informations d'identification Xero
4. Autorisez StockCraft à accéder à votre organisation Xero
5. Xero vous redirige vers StockCraft — la connexion est maintenant active

Étape par étape : connectez QuickBooks en ligne

1. Naviguez vers Finances → Connexions API dans StockCraft
2. Trouvez le QuickBooks en ligne carte et cliquez « Connecter »
3. Vous serez redirigé vers la page de connexion d'Intuit : connectez-vous avec vos informations d'identification QuickBooks
4. Sélectionnez l'entreprise à laquelle vous souhaitez vous connecter et accordez l'accès
5. QuickBooks vous redirige vers StockCraft — la connexion est maintenant active

Étape par étape : connectez MYOB Business

1. Naviguez vers Finances → Connexions API dans StockCraft
2. Trouvez le MYOB Business carte et cliquez « Connecter »
3. Vous serez redirigé vers la page de connexion de MYOB : connectez-vous avec vos informations d'identification MYOB
4. Autorisez StockCraft à accéder aux fichiers de votre entreprise MYOB
5. Si vous avez plusieurs fichiers d'entreprise, sélectionnez celui avec lequel vous souhaitez synchroniser
6. MYOB vous redirige vers StockCraft — la connexion est maintenant active

Configuration de la plage de dates de synchronisation

Avant de déclencher une synchronisation, configurez la date à laquelle StockCraft doit envoyer les données financières. Cela permet d'éviter de dupliquer des enregistrements historiques qui existent déjà dans votre logiciel de comptabilité.

1. Sur la carte du fournisseur connecté, localisez Plage de dates de synchronisation section
2. Définissez un Date de début — seules les transactions effectuées à cette date ou après cette date seront reportées
3. Définissez éventuellement un Date de fin — si ce champ est laissé vide, StockCraft se synchronise avec la date actuelle
4. Cliquez « Enregistrer » pour appliquer la plage de dates

Déclencher une synchronisation manuelle

Les synchronisations sont déclenchées manuellement : vous contrôlez le moment où les données sont transmises à votre plateforme de comptabilité.

1. Naviguez vers Finances → Connexions API
2. Sur la carte du fournisseur connecté, cliquez sur « Synchroniser maintenant »
3. StockCraft met la tâche de synchronisation en file d'attente et affiche une confirmation
4. La synchronisation s'effectue en arrière-plan : les commandes terminées et les dépenses effectuées dans la plage de dates que vous avez configurée sont transmises au fournisseur
5. Une fois terminée, l'état de la synchronisation et le nombre d'enregistrements apparaissent sur la carte du fournisseur

Ce qui est poussé

• Chiffre d'affaires : Les commandes StockCraft terminées sont transmises sous forme de factures de vente (ou équivalent) à votre plateforme comptable
• Dépenses et coût des marchandises : Les dépenses d'achat de matériel sont présentées sous forme de factures ou d'écritures d'achat

Pannes partielles

Si certains enregistrements ne sont pas transmis (par exemple, en raison d'une erreur d'API du fournisseur), StockCraft continue à envoyer les enregistrements restants. Le résultat de la synchronisation s'affichera sous la forme Défaillance partielle avec un décompte des enregistrements ayant échoué et un résumé des erreurs.

Historique de synchronisation de lecture

Chaque fournisseur connecté affiche les 20 dernières tentatives de synchronisation, classées les plus récentes en premier. Chaque enregistrement de synchronisation inclut :

• Fournisseur : Quelle plateforme comptable a été synchronisée
• Commencé/Terminé : Horodatages de l'exécution de la synchronisation
• Enregistrements réussis : Nombre de transactions repoussées avec succès
• Les enregistrements ont échoué : Nombre de transactions qui n'ont pas été repoussées
• État : Résultat global : succès, échec partiel ou échec
• Résumé des erreurs : Description lisible par l'homme en cas de problème

Résolution des problèmes de réautorisation

Parfois, une connexion peut nécessiter une nouvelle autorisation. Cela se produit lorsque :

• Le fournisseur révoque ou fait expirer votre jeton d'actualisation
• Vous modifiez votre mot de passe sur la plateforme de comptabilité
• La politique de sécurité du fournisseur exige un nouveau consentement périodique
• Le déchiffrement du jeton échoue (rare, indique un problème d'intégrité des données)

Comment procéder à une nouvelle autorisation

1. Naviguez vers Finances → Connexions API
2. La carte du fournisseur concerné affichera un « Nécessite une nouvelle autorisation » badge d'état
3. Cliquez sur « Reconnecter » bouton
4. Terminez à nouveau le flux OAuth (connectez-vous au fournisseur et accordez l'accès)
5. Une fois reconnectée, les synchronisations reprendront normalement

Réautorisation MYOB

Pour les connexions MYOB, la réautorisation doit être effectuée par un utilisateur disposant d'un accès de niveau administrateur MYOB. Si une invite de réautorisation s'affiche, assurez-vous que le bon utilisateur MYOB Administrator complète l'étape de connexion.

Problèmes courants

Symptôme	Cause probable	Solution
Le badge « Nécessite une nouvelle autorisation » apparaît	Le jeton d'actualisation a expiré ou a été révoqué	Cliquez sur « Reconnecter » et terminez le flux OAuth
La synchronisation échoue avec une erreur 409	Une synchronisation est déjà en cours	Attendez la fin de la synchronisation en cours, puis réessayez
Défaillance partielle avec échec de certains enregistrements	Enregistrements individuels rejetés par l'API du fournisseur	Consultez le résumé des erreurs pour plus de détails ; corrigez les données et resynchronisez
Impossible de se connecter — erreur 403	Le compte est en niveau gratuit	Passez à la version Plus pour accéder aux intégrations comptables
La synchronisation affiche 0 enregistrements envoyés	Aucune transaction dans la plage de dates configurée	Ajustez les dates de début et de fin de synchronisation pour couvrir la période souhaitée

Déconnecter un fournisseur

Pour supprimer une connexion :

1. Naviguez vers Finances → Connexions API
2. Sur la carte du fournisseur connecté, cliquez sur « Déconnecter »
3. Confirmez la déconnexion dans la boîte de dialogue
4. StockCraft révoque le jeton OAuth auprès du fournisseur (lorsqu'il est pris en charge) et supprime la connexion

Sécurité

• Les jetons OAuth sont chiffrés au repos à l'aide du chiffrement d'enveloppe KMS
• Les jetons ne sont jamais affichés dans l'interface utilisateur : seul un indicateur masqué confirme qu'un jeton est configuré
• Le rappel OAuth utilise la validation des paramètres d'état standard pour empêcher les attaques CSRF
• Les connexions Xero utilisent PKCE pour une sécurité supplémentaire lors du flux d'autorisation
• Toutes les communications d'API avec les fournisseurs utilisent le protocole HTTPS

soutien

Vous avez besoin d'aide pour les intégrations comptables ?

• Courrier électronique : support@stockcraft.org
• Incluez votre identifiant de locataire et le fournisseur concerné lorsque vous signalez des problèmes
• Les utilisateurs du plan Plus reçoivent des réponses prioritaires dans les 24 heures