
Connexion à l'API RESTful WooCommerce
Pour pouvoir extraire des données d'une boutique en ligne WooCommerce, il faut d'abord activer l'API RESTful dans WooCommerce. Ce réglage peut être effectué dans le backend de WordPress sous [WooCommerce > Paramètres] dans le registre [API] peuvent être effectuées.
Cliquez sur le bouton [Sauvegarder les modifications]pour confirmer l'activation de l'interface. L'étape suivante consiste à créer une nouvelle clé API. Pour ce faire, cliquez sur l'onglet [Clés/Applications] puis sur le bouton [Ajouter une clé].
Sur le terrain [Description] vous pouvez ajouter une description de votre choix. Sélectionnez un utilisateur qui doit être autorisé à accéder à l'API RESTful WooCommerce. Selon que l'utilisateur doit également écrire des données dans le système de boutique via l'interface, vous pouvez attribuer les autorisations correspondantes. Pour la solution FileMaker présentée, l'autorisation "Lecture" est suffisante. Cliquez ensuite sur le bouton [Créer une clé API].
Notez maintenant le contenu des deux champs "Clé (Consumer Key)" et "Secret (Consumer Secret)". Cette étape est importante, car vous ne pourrez plus voir le contenu de ces champs à l'avenir, étant donné que les données de la clé sont enregistrées de manière masquée.
Interface dans FileMaker vers l'API REST de WooCommerce
L'exemple de solution présenté dans cet article permet de transférer les commandes d'une boutique en ligne WooCommerce et les données clients associées, telles que l'adresse de facturation et de livraison, dans une base de données FileMaker. Le fichier d'exemple (ou la solution personnelle) peut être facilement étendu à d'autres fonctions et tables. WooCommerce met à disposition les points finaux suivants pour l'accès à l'API RESTful :
- Coupons
- Clients
- Ordres (utilisés dans le fichier d'exemple)
- Notes de commande
- Refunds
- Produits
- Attributs du produit
- Termes d'attribut du produit
- Catégories de produits
- Classes d'expédition des produits
- Tags de produit
- Rapports
- Taux d'imposition
- Classes fiscales
Avec l'API RESTful WooCommerce, de nombreuses autres sources de données peuvent être lues et/ou modifiées avec FileMaker, comme par exemple les bons d'achat, les produits, les attributs de produits ou encore les classes de taxe. Dans notre exemple de solution FileMaker, nous utilisons le point final "Orders" pour importer des commandes de WooCommerce dans FileMaker.
Exemple de solution nécessitant le plugin MBS FileMaker
Pour le développement de l'interface, le fichier d'exemple a utilisé le Plugin MBS FileMaker de Monkeybread Software est utilisé. Le plugin offre toutes les fonctions nécessaires à une interface avec API RESTful. Il est également possible d'utiliser les fonctions du Plugin Base Elements si le logiciel est reprogrammé en conséquence.
Préférences dans la solution FileMaker
Vous pouvez télécharger la version d'essai de la solution FileMaker pour l'interface avec une boutique en ligne WooCommerce. télécharger ici. La solution se trouve dans le .format fmp12 pour FileMaker 13 à 15 et nécessite le plugin MBS FileMaker au moins dans sa version 4.4. Après avoir décompressé l'archive zip et démarré la solution avec FileMaker, vous devez d'abord saisir les données pour l'API RESTful de votre boutique en ligne WooCommerce.
Saisissez toutes les données dans les champs surlignés en jaune :
- URL DE L'API - URL de votre serveur et le suffixe /wp-api/v3
- Point final - Par défaut : /orders
- Objet de départ - Par défaut : orders
- Clé consommateur - Clé consommateur que vous avez créée et notée dans le backend de WordPress
- Consumer-Secret - Consumer Secret, que vous avez créé et noté dans le backend de WordPress
Si toutes les données ont été correctement saisies, en cliquant sur le bouton [Importation de données] toutes les commandes de la boutique en ligne WooCommerce indiquée et les données clients correspondantes sont importées.
Structure de la base de données FileMaker d'exemple
La base de données d'exemple pour l'importation des commandes de la boutique est structurée de manière simple et contient les tableaux de données suivants :
- Commandes - Enregistrement de données de base d'une commande, contient les champs suivants :
- __ORDERS (données de l'objet de départ "orders", à titre d'illustration uniquement)
- _numéro de commande (numéro de commande de WooCommerce)
- _ID_Système étranger (Clé primaire [post_id] de WooCommerce)
- _pk_Bestellung_ID (clé primaire)
- Remarques (remarques de WooCommerce)
- Statut de la commande
- Montant_total_brut
- Montant_total_net
- Montant_TVA
- Montant_TVA_Positions
- montant_TVA_frais_d'expédition
- Montant_Réduction
- montant_frais_d'expédition
- Montant_Sous-total
- date_commande
- E_Mail
- JSON_Sortie (champ global pour la sortie des données JSON, est utilisé dans le Script utilisé)
- client_numéro_WC
- LiAdr_Adresse (adresse de livraison)
- LiAdr_Société
- LiAdr_code_pays
- LiAdr_Name
- LiAdr_Lieu
- LiAdr_PLZ
- LiAdr_prénom
- Taux de TVA
- ReAdr_Adresse (adresse de facturation)
- ReAdr_Société
- ReAdr_Code pays
- ReAdr_Name
- ReAdr_Lieu
- ReAdr_PLZ
- ReAdr_prénom
- statut_payé
- Téléphone
- Méthode d'expédition
- Monnaie
- Méthode de paiement
- Positions - Tableau de postes de commande, contient les champs suivants :
- _numéro de commande (numéro de commande de WooCommerce)
- _pk_Position_ID (clé primaire)
- Nombre
- Article_numéro
- Désignation de l'article
- Montant_TVA
- Montant_net
- id (clé primaire de WooCommerce)
- product_id (ID du produit dans WooCommerce)
- Réglages - Paramètres de l'API RESTful WooCommerce
- Système tiers (global) - nom du système tiers (utilisé uniquement en cas d'utilisation de plusieurs systèmes tiers)
- rf_URL (Global) - URL du serveur avec chemin vers l'API
- rf_Utilisateur (Global) - Nom d'utilisateur/clé utilisateur pour RESTful API
- rf_Passwort (Global) - Mot de passe/Secret du consommateur
- rf_Status_SSL (Global) - Statut indiquant si SSL doit être utilisé ou non
- rf_Endpunkt (Global) - Point final de l'API RESTful
- rf_Startobjekt (Global) - Objet de départ à l'intérieur du point final
Les tables "Commandes" et "Positions" sont liées entre elles par la clé "_Numéro de commande". Pour l'intégration dans des solutions FileMaker personnalisées, les rubriques de ces tables peuvent être renommées à volonté. La table "Paramètres" ne contient pas de lien, car toutes les rubriques ont été définies globalement. Si plusieurs systèmes tiers doivent être connectés avec l'API RESTful, il est recommandé de ne pas définir les rubriques comme globales et d'ajouter une clé primaire pour sélectionner le système tiers.
Connexion à l'API RESTful
L'exemple de solution FileMaker contient deux sous-scripts qui permettent d'importer les données de commande de la boutique en ligne dans FileMaker. Dans le script "ts.Query_REST_API", il y a d'abord la connexion au Serveur. Pour ce faire, des fonctions cURL correspondantes sont appelées avec le plug-in MBS selon le déroulement suivant :
- Ouvrir une nouvelle session cURL
- Définir l'URL pour l'API REST
- Définir les données de connexion
- Définir l'option d'en-tête
- Définir le SSL
- Activer les messages de log
- Exécuter la requête avec message en cas d'erreur
- Résultat dans le champ [Commandes::Sortie JSON] écrire
- Fermer la session cURL, Cleanup
Lire les données JSON de l'interface
Le deuxième sous-script "ts.Parse_JSON_Bestellungen_WC" permet de lire les données JSON fournies par le serveur et de les saisir dans les différents champs des tableaux "Commandes" et "Positions". Pour ce faire, toutes les données de l'objet de départ "orders" (voir champ "Objet de départ" dans les paramètres) sont d'abord insérées dans les Variable $ordersJSON est écrite. Il est suivi d'une boucle d'exécution principale pour la lecture de toutes les commandes et d'une autre boucle d'exécution pour l'importation de tous les postes d'une commande. L'accès au serveur n'a plus lieu dans ce script.
Tous les champs de l'adresse de livraison (shipping_address), de l'adresse de facturation (billing_address) et des postes de document (line_items) se trouvent dans une structure arborescente et doivent être complétés par la commande :
MBS( "JSON.GetObjectItemTree" ; json ; names )
peuvent être extraits de l'arbre correspondant. Tous les autres champs peuvent être lus normalement avec les fonctions MBS( "JSON.GetStringValue" ; json ) ou MBS( "JSON.GetIntegerValue" ; json ).
Télécharger l'exemple de base de données FileMaker
Vous pouvez télécharger la base de données exemple FileMaker télécharger ici et le tester avec n'importe quelle boutique en ligne WooCommerce. La version publique est bloquée pour l'édition des définitions de champs et des scripts. Vous souhaitez démarrer immédiatement avec la solution d'exemple et l'adapter à vos propres exigences ? Dans ce cas, n'hésitez pas à prendre contact avec Contact avec nous.

Markus Schall développe depuis 1994 des bases de données individuelles, des interfaces et des applications commerciales sur la base de Claris FileMaker. Il est partenaire de Claris, lauréat du FMM-Award 2011 et développeur de la Logiciel ERP gFM-Business. Il est en outre auteur de livres et fondateur du M. Schall Verlags.







Cela semble correspondre à ce que je recherche. L'inverse est-il également possible ? C'est-à-dire réécrire les modifications dans la base de données mysql ?
Les plugins utilisés dans l'exemple supportent bien sûr aussi le chemin inverse, avec lequel les données peuvent être écrites dans la base de données WooCommerce via l'API RESTful.
Après la publication de FMP 16 avec API RESTful et Json intégrés, serait-il maintenant possible de se connecter à WC sans le plugin MBC ?
Oui, avec FileMaker 16, cela devrait être possible sans utiliser le plug-in MBS. La solution ne fonctionne toutefois que sur FileMaker 16 et pas sur les versions antérieures.
Très intéressant, sera-t-il nécessaire de mettre à jour votre exemple pour en tenir compte ?
Oui, si les fonctions doivent fonctionner de manière native avec les nouvelles fonctions FileMaker 16, les fonctions basées sur MBS doivent être reprogrammées en conséquence.
As-tu l'intention de réaliser une version native de FMP 16 sans plugin MBS ?
si oui, je suis très intéressé
Non, je n'ai pas l'intention de développer une version native FileMaker de cette solution, car j'utilise en principe le plug-in MBS pour ce genre de fonctions.
Bonjour, y a-t-il des expériences pour savoir si la démo actuelle fonctionne également avec la version actuelle de Woocommerce et fm 19 ? Merci
Bonjour, le logiciel ne devrait pas avoir de problème avec FileMaker 19 - mais dans ce cas, on pourrait probablement résoudre le problème avec les moyens du bord, on n'aurait alors plus obligatoirement besoin du plugin MBS FileMaker. En ce qui concerne la boutique, le logiciel n'est plus à jour et doit éventuellement être adapté aux nouvelles versions de WooCommerce. Le principe de base ne change cependant pas.
Bonjour ! Du point de vue du principe de base, rien n'a changé depuis le développement jusqu'à aujourd'hui, si ce n'est que d'autres champs ont éventuellement été ajoutés dans l'interface WooCommerce.