Mağaza
API ile sipariş al, ERP’de yönet.
Vitrin sitesi olmadan çalışan, API tabanlı ürün ve sipariş yönetimi. Kendi siten, sohbet botun ya da pazaryeri entegrasyonun ürünleri API’den okur ve siparişi doğrudan buraya bırakır. Kapıda ödeme, kargo seçenekleri ve ek ücretler mağaza ayarlarından yönetilir; siparişler Krowten ERP’de açılır.
Vitrin değil, sipariş altyapısı.
Her entegrasyona tek API.
Mağaza tek hesabınla, Workspace’teki diğer uygulamalarla birlikte çalışır.
Mağazayı aç ↗- 01
Ürün, fiyat ve stok API’si
Ürünlerini fiyatı, stok durumu, kategorisi ve varyant özellikleriyle API’den listele ya da ara. Fiyat ve stok Krowten ERP’deki kayıtlardan anlık okunur.
- 02
API ile sipariş oluşturma
Müşteri, adres, ürünler, ödeme yöntemi ve kargo seçimiyle tek istekte sipariş aç. Aynı dış sipariş numarası tekrar gelirse ikinci kayıt açılmaz.
- 03
Kapıda ödeme ve ödeme yöntemleri
Kapıda nakit, kapıda kart, havale/EFT ve ödeme bağlantısı gibi yöntemleri aç ya da kapat; kapıda ödeme hizmet bedeli siparişe ayrı satır olarak eklenir.
- 04
Kargo seçenekleri
Kargo firmalarını ücret, ücretsiz kargo eşiği ve tahmini teslim süresiyle tanımla. Seçilen kargonun ücreti sipariş tutarına göre otomatik hesaplanır.
- 05
Durum ve kargo takibi
Siparişler otomatik onaylanır; API’den “Kargoda”, “Teslim edildi” ya da “İptal” durumuna alınır, kargo takip numarası yazılır. Müşteri telefonuyla sorgulanabilir.
- 06
İmzalı sipariş bildirimleri
Sipariş oluşunca ve durumu değişince belirlediğin adrese imzalı bildirim gider. Siten ya da botun değişikliği anında öğrenir.
Mağaza API.
Siten, botun ya da entegrasyonun için.
Kimlik: Mağaza ayarlarından üretilen anahtar, her istekte X-Magaza-Anahtar başlığıyla. Anahtar yalnızca o mağazanın ürün ve siparişlerine erişir.
| Yöntem | Uç | Ne yapar |
|---|---|---|
GET | ayarlar | Aktif ödeme yöntemleri ve kargo seçenekleri (kod, ad, ücret, eşik, teslim süresi). |
GET | urunler | ara, sayfa, adet → ürün kodu, ad, fiyat, stok, kategori, varyant özellikleri. |
POST | siparis_olustur | musteri, urunler, odeme, kargo, adres, aciklama, dis_no → sipariş no, durum, toplam. |
GET | siparis | no ya da telefon → sipariş(ler), ürünler, ek ücretler, kargo takip no. |
POST | siparis_durum | no, durum (Onaylandı · Kargoda · Teslim edildi · İptal), kargo_takip_no. |
Taban adres: https://workspace.krowten.com.tr/api/method/suite.shop.magaza_api.<uç>
Sipariş oluşturma
curl -X POST https://workspace.krowten.com.tr/api/method/suite.shop.magaza_api.siparis_olustur \
-H "X-Magaza-Anahtar: km_…" \
--data-urlencode 'musteri={"ad":"Ayşe Yılmaz","telefon":"05320000000"}' \
--data-urlencode 'adres={"il":"İstanbul","ilce":"Kadıköy","adres":"…"}' \
--data-urlencode 'urunler=[{"kod":"TISORT-01","adet":2}]' \
--data-urlencode 'odeme=kapida_nakit' \
--data-urlencode 'kargo=standart' \
--data-urlencode 'dis_no=SITE-1001'Yanıt
{"message": {"siparis_no": "SAL-ORD-2026-00012", "durum": "Onaylandı",
"ara_toplam": 699.8, "toplam": 784.7,
"ek_ucretler": [{"aciklama": "Kargo (Standart kargo)", "tutar": 59.9},
{"aciklama": "Kapıda nakit ödeme hizmet bedeli", "tutar": 25.0}]}}Bildirim imzası
Bildirim gövdesi JSON olarak POST edilir. X-Magaza-Imza başlığı, gövdenin HMAC-SHA256 imzasıdır; imza anahtarı API anahtarının SHA-256 özetidir (hex).
Mağaza
hakkında.
Mağaza bir e-ticaret sitesi mi?+
Hayır. Ziyaretçiye açık bir vitrin yok; Mağaza, siparişleri API üzerinden alan ve Krowten ERP’de yöneten bir altyapı. Satışı kendi sitenden, sohbet botundan ya da başka bir kanaldan yaparsın.
API’ye nasıl bağlanırım?+
Workspace’te Mağaza ayarlarından “API anahtarı üret” ile anahtarını al ve her isteğe X-Magaza-Anahtar başlığıyla ekle. Anahtar yalnızca bir kez gösterilir; yenisi üretilince eskisi geçersiz olur.
Kapıda ödeme ve kargo ücretleri nasıl hesaplanır?+
Seçilen kargonun ücreti, sipariş tutarı ücretsiz kargo eşiğinin altındaysa eklenir; seçilen ödeme yönteminin hizmet bedeli varsa o da ayrı satır olarak siparişe yazılır.
Siparişler nerede görünür?+
Krowten ERP’de satış siparişi olarak açılır; ödeme yöntemi, kargo, mağaza durumu ve takip numarası siparişin üzerinde durur. Stok, fatura ve muhasebe ERP’den devam eder.