Skip to main content
Teklif, bir başlık ve bir ya da daha fazla satırdan oluşur. Alış teklifleri (QuoteType 1) ve satış teklifleri (QuoteType 2) aynı endpoint’leri kullanır.
API tutarları hesaplamaz ve tutarlı olup olmadıklarını denetlemez. Satır tutarları, indirim tutarları, KDV, ek vergiler, tevkifat, teklif toplamları ve ağırlıklı kur ortalaması gönderdiğiniz gibi kaydedilir. Noyax’ın bunları nasıl hesapladığı hesaplama sayfasında anlatılır; API ile oluşturulan teklifler Noyax’ta oluşturulanlar gibi toplansın diye o sayfayı izleyin.

​
Zorunlu alanlar

  • QuoteType: 1 alış teklifi, 2 satış teklifi. Teklif oluşturulduktan sonra değiştirilemez (5015).
  • QuoteNumber: şirkette aynı QuoteType içinde benzersiz, en fazla 10 karakter (5002). Oluştururken "Next" gönderilirse numara şirketin numara serisinden üretilir: alış teklifleri için ALTEKLİFNO, satış teklifleri için VERTEKLİFNO. Güncellemede "Next" gönderilemez (5003).
  • Date: teklif tarihi. Saat de gönderirseniz teklif saati olarak yazılır, göndermezseniz o anki saat kullanılır.
  • CustomerId: kullanıcının görebildiği bir cari. RepresentativeId isteğe bağlıdır ve o carinin yetkilisi olmalıdır.
  • CurrencyId: teklif dövizi.
  • Lines: en az bir satır (5012).

​
Satırlar

  • ProductId ve UnitId zorunludur. Birim, ürünün kendi birimlerinden biri olmalıdır (ana birimi ya da 2./3. birimi).
  • Quantity sıfırdan büyük olmalı; UnitPrice negatif olamaz.
  • Satırın CurrencyId alanı verilmezse teklif dövizi kullanılır; ExchangeRate satır dövizinin kurudur.
  • Discounts, satırın indirim oranlarının listesidir. Liste sırasıyla art arda uygulanır: 10, 10 ve 10 satırda %27,1’lik indirim eder. Satırda indirim yoksa liste boş bırakılır.
  • LineGroupId isteğe bağlıdır ve satır grupları tanımından gelir.
  • Satırların ID’si yoktur: listedeki sıraları tekliftaki sıralarıdır ve güncelleme bütün satırları değiştirir.

​
Durum

Status salt okunurdur. API ile oluşturulan teklifler her zaman 0 (beklemede) olur ve güncelleme durumu değiştirmez. Noyax’ta kabul edilen, revize edilen ya da reddedilen teklifler bu durumu burada gösterir.

​
Düzenleme ve silme

Düzenleme ve silme duruma göre kısıtlanmaz: teklif hangi durumda olursa olsun, hatta Noyax’ta siparişe, faturaya ya da irsaliyeye aktarılmış olsa bile güncellenebilir ya da silinebilir. Noyax bu durumda yalnızca kullanıcıdan onay ister; API’de böyle bir onay yoktur, bu tür teklifleri değiştirmeden önce kendi tarafınızda kontrol edin. Başka kayıtların (örneğin servis fişi ya da fırsat) bağlı olduğu teklif silinemez (5014).

​
Paylaşım

SharingCodeId teklifi kimlerin görebileceğini sınırlar: boşsa herkes görür, doluysa kullanıcının paylaşım kodlarından biri olmalıdır (5011). Kullanıcının göremediği teklifler 404 döner.