Akinon siparişleri

Akinon kullanan bir mağazada siparişlerin Sayproof’a ulaşması için kod yazılması gerekmez. Sayproof, sizin açtığınız bir Omnitron kullanıcısıyla Omnitron’a bağlanır ve yeni ya da değişen siparişleri belli aralıklarla (varsayılan olarak 15 dakikada bir) kendisi okur. Okunan siparişler, mağaza sisteminden gönderilen siparişlerle aynı biçimde kaydedilir; yorum yazma hakkı ve davetler aynı kurallarla çalışır.

Ne zaman kullanılır

• Mağazanız Akinon (Omnitron) üzerindeyse bu sayfadaki bağlantıyı kurun.
• Hazır bağlantısı olmayan bir sistem kullanıyorsanız siparişleri mağaza sisteminiz gönderir: Sipariş ve teslimat aktarımı.

Panelde iki yol Entegrasyon › Sipariş aktarımı sekmesinde alt alta gösterilir: Platformdan okuma ve Mağazadan gönderim.

Gerekenler

Bilgi	Açıklama
Omnitron adresi	Omnitron’a girerken kullandığınız adres, örneğin https://omnitron.markaniz.com. Yalnızca alan adı kullanılır; adrese yol yazılmışsa atılır. Kullanıcı bilgisi, sorgu dizesi ya da # içeren adres kabul edilmez.
Omnitron kullanıcı adı ve parolası	Bu iş için açılmış, yalnızca siparişleri görebilen ayrı bir kullanıcı. Kendi yönetici hesabınızı kullanmayın; ayrı kullanıcıyı istediğiniz an kapatabilirsiniz.
Omnitron kanal numarası	Siparişlerin okunacağı satış kanalının Omnitron’daki numarası; yalnızca rakamdan oluşur. Bilmiyorsanız Akinon ekibiniz söyleyebilir.
Sayproof kanalı	Okunan siparişlerin yazılacağı kanal. Siparişin pazarı bu kanalın pazarıdır.

Bir Sayproof kanalı için her platformda tek bağlantı kurulabilir.

Panelde kurulum

1. Entegrasyon › Sipariş aktarımı sekmesinin Platformdan okuma bölümünde Bağlantı kur düğmesine basın.
2. Nereden okunacak adımında platform olarak Akinon (Omnitron) seçeneğini ve Sayproof kanalını seçin.
3. Bağlantı bilgileri adımında Omnitron adresi, Omnitron kanal numarası, Omnitron kullanıcı adı ve Omnitron parolası alanlarını doldurun. İlk okumada kaç gün geriye gidilsin alanı 1 ile 365 arasında bir değer alır; varsayılan 30 gündür.
4. Deneyin adımında Bağlantıyı dene düğmesine basın. Sayproof Omnitron’a bağlanır ve seçilen gün sayısı içindeki siparişlerin ilk sayfasını (en fazla 100 sipariş) okur. Sonuçta okunan sipariş sayısı, okunamayan siparişler ve en fazla beş örnek sipariş gösterilir: Sipariş no, Sipariş tarihi, Ödeme, Ürün sayısı, Kargo durumu, E-posta var mı. Müşteri e-posta adresi gösterilmez. Bu adımda hiçbir şey kaydedilmez.
5. Kaydet ve okumayı başlat düğmesi yalnızca başarılı bir denemeden sonra açılır. Deneme sonrasında bir bilgi değiştirilirse bağlantı yeniden denenmelidir.

Kayıttan sonra bağlantı Platform bağlantıları kartında görünür. Kartta Okuma sıklığı, Son okuma, Son okumada (okunan ve yeni gelen sipariş sayısı), Okunamayan ve Son hata bilgileri yer alır. Düğmeler:

Düğme	İşlevi
Şimdi oku	Sıradaki okumayı beklemeden okumayı başlatır. Duraklatılmış bağlantıda ve kanal kapalıyken kullanılamaz.
Bağlantıyı dene	Kayıtlı bilgilerle denemeyi tekrarlar; hiçbir şey kaydetmez.
Duraklat / Sürdür	Okumayı durdurur ya da yeniden başlatır.
Bağlantıyı düzenle	Omnitron adresi, Omnitron kanal numarası ve Okuma sıklığı (5 ile 1440 dakika arası) değiştirilir. Okuma kaldığı yerden sürer; daha önce aktarılan siparişler yeniden okunmaz. Adres başka bir sunucuyu gösteriyorsa Omnitron kullanıcı adı ve Omnitron parolası da aynı formda yeniden girilir; kayıtlı giriş bilgileri yeni adrese gönderilmez (400 invalid / address_needs_credentials). Sayproof kanalı bu formda değişmez.
Giriş bilgilerini değiştir	Yeni parolayı kaydeder; kullanıcı adı boş bırakılırsa mevcut kullanıcı adı korunur.
Bağlantıyı kaldır	Okumayı sonlandırır. Daha önce okunan siparişler ve gönderilen davetler silinmez.

Okuma

• Okuma varsayılan olarak 15 dakikada bir yapılır; sıklık Bağlantıyı düzenle ile 5 ile 1440 dakika arasında değiştirilebilir. İlk okuma, değişiklik zamanı seçilen gün sayısı içinde kalan siparişleri alır.
• Sonraki okumalar, bir önceki okumanın başladığı andan 10 dakika öncesine kadar değişen siparişleri alır. Aynı siparişin tekrar okunması güvenlidir: sipariş güncellenir, kopyası oluşmaz.
• Bir bağlantı için aynı anda tek okuma çalışır.
• Bir okuma en fazla 50 sayfa (sayfa başına 100 sipariş) alır. Siparişler bitmeden sınıra ulaşılırsa kartta “Son okuma sayfa sınırına takıldı” notu görünür ve sonraki okuma son okunan siparişin değişiklik zamanından (10 dakika payla) devam eder.
• Okuma başarısız olursa kaldığı yer ilerlemez; sonraki okuma, okuma sıklığı kadar sonra aynı aralığı yeniden dener ve nedeni Son hata satırında görünür. Okumanın başladığı an hemen kaydedilir; okuma sürerken aynı bağlantı için ikinci bir okuma başlamaz.

Sayproof önce Omnitron’da oturum açar:

POST https://omnitron.markaniz.com/api/v1/auth/login/
Content-Type: application/json

{"username": "sayproof-okuma", "password": "<parola>"}

Yanıttaki key alanı token olarak kullanılır ve sipariş listesi değişiklik zamanına göre sıralı okunur:

GET https://omnitron.markaniz.com/api/v1/orders/?channel=3&modified_date__gte=2026-09-02T12:00:00%2B00:00&ordering=modified_date&limit=100
Authorization: Token <token>

• Siparişler yanıttaki results listesinden okunur. next adresi izlenerek sonraki sayfalara geçilir; bu adres Omnitron adresiyle aynı alan adında olmalıdır.
• Token’ın süresi dolmuşsa (401) Sayproof bir kez yeniden oturum açar.
• Her isteğin zaman aşımı 30 saniye, yanıt sınırı 20 MB’tır.

Okunan alanlar

Her satırda sırayla bakılan alanlar listelenir; dolu olan ilk alan kullanılır.

Sayproof’taki bilgi	Omnitron’da okunan alan
Sipariş numarası	number
Sipariş durumu	status.value, status
Sipariş tarihi	date_placed, created_date
Değişiklik zamanı	modified_date
Müşteri e-postası	customer.email, email, shipping_address.email, billing_address.email
Müşteri telefonu	customer.phone_number, shipping_address.phone_number, billing_address.phone_number
Müşteri kimliği	customer.id, customer
Dil	language_code (yalnızca ilk bölüm; tr-tr → tr)
Ürün satırları	orderitem_set, items
Satır kimliği	Satırdaki id, pk
Ürün kodu	product.sku, sku
Grup kodu	product.base_code, base_code
Ürün adı	product.name, name
Adet	quantity
Satır durumu	Satırdaki status.value, status; boşsa sipariş durumu

• Müşteri e-postası, mağaza sisteminden gönderilen sipariş verisindeki customer_email alanıyla aynı işi görür: davet bu adrese gönderilir ve sipariş doğrulamasında bu adres kullanılır.
• Müşteri telefonu, sipariş verisindeki customer_phone alanıyla aynı işi görür: numara WhatsApp ile davet için kullanılacak. WhatsApp ile davet v2 sürümüyle gelene kadar telefon numarası saklanmaz.
• Ürün kodu, ürün kaynağınızdaki ürün anahtarıyla ve ürün sayfasındaki container’a verilen kodla aynı olmalıdır.
• Siparişin adres, fiyat ve ödeme bilgileri Sayproof’a kaydedilmez.

Durum eşlemesi

Omnitron durum kodları Sayproof’taki ödeme ve kargo durumlarına aşağıdaki tabloya göre eşlenir. Tablo panelde bağlantı kartındaki Durumların karşılığı bölümünde de görünür.

Omnitron kodu	Omnitron’daki anlamı	Ödeme	Kargo durumu
50	İptal talep edildi	Ödendi	Sipariş verildi
100	İptal edildi	İptal edildi	İptal edildi
200	Beklemede	Ödeme bekliyor	Sipariş verildi
300	Ödeme bekleniyor	Ödeme bekliyor	Sipariş verildi
350	Onay bekleniyor	Ödeme bekliyor	Sipariş verildi
400	Onaylandı	Ödendi	Sipariş verildi
450	Hazırlanıyor	Ödendi	Hazırlanıyor
500	Kargoya verildi	Ödendi	Kargoya verildi
510	Kargoya verildi, müşteri bilgilendirildi	Ödendi	Kargoya verildi
520	Mağazadan teslim almaya hazır	Ödendi	Yolda
540	Teslimat denendi	Ödendi	Yolda
550	Teslim edildi	Ödendi	Teslim edildi
600	İade edildi	İade edildi	İade edildi

• Teslim tarihi olarak satırın modified_date değeri, yoksa siparişin modified_date değeri kullanılır.
• Davet ve yorum yazma hakkı için satırın Teslim edildi, siparişin Ödendi olması gerekir. Davet, Davet gönderimi ekranındaki bekleme süresi dolduğunda gönderilir.
• Tabloda olmayan bir kod gelirse sipariş ya da satır okunmaz ve Okunamayan satırında sayılır.

Okunamayan siparişler

Panelde	Nedeni
numarası ya da tarihi eksik	Siparişte numara, sipariş tarihi ya da ürün satırları listesi yok
durumu tanınmıyor	Siparişin durumu tabloda yoksa sipariş, satırın durumu tabloda yoksa yalnızca o satır atlanır
ürün satırında ürün kodu eksik	Satırda satır kimliği ya da ürün kodu yok; satır atlanır
okunabilen ürün satırı yok	Siparişin okunabilen hiçbir satırı kalmadı
Sayproof’a kaydedilemedi	Sipariş okundu ama Sayproof’ta kaydedilemedi (örneğin kanalın pazarı için tanımlı kural yok)

Okunamayan ya da kaydedilemeyen siparişler okumayı durdurmaz; diğer siparişler kaydedilir. Okunan siparişlerin hiçbiri kaydedilemezse okuma başarısız sayılır ve kaldığı yer ilerlemez; neden Son hata satırında görünür.

Hata durumları

Okuma ya da deneme başarısız olduğunda panelde aşağıdaki nedenlerden biri gösterilir:

Panelde	Anlamı
kullanıcı adı ve parola gerekli	Bağlantıda kayıtlı kullanıcı adı ya da parola yok
kullanıcı adı ya da parola kabul edilmedi	Omnitron oturum açma isteğini reddetti ya da yanıtta token yok
alan adına ulaşılamadı	Omnitron adresi çözümlenemedi
bu adrese internetten ulaşılamıyor	Adres özel bir ağ adresine çıkıyor; bu tür adreslere bağlanılmaz
sunucuya bağlanılamadı, güvenli bağlantı kurulamadı	Bağlantı ya da TLS el sıkışması başarısız
kaynak zamanında yanıt vermedi	İstek 30 saniyede yanıt almadı
adres başka bir yere yönlendiriyor; doğrudan adresi yazın	Omnitron yönlendirme döndürdü; yönlendirmeler izlenmez
karşı sistem hata verdi, durum kodu	Omnitron 200 dışında bir yanıt verdi (örneğin http_status: 403)
platformun yanıtı okunamadı, platformun yanıtı çok büyük	Yanıt JSON değil ya da 20 MB’tan büyük
platform sonraki sayfa için başka bir adrese yönlendirdi	next adresi Omnitron adresiyle aynı alan adında değil
kayıtlı giriş bilgileri okunamadı; yeniden girin	Kayıtlı parola çözülemedi; Giriş bilgilerini değiştir ile yeniden girin
okuma beklenmeyen bir hatayla durdu	Beklenmeyen bir hata oluştu; okuma, okuma sıklığı kadar sonra yeniden denenir

Güvenlik

• Parola şifreli saklanır ve panelde ya da API yanıtlarında bir daha gösterilmez.
• Yalnızca https adreslerine bağlanılır; özel ağ adresleri ve yönlendirmeler reddedilir.
• Bağlantılar yalnızca panelde oturum açmış ve “Ayarları değiştirebilir” iznine sahip bir kullanıcı tarafından görülür ve yönetilir; API anahtarıyla bu işlemler yapılamaz.
• Kurma, değiştirme, deneme, elle okuma ve kaldırma işlemleri İşlem geçmişi ekranına kaydedilir. Giriş bilgilerinin değiştirilmesi kayıtta yalnızca “Giriş bilgileri yenilendi” satırı olarak görünür; değerler yazılmaz. Kaldırma kaydında kaldırılan bağlantının platformu ve kanalı yazılır.