# 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` | Parametre | Açıklama | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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. | | EMAIL | 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` | Parametre | Açıklama | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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. | | EMAIL | 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` | Parametre | Açıklama | | ---------------- | ---------------------------------------------------------------------------------- | | 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ç. | ***
***