QuoteType 1) ve satış teklifleri (QuoteType 2) aynı endpoint’leri kullanır.
Zorunlu alanlar
QuoteType:1alış teklifi,2satış teklifi. Teklif oluşturulduktan sonra değiştirilemez (5015).QuoteNumber: şirkette aynıQuoteTypeiç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.RepresentativeNameisteğe bağlıdır ve o carinin yetkilisi olmalıdır.Lines: en az bir satır (5012).
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 daECommerceProductCode(e-ticaret entegrasyon kodu) ile verilir; ikisinden biri zorunludur. İkisi de gönderilirseProductCodekullanılır.UnitCodezorunludur. Birim, ürünün kendi birimlerinden biri olmalıdır (ana birimi ya da 2./3. birimi). Quantitysıfırdan büyük olmalı;UnitPricenegatif olamaz ve KDV hariç olmalıdır.VatIncludedyok sayılır (mevcut istekler çalışmaya devam etsin diye kabul edilir).CurrencyCodeher satırda zorunludur.ExchangeRate, satırın dövizi şirketin varsayılan döviziyse1olmalı; 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.LineGroupNameisteğ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.