Shopify

Shopify mağazaları API bağlantısıyla doğrudan bağlanır: ürünler ve koleksiyonlar, siparişler (durum, kargo takibi, müşteri telefonu) ve müşteriler zamanlanmış senkronla düzenli olarak eşitlenir.

Bağlayıcı hakkında

Shopify GraphQL Admin API’si kullanılır (API sürümü 2026-07). OAuth yönlendirmesi yoktur; mağazanın kendi uygulamasıyla çalışır.
İki kimlik yolu: Dev Dashboard uygulamasının Client ID + Client secret’ı (belirteç “client credentials” ile alınır, yaklaşık 24 saat geçerlidir ve kendiliğinden yenilenir) ya da 1 Ocak 2026’dan önce yönetim panelinde oluşturulmuş özel uygulamanın Admin API erişim belirteci (shpat_…).
Mağaza adresi ad.myshopify.com biçiminde olmalıdır (özel alan adınız değil); istekler yalnız bu adrese gider.
Shopify’ın sorgu maliyeti sınırı izlenir; kova yetmezse gereken süre kadar beklenir, kısıtlanan istek yeniden denenir. Yanıtta herhangi bir hata varsa o sorgu başarısız sayılır; tam senkron eksik veriyle kayıt silmez.
Konsolda alanlar: Mağaza adresi, İstemci kimliği (Client ID), Gizli anahtar (Client secret), Admin API erişim belirteci. Belirteç ya da istemci kimliği + gizli anahtar çiftinden biri zorunludur.

Aşağıdaki adımlar ve doğrulama işaretleri, ürünün kurulum sihirbazında gösterdiği ön ayardan birebir alınır. Belgeden doğrulanmadı işaretli bir adım ya da bilgi, altyapının herkese açık belgesinde görülemedi; panelinizde kontrol edin.

Özet: API ile doğrudan bağlantı: ürün, sipariş, kargo, müşteri.
Önerilen yol: API bağlantısı
Kullanılabilir yollar: API bağlantısı · XML-CSV bağlantısı (veri akışı) · API ile gönderim (Veri API) · Elle yükleme
Araştırma tarihi: 2026-09-26

Neler doğrulandı

Aşağıdaki her bilgi ya altyapının herkese açık belgesinde görülüp doğrulandı ya da doğrulanamadı. Doğrulanmayanlar yine kullanılabilir; ancak güvenmeden önce önizlemede kontrol edin.

✓ Belgede doğrulandı API
✓ Belgede doğrulandı kimlik doğrulama
✓ Belgede doğrulandı sipariş durumları
! Belgeden doğrulanmadı akış adresi
! Belgeden doğrulanmadı dosya biçimi
! Belgeden doğrulanmadı kayıt yolu
! Belgeden doğrulanmadı alan adları
! Belgeden doğrulanmadı webhook'lar
! Belgeden doğrulanmadı panel menü yolları

API bağlantısıönerilen

Yeni kurulum: Shopify Dev Dashboard'da (dev.shopify.com) bir uygulama oluşturun; uygulama sürümünde read_products, read_inventory, read_orders ve read_customers izinlerini seçip uygulamayı mağazanıza kurun.
Uygulamanın Ayarlar sayfasındaki Client ID ve Client secret değerlerini sihirbazdaki forma girin. Belirteç günlük olarak otomatik yenilenir.
1 Ocak 2026'dan önce Shopify yönetim panelinde oluşturulmuş bir özel uygulamanız varsa, onun Admin API erişim belirtecini (shpat_…) de kullanabilirsiniz; o zaman Client ID/secret gerekmez.
Mağaza adresini ad.myshopify.com biçiminde yazın (özel alan adınız değil), kaydedin ve 'Bağlantıyı test et'e basın.
Shopify izin verilmedikçe yalnız son 60 günün siparişlerini verir; daha eskiler için uygulamaya read_all_orders izni ekleyin.

XML-CSV bağlantısı (veri akışı)

Shopify'ın yerleşik bir ürün XML adresi yok. Bir ürün feed uygulamasının ürettiği Google Merchant XML adresini yapıştırın. ! Belgeden doğrulanmadı
Siparişler XML ile gelmez; sipariş sorguları için API bağlantısını kullanın.

API ile gönderim (Veri API)

Sihirbazda (ya da Ayarlar → API anahtarları’nda) gizli API anahtarını oluşturun ve yazılımcınıza/entegratörünüze güvenli bir kanaldan iletin.
Shopify tarafındaki entegrasyon ürünleri PUT /api/v1/catalog/products, siparişleri PUT /api/v1/orders, müşterileri PUT /api/v1/musteriler uçlarına gönderir (örnekler Veri API sayfasında).
Siparişte durum, kargo firması, takip numarası ve müşteri telefonu gönderilirse asistan arayanı telefonundan tanır ve kargo sorusunu yanıtlar.

Elle yükleme

Altyapınızın panelinden ürün listesini CSV ya da XML olarak dışa aktarın.
Dosyayı sihirbaza yükleyin; sütunlar otomatik eşlenir, gerekirse düzeltin.
Elle yükleme tek seferliktir: fiyat ve stok değiştikçe yeniden yükleyin ya da XML bağlantısına geçin.

Akış şablonu

Ürün akışı (Google Merchant XML)

Biçim

google_merchant ! Belgeden doğrulanmadı

Adres kalıbı

Belgede yok — adresi panelden kopyalayın.

Bilinen alan adları

item_ref ← g:id, id, g:item_group_id
urun_kodu ← g:mpn, g:gtin, sku

! Belgeden doğrulanmadı

Bilinen alan adları yalnız dosyanızda gerçekten varsa uygulanır; eşleşmeyen ad hiçbir şey yapmaz. Eşleme, içe aktarmadan önce her zaman önizlemede gösterilir.

Sipariş durumu eşlemesi

Altyapıdan gelen durum değerleri standart kısa adlara, firmanızın aynı gruptaki kendi durumu varsa ona eşlenir. Bilinmeyen değerler eşlenmez ve size gösterilir.

Altyapı değeri	Standart kısa ad
`pending`	`pending`
`cash_on_delivery`	`processing`
`paid`	`processing`
`partially_fulfilled`	`processing`
`fulfilled`	`shipped`
`in_transit`	`shipped`
`delivered`	`delivered`
`delivery_failed`	`shipped`
`cancelled`	`cancelled`
`refunded`	`refunded`
`authorized`	`processing`
`partially_paid`	`processing`
`partially_refunded`	`processing`
`voided`	`cancelled`
`expired`	`cancelled`

Notlar

İstemci kimliğiyle belirteç alma yalnız uygulama ile mağaza aynı Shopify organizasyonundaysa çalışır. İstekler yalnız ad.myshopify.com adresine gider.

Altyapı belgeleri

Ana site Destek [email protected]