Salta i link

Importazione di ordini da WooCommerce a FileMaker

Interfaccia WooCommerce di FileMaker

Interfaccia WooCommerce per FileMakerIl negozio online WooCommerce sta diventando sempre più popolare, anche grazie all'enorme diffusione dei siti web basati su WordPress. Sono ormai disponibili innumerevoli plugin per la piattaforma WooCommerce e non è più un problema configurare WooCommerce per la Germania in modo conforme alla legge. Come molti altri negozi online e sistemi web, WooCommerce dispone di un'API RESTful che può essere utilizzata per accedere ai dati del negozio online. In questo articolo vi presentiamo una piccola soluzione FileMaker che può essere utilizzata per trasferire gli ordini da un negozio online WooCommerce a un'API FileMaker.Database possono essere importati. La soluzione utilizza l'API RESTful di WooCommerce v3 e converte il flusso di dati JSON fornito in dati leggibili da FileMaker. Per semplificare la programmazione del Interfaccia l'API RESTful e per la lettura dei dati JSON, l'MBS Plugin FileMaker di Monkeybread Software. Il database di esempio è esemplare e in linea di principio può essere utilizzato anche per altri sistemi di negozi online, come ad esempio Articoli per negoziMagento o Gambio È possibile utilizzare il GX3.

Accesso all'API REST di WooCommerce

Per poter leggere i dati da un negozio online WooCommerce, l'API RESTful deve essere attivata in WooCommerce. Questa impostazione può essere effettuata nel backend di WordPress alla voce [WooCommerce > Impostazioni] nel registro [API] può essere realizzato.

Attivare l'API REST in WooCommerce

Fare clic sul pulsante [Salva le modifiche]per confermare l'attivazione dell'interfaccia. Nella fase successiva, creare una nuova chiave API. Per farlo, fare clic sulla scheda [Chiave/Applicazioni] e poi fare clic sul pulsante [Aggiungi chiave].

Creare la chiave API di WooCommerce

Sul campo [Descrizione] è possibile aggiungere una descrizione a scelta. Selezionare un utente che deve essere autorizzato ad accedere all'API RESTful di WooCommerce. A seconda che l'utente debba anche scrivere dati nel sistema del negozio tramite l'interfaccia, è possibile assegnare le autorizzazioni appropriate. L'autorizzazione "Read" è sufficiente per la soluzione FileMaker qui presentata. Fare quindi clic sul pulsante [Crea chiave API].

Chiave API WooCommerce

Ora annotate il contenuto dei due campi "Key (Consumer Key)" e "Consumer Secret". Questo passaggio è importante perché in futuro non sarà più possibile visualizzare il contenuto di questi campi, poiché i dati delle chiavi sono memorizzati in forma mascherata.

Interfaccia in FileMaker con l'API REST di WooCommerce

La soluzione di esempio presentata in questo articolo può essere utilizzata per trasferire gli ordini del negozio e i dati dei clienti associati, come gli indirizzi di fatturazione e di consegna, da un negozio online WooCommerce a un database FileMaker. Il file di esempio (o la vostra soluzione) può essere facilmente ampliato per includere ulteriori funzioni e tabelle. WooCommerce fornisce i seguenti endpoint per accedere all'API RESTful:

  • Buoni sconto
  • Clienti
  • Ordini (utilizzati nel file di esempio)
  • Note sull'ordine
  • Rimborsi
  • Prodotti
  • Attributi del prodotto
  • Termini degli attributi del prodotto
  • Categorie di prodotti
  • Classi di spedizione dei prodotti
  • Tag del prodotto
  • Rapporti
  • Aliquote fiscali
  • Classi fiscali

Con l'API RESTful di WooCommerce, anche molte altre fonti di dati possono essere lette e/o elaborate con FileMaker, come ad esempio buoni, prodotti, attributi di prodotti o persino classi fiscali. Nella nostra soluzione FileMaker di esempio, utilizziamo l'endpoint "Ordini" per importare gli ordini da WooCommerce a FileMaker.

La soluzione di esempio richiede il plugin MBS FileMaker

Per lo sviluppo dell'interfaccia, il Plugin MBS FileMaker di Monkeybread Software. Il plugin offre tutte le funzioni necessarie per un'interfaccia con API RESTful. In alternativa, le funzioni del programma gratuito Plugin Elementi di base se il software viene riprogrammato di conseguenza.

Impostazioni predefinite nella soluzione FileMaker

