Ana içeriğe geç

importCustomerXML

Genel Bilgi

Özellik Değer
Endpoint Adı importCustomerXML
SOAPAction urn:WebticariService#importCustomerXML
Açıklama Cari kartları XML formatında sisteme içe aktarır. Yeni cari oluşturma ve mevcut cari güncelleme işlemlerini kapsar.
Kimlik Doğrulama Gerektirir Evet (token)

cari XML Alanları (Cari Hesap)

Alan Tip Zorunlu Açıklama
cr_kod string Evet Cari hesap kodu
cr_adi string Evet Cari hesap adı
cr_turu string Hayır Cari türü: A, S, AS, M, P, PS, U, O, SP, T, H, G, CRM (varsayılan: AS)
cr_vergino string Hayır Vergi numarası
cr_vergidairesi string Hayır Vergi dairesi
cr_adres string Hayır Adres
cr_tel string Hayır Telefon numarası
cr_fax string Hayır Faks numarası
cr_mail string Hayır E-posta adresi
cr_web string Hayır Web sitesi
cr_il string Hayır İl
cr_ilce string Hayır İlçe
cr_ulke string Hayır Ülke
cr_sube integer Hayır Şube numarası
cr_semt string Hayır Semt/mahalle
cr_adres2 string Hayır 2. adres
cr_il2 string Hayır 2. adres ili
cr_ilce2 string Hayır 2. adres ilçesi
cr_semt2 string Hayır 2. adres semti
cr_ulke2 string Hayır 2. adres ülkesi
cr_postakodu string Hayır Posta kodu
cr_tel2 string Hayır 2. telefon numarası
cr_evtel string Hayır Ev telefonu
cr_cep string Hayır Cep telefonu
cr_cep2 string Hayır 2. cep telefonu
cr_tckimlik string Hayır TC kimlik numarası
cr_mersisno string Hayır MERSİS numarası
cr_babaadi string Hayır Baba adı
cr_sosyalguvenceno string Hayır Sosyal güvence numarası
cr_doviz string Hayır Para birimi (varsayılan: sistem para birimi)
cr_iskonto decimal Hayır İskonto oranı
cr_unvan string Hayır Ünvan (boşsa cr_adi kullanılır)
cr_grup string\|integer Hayır Cari grubu adı veya ID
cr_altgrup string Hayır Alt grup
cr_not string Hayır Not
cr_opsiyon date Hayır Opsiyon tarihi
cr_opsiyonaysonu date Hayır Opsiyon ay sonu tarihi
cr_durum string Hayır Durum (A=Aktif, P=Pasif, varsayılan: A)
cr_risklimiti decimal Hayır Risk limiti
cr_resim string Hayır Resim dosya adı
cr_websifre string Hayır Web şifresi
cr_webkuladi string Hayır Web kullanıcı adı
cr_istihbarat string Hayır İstihbarat bilgisi
cr_dogumtarihi date Hayır Doğum tarihi
cr_evlilikyildonumu date Hayır Evlilik yıl dönümü
cr_bankahesap string Hayır Banka hesap bilgisi
cr_temsilci string Hayır Temsilci
cr_rutgunu string Hayır Rut günü
cr_var1 string Hayır Serbest alan 1
cr_var2 string Hayır Serbest alan 2
cr_var3 string Hayır Serbest alan 3
cr_koordinatenlem decimal Hayır GPS koordinatı (enlem)
cr_koordinatboylam decimal Hayır GPS koordinatı (boylam)
cr_odemesekli string Hayır Ödeme şekli
cr_ozelkod string Hayır Özel kod 1
cr_ozelkod2 string Hayır Özel kod 2
cr_ozelkod3 string Hayır Özel kod 3
cr_ozelkod4 string Hayır Özel kod 4
cr_ozelkod5 string Hayır Özel kod 5
cr_ozelkod6 string Hayır Özel kod 6
cr_no integer Hayır Güncellenecek cari ID (update=TRUE ile)
---

İstek Parametreleri

Parametre Tip Zorunlu Açıklama
token xsd:string Evet login endpoint'inden alınan oturum token'ı
customers xsd:string Evet Cari kart verilerini içeren XML

Yanıt Parametreleri

Parametre Tip Açıklama
return xsd:string İşlem sonucu

Yanıt Yapısı

<transactions>
  <transferreds>
    <transaction>
      <server_id>542</server_id>  <!-- sunucuda atanan cari ID -->
    </transaction>
  </transferreds>
  <transposeds>
    <transaction>
      <errorno>-1</errorno>
      <errormessage>Hata açıklaması</errormessage>
    </transaction>
  </transposeds>
  <duplicates>
    <transaction>
      <cr_no>78</cr_no>    <!-- mevcut kaydın sunucu ID'si -->
      <cr_kod>C001</cr_kod>
      <cr_adi>Örnek Firma</cr_adi>
    </transaction>
  </duplicates>
</transactions>

Not: Mükerrer tespitinde <duplicates> bloğu sadece bu endpoint'e özgü olarak mevcut cari kaydının cr_no, cr_kod ve cr_adi bilgilerini de içerir.

Mükerrer Kayıt Tespiti

Her cari gönderilmeden önce üst müşteri numarası ve XML'deki alanlar kullanılarak mükerrer kontrolü yapılır. Var olan bir kayıtla eşleşme bulunursa kayıt <duplicates> bölümünde mevcut cari bilgileriyle (cr_no, cr_kod, cr_adi) döner.

XML Yapısı (customers parametresi)

<cariler>
  <cari>
    <cr_kod>C001</cr_kod>             <!-- Cari kodu (zorunlu) -->
    <cr_adi>Örnek Firma A.Ş.</cr_adi>  <!-- Cari adı -->
    <cr_turu>AS</cr_turu>              <!-- A=Alıcı, S=Satıcı, AS=Alıcı-Satıcı, vb. -->
    <cr_tel>0212 555 00 00</cr_tel>
    <cr_fax>0212 555 00 01</cr_fax>
    <cr_cep>0555 000 00 00</cr_cep>
    <cr_mail>info@ornekfirma.com</cr_mail>
    <cr_vergidairesi>Kadıköy</cr_vergidairesi>  <!-- Vergi dairesi -->
    <cr_vergino>1234567890</cr_vergino>          <!-- Vergi numarası -->
    <cr_adres>Atatürk Cad. No:1</cr_adres>
    <cr_ilce>Kadıköy</cr_ilce>
    <cr_il>İstanbul</cr_il>
  </cari>
</cariler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importCustomerXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <customers><![CDATA[
        <cariler>
          <cari>
            <cr_kod>C001</cr_kod>
            <cr_adi>Örnek Firma A.Ş.</cr_adi>
            <cr_turu>AS</cr_turu>
            <cr_vergino>1234567890</cr_vergino>
            <cr_mail>info@ornekfirma.com</cr_mail>
          </cari>
        </cariler>
      ]]></customers>
    </tns:importCustomerXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

  • Mükerrer tespit yapıldığında kayıt güncellenmez; mevcut kayıt bilgileriyle <duplicates> bölümünde döner.
  • Birden fazla cari tek istekte gönderilebilir; sistem her birini bağımsız işler.
  • Token geçersizse yanıt Invalid Token string'i döner.

Kontrol Alanları

Alan Adı Tip Açıklama
update boolean TRUE ise mevcut cariyi günceller (cr_no veya cr_kod ile)
oto_kod boolean TRUE ise cr_kod boşsa veya çakışırsa otomatik atanır