Pazaryeri fatura entegrasyonu nasıl çalışır?
Pazaryeri fatura entegrasyonu; işletmede oluşturulan faturanın link veya dosya olarak doğru sipariş, paket ya da ürün kaydına gönderilmesi ve mümkün olduğunda pazaryeri durumuyla doğrulanmasıdır. Her kanal aynı alanları ve aynı durum bilgisini sunmadığı için tek bir “gönderildi” etiketi bütün pazaryerlerinde aynı anlama gelmez.
Fatura tek merkezden yönetilir; her pazaryerine kendi API kuralıyla gönderilir.
SatGitsin dosyayı veya kalıcı bağlantıyı hazırlar, doğru sipariş kapsamını seçer ve kanalın resmî servisine gönderir. API bir kontrol servisi sunuyorsa sonuç pazaryerinden yeniden doğrulanır. Sunmuyorsa panel yalnız SatGitsin üzerinden yapılan gönderimi kesin olarak işaretler.
Fatura gönderiminde dört temel yapı
Fatura entegrasyonu yalnız dosya yüklemekten ibaret değildir. Belgenin erişilebilirliği, doğru sipariş kapsamı, kanal cevabı ve sonradan yapılacak durum kontrolü birlikte ele alınmalıdır.
Kalıcı fatura linki
PDF veya görsel belge, pazaryerinin ve müşterinin oturum açmadan ulaşabildiği güvenli bir HTTPS adresiyle iletilir.
Dosya yükleme
Pazaryerinin desteklediği akışta PDF, JPEG veya PNG dosyası doğrudan paket kaydına yüklenir.
Sipariş, paket veya ürün kapsamı
Faturanın hangi siparişe, kargo paketine ya da ürün satırına bağlanacağı kanalın veri modeline göre belirlenir.
Durum doğrulama
API izin veriyorsa pazaryeri durumu okunur; izin vermiyorsa SatGitsin gönderim kaydı ayrı ve açık biçimde gösterilir.
Trendyol, Hepsiburada, N11, Pazarama, Idefix ve ÇiçekSepeti farkları
Kanalların kullandığı kimlikler ve geri bildirim düzeyi farklıdır. Aşağıdaki tablo SatGitsin’deki entegrasyon yaklaşımını özetler; pazaryerleri API kurallarını değiştirdiğinde kapsam yeniden doğrulanır.
| Pazaryeri | Gönderim biçimi | Bağlanan kayıt | Durum yaklaşımı |
|---|---|---|---|
| Trendyol | Link veya dosyaPDF/JPEG/PNG desteği | Paket kimliği | Paket cevabı ve SatGitsin gönderim kaydı birlikte değerlendirilir. |
| Hepsiburada | Fatura linkiPaket fatura servisi | Paket numarası | Faturası eksik paketler servisiyle yüklenmemiş kayıtlar ayrıca doğrulanabilir. |
| N11 | HTTPS fatura linkiSOAP fatura servisi | Sipariş numarası | API’de link görünüyorsa doğrulanır; panelden veya başka kanaldan yüklenen belge her zaman geri okunamayabilir. |
| Pazarama | Fatura linkiSipariş, paket veya ürün bazlı | Sipariş ve gerekirse paket/ürün | Gönderim cevabı kaydedilir; dış sistem gönderimleri API kapsamına göre belirsiz kalabilir. |
| Idefix | HTTPS link veya PDFPDF güvenli bağlantıya dönüştürülür | Shipment ID | Başarılı gönderim cevabı kaydedilir; ayrı geri okuma servisi olmadığı için dış sistem gönderimleri bilinmeyen kalır. |
| ÇiçekSepeti | PDF e-posta ekiGeçerli PDF · en fazla 5 MB | Sipariş verisindeki fatura e-postası | E-posta sağlayıcısının kabulü ve SatGitsin gönderim tarihçesi izlenir; pazaryeri okuma/onay durumu varsayılmaz. |
“Bilgi yok”, “gönderilmedi” demek değildir. Bir pazaryeri dışarıdan yapılan fatura yüklemelerini API ile paylaşmıyorsa SatGitsin bu siparişi kesin biçimde gönderilmedi olarak etiketlemez; doğrulanamayan durumu ayrıca gösterir.
Fatura durumları nasıl doğru okunur?
Durum etiketinin kaynağı kullanıcıya açık olmalıdır. Böylece başka bir fatura entegratörünün yüklediği belgeyle SatGitsin üzerinden gönderilen belge birbirine karışmaz.
PDF dosyası neden kalıcı bir URL’ye dönüştürülür?
N11 ve Pazarama gibi link bekleyen servislerde yerel bilgisayardaki bir PDF doğrudan kullanılamaz. Belge güvenli depolamaya alınır ve pazaryerinin erişebildiği HTTPS adresi üretilir. URL’nin oturum açma ekranına yönlenmemesi, doğru dosya türünü açması ve süresi dolmaması gerekir.
PDF seç → güvenli bağlantı oluştur → siparişe gönder
Kullanıcı faturayı seçer. SatGitsin dosya türünü ve boyutunu doğrular, tahmin edilmesi zor bir belge adresi oluşturur ve bağlantıyı ilgili pazaryeri servisine iletir.
HTTPS- Doğru içerik türü
- Kalıcı erişim
- Yetkisiz listeleme yok
- Siparişle doğru eşleşme
Fatura bağlantısında güvenlik ve saklama
Fatura kişisel ve finansal bilgi içerebilir. Bağlantı arama motorlarına veya herkese açık dosya listelerine dahil edilmemeli, dosya adı tahmin edilememeli ve aktarım HTTPS üzerinden yapılmalıdır. Pazaryerinin yasal saklama şartı varsa belge yaşam döngüsü buna göre planlanmalıdır.
Tahmin edilemeyen adres
Sıralı sipariş numarası yerine yeterli rastgelelik içeren belge anahtarı kullanılır; dizin listeleme kapalı tutulur.
Uzun süreli erişim
Örneğin Trendyol’a iletilen fatura bağlantılarının hukuki gereklilik nedeniyle 10 yıl erişilebilir kalması gerekir.
Otomatik fatura entegrasyonu nasıl kurulmalı?
Harici e-fatura sağlayıcısı belgeyi oluşturduğunda akış sipariş numarasıyla eşleşmeli, doğru kapsam seçilmeli ve başarısız gönderimler yeniden denenmelidir. Aynı faturanın iki kez gönderilmesini önlemek için kanal cevabı ve SatGitsin işlem kaydı birlikte tutulur.
Belge hazırlanır
Fatura PDF veya desteklenen görsel biçiminde oluşturulur; numara ve tarih gerekiyorsa doğrulanır.
Doğru kapsam seçilir
Sipariş numarası, paket kimliği, kargo paketi veya ürün satırı pazaryerinin beklediği alana bağlanır.
API gönderimi yapılır
Link ya da dosya kanalın resmî servisine iletilir ve dönen başarı/hata cevabı kaydedilir.
Durum yeniden okunur
Pazaryeri bir sorgulama alanı sunuyorsa gönderim durumu periyodik yenilemede tekrar doğrulanır.
Pazaryeri fatura entegrasyonu hakkında sık sorulanlar
Pazaryerine fatura dosyası mı, fatura linki mi gönderilir?
Bu yöntem pazaryerine göre değişir. Bazı kanallar kalıcı HTTPS fatura bağlantısı, bazıları PDF veya görsel dosya, bazıları ise her iki yöntemi destekler.
Fatura gönderildi durumu bütün pazaryerlerinde aynı şekilde doğrulanabilir mi?
Hayır. Pazaryerinin API kapsamına göre durum pazaryeri tarafından doğrulanmış, SatGitsin tarafından gönderilmiş veya dışarıdan yapılan gönderim için bilinmiyor olarak gösterilebilir.
Fatura bağlantısı neden herkese açık HTTPS adresi olmalıdır?
Pazaryeri ve müşteri fatura belgesine oturum açmadan ulaşabilmelidir. Bağlantı HTTPS kullanmalı, tahmin edilmesi zor olmalı ve belgeyi doğru içerik türüyle açmalıdır.
Paket bölünmüşse faturayı hangi kayda göndermek gerekir?
Sipariş, paket veya ürün satırı kapsamı pazaryerinin API modeline göre seçilir. Yanlış kapsam seçilirse faturanın yalnız bir pakete ulaşması veya reddedilmesi mümkündür.