OpenCart bağlama (köprü eklentisi)

OpenCart'ın çekirdeğinde ürün ve sipariş için hazır bir API yoktur. Bu yüzden sitenize küçük bir Senkronia köprü eklentisi kurulur; panel o eklentiyle konuşur.

Adım adım

1. Panelde Entegrasyonlar > OpenCart > Bağla ekranına girin.
2. Sürümünüze uygun eklenti paketini (OpenCart 3 veya 4) indirin.
3. OpenCart yöneticisi > Eklentiler > Yükleyici ile paketi yükleyin.
4. Eklentiler > Modüller listesinden Senkronia köprüsünü bulup düzenleyin ve etkinleştirin.
5. Ekranda görünen köprü adresini ve köprü anahtarını kopyalayın.
6. Panele dönüp bu iki değeri girin ve bağlantıyı kurun.

Bilinmesi gerekenler

• Anahtar gizlidir: köprü adresini bilen ama anahtarı bilmeyen kimse veri okuyamaz. Anahtarı paylaşmayın; şüphelenirseniz eklenti ekranından yenileyin ve panele yeni değeri girin.
• Sipariş durumları kimlik (id) ile eşlenir. OpenCart'ta durum adlarını değiştirebildiğiniz için panel, kanal Yönet ekranından hangi panel durumunun hangi OpenCart durumuna karşılık geldiğini yazmanıza izin verir.
• Fiyat ve KDV: OpenCart sipariş satırları KDV hariç + vergi satırı olarak gelir; panel bunları KDV dahil tutara çevirir. Bağlarken sorduğumuz varsayılan KDV oranı, mağazanız vergi bilgisi vermeyen ürünler için kullanılır — bu yüzden zorunludur (sonradan Yönet ekranından değiştirebilirsiniz).
• Yeni ürün gönderimi panelde şu an kapalıdır; ürünleri OpenCart'ta açıp panelle eşleştirirsiniz.

Sunucu güncellemesi yaparsanız

Eklenti site dosyalarınızda durur. OpenCart'ı taşır ya da yeniden kurarsanız eklentiyi tekrar kurmanız gerekir; indirme bağlantısı kanalın Yönet ekranında da durur.

Eklenti sürümü (1.7)

Bağlantıyı sınadığınızda panel, kurulu eklentinin sürümünü de söyler. Eskiyse ne yapmanız gerektiğini yazar; bir özelliği denerken hata almazsınız.

1.7 sürümü, panelin bugün kullandığından fazlasını taşır. Sebebi şu: yeni bir panel özelliği çıktığında sizden tekrar dosya yüklemenizi istemeyelim. Bu sürümle gelenler:

• Ürünü mağazada satışa açma/kapatma (stok adedine dokunmadan). Eskiden stok takibi kapalı üründe "satışa kapat" mağazaya iletilemiyordu.
• Ürün görselleri: panelde görsel yükleyip silince ya da sırasını değiştirince mağazadaki galeri panelle aynı olur (ilk görsel ana görsel). Görseller mağazanızın image/catalog/senkronia/ klasörüne indirilir; aynı görsel ikinci kez indirilmez. OpenCart'ta seçenek görseli olmadığı için varyant görselleri de ürün galerisine eklenir.
• Kategori ağacı, tek ürünün tam bilgisi, mağaza para birimi ve vergi ayarları.
• Ürün açma/güncelleme ve kargo takip numarasını sipariş geçmişine yazma.

Güncelleme, eklenti dosyalarını yenisiyle değiştirmektir; ayarlarınız ve anahtarınız korunur.

Kargo bedeli, kupon ve KDV (eklenti 1.6+)

Köprü eklentisinin 1.6 sürümü siparişin toplam satırlarını (kargo, kupon, hediye çeki, ödül puanı, vergi) da panele taşır. Panel kargo bedelini ve sipariş indirimini buradan okur; KDV kırılımı ve e-fatura ödenecek son tutar üzerinden hesaplanır. Eski sürümde bu satırlar gelmez; panel kargo ya da indirimi genel toplam ile kalem toplamının farkından türetir (fark artıysa kargo, eksiyse indirim). Kargo ve kuponun ikisi birden varsa ayrımı doğru görmek için eklentiyi 1.6 ile güncelleyin — dosyaları üzerine yüklemek yeter. Güncellemeden sonra yeni çekilen siparişler doğru gelir; mağazada sonradan değişen siparişlerin toplamları da taramada güncellenir.

Fatura bilgileri: TC kimlik / vergi no / vergi dairesi / firma unvanı (eklenti 1.2+)

OpenCart'ta bu bilgiler ödeme adımına eklenen özel alanlarda (Sistem > Özel Alanlar) ve firma unvanı OpenCart'ın kendi "Firma" kutusunda durur. Köprü eklentisinin 1.2 sürümü bu alanları siparişle birlikte panele taşır:

• Özel alan adlarından ("Vergi Numarası", "T.C. Kimlik No", "Vergi Dairesi" gibi) otomatik tanınır; siparişin fatura bilgisine ve müşteri kartına yazılır.
• Firma unvanı doluysa faturada isim-soyisim yerine unvan kullanılır; boşsa isim-soyisim devam eder. Vergi no/TC boşsa fatura bireysel e-Arşiv kesilir; vergi dairesi boşsa boş kalır.
• Hangi alanın eşleştiğini görmek ya da düzeltmek için: Kanal > Yönet > Fatura alanı eşleme > "Mağazadan alanları getir" — alanlar örnek değerleriyle listelenir, hatalıysa doğru olanı seçersiniz (listede yoksa elle yazın).
• Mağazanızda eklentinin eski sürümü kuruluysa panel "eklentiyi 1.2 ile güncelleyin" der — dosyaları üzerine yüklemek yeter, kaldırıp kurmanız gerekmez.

Sipariş durumu eşlemesi (eklenti 1.3+)

OpenCart'ta sipariş durumları mağazaya özeldir — yönetici kendi durumunu ekleyebilir ("Depoda Paketleniyor", "Kargoya Verildi" gibi) ve bunların kimlikleri her mağazada farklıdır. Panel tanımadığı bir durumu görürse siparişi "Yeni" sayar; yani kargoya verdiğiniz sipariş panelde bekliyormuş gibi görünür ve stoğunuzu rezervde tutar.

Kanal > Yönet ekranında:

• "Mağazadan durumları getir" deyin: mağazanızdaki bütün durumlar adıyla ve sipariş sayısıyla listelenir, her birinin şu an hangi panel durumuna alındığını görürsünüz.
• Panel, adından anlaşılanları ("kargo", "teslim", "iptal", "paketlen" geçenler) kendiliğinden eşler; emin olamadıklarını "TANINMIYOR" diye işaretler ve size bildirim gönderir. İade süreçleri bilerek tahmin edilmez — onları siz seçersiniz.
• Panelden mağazaya yazarken de aynı eşleme kullanılır: durumu bir kez tanıttıysanız ikinci kez yazmanız gerekmez. Farklı bir durum yazılmasını isterseniz listeden seçebilir ya da "elle yaz" ile kodu kendiniz girebilirsiniz.
• Eşlemeyi değiştirdiyseniz "Geçmiş sipariş durumlarını tazele" ile son 30 günün siparişlerini mağazanızdan yeniden okutabilirsiniz.

Eski eklenti sürümünde panel "eklentiyi 1.3 ile güncelleyin" der; dosyaları yüklemek yeter, kaldırıp yeniden kurmanıza gerek yoktur.

Siparişler anında düşer (eklenti 1.1+)

OpenCart'ın kendisinde anlık bildirim yoktur; bu özelliği Senkronia köprü eklentisi sağlar. Kanalı bağladığınızda panel bildirim adresini mağazanıza kendisi yazar ve eklenti gerekli OpenCart olay kaydını kendisi açar — mağaza tarafında elle ayar yapmanız gerekmez.

• Bir siparişin durumu değiştiğinde (yeni sipariş onaylandığında dahil) panel anında haber alır.
• Mağazanızda eklentinin 1.0 sürümü kuruluysa panel size "eklentiyi güncelleyin" der; bağlama ekranındaki indirme bağlantısından yeni paketi alıp dosyaların üzerine yükleyin. Kaldırıp yeniden kurmanız gerekmez.
• Bildirim gelmese bile sipariş kaçmaz: panel 5 dakikada bir mağazanızı yine yokluyor.
• Mağazanızın hızı etkilenmez — bildirim 3 saniyede zaman aşımına uğrar ve hatası yutulur, müşterinin siparişi her hâlükârda tamamlanır.