v1
latestOpenAPI 3.0.32026-07-248879173.4 KBFatura 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