Sauter les liens

Importer des commandes de WooCommerce dans FileMaker

Interface FileMaker WooCommerce

Interface WooCommerce pour FileMakerLa boutique en ligne WooCommerce jouit d'une popularité croissante, notamment grâce à l'énorme diffusion des sites web basés sur WordPress. Il existe aujourd'hui d'innombrables plugins d'extension pour la plateforme WooCommerce et il n'est plus difficile de mettre en place WooCommerce pour l'Allemagne en toute sécurité juridique. WooCommerce dispose, comme de nombreux autres systèmes de boutiques en ligne et de sites web, d'une API RESTful permettant d'accéder aux données de la boutique en ligne. Dans cet article, nous présentons des instructions avec une petite solution FileMaker permettant de transférer les commandes d'une boutique en ligne WooCommerce dans une base de données FileMaker.Base de données peuvent être importées. La solution utilise pour cela l'API RESTful WooCommerce v3 et transforme le flux de données JSON fourni en données lisibles par FileMaker. Afin de faciliter la programmation des Interface Pour faciliter la connexion à l'API RESTful et la lecture des données JSON, le MBS Plugin FileMaker de Monkeybread Software. L'exemple de base de données est donné à titre d'exemple et peut en principe être utilisé pour d'autres systèmes de boutiques en ligne, comme par exemple Shopware, Magento ou Gambio GX3 peut être utilisé.

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.

Activer l'API REST dans WooCommerce

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é].

Créer une clé API WooCommerce

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].

Clé de l'API WooCommerce

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.

Interface FileMaker avec l'API REST de 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

Script FileMaker : 'ts.Query_REST_API'.

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.

Sous-script FileMaker 'Parser JSON

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.

Laisser un commentaire

  1. 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 ?

    1. 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.

  2. 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 ?

    1. 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.

      1. Très intéressant, sera-t-il nécessaire de mettre à jour votre exemple pour en tenir compte ?

        1. 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.

          1. As-tu l'intention de réaliser une version native de FMP 16 sans plugin MBS ?
            si oui, je suis très intéressé

          2. 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.

  3. 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

    1. 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.

    2. 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.

Partager cette page :

Un logiciel ERP aussi flexible que votre entreprise.
Nous nous ferons un plaisir de vous conseiller.

Logiciel ERP personnalisable pour Mac, Windows et iOS.

Vous êtes ici : Importer des commandes WooCommerce dans FileMaker via l'API RESTful