È possibile scaricare la versione di prova della soluzione FileMaker per l'interfaccia con un negozio online WooCommerce all'indirizzo scarica qui. La soluzione sta nel .formato fmp12 per FileMaker da 13 a 15 e richiede il plugin MBS FileMaker almeno nella versione 4.4. Dopo aver scompattato l'archivio zip e aver avviato la soluzione con FileMaker, è necessario inserire i dati per l'API RESTful del vostro negozio online WooCommerce.

Interfaccia FileMaker per l'API REST di WooCommerce

Inserire tutti i dati nei campi evidenziati in giallo:

  • URL API - URL del vostro server e l'estensione /wp-api/v3
  • Punto finale - Standard: /ordini
  • Oggetto iniziale - Standard: ordini
  • Chiave del consumatore - Chiave del consumatore che avete creato e annotato nel backend di WordPress
  • Segreto del consumatore - Il segreto del consumatore creato e annotato nel backend di WordPress

Se tutti i dati sono stati inseriti correttamente, cliccando sul pulsante [Importazione dati] importa tutti gli ordini dal negozio online WooCommerce specificato e i relativi dati dei clienti.

Struttura del database di esempio FileMaker

Il database di esempio per l'importazione degli ordini del negozio ha una struttura semplice e contiene le seguenti tabelle di dati:

  • Ordini - Il record dei dati anagrafici di un ordine contiene i seguenti campi:
    • __ORDERS (dati dell'oggetto iniziale "orders", solo a scopo illustrativo)
    • Numero d'ordine (numero d'ordine da WooCommerce)
    • _ID_Fremdsystem (Chiave primaria [post_id] da WooCommerce)
    • _pk_Order_ID (chiave primaria)
    • Osservazioni (osservazioni da WooCommerce)
    • Stato dell'ordine
    • Importo_totale_lordo
    • Importo_totale_netto
    • Importo_IVA
    • Importo_VAT_voci
    • Importo_IVA_costi_di_spedizione
    • Importo_sconto
    • Importo_Costi di spedizione
    • Importo_Subtotale
    • Data_Ordine
    • E_Mail
    • JSON_Ausgabe (campo globale per l'output dei dati JSON, viene utilizzato nel file Scrittura usato)
    • Cliente_No_WC
    • LiAdr_Address (indirizzo di consegna)
    • Azienda_LiAdr
    • Codice_paese_LiAdr
    • Nome_LiAdr
    • LiAdr_Città
    • LiAdr_PLZ
    • LiAdr_nome_di_cognome
    • Aliquota IVA
    • ReAdr_Address (indirizzo di fatturazione)
    • Azienda_ReAdr
    • Codice paese ReAdr
    • Nome_Readr
    • ReAdr_Città
    • ReAdr_PLZ
    • Nome_Readr
    • Stato_pagato
    • Telefono
    • Metodo di spedizione
    • Valuta
    • Metodo di pagamento
  • Posizioni - Tabella degli articoli dell'ordine, contiene i seguenti campi:
    • Numero d'ordine (numero d'ordine da WooCommerce)
    • _pk_Position_ID (chiave primaria)
    • Quantità
    • Articolo_No
    • Descrizione dell'articolo
    • Importo_IVA
    • Importo_netto
    • id (chiave primaria di WooCommerce)
    • product_id (ID del prodotto in WooCommerce)
  • Impostazioni - Impostazioni per l'API REST di WooCommerce
    • Sistema esterno (Globale) - Nome del sistema esterno (utilizzato solo se si utilizzano più sistemi esterni)
    • rf_URL (globale) - URL del server con il percorso dell'API
    • rf_Benutzer (Globale) - Nome utente/chiave di consumo per l'API RESTful
    • rf_Password (globale) - Password/Segreto del consumatore
    • rf_Status_SSL (Globale) - Stato, se SSL deve essere usato o meno
    • rf_Endpoint (globale) - Endpoint dell'API RESTful
    • Oggetto rf_Start (globale) - Oggetto di avvio all'interno del punto finale

Le tabelle "Ordini" e "Articoli" sono collegate tramite la chiave "_Numero d'ordine". I campi di queste tabelle possono essere rinominati come richiesto per l'integrazione nelle proprie soluzioni FileMaker. La tabella "Impostazioni" non contiene un collegamento perché tutti i campi sono stati definiti a livello globale. Se si vogliono collegare diversi sistemi di terze parti con API RESTful, si consiglia di non definire i campi come campi globali e di aggiungere una chiave primaria per selezionare il sistema di terze parti.

Accesso all'API RESTful

