Ana içeriğe atla
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 satır tutarlarını hesaplamaz, ama birbirini tuttuğunu denetler. Satır tutarları, indirim tutarları, KDV, ek vergiler ve tevkifat gönderdiğiniz gibi kaydedilir; tutarları Noyax’ın kurallarına uymayan satır reddedilir (5118). Teklif toplamları ve AverageExchangeRate satırlardan doldurulur; bunlar için gönderilen değerler yok sayılır. Kurallar hesaplama sayfasındadır. Satırın AdditionalTaxes listesi ürünün ek vergileriyle aynı kurallara uyar: en fazla 3, her Code zorunlu ve listedeki kodlardan biri, bir kod satırda yalnızca bir kez kullanılabilir.

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.
  • CustomerCode: kullanıcının görebildiği bir cari. RepresentativeName isteğe bağlıdır ve o carinin yetkilisi olmalıdır.
  • Lines: en az bir satır (5012).
Teklif dövizi istekte yer almaz: her satır kendi CurrencyCode’unu gönderir. Belgenin dövizi satırlardan türetilir (satırların tek bir dövizi varsa o, birden fazlaysa şirketin varsayılan dövizi) ve yanıtta CurrencyCode olarak döner. AverageExchangeRate de gönderilmez, satırlardan doldurulur (istekte gönderilen değer yok sayılır): satırların hepsi aynı dövizdeyse satır kurlarının tutarla ağırlıklandırılmış ortalaması (AmountExcludingTax × ExchangeRate toplamı / AmountExcludingTax toplamı), dövizler farklıysa 1. Bkz. dövizler.

Satırlar

  • Ürün ProductCode (ürün kodu) ya da ECommerceProductCode (e-ticaret entegrasyon kodu) ile verilir; ikisinden biri zorunludur. İkisi de gönderilirse ProductCode kullanılır. UnitCode 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 ve KDV hariç olmalıdır. VatIncluded yok sayılır (mevcut istekler çalışmaya devam etsin diye kabul edilir).
  • CurrencyCode her satırda zorunludur. ExchangeRate, satırın dövizi şirketin varsayılan döviziyse 1 olmalı; değilse zorunlu ve 0’dan büyük olmalıdır.
  • 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.
  • LineGroupName 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

SharingCode 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.