API SCALERP

Connectez un logiciel métier aux données de l’entreprise par HTTPS. Le connecteur expose des ressources REST et échange des données au format JSON.

Authentifier l’intégration

Une fois le connecteur activé et l’accès autorisé, envoyez le jeton dans l’en-tête Authorization avec le préfixe Bearer. Conservez le jeton côté serveur. Commencez par lire l’utilisateur connecté pour vérifier l’identité associée à l’intégration. GET /connector/api/user/loggedin

Lire le catalogue

Récupérez les établissements, puis interrogez les produits du site voulu avec le filtre location_id. Pour un premier essai, limitez la page à dix produits. Parcourez les pages suivantes pour traiter le catalogue complet. GET /connector/api/product?per_page=10

Créer ou rapprocher une opération

Le connecteur permet notamment de lire et créer des contacts, des ventes et des dépenses. Pour relier une vente externe à son client, identifiez d’abord le contact puis rapprochez la réponse de SCALERP de la référence du système source. GET /connector/api/contactapi · GET /connector/api/sell

Vérifier une erreur

Si l’authentification échoue, vérifiez le domaine et la validité du jeton. Après une interruption réseau pendant une création, recherchez l’opération avant de renvoyer la demande. Pour le support, communiquez la méthode, le chemin et le statut HTTP en masquant le jeton.