Bağlantıları atla

Siparişleri WooCommerce'den FileMaker'a aktarma

FileMaker WooCommerce arayüzü

FileMaker için WooCommerce arayüzüWooCommerce çevrimiçi mağazası, özellikle WordPress tabanlı web sitelerinin muazzam yayılımı sayesinde giderek daha popüler hale geliyor. WooCommerce platformu için artık sayısız eklenti mevcut ve Almanya için WooCommerce'i yasal olarak uyumlu bir şekilde kurmak artık sorun değil. Diğer birçok çevrimiçi mağaza ve web sistemi gibi, WooCommerce de çevrimiçi mağaza verilerine erişmek için kullanılabilecek bir RESTful API'ye sahiptir. Bu makalede, bir WooCommerce çevrimiçi mağazasından siparişleri bir FileMaker API'sine aktarmak için kullanılabilecek küçük bir FileMaker çözümü ile talimatlar sunuyoruz.Veritabanı içe aktarılabilir. Çözüm, WooCommerce RESTful API v3'ü kullanır ve sağlanan JSON veri akışını FileMaker tarafından okunabilecek verilere dönüştürür. Programlamayı basitleştirmek için Arayüz RESTful API ve JSON verilerini okumak için MBS FileMaker Eklentisi Monkeybread Software'den. Örnek veritabanı örnek niteliğindedir ve prensip olarak aşağıdaki gibi diğer çevrimiçi mağaza sistemleri için de kullanılabilir ShopwareMagento veya Gambio GX3 kullanılabilir.

WooCommerce RESTful API'ye giriş yapın

Bir WooCommerce online mağazasından veri okuyabilmek için öncelikle WooCommerce'de RESTful API'nin etkinleştirilmesi gerekir. Bu ayar WordPress arka ucunda şuradan yapılabilir [WooCommerce > Ayarlar] kayıt defterinde [API] yapılabilir.

WooCommerce'de REST API'yi Etkinleştirme

Düğmeye tıklayın [Değişiklikleri kaydet]arayüzün etkinleştirilmesini onaylamak için. Bir sonraki adımda, yeni bir API anahtarı oluşturun. Bunu yapmak için sekmeye tıklayın [Anahtar/Uygulamalar] ve ardından düğmesine tıklayın [Anahtar ekle].

WooCommerce API Anahtarı Oluşturma

Sahada [Açıklama] seçtiğiniz bir açıklama ekleyebilirsiniz. WooCommerce RESTful API'ye erişmek için yetkilendirilmesi gereken bir kullanıcı seçin. Kullanıcının arayüz üzerinden mağaza sistemine de veri yazıp yazmayacağına bağlı olarak, uygun yetkileri atayabilirsiniz. Burada sunulan FileMaker çözümü için "Oku" yetkisi yeterlidir. Ardından düğmeye tıklayın [API anahtarı oluştur].

WooCommerce API anahtarı

Şimdi "Anahtar (Tüketici Anahtarı)" ve "Tüketici Sırrı" alanlarının içeriğini not edin. Bu adım önemlidir çünkü anahtar veriler maskelenmiş biçimde saklandığından gelecekte bu alanların içeriğini görüntüleyemeyeceksiniz.

FileMaker'da WooCommerce REST API için arayüz

Bu makalede sunulan örnek çözüm, mağaza siparişlerini ve fatura ve teslimat adresleri gibi ilgili müşteri verilerini bir WooCommerce online mağazasından FileMaker veritabanına aktarmak için kullanılabilir. Örnek dosya (veya kendi çözümünüz) ek işlevler ve tablolar içerecek şekilde kolayca genişletilebilir. WooCommerce, RESTful API'ye erişmek için aşağıdaki uç noktaları sağlar:

  • Kuponlar
  • Müşteriler
  • Siparişler (örnek dosyada kullanılır)
  • Sipariş Notları
  • Para İadeleri
  • Ürünler
  • Ürün özellikleri
  • Ürün öznitelik terimleri
  • Ürün kategorileri
  • Ürün sevkiyat sınıfları
  • Ürün etiketleri
  • Raporlar
  • Vergi oranları
  • Vergi sınıfları

WooCommerce RESTful API ile, kuponlar, ürünler, ürün nitelikleri ve hatta vergi sınıfları gibi diğer birçok veri kaynağı da FileMaker ile okunabilir ve/veya işlenebilir. Örnek FileMaker çözümümüzde, siparişleri WooCommerce'den FileMaker'a aktarmak için "Orders" uç noktasını kullanıyoruz.

Örnek çözüm MBS FileMaker eklentisini gerektirir

Arayüzün geliştirilmesi için MBS FileMaker Eklentisi Monkeybread Software'den. Eklenti, RESTful API ile bir arayüz için gerekli tüm işlevleri sunar. Alternatif olarak, ücretsiz Temel Elemanlar Eklentisi yazılım buna göre yeniden programlanırsa.

FileMaker çözümündeki varsayılan ayarlar