La soluzione campione di FileMaker contiene due script parziali che possono essere utilizzati per importare i dati degli ordini dal negozio online in FileMaker. Nello script "ts.Query_REST_API", l'accesso al sito web di FileMaker è stato effettuato in base a una serie di criteri. Server. A questo scopo, il plugin MBS chiama le funzioni cURL corrispondenti con la seguente sequenza:

  • Aprire una nuova sessione cURL
  • Impostare l'URL per l'API REST
  • Impostare i dati di accesso
  • Impostare l'opzione di intestazione
  • Imposta SSL
  • Attivare i messaggi di log
  • Esecuzione della query con messaggio di errore
  • Risultato nel campo [Orders::JSON_Output] scrivere
  • Chiudere la sessione cURL, pulire

Script FileMaker: 'ts.Query_REST_API'

Leggere i dati JSON dall'interfaccia

Il secondo pedice "ts.Parse_JSON_Orders_WC" legge i dati JSON forniti dal server e li inserisce nei singoli campi delle tabelle "Ordini" e "Articoli". Tutti i dati dell'oggetto iniziale "Ordini" (vedere il campo "Oggetto iniziale" nelle impostazioni) vengono prima trasferiti alla tabella "Ordini". Variabile $ordersJSON viene scritto. Segue un ciclo di esecuzione principale per leggere tutti gli ordini e un altro ciclo di esecuzione per importare tutti gli articoli di un ordine. In questo script non si accede più al server.

Sottoscritto FileMaker 'Analizzare JSON'

Tutti i campi dell'indirizzo di spedizione (shipping_address), dell'indirizzo di fatturazione (billing_address) e degli articoli (line_items) si trovano in una struttura ad albero e devono essere compilati con il comando:

MBS( "JSON.GetObjectItemTree"; json; nomi )

possono essere letti dall'albero corrispondente. Tutti gli altri campi possono essere letti normalmente utilizzando le funzioni MBS( "JSON.GetStringValue"; json ) o MBS( "JSON.GetIntegerValue"; json ).

Scarica il database di esempio di FileMaker

È possibile scaricare il database di esempio di FileMaker scarica qui e testarlo con qualsiasi negozio online WooCommerce. La versione pubblica è bloccata per la modifica delle definizioni dei campi e degli script. Volete iniziare subito a utilizzare la soluzione di esempio e personalizzarla in base alle vostre esigenze? Allora siete invitati a Contattateci con noi.

Lascia un commento

  1. Sembra proprio quello che sto cercando. È possibile anche il contrario? Quindi scrivere le modifiche nel DB mysql?

    1. I plugin utilizzati nella soluzione di esempio supportano naturalmente anche il metodo inverso, che consente di scrivere i dati nel database di WooCommerce tramite l'API RESTful.

  2. Dopo il rilascio di FMP 16 con API RESTful e Json integrate, sarebbe ora possibile connettersi a WC senza il plugin MBC?

    1. Sì, con FileMaker 16 il tutto dovrebbe essere possibile anche senza utilizzare il plugin MBS. Tuttavia, la soluzione funziona solo con FileMaker 16 e non con le versioni precedenti.

      1. Molto interessante, sarà necessario aggiornare l'esempio per tenerne conto?

        1. Sì, se le funzioni devono funzionare in modo nativo con le nuove funzioni di FileMaker 16, le funzioni basate su MBS devono essere riprogrammate di conseguenza.

          1. Avete intenzione di realizzare una versione nativa di FMP 16 senza il plugin MBS?
            Se è così sono molto interessato

          2. No, non ho in programma di sviluppare una versione nativa di FileMaker di questa soluzione, poiché in genere utilizzo il plugin MBS per queste funzioni.

  3. Ciao, c'è qualche esperienza se la demo attuale funziona anche con l'attuale versione di Woocommerce e fm 19? Grazie

    1. Salve, il software non dovrebbe avere problemi con FileMaker 19 - ma in questo caso si potrebbe probabilmente risolvere il tutto con le risorse di bordo, quindi non è più necessario il plugin MBS FileMaker. Per quanto riguarda il negozio, il software non è più aggiornato e potrebbe essere necessario adattarlo alle nuove versioni di WooCommerce. Tuttavia, questo non cambia il principio di base.

    2. Il principio di base non è cambiato dallo sviluppo a oggi, tranne per il fatto che sono stati aggiunti altri campi all'interfaccia di WooCommerce.

Condividi questa pagina:

Un software ERP flessibile come la vostra azienda.
Saremo lieti di consigliarvi.

Software ERP personalizzabile per Mac, Windows e iOS.

Siete qui: Importare gli ordini di WooCommerce in FileMaker tramite API RESTful