Satıcı API Aksiyonları
Pazaryeri modelinde çalışan firmalarımız, alt satıcı bilgilerini panelden ekleyebildikleri gibi API aracılığı ile de ekleme, güncelleme, sorgulama işlemlerini gerçekleştirebilirler. Eklenen her satıcının Paratika tarafında bir onay sürecine gireceiğini ve onaylandıktan sonra bu satıcı adına işlem gönderebileceğinizi lütfen unutmayın.
Satıcı Ekleme (SELLERADD)
SELLERADD aksiyonu, pazaryeri yapısında yeni bir satıcının sisteme tanımlanmasını sağlar. Zorunlu alanların yanında TCKN, VKN ve farklı para birimlerine ait IBAN bilgileri gibi opsiyonel bilgiler de gönderilebilir. Satıcı, tanımlandıktan sonra üye işyeri altında ödeme alabilir ve hakediş süreçlerine dahil edilir.
Örnek Kullanım Amacı
Yeni bir satıcıyı sisteme alırken IBAN, ödeme günleri ve komisyon bilgileri ile birlikte ilk tanım bu servis üzerinden yapılır.
SELLERADD isteği aşağıdaki istek alanlarını beklemektedir.
POST https://entegrasyon.paratika.com.tr/paratika/api/v2
MERCHANT
Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir.
MERCHANTUSER
Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir.
MERCHANTPASSWORD
Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir.
ACTION
Bu istek tipi için SELLERADD olarak gönderilmelidir.
SELLERID
Eklemek istediğiniz alt satıcınız için atamış olduğunuz tekil ayıraç.
NAME
Alt satıcı ismi.
LASTNAME
Alt satıcı soy ismi.
Alt satıcı e-posta adresi.
MOBILENUMBER
Alt satıcı telefon numarası.
TCKN
Bireysel alt satıcılar için TCKN, kurumsal alt satıcılar için VKN bilgisi gönderilmelidir.
VKN
Bireysel alt satıcılar için TCKN, kurumsal alt satıcılar için VKN bilgisi gönderilmelidir.
COMMERCIALTITLE
Alt satıcı ticari ünvanı; istekte TCKN yerine VKN gönderildi ise yani alt satıcı bireysel değil kurumsal firma ise gönderilmelidir.
IBAN
Alt satıcı IBAN bilgisi.
ACCOUNTOWNERNAME
IBAN Hesap Sahibi İsmi; istekte VKN yerine TCKN gönderildi ise yani alt satıcı kurumsal firma değil bireysel alt satıcı ise gönderilmelidir.
ACCOUNTOWNERLASTNAME
IBAN Hesap Sahibi Soyismi; istekte VKN yerine TCKN gönderildi ise yani alt satıcı kurumsal firma değil bireysel alt satıcı ise gönderilmelidir.
SELLERPAYMENTDAYS
Alt satıcınız için ödeme çıkılacak günleri belirtir. Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir:Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4).Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4;
SELLERPAYMENTDUEDAY
Alt satıcınız için ödeme çıkılmadan önce ödemenin bloke edilecek gün bilgisidir. Ana firma olan pazaryeri yani sizin ödeme vadenizden daha az olamaz, eşit veya daha fazla olmalıdır.
COMMISSIONAPPLYTYPE
CA olarak gönderilmelidir. CA -> Commission amount
CITY
İSTANBUL, ADANA, VAN, BAYBURT, ADIYAMAN, DÜZCE, BOLU, HAKKARİ, ISPARTA, NEVŞEHİR, AYDIN, KARABÜK, MUĞLA, ORDU, KARAMAN, TRABZON, ÇANKIRI, ELAZIĞ, AFYONKARAHİSAR, ÇORUM, ÇANAKKALE, AMASYA, ZONGULDAK, İZMİR, BURSA, KIRKLARELİ, MANİSA, KİLİS, TOKAT, TUNCELİ, AKSARAY, KARS, SİİRT, SİVAS, KONYA, MUŞ, UŞAK, KAHRAMANMARAŞ, KASTAMONU, ERZİNCAN, DİYARBAKIR, ARTVİN, DENİZLİ, BİTLİS, MALATYA, SİNOP, GİRESUN, BURDUR, GAZİANTEP, YOZGAT, AĞRI, ERZURUM, SAMSUN, KAYSERİ, ESKİŞEHİR, BİNGÖL, KIRŞEHİR, IĞDIR, ŞANLIURFA, RİZE, YALOVA, BALIKESİR, NİĞDE, OSMANİYE, HATAY, GÜMÜŞHANE, KÜTAHYA, ANKARA, TEKİRDAĞ, MERSİN, EDİRNE, KIRIKKALE, ANTALYA, KOCAELİ, ARDAHAN, SAKARYA, ŞIRNAK, MARDİN, BARTIN, BİLECİK, BATMAN
Satıcı Güncelleme (SELLEREDIT)
SELLEREDIT işlemi, sistemde kayıtlı olan bir satıcının bilgilerinin güncellenmesini sağlar. Bu işlemde SELLERID zorunludur ve sadece gönderilen alanlar güncellenir.
Güncellenebilen Alanlar
İsim, soyisim
E-posta, telefon
Satıcı durumu (STATUS)
TCKN / VKN
IBAN ve yabancı para IBAN’ları
Ödeme günü ve vade bilgileri
Komisyon bilgileri
Kullanım Amacı
Satıcının IBAN değişikliği, iletişim bilgisi güncellemesi veya statü değişiklikleri (aktif/pasif vb.) için kullanılır.
SELLEREDIT isteği aşağıdaki istek alanlarını beklemektedir.
POST https://entegrasyon.paratika.com.tr/paratika/api/v2
MERCHANT
Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir.
MERCHANTUSER
Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir.
MERCHANTPASSWORD
Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir.
ACTION
Bu istek tipi için SELLEREDIT olarak gönderilmelidir.
SELLERID
Güncellemek istediğiniz alt satıcınız için atamış olduğunuz tekil ayıraç.
NAME
Alt satıcı ismi.
LASTNAME
Alt satıcı soy ismi.
Alt satıcı e-posta adresi.
MOBILENUMBER
Alt satıcı telefon numarası.
TCKN
Bireysel alt satıcılar için TCKN, kurumsal alt satıcılar için VKN bilgisi gönderilmelidir.
VKN
Bireysel alt satıcılar için TCKN, kurumsal alt satıcılar için VKN bilgisi gönderilmelidir.
COMMERCIALTITLE
Alt satıcı ticari ünvanı; istekte TCKN yerine VKN gönderildi ise yani alt satıcı bireysel değil kurumsal firma ise gönderilmelidir.
IBAN
Alt satıcı IBAN bilgisi.
ACCOUNTOWNERNAME
IBAN Hesap Sahibi İsmi; istekte VKN yerine TCKN gönderildi ise yani alt satıcı kurumsal firma değil bireysel alt satıcı ise gönderilmelidir.
ACCOUNTOWNERLASTNAME
IBAN Hesap Sahibi Soyismi; istekte VKN yerine TCKN gönderildi ise yani alt satıcı kurumsal firma değil bireysel alt satıcı ise gönderilmelidir.
SELLERPAYMENTDAYS
Alt satıcınız için ödeme çıkılacak günleri belirtir. Satıcı ödeme günleri, noktalı virgülle ayrılmış indeks formatında gönderilmelidir. Günler için indeksler aşağıdaki gibidir:Pazartesi(0), Salı(1), Çarşamba(2), Perşembe(3), Cuma(4).Örnek olarak, satıcı ödeme günlerinin Pazartesi ve Cuma olması için SELLERPAYMENTDAYS parametresinin değeri aşağıdaki gibi gönderilmelidir: 0;4;
SELLERPAYMENTDUEDAY
Alt satıcınız için ödeme çıkılmadan önce ödemenin bloke edilecek gün bilgisidir. Ana firma olan pazaryeri yani sizin ödeme vadenizden daha az olamaz, eşit veya daha fazla olmalıdır.
COMMISSIONAPPLYTYPE
CA olarak gönderilmelidir. CA -> Commission amount
CITY
İSTANBUL, ADANA, VAN, BAYBURT, ADIYAMAN, DÜZCE, BOLU, HAKKARİ, ISPARTA, NEVŞEHİR, AYDIN, KARABÜK, MUĞLA, ORDU, KARAMAN, TRABZON, ÇANKIRI, ELAZIĞ, AFYONKARAHİSAR, ÇORUM, ÇANAKKALE, AMASYA, ZONGULDAK, İZMİR, BURSA, KIRKLARELİ, MANİSA, KİLİS, TOKAT, TUNCELİ, AKSARAY, KARS, SİİRT, SİVAS, KONYA, MUŞ, UŞAK, KAHRAMANMARAŞ, KASTAMONU, ERZİNCAN, DİYARBAKIR, ARTVİN, DENİZLİ, BİTLİS, MALATYA, SİNOP, GİRESUN, BURDUR, GAZİANTEP, YOZGAT, AĞRI, ERZURUM, SAMSUN, KAYSERİ, ESKİŞEHİR, BİNGÖL, KIRŞEHİR, IĞDIR, ŞANLIURFA, RİZE, YALOVA, BALIKESİR, NİĞDE, OSMANİYE, HATAY, GÜMÜŞHANE, KÜTAHYA, ANKARA, TEKİRDAĞ, MERSİN, EDİRNE, KIRIKKALE, ANTALYA, KOCAELİ, ARDAHAN, SAKARYA, ŞIRNAK, MARDİN, BARTIN, BİLECİK, BATMAN
Satıcı Sorgulama (QUERYSELLER)
QUERYSELLER aksiyonu, üye işyerine bağlı tüm satıcıların veya belirli bir SELLERID’ye ait satıcının detaylarının sorgulanmasını sağlar.
Filtreleme Parametreleri
SELLERID: Belirli bir satıcıyı sorgulamak için
STATUS: Satıcı durumuna göre filtreleme
ONBEHALFOFMERCHANT: Alt üye işyeri senaryoları için
Cevap İçeriği
Sorgu sonucunda satıcıya ait aşağıdaki bilgiler döner:
Satıcı kimlik ve iletişim bilgileri
Satıcı durumu
IBAN ve hesap sahibi bilgileri
Bağlı olduğu üye işyeri bilgileri
Genel Kullanım Senaryosu
SELLERADD ile satıcı sisteme tanımlanır, SELLEREDIT ile bilgiler güncellenir ve QUERYSELLER ile satıcı listesi veya detayları sorgulanır. Bu üç servis birlikte pazaryeri satıcı yönetimi, hakediş ve ödeme süreçlerinin temelini oluşturur.
QUERYSELLER isteği aşağıdaki istek alanlarını beklemektedir.
POST https://entegrasyon.paratika.com.tr/paratika/api/v2
MERCHANT
Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir.
MERCHANTUSER
Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir.
MERCHANTPASSWORD
Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir.
ACTION
Bu istek tipi için QUERYSELLER olarak gönderilmelidir.
SELLERID
Sorgulamakistediğiniz alt satıcınız için atamış olduğunuz tekil ayıraç.
Last updated