v1

latestOpenAPI 3.0.32026-07-248879173.4 KB
Fatura Dosyası Yönetimi

Fatura Dosyası Gönderme - uploadInvoiceFile

Satıcıların sipariş paketleri için fatura dosyalarını (PDF, JPEG, PNG) yüklemelerini sağlar.

Önemli Kurallar

  • Dosya boyutu 10 MB'dan büyük olamaz
  • İleri tarihli fatura eklenemez
  • Desteklenen dosya formatları: PDF, JPEG, PNG
  • Mikro ihracat siparişleri için invoiceDateTime ve invoiceNumber zorunludur

Hata Durumları

  • Gönderi paketi başka satıcıya aitse: "Gönderi paketi, belirtilen satıcıya ait değil. sellerId: X"
  • Faturası oluşmuş bir pakete yüklenmek istenirse: "{paketNo} numaralı pakete ait fatura önceden gönderilmiş"
  • Paket bulunamazsa: "{paketNo} IDli kargo paketi bulunamadı"
  • Geçersiz dosya formatı: "Dosya türü (.txt) desteklenmiyor. Desteklenen dosya türleri: application/pdf,image/jpeg,image/png"
  • Dosya gönderilmezse: "Dosya gönderilmedi. Lütfen fatura dosyasını seçip tekrar deneyin"
  • Mikro için fatura numarası eksikse: "Micro export type'ları için fatura bilgisi zorunludur"
  • Mikro için tarih eksikse: "Micro export type'ları için fatura bilgisi zorunludur"

TR (Türkiye) Siparişleri

Herhangi bir JSON request body bulunmamaktadır. Aşağıdaki alanları form-data olarak göndermeniz gerekmektedir:

  • shipmentPackageId: form-data (Text) olarak
  • file: form-data (File) olarak - PDF, JPEG veya PNG

Mikro İhracat Siparişleri

Aşağıdaki alanları form-data olarak göndermeniz gerekmektedir:

  • shipmentPackageId: form-data (Text) olarak
  • invoiceDateTime: form-data (Text) olarak - Unix timestamp (saniye veya milisaniye)
  • invoiceNumber: form-data (Text) olarak
  • file: form-data (File) olarak - PDF, JPEG veya PNG
post/sellers/{sellerId}/seller-invoice-file

Path parameters

sellerIdinteger required

Satıcı ID

Response

Success - Fatura dosyası başarıyla yüklendi