Bir WooCommerce çevrimiçi mağazasının arayüzü için FileMaker çözümünün deneme sürümünü şu adresten indirebilirsiniz buradan indirin. Çözüm, .fmp12 formatı FileMaker 13 ila 15 içindir ve en az 4.4 sürümünde MBS FileMaker eklentisi gerektirir. Zip arşivini açtıktan ve çözümü FileMaker ile başlattıktan sonra, önce WooCommerce çevrimiçi mağazanızın RESTful API'si için verileri girmelisiniz.

WooCommerce REST API için FileMaker arayüzü

Sarı renkle vurgulanan alanlara tüm verileri girin:

  • API URL'SI - Sunucunuzun URL'si ve uzantısı /wp-api/v3
  • Bitiş noktası - Standart: /orders
  • Nesneyi başlat - Standart: siparişler
  • Tüketici anahtarı - WordPress arka ucunda oluşturduğunuz ve not ettiğiniz tüketici anahtarı
  • Tüketici Sırrı - WordPress arka ucunda oluşturduğunuz ve not ettiğiniz tüketici sırrı

Tüm veriler doğru bir şekilde girilmişse [Veri içe aktarma] Belirtilen WooCommerce çevrimiçi mağazasındaki tüm siparişleri ve ilgili müşteri verilerini içe aktarır.

FileMaker örnek veritabanının yapısı

Mağaza siparişlerini içe aktarmaya yönelik örnek veritabanı basit bir yapıya sahiptir ve aşağıdaki veri tablolarını içerir:

  • Siparişler - Bir siparişin ana veri kaydı, aşağıdaki alanları içerir:
    • __ORDERS ("orders" başlangıç nesnesinden alınan veriler, yalnızca açıklama amaçlıdır)
    • Sipariş numarası (WooCommerce'den sipariş numarası)
    • _ID_Fremdsystem (Birincil anahtar [post_id] WooCommerce'den)
    • _pk_Order_ID (birincil anahtar)
    • Açıklamalar (WooCommerce'den açıklamalar)
    • Sipariş durumu
    • Amount_total_gross
    • Amount_total_net
    • Tutar_KDV
    • Amount_VAT_items
    • Amount_VAT_shipping_costs
    • Tutar_İndirim
    • Tutar_Nakliye_Maliyetleri
    • Tutar_Alt Toplam
    • Tarih_Sipariş
    • E_Posta
    • JSON_Ausgabe (JSON verilerinin çıktısı için global alan, aşağıdaki durumlarda kullanılır Senaryo kullanılmış)
    • Customer_No_WC
    • LiAdr_Address (teslimat adresi)
    • LiAdr_Company
    • LiAdr_Country_code
    • LiAdr_Name
    • LiAdr_City
    • LiAdr_PLZ
    • LiAdr_first_name
    • KDV oranı
    • ReAdr_Address (fatura adresi)
    • ReAdr_Company
    • ReAdr_Country_Code
    • ReAdr_Name
    • ReAdr_City
    • ReAdr_PLZ
    • ReAdr_first_name
    • Status_paid
    • Telefon
    • Nakliye yöntemi
    • Para Birimi
    • Ödeme yöntemi
  • Pozisyonlar - Tablo sipariş kalemleri, aşağıdaki alanları içerir:
    • Sipariş numarası (WooCommerce'den sipariş numarası)
    • _pk_Position_ID (birincil anahtar)
    • Miktar
    • Makale_No
    • Makale açıklaması
    • Tutar_KDV
    • Tutar_net
    • id (WooCommerce'den birincil anahtar)
    • product_id (WooCommerce'deki ürünün kimliği)
  • Ayarlar - WooCommerce RESTful API için ayarlar
    • Harici sistem (Global) - Harici sistemin adı (yalnızca birden fazla harici sistem kullanılıyorsa kullanılır)
    • rf_URL (Global) - API'ye giden yolu içeren sunucu URL'si
    • rf_Benutzer (Global) - RESTful API için kullanıcı adı/tüketici anahtarı
    • rf_Password (Global) - Parola/Tüketici Sırrı
    • rf_Status_SSL (Global) - Durum, SSL'in kullanılıp kullanılmayacağı
    • rf_Endpoint (Global) - RESTful API'nin Uç Noktası
    • rf_Start nesnesi (Global) - Bitiş noktası içindeki başlangıç nesnesi

"Siparişler" ve "Kalemler" tabloları "_Sipariş numarası" anahtarıyla bağlantılıdır. Bu tablolardaki alanlar, kendi FileMaker çözümlerinize entegrasyon için gerektiği şekilde yeniden adlandırılabilir. Tüm alanlar global olarak tanımlandığı için "Ayarlar" tablosu bir bağlantı içermez. RESTful API ile birden fazla üçüncü taraf sistem bağlanacaksa, alanların global alanlar olarak tanımlanmaması ve üçüncü taraf sistemi seçmek için bir birincil anahtar eklenmesi önerilir.

RESTful API'ye giriş yapın

FileMaker örnek çözümü, online mağazadan sipariş verilerinin FileMaker'a aktarılabileceği iki kısmi komut dosyası içerir. "ts.Query_REST_API" komut dosyasında, çevrimiçi mağazaya giriş Sunucu. Bu amaçla, MBS eklentisi ilgili cURL fonksiyonlarını aşağıdaki sırayla çağırır:

  • Yeni cURL oturumu açın
  • REST API için URL ayarlama
  • Oturum açma verilerini ayarlama
  • Başlık seçeneğini ayarla
  • SSL'yi ayarla
  • Günlük mesajlarını açma
  • Hata mesajı ile sorguyu çalıştırma
  • Sahadaki sonuç [Orders::JSON_Output] yaz
  • cURL oturumunu kapat, Temizle

FileMaker Komut Dosyası: 'ts.Query_REST_API'

Arayüzden JSON verilerini okuma

İkinci alt simge "ts.Parse_JSON_Orders_WC" sunucu tarafından sağlanan JSON verilerini okur ve bunları "Orders" ve "Items" tablolarının ayrı alanlarına girer. "Siparişler" başlangıç nesnesindeki tüm veriler (ayarlardaki "Başlangıç nesnesi" alanına bakın) önce Değişken $ordersJSON yazılır. Bunu, tüm siparişleri okumak için bir ana yürütme döngüsü ve bir sipariş için tüm öğeleri içe aktarmak için bir başka yürütme döngüsü izler. Bu kodda sunucuya artık erişilmez.

FileMaker alt simgesi 'Parse JSON'

Sevkiyat adresi (shipping_address), fatura adresi (billing_address) ve satır kalemlerinin (line_items) tüm alanları bir ağaç yapısında bulunur ve komutla doldurulmalıdır:

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

ilgili ağaçtan okunabilir. Diğer tüm alanlar MBS( "JSON.GetStringValue"; json ) veya MBS( "JSON.GetIntegerValue"; json ) fonksiyonları kullanılarak normal şekilde okunabilir.

FileMaker örnek veritabanını indirin

FileMaker örnek veritabanını indirebilirsiniz buradan indirin ve herhangi bir WooCommerce çevrimiçi mağazasıyla test edin. Genel sürüm, alan tanımlarını ve komut dosyalarını düzenlemek için kilitlidir. Örnek çözümle hemen başlamak ve kendi gereksinimlerinize göre özelleştirmek ister misiniz? O zaman şunları yapabilirsiniz Bize ulaşın Bizimle birlikte.

Bir yorum bırakın

  1. Bu benim aradığım şeye benziyor. Diğer yol da mümkün mü? Yani değişiklikleri mysql DB'ye geri yazmak?

    1. Örnek çözümde kullanılan eklentiler doğal olarak verilerin RESTful API aracılığıyla WooCommerce veritabanına yazılmasını sağlayan ters işlemi de desteklemektedir.

  2. FMP 16'nın entegre RESTful API ve Json ile piyasaya sürülmesinden sonra, MBC eklentisi olmadan WC'ye bağlanmak artık mümkün olacak mı?

    1. Evet, FileMaker 16 ile artık MBS eklentisini kullanmadan da her şey mümkün olmalıdır. Ancak, çözüm yalnızca FileMaker 16'da çalışır ve daha eski sürümlerle çalışmaz.

      1. Çok ilginç, bunu dikkate almak için örneğinizi güncellemeniz gerekecek mi?

        1. Evet, işlevler yeni FileMaker 16 işlevleriyle yerel olarak çalışacaksa, MBS tabanlı işlevler buna göre yeniden programlanmalıdır.

          1. MBS eklentisi olmadan yerel bir FMP 16 sürümü gerçekleştirmeyi planlıyor musunuz?
            eğer öyleyse çok ilgileniyorum

          2. Hayır, bu tür işlevler için genellikle MBS eklentisini kullandığımdan, bu çözümün yerel bir FileMaker sürümünü geliştirme planım yok.

  3. Merhaba, mevcut demonun güncel Woocommerce sürümü ve fm 19 ile de çalışıp çalışmadığı konusunda herhangi bir deneyiminiz var mı? Teşekkür ederim

    1. Merhaba, yazılımın FileMaker 19 ile hiçbir sorunu olmamalıdır - ancak burada muhtemelen tümleşik kaynaklarla her şeyi çözebilirsiniz, o zaman artık MBS FileMaker eklentisine ihtiyacınız yoktur. Mağaza ile ilgili olarak, yazılım artık güncel değil ve daha yeni WooCommerce sürümleri için uyarlanması gerekebilir. Ancak bu, temel prensibi değiştirmez.

    2. Temel prensip, WooCommerce arayüzüne muhtemelen daha fazla alan eklenmesi dışında, geliştirmeden bugüne kadar değişmedi.

Bu sayfayı paylaşın:

Şirketiniz kadar esnek ERP yazılımı.
Size tavsiyede bulunmaktan memnuniyet duyarız.

Mac, Windows ve iOS için özelleştirilebilir ERP yazılımı.

Buradasınız: WooCommerce siparişlerini RESTful API aracılığıyla FileMaker'a aktarın