Intégration Shopify - Facturation automatique en Tunisie (bêta)
L'application Hesabi pour Shopify synchronise les commandes payées vers Hesabi et aligne votre catalogue par SKU de variante.
En bref - Shopify
- Application Shopify (version bêta) - installation via Partners
- Webhook orders/paid pour création document automatique
- Sync catalogue Hesabi → Shopify par SKU variante
- Journal de sync intégré dans l'app admin Shopify
- Plan Hesabi PRO ou CABINET + clé API requis
Fonctionnalités
Webhook commandes payées
Déclenchement automatique à la réception du paiement Shopify (contrairement au polling Woo v1).
Sync manuelle
Resynchronisez une commande par ID Shopify depuis l'interface de l'app.
Catalogue Hesabi → Shopify
Import des produits Hesabi dans Shopify avec correspondance par SKU variante.
Options fiscales
TVA par défaut, timbre, FODEC, validation et enregistrement paiement configurables.
OAuth Shopify
Authentification Shopify standard + clé API Hesabi dans les paramètres de l'app.
SDK TypeScript
Construit sur @hesabi/sdk pour une intégration API typée et maintenable.
Installation en 4 étapes
Créez une clé API Hesabi
Paramètres → Clés API. Copiez la clé (affichée une seule fois).
Installez le connecteur Shopify
Installez l'app via le lien Shopify (domaine boutique) ou l'App Store quand listé.
Configurez
Collez la clé et l'URL https://hesabi.tn/api/v1/org. Choisissez le type de document et le statut déclencheur.
Testez
Utilisez « Tester la connexion », puis passez une commande test.
FAQ
L'intégration Shopify est-elle en production ?
L'application est en version bêta (v0.1). Les fonctionnalités principales (settings, webhook orders/paid, sync log) sont disponibles ; l'App Store listing est en cours.
Comment installer l'app Shopify Hesabi ?
Via Shopify Partners et une boutique de développement ou production. Consultez la documentation GitHub hesabi-shopify pour la procédure CLI.
Quelle clé d'API utiliser ?
Générez une clé Org API (hsb_live_*) dans Hesabi Paramètres → Clés API et collez-la dans les paramètres de l'app Shopify Hesabi.
Prêt à connecter Shopify ?
Connecteur gratuit. Plan PRO ou CABINET avec accès API requis.