Fatura Dosyası ile Bağlantı Kaydı
sendInvoiceLink servisi, işletmenin kendi sisteminde hazırladığı faturanın bağlantısını Trendyol sipariş paketiyle ilişkilendirir. Belgeyi üretmek ve bağlantısını pazaryerine bildirmek iki ayrı işlemdir. Muhasebe programında faturanın bulunması, müşteriye doğru paket üzerinden ulaştığını göstermez. Aynı şekilde bağlantı gönderiminin kabul edilmesi de belgedeki ürün, tutar veya müşteri bilgisinin işletme tarafından kontrol edilmesi gereğini ortadan kaldırmaz. İnceleme yapılırken paket kimliği, fatura numarası ve bağlantı üç ayrı alan olarak karşılaştırılır. Sipariş numarasını doğrudan paket kimliği yerine kullanmak yanlış eşleştirmeye yol açabilir.
409 Yanıtının İki Temel Nedeni
Trendyol, 409 yanıtı için iki olasılık açıklar: ilgili pakete daha önce fatura gönderilmiş olması veya aynı bağlantının başka pakete bağlanmış olması. Dolayısıyla bu yanıt her zaman faturanın eksik olduğunu göstermez. Daha önce başarılı gönderilen bir kaydın tekrar denenmesi de çakışma yaratabilir. Önce sistemdeki mevcut kayıt okunmalı, ardından beklenen belgeyle karşılaştırılmalıdır. Bağlantının sonuna rastgele parametre ekleyerek hatayı aşmaya çalışmak, yanlış eşlemenin nedenini gizleyebilir. Kayıt zaten doğruysa yeni belge veya ikinci bağlantı oluşturmaya ihtiyaç olmayabilir.
Yanlış Kaydı Değiştirirken
Trendyol, hatalı bildirilmiş fatura bağlantısını silmek ve sonrasında doğru bağlantıyı göndermek için ayrı bir servis sunar. Silme isteğinde paketle ilişkili serviceSourceId ve sipariş verisinden alınan customerId gibi alanlar kullanılır. Bu işlem yalnızca bağlantı ilişkisinin düzeltilmesi olarak değerlendirilmelidir; muhasebe belgesinin iptal edildiği sonucuna varılmaz. Önce mevcut belgenin neden yanlış olduğu belirlenir. Kurgusal bir örnekte aynı müşterinin iki ayrı paketi karıştırılmışsa her paketin faturası ayrı kontrol edilir. Bir kaydı düzeltirken diğer doğru kaydın erişimini kesmemek gerekir.
Bağlantının Erişilebilirliği
Fatura bağlantısı yalnızca yönetici oturumu açıkken çalışıyorsa müşteriye ulaşmayabilir. Süresi dolan geçici dosya adresleri veya yönlendirme sonrasında giriş ekranına düşen bağlantılar da sorun yaratır. Dosya, işletmenin belge erişim politikasına uygun ve kalıcı biçimde sunulmalıdır. Belge URL'sini herkese açık bir sayfada listelemek gerekmez; müşteriye ait kişisel veriler korunur. Testte doğru bağlantının doğru belgeyi açması, tarayıcı oturumundan bağımsız erişim koşulları ve dosyanın gerçekten PDF olup olmadığı incelenir. Teknik erişim değerlendirmesi, belgenin muhasebe bakımından geçerliliğine ilişkin ayrı kontrollerin yerine geçmez.
Tekrar Gönderim ve Kayıt Takibi
Zaman aşımı yaşandığında isteğin karşı tarafta işlenip işlenmediği belirsiz kalabilir. Uygulamanın aynı işlemi sınırsız tekrar etmesi yerine mevcut ilişkiyi doğrulaması daha güvenilir bir yaklaşımdır. Gönderim kaydı; paket kimliği, belge tanımlayıcısı, yanıt kodu ve işlem zamanını içermelidir. Düzeltme yapıldıysa önceki ve yeni ilişki izlenebilir olmalıdır. Fatura içeriğini veya müşterinin kişisel bilgilerini hata mesajına bütünüyle yazmak gerekmez. Son kontrolde müşteri için geçerli belgenin doğru paketten erişildiği görülmeli; başarılı eski kayıtlar tekrar işlenmeden korunmalıdır. Böylece 409 uyarısının gerçek veri hatası mı, yinelenen işlem mi olduğu anlaşılır.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- Kişisel Veri
- Kişisel veri, kimliği belirli ya da belirlenebilir gerçek kişiye ilişkin her türlü bilgidir; e-ticarette ad, adres, telefon, e-posta, sipariş geçmişi ve IP adresi gibi veriler bu kapsamdadır.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
Trendyol