OpenCart API entegrasyonu, sipariş, stok, kargo ve muhasebe verilerini elle taşımak yerine sistemler arasında otomatik akıtmak için kurulur. Günde 5 siparişte elle takip yürür; 30 siparişte yürümez. Bu rehber hangi sistemlerin nasıl bağlandığını, nelerin ters gittiğini ve sağlıklı bir kurulumun neye benzediğini anlatıyor.
Ne zaman entegrasyon gerekiyor?
Şu belirtiler varsa manuel takip sınırına gelmişsiniz demektir:
- Sipariş bilgisi OpenCart'tan kargo paneline elle kopyalanıyor
- Stok, sitede ve muhasebe programında ayrı ayrı güncelleniyor
- Pazaryerinde satılan ürün sitede hâlâ stokta görünüyor
- Fatura kesmek için gün sonunda siparişler tek tek dökülüyor
- Müşteriye kargo takip numarası elle gönderiliyor
Bunların her biri ayda birkaç saatlik iş gibi görünüyor ama asıl maliyet hata: olmayan ürünü satmak, yanlış adrese kargo göndermek, faturayı eksik kesmek.
OpenCart hangi sistemlere bağlanır?
- Kargo firmaları: Barkod üretimi, takip numarası, teslim durumu
- Muhasebe ve e-fatura: Logo, Mikro, Netsis, Paraşüt, özel entegratörler
- Stok ve depo yazılımları: Merkezi stok, çoklu depo
- Pazaryerleri ve ERP: Trendyol, Hepsiburada, N11 ve kurumsal ERP sistemleri
- Bildirim servisleri: SMS ve e-posta
- CRM ve destek sistemleri: Müşteri geçmişi ve talep takibi
En sık kurulan dört akış
1. Sipariş → kargo
Sipariş onaylandığında kargo firmasında kayıt açılır, barkod üretilir, takip numarası siparişe yazılır ve müşteriye SMS gider. Doğru kurulduğunda sipariş başına 3–4 dakika kazandırıyor.
Dikkat: kargo firmasının API'si geçici olarak cevap vermediğinde sipariş kaybolmamalı. Sistem hatayı kaydetmeli, siparişi "kargo bekliyor" durumunda tutmalı ve tekrar denemeli.
2. Stok senkronizasyonu
Stok tek bir yerde "gerçek" olmalı — genelde muhasebe veya depo sistemi. Site ve pazaryerleri oradan besleniyor.
En sık hata: iki yönlü senkronizasyon kurup hangi sistemin doğruyu söylediğini tanımlamamak. Bu durumda iki sistem birbirinin verisini eziyor ve stok sürekli yanlış çıkıyor. Tek yönlü akış (merkez → kanallar) çoğu vakada daha güvenli.
3. Fatura ve muhasebe
Sipariş tamamlandığında e-arşiv fatura kesilir ve muhasebeye kaydedilir. Burada dikkat edilecek noktalar: iade ve iptal senaryosunda fatura durumu, kargo bedelinin faturada nasıl görüneceği, farklı KDV oranlı ürünlerin aynı siparişte olması.
4. Pazaryeri bağlantısı
Ürün, fiyat ve stok merkezden pazaryerine; sipariş pazaryerinden merkeze. Fiyat farklılaştırması (pazaryeri komisyonu yüzünden farklı fiyat) bu akışın en çok özelleştirme gerektiren kısmı. Detay: Trendyol entegrasyonu.
Entegrasyonda en çok ters giden 6 şey
- Hata yönetimi yok. API cevap vermediğinde ne olacağı tanımlanmamış; sipariş sessizce kayboluyor.
- Loglama yok. Bir sipariş aktarılmadığında nerede takıldığını görmenin yolu yok.
- Tekrar deneme yok. Geçici bir ağ hatası, kalıcı bir veri kaybına dönüşüyor.
- Test ortamı yok. Denemeler canlı sistemde yapılıyor, gerçek müşteriye gerçek SMS gidiyor.
- Veri alanları eşleşmemiş. İki sistemde farklı isimlendirilen alanlar (ör. ürün kodu vs. barkod) yanlış eşleşiyor.
- Yetki güvenliği zayıf. API anahtarı kod içinde sabit yazılmış, herkes erişebiliyor.
Bu altısı, entegrasyonun "çalışıyor gibi görünüp" aylar sonra fark edilen kayıplar üretmesinin sebebi.
Sağlıklı kurulum adımları
- Mevcut durumun incelenmesi: OpenCart sürümü, kurulu modüller, tema değişiklikleri. Eski sürümlerde önce güncelleme gerekebiliyor.
- Veri eşleme tablosu: Kaynak ve hedef sistemdeki her alan yazılı olarak eşleştirilir. Bu tablo olmadan yazılan entegrasyon her zaman sonradan düzeltiliyor.
- Test ortamı: Canlıya dokunmadan sipariş, stok güncelleme, iptal ve iade senaryoları denenir.
- Hata ve bildirim mekanizması: Aktarılamayan kayıtlar bir ekranda görünür ve sorumluya bildirim gider.
- Kademeli canlı geçiş: Önce tek kanal veya tek kargo firması. Sorun çıkarsa etkisi sınırlı kalır.
- İlk hafta yakın takip: İlk siparişlerin her biri elle doğrulanır.
Hazır eklenti mi, özel geliştirme mi?
Hazır eklentiler standart senaryolarda işe yarıyor: tek kargo firması, tek depo, standart fatura akışı, güncel OpenCart sürümü.
Özel geliştirme gerekiyorsa sebebi genelde şunlardan biri:
- Bayi veya toptan müşteriye farklı fiyat listesi
- Birden fazla depo ve depo bazlı stok
- ERP bağlantısı ve özel muhasebe alanları
- Sipariş öncesi özel onay akışı
- Ölçüye göre üretim veya varyant hesaplama
- Eski OpenCart sürümü üzerinde yapılmış tema/modül değişiklikleri
Bir de eklentilerin görünmeyen maliyeti var: her eklenti kendi güncelleme takvimine sahip ve OpenCart sürüm yükseltmelerinde uyumsuzluk çıkarıyor. Üç-dört eklentiyle kurulan bir sistemin bakımı, tek bir özel entegrasyondan zor olabiliyor.
Süre ve maliyet
| Kapsam | Süre | Bütçe |
|---|---|---|
| Tek yönlü tek akış (kargo veya fatura) | 1–2 hafta | 8.000–20.000 TL |
| Sipariş + stok + fatura üçlüsü | 3–5 hafta | 25.000–60.000 TL |
| ERP / muhasebe + çoklu pazaryeri | 6–10 hafta | 60.000–150.000 TL |
Değişkenlik büyük ölçüde hedef sistemin API kalitesinden geliyor. Belgelenmiş, güncel bir API ile çalışmak ile eski bir muhasebe programının veri tabanına doğrudan bağlanmak arasında 3 kat efor farkı olabiliyor.
Sık sorulan sorular
OpenCart yerine başka altyapıya geçmeli miyim?
Mevcut kurulumunuz çalışıyorsa hayır. Altyapı değiştirmek entegrasyon kurmaktan çok daha pahalı ve riskli. Geçiş kararını yalnızca performans veya sürüm desteği sorunları haklı çıkarır.
Entegrasyon sitemi yavaşlatır mı?
Doğru kurulduğunda hayır. Aktarımlar arka planda kuyruk üzerinden yapılmalı; sipariş kaydını API cevabını bekleyerek yapan kurulumlar hem yavaş hem kırılgan oluyor.
API anahtarları güvenli mi?
Kod içinde sabit yazılmamalı, ortam değişkeninde tutulmalı ve yetkileri gerektiği kadar dar olmalı.
Kaç kişi bu işi kullanacak?
Entegrasyonun amacı kullanıcı sayısını azaltmak. İyi kurulmuş bir akışta ekip yalnızca istisna durumlara bakıyor.
Kurulum için
Hangi sistemleri bağlamak istediğinizi ve OpenCart sürümünüzü yazın; kapsamı ve süreyi ücretsiz çıkarıyoruz. Genel entegrasyon yaklaşımımızı API entegrasyonu sayfasında, e-ticaret tarafını e-ticaret sitesi sayfasında anlattık.
Telefon / WhatsApp: +90 536 628 0007
E-posta: info@enextware.com