Ana içeriğe atla
GET
Alış faturalarını listele
Alış faturaları en yeniden eskiye ve satırları olmadan döner; satırlar için Alış faturası detayı kullanılır.
  • search fatura numarasında, belge numarasında ve cari adında arar.
  • Noyax’ta iptal edilmiş faturalar listede yer almaz; ID ile detayı okunabilir (Cancelled: true).
  • Sayfalama diğer listelerle aynıdır: page 1’den başlar, pageSize en fazla 50’dir.

Filtreler ve sıralama

Hepsi isteğe bağlıdır ve birlikte kullanılabilir: Değişiklikleri senkronize etmek için son senkronizasyon zamanınızı modifiedSince ile verin ve sortBy=modifyDate&sortDirection=asc ile sıralayın. Zamanı dilim bilgisi olmadan, Türkiye saatiyle gönderin. Silinen belgeler listede görünmediği için bu yolla öğrenilemez.

Hata kodları

Bu endpoint’in dönebileceği kodlar. Her endpoint için geçerli olan genel hatalar (kimlik doğrulama, yetki, istek header’ları, istek limitleri) burada tekrarlanmaz.

Yetkilendirmeler

Authorization
string
header
gerekli

Access token obtained from the Noyax auth service with your API key.

Başlıklar

X-UserID
integer<int32>
gerekli

İsteğin adına yapıldığı Noyax kullanıcısının ID'si. Oluşturulan, güncellenen ve silinen kayıtların denetim alanlarına yazılır.

Gerekli aralık: x >= 1
X-CompanyID
integer<int32>
gerekli

Şirketin ID'si. Kullanıcı bu şirkete tanımlı olmalıdır. Bütün okuma ve yazma işlemleri bu şirketle sınırlıdır.

Gerekli aralık: x >= 1
X-PeriodID
integer<int32>

Muhasebe döneminin ID'si. İsteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Sorgu Parametreleri

page
integer<int32>
varsayılan:1

Sayfa numarası, 1'den başlar.

pageSize
integer<int32>
varsayılan:50

Sayfa başına kayıt sayısı (en fazla 50).

InvoiceNumber, DocumentNumber ve cari adında arar.

startDate
string<date-time>

Yalnızca Date değeri bu tarih ya da sonrası olan belgeler.

endDate
string<date-time>

Yalnızca Date değeri bu tarih ya da öncesi olan belgeler.

customerCode
string

Yalnızca bu koda sahip carinin belgeleri (GET /api/v1/customers içindeki Code).

currencyCode
string

Yalnızca bu dövizdeki belgeler (GET /api/v1/definitions/currencies içindeki Code).

modifiedSince
string<date-time>

Yalnızca bu tarih-saatte ya da sonrasında oluşturulmuş veya değiştirilmiş belgeler (ISO 8601). Hiç değiştirilmemiş belge oluşturulma anıyla değerlendirilir. Son senkronizasyonunuzdan bu yana olan değişiklikleri almak için kullanın.

createdSince
string<date-time>

Yalnızca bu tarih-saatte ya da sonrasında oluşturulmuş belgeler (ISO 8601).

sortBy
string

Sıralama alanı: date (varsayılan; belgenin tarih ve saati), modifyDate (son değişiklik, hiç değişmemişse oluşturulma), createDate ya da number.

sortDirection
string

asc ya da desc. Varsayılan desc (yeniden eskiye).

Yanıt

OK

Success
boolean
gerekli

İşlemin başarılı olup olmadığı.

Örnek:

true

ResultCode
string
gerekli

Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.

Örnek:

"0000"

Data
object
gerekli

Response data. Null when Success is false.

Message
null | string

Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.