Sign in

v1

latestOpenAPI 3.0.32026-07-248879173.4 KB
Fatura Linki Yönetimi

Fatura Linki Gönderme - sendInvoiceLink

Tedarikçi tarafından kendi sisteminde yaratılmış e-Arşiv ya da e-Fatura bilgisinin LİNK detayını Trendyol sistemine transfer etmek için bu method kullanılacaktır.

YASAL ZORUNLULUK: Bu servis ile gönderilen fatura bağlantılarının hukuki zorunluluk gereği 10 yıl boyunca erişilebilir durumda olması gereklidir.

Kullanım Şartları

  • Eğer ilgili siparişe ait fatura gönderimini siparişteki kriptolu mail adresine PDF ekleyerek gönderim yapamıyorsanız bu servisi kullanmanız gerekmektedir.
  • Bu servisin tetiklenmesi ile birlikte ilgili sipariş paketi için Trendyol müşterilerine e-Fatura linki kontrol edilerek gönderilir.
  • Kriptolu mail adresleri müşteri bazlı sabit değildir, her sipariş için unique mail üretilmektedir.

Zorunlu Alanlar

  • "invoiceNumber" ve "invoiceDateTime" alanları mikro ihracat paketleri için zorunlu ancak diğer paket türleri için opsiyoneldir.
  • Azerbaycan ve GULF ülkelerinin sipariş faturaları için entegrasyondan yapacağınız yüklemelerde, fatura üzerinde yazılı olan fatura numarası ile sistem üzerinden ileteceğiniz fatura numarası aynı olmalıdır.

Fatura Numarası Formatı

Fatura numarasının geçerli olabilmesi için aşağıdaki koşullara uyması gerekmektedir:

  • İlk üç hane: alfa numeric olmalı (Harf veya rakam)
  • Dört, beş, altı ve yedinci hane: bir yıla eşit olmalı (2020'den 2099'a kadar)
  • Sekizinci haneden itibaren (son dokuz hane): numeric olmalı

Format: [3 digit(alphanumeric)][4 digit(year)][9 digit(numeric)]

Geçerli Örnekler:

  • FRY2024567890123
  • FR12024567890123
  • F1Y2024567890123
  • 1RY2024567890123
  • 12Y2024567890123
  • 1232024567890123
  • F232024567890123

Geçersiz Örnek:

  • FRY12345 (eksik hane)
post/sellers/{sellerId}/seller-invoice-links

Path parameters

sellerIdinteger required

Satıcı ID

Request body

invoiceLinkstring uri required

E-Fatura veya E-Arşiv fatura linki. Bu link 10 yıl boyunca erişilebilir olmalıdır (yasal zorunluluk).

shipmentPackageIdinteger required

Trendyol sipariş paket ID

invoiceDateTimeinteger

Fatura tarihi - Unix timestamp formatında (saniye veya milisaniye). 0'dan büyük, 10 haneli (saniye) veya 13 haneli (milisaniye) olmalıdır. Mikro ihracat paketleri için zorunlu, diğer paket türleri için opsiyonel.

invoiceNumberstring

Fatura numarası. Mikro ihracat paketleri için zorunlu, diğer paket türleri için opsiyonel.

Format Kuralları:

  • İlk 3 hane: alfanumerik (harf veya rakam)
  • 4-7. haneler: yıl bilgisi (2020-2099 arası)
  • Son 9 hane: numerik

Toplam 16 karakter: [3 alfanumerik][4 digit yıl][9 digit numara]

Azerbaycan ve GULF ülkeleri için: Fatura üzerindeki numara ile gönderilen numara aynı olmalıdır.

Example request

{
  "invoiceLink": "https://extfatura.faturaentegratoru.com/324523-34523-52345-3453245.pdf",
  "shipmentPackageId": 435346,
  "invoiceDateTime": 1678788898,
  "invoiceNumber": "TY42024567890123"
}

Response

Success - Fatura linki başarıyla kaydedildi