importCrmXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	`importCrmXML`
SOAPAction	`urn:WebticariService#importCrmXML`
Açıklama	CRM (Müşteri İlişkileri Yönetimi) kayıtlarını XML formatında sisteme aktarır. Müşteri etkileşimleri, notlar, aktiviteler gibi CRM verilerini günceller veya ekler.
Kimlik Doğrulama Gerektirir	Evet (token)

XML Alanları (CRM)

tablo parametresi ile hangi CRM tablosuna kayıt yapılacağı belirlenir.

Ortak Alanlar (tüm CRM tabloları)

Alan	Tip	Zorunlu	Açıklama
`kid`	`integer`	Evet	Cari hesap numarası (cr_kod yerine kullanılabilir)
`cr_kod`	`string`	Hayır	Cari hesap kodu (kid yerine kullanılabilir)
`personel`	`integer`	Hayır	Personel numarası
`kategori`	`string`	Hayır	Kategori
`bas_tarih`	`date`	Hayır	Başlangıç tarihi
`bit_tarih`	`date`	Hayır	Bitiş tarihi
`statu`	`string`	Hayır	Durum/statü
`konu`	`string`	Hayır	Konu
`aciklama`	`string`	Hayır	Açıklama

`crmgorusme` — Görüşme Ek Alanları

Alan	Tip	Zorunlu	Açıklama
`yetkili_id`	`integer`	Hayır	Yetkili personel ID
`_musteri_tipi`	`string`	Hayır	Müşteri tipi
`_islem`	`string`	Hayır	İşlem türü
`_talep_kaynagi`	`string`	Hayır	Talep kaynağı
`cagriid`	`integer`	Hayır	Çağrı ID

`crmkampanya` — Kampanya Ek Alanları

Alan	Tip	Zorunlu	Açıklama
`beklenen_ciro`	`decimal`	Hayır	Beklenen ciro
`gercek_masraf`	`decimal`	Hayır	Gerçek masraf
`butce_masraf`	`decimal`	Hayır	Bütçe masrafı

`crmfirsat` — Fırsat Ek Alanları

Alan	Tip	Zorunlu	Açıklama
`cagriid`	`integer`	Hayır	Çağrı ID
`kaynak`	`string`	Hayır	Kaynak

`crmsikayet` — Şikayet Ek Alanları

Alan	Tip	Zorunlu	Açıklama
`cagriid`	`integer`	Hayır	Çağrı ID
`kod`	`string`	Hayır	Şikayet kodu
`var1`	`string`	Hayır	Ek alan 1
`var2`	`string`	Hayır	Ek alan 2
`var3`	`string`	Hayır	Ek alan 3

`crmrapor` — Rapor Ek Alanları

Alan	Tip	Zorunlu	Açıklama
`yetkili_id`	`integer`	Hayır	Yetkili personel ID
`var1`	`string`	Hayır	Ek alan 1
`var2`	`string`	Hayır	Ek alan 2
`var3`	`string`	Hayır	Ek alan 3

`satir` Alt Elemanı (`crmvalues` içinde) — Tüm tablolar

Alan	Tip	Zorunlu	Açıklama
`{field_id}`	`string`	Hayır	Özel alan değeri; eleman adı numeric ID veya `a_a{id}` formatında

Kontrol Alanları

Alan Adı	Tip	Açıklama
`tablo`	`string`	Hedef CRM tablosu: `crmgorusme`, `crmetkinlik`, `crmkampanya`, `crmfirsat`, `crmsikayet`, `crmrapor`

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
`token`	`xsd:string`	Evet	`login` endpoint'inden alınan oturum token'ı
`tablo`	`xsd:string`	Evet	Hedef CRM tablosu adı
`xmlVeri`	`xsd:string`	Evet	İçe aktarılacak CRM verisi, XML formatında

Yanıt Parametreleri

Parametre	Tip	Açıklama
`return`	`xsd:string`	İşlem sonucu (başarı/hata mesajı)

Yanıt Yapısı

Standart import yanıt formatı (mükerrer <duplicates> bölümü döndürülmez):

<transactions>
  <transferreds>
    <transaction>
      <server_id>SUNUCU_KAYIT_ID</server_id>
    </transaction>
  </transferreds>
  <transposeds>
    <transaction>
      <errorno>-1</errorno>
      <errormessage>Hata açıklaması</errormessage>
    </transaction>
  </transposeds>
</transactions>

Desteklenen CRM Tablosu Değerleri

`tablo` Değeri	Açıklama
`crmgorusme`	Müşteri görüşme kaydı
`crmetkinlik`	CRM etkinlik kaydı
`crmkampanya`	Kampanya kaydı
`crmfirsat`	Satış fırsat kaydı
`crmsikayet`	Şikayet kaydı
`crmrapor`	CRM rapor kaydı

Geçersiz bir tablo değeri geniş yanıt XML ile boş <transferreds> ve <transposeds> döndürür.

XML Veri Yapısı

Tüm CRM tipleri aynı XML şablonunu paylaşır. Her kayıt başlık alanları ve isteğe bağlı bir <crmvalues> altöğesi içerir:

<hareketler>
  <hareket>
    <kid>42</kid>                           <!-- Cari ID (cr_no) -->
    <bas_tarih>2024-06-01</bas_tarih>
    <bit_tarih>2024-06-01</bit_tarih>
    <aciklama>Görüşme notu</aciklama>
    <personel>5</personel>
    <kategori>Genel</kategori>
    <statu>Tamamlandı</statu>
    <konu>Teklif</konu>
    <!-- Diğer tablo-spesifik alanlar -->
    <crmvalues>
      <satir>
        <alan>Konu</alan>
        <deger>Teklif görüşmesi</deger>
      </satir>
      <satir>
        <alan>Sonuç</alan>
        <deger>Olumlu</deger>
      </satir>
    </crmvalues>
  </hareket>
</hareketler>

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:importCrmXML>
      <token>a3f5c2b1d8e4f9a0b7c6d3e2f1a8b5c4d7e0f3a2</token>
      <tablo>crmgorusme</tablo>
      <xmlVeri><![CDATA[
        <hareketler>
          <hareket>
            <kid>42</kid>
            <bas_tarih>2024-06-01</bas_tarih>
            <aciklama>Yıllık sözleşme görüşmesi</aciklama>
            <crmvalues>
              <satir><alan>Sonuç</alan><deger>Olumlu</deger></satir>
            </crmvalues>
          </hareket>
        </hareketler>
      ]]></xmlVeri>
    </tns:importCrmXML>
  </soapenv:Body>
</soapenv:Envelope>

Notlar

Bu endpoint mükerrer kontrol yapmaz; aynı verinin tekrar gönderilmesi yeni bir kayıt oluşturur.
crmvalues/satir altöğeleri isteğe bağlıdır; olmadığında boş array olarak işlenir.
Token geçersizse yanıt Invalid Token string'i döner.