Nebim iş ortağınıza iletilecekler

Bu makaleyi olduğu gibi Nebim iş ortağınıza iletebilirsiniz. Kurulumun ilerlemesi için gereken
teknik gereksinimlerin tamamı buradadır.

Ne hazırlanacak

Nebim üzerinde, Pixa'nın çağıracağı ayrı sorgular hazırlanması gerekir. Her biri ayrı bir
sorgudur; tek bir sorgu birden fazla amaca hizmet edemez.

Sorgu	Amacı	Zorunlu mu
Ürün	Ürün kartı, varyant, marka, kategori, açıklama	Ürün aktarımı isteniyorsa evet
Stok	Barkod bazında depo stoğu	Stok aktarımı isteniyorsa evet
Fiyat	Liste ve satış fiyatı, kanal bazlı fiyat	Fiyat aktarımı isteniyorsa evet
Görsel	Ürün görsellerinin adresleri	Görsel aktarımı isteniyorsa evet
Müşteri sorgulama	Sipariş aktarımında mevcut cariyi bulmak	Sipariş aktarımı isteniyorsa evet
Fatura bağlantısı	Kesilen faturanın numarası ve görüntüleme adresi	Fatura pazaryerine iletilecekse evet
İl/ilçe	Adres eşleştirmesi	Alternatifi Excel ile aktarımdır
Satışa kapalı ürünler	Nebim'de satışa kapatılan ürünlerin stoğunu sıfırlamak	Opsiyonel

En önemli kural: sütun adları birebir olmalı

Pixa, gelen verinin sütun adlarına bakarak hangi alanın ne olduğunu anlar. Sütun adları aşağıdaki
listeyle birebir aynı olmalıdır — büyük/küçük harf, boşluk ve Türkçe karakterler dâhil.

⚠️ Listede olmayan bir sütun eklenirse aktarım tamamen durur. Pixa tanımadığı bir sütun
gördüğünde o turdaki verinin tamamını işlemez; tek bir satır bile yazılmaz. Bu, yanlış veri
yazılmasını önlemek için kasıtlı bir davranıştır.

Sorguya operasyonel amaçla bile olsa yeni bir sütun eklemeden önce Pixa destek ekibine haber verin.

Stok sorgusu

En katı kurallara sahip sorgudur. Yalnızca aşağıdaki sütunlar döndürülebilir:

Sütun adı	İçerik
`Ürün Stok Kodu`	Ürünün stok kodu
`Varyant Stok Kodu`	Varyantın stok kodu
`Barkod`	Barkod — eşleştirmenin temel alanıdır
`Depo Adı`	Deponun adı
`Depo Kodu`	Deponun kodu
`Stok Miktarı`	Adet
`Seri Numarası`	Seri numarası takibi varsa

⚠️ Bu listeye hiçbir sütun eklenemez. Stok sorgusu, diğerlerinin aksine hiçbir ek sütuna
tolerans göstermez. Renk, Mağaza, Rezerve gibi bir sütun eklenirse stok senkronu tümüyle
durur.

Aynı satırın iki kez dönmemesi

⚠️ Kritik: Aynı barkod aynı depo için iki satır döndürülürse Pixa bu iki satırın miktarını
toplar. Bu, sorguda bir birleştirme (join) hatası varsa ya da seri numarası/renk/beden
kırılımı yüzünden satır çoğalıyorsa stoğun katlanmasına yol açar.

Sorgu, her barkod + depo çifti için tek satır döndürmelidir. Gruplama (GROUP BY) ile
tekilleştirilmesi önerilir.

Depo adının başında veya sonunda boşluk bulunmamalıdır; Merkez ile Merkez aynı depo sayılır ve
miktarları toplanır.

Ürün sorgusu

Sütun adı	İçerik
`Ürün Stok Kodu`	Zorunlu
`Varyant Stok Kodu`	Varyantlı üründe zorunlu
`Barkod`	Zorunlu
`Ürün Adı`	Zorunlu — boş gelirse ürün hiç işlenmez
`Ürün Model Kodu`	Model kodu
`Kısa Açıklama`, `Uzun Açıklama`	Ürün açıklamaları
`Marka`	Marka adı
`Kategori`, `Kategori Kodu`	Ana kategori
`Kategori2`, `Kategori3`	Ek kategoriler
`Renk`, `Beden`	Varyant özellikleri
`Cinsiyet`, `Ürün Sezonu`	—
`Vergi Oranı`	KDV oranı
`Para Birimi`	—
`Liste Fiyatı`, `Satış Fiyatı`, `Alış Fiyatı`	—
`Tedarikçi`	—
`Seri Numarası`	Seri takibi varsa
`Ek Alan 1`, `Ek Alan 5`	Serbest alanlar

Ürün sorgusu ek sütunlara izin verir, ancak bu sütunların adı belirli öneklerle başlamalıdır:

Önek	Kullanımı	Örnek
`Filtre:`	Filtre değeri	`Filtre: Kumaş İçeriği`
`Etiket:`	Ürün etiketi	`Etiket: Yeni Sezon`
`Özellik:`	Varyant özelliği	`Özellik: Yüzük Boyutu`
`Metafield:`	Satış kanalına gönderilecek ek alan	`Metafield: custom.kalip`

Bu öneklerle başlamayan yeni bir sütun ürün aktarımını durdurur.

Sessizce elenen ürünler

Aşağıdaki durumlarda ürün hiçbir uyarı vermeden atlanır — sorgu hazırlanırken dikkat edilmelidir:

Ürün Adı boşsa
Ürün Stok Kodu veya Barkod boşsa
Beklenen varyant özellikleri (örneğin beden ve renk) varyantlardan birinde eksikse — bu durumda
ürünün tamamı atlanır, yalnız o varyant değil

Vergi Oranı alanında ondalıklı değer (örneğin %8,5) kullanıyorsanız Pixa bu değeri tam sayıya
yuvarlar. Ondalıklı KDV oranı kullanıyorsanız kurulum öncesi bunu bildirin.

Fiyat sorgusu

Sütun adı	İçerik
`Ürün Stok Kodu`, `Varyant Stok Kodu`, `Barkod`	Eşleştirme
`Liste Fiyatı`	Genel liste fiyatı
`Satış Fiyatı`	Genel satış fiyatı
`Alış Fiyatı`	Maliyet

Satış kanalı bazında farklı fiyat göndermek için sütun adı kanal adı + boşluk + fiyat tipi
biçiminde olmalıdır:

Trendyol Liste Fiyatı
Trendyol Satış Fiyatı
Hepsiburada Liste Fiyatı
Hepsiburada Satış Fiyatı

⚠️ Kanal adı ile "Liste Fiyatı" arasında boşluk zorunludur. TrendyolListe Fiyatı gibi
boşluksuz bir ad hata vermez ama hiçbir yere yazılmaz — fiyat sessizce kaybolur.

⚠️ Kanal satış fiyatı 0 gönderilmemelidir. Genel satış fiyatı 0 geldiğinde Pixa liste fiyatını
kullanır, ancak kanal fiyatlarında bu koruma yoktur; 0 gelirse 0 yazılır ve ürün pazaryerinde
sıfır bedelle listelenebilir. Fiyatı olmayan kanal için o sütunu boş bırakın, 0 yazmayın.

Kanal sütunlarının ilk satırda da dolu olması gerekir. Pixa hangi kanalların geldiğini ilk
satıra bakarak belirler; ilk üründe bir kanal sütunu boşsa o kanal tüm parti boyunca atlanır.

Görsel sorgusu

Sütun adı	İçerik
`Barkod`, `Ürün Stok Kodu`, `Varyant Stok Kodu`	Eşleştirme
`Görsel1` … `Görsel10`	Görsel adresleri

⚠️ En fazla 10 görsel aktarılır. Sorgu daha fazlasını döndürse bile 10'dan sonrası okunmaz.

Görsel adresleri hakkında:

Adres tam ve erişilebilir olmalıdır. Pixa her adresi indirmeden önce erişilebilirliğini test
eder; ulaşılamayan adres kaydedilmez.
Adres http:// veya https:// ile başlamalıdır.
Aynı görsel adresi birden fazla ürüne verilmemelidir. Aynı adres iki üründe geçerse görsel
yalnızca ilk ürüne bağlanır.

Müşteri sorgulama sorgusu

Sipariş aktarımında, aynı müşteri için tekrar tekrar cari açılmasını önlemek amacıyla kullanılır.
Genellikle e-posta adresine göre mevcut cariyi döndürür. Parametre adı kurulum sırasında Pixa
tarafından tanımlanır.

Fatura bağlantısı sorgusu

Kesilen faturanın numarasını ve görüntüleme adresini döndürmelidir. Pixa bu bilgiyi okuyup
pazaryerine iletir.

Döndürülmesi beklenen	İçerik
Fatura görüntüleme adresi	Müşterinin faturayı göreceği adres
Fatura numarası	E-fatura/e-arşiv numarası
Fatura tarihi	—

Ağ ve erişim gereksinimleri

Nebim servisinin Pixa'nın bağlanabileceği şekilde erişilebilir olması gerekir. Bağlantı yapılacak
adresleri Pixa destek ekibinden alın ve güvenlik duvarında izin verin.
Entegrasyon için ayrı bir kullanıcı adı, parola ve kullanıcı grubu tanımlanmalıdır.
Pixa gün boyunca düzenli aralıklarla bağlanır ve her bağlantı bir Nebim oturumu tüketir.
Mevcut oturum lisansınızın buna yeteceğinden emin olun; lisans dolduğunda aktarımlar duraklar.

Değişiklik yapmadan önce

Kurulum tamamlandıktan sonra sorgularda yapılacak her değişiklik aktarımı etkileyebilir.
Aşağıdakilerden biri yapılacaksa önce Pixa destek ekibine haber verin:

Sorguya yeni sütun eklenmesi veya sütun adının değiştirilmesi
Sorgunun adının değiştirilmesi
Döndürülen satır sayısını etkileyecek bir birleştirme değişikliği
Yeni depo, mağaza, ödeme tipi veya kargo firması kodu tanımlanması