Mağaza, ERP ve ödeme sisteminde iade verisini eşleştirmek

Mağazayı, ERP’yi ve ödeme hizmetini bağlarken bir iade için ortak bir “tamamlandı” alanı yeterli olmaz. Entegrasyon hangi kalemin geri geldiğini, stoğa ne olduğunu ve ilgili para iadesinin durumunu ayırt etmelidir. Bu ilişkileri bağlantıyı geliştirmeden önce belirleyin.

Bir durumu eksiksiz eşleştirmek

Kurgusal bir ev aksesuarı mağazası, O-86 siparişiyle iki vazo teslim etmiş ve bedelini almıştır. Bir vazo kenarı kırık olarak geri gelir. Örnekte bu vazo için 24 EUR para iadesi kararlaştırılmıştır. Ekip şu eşlemeyi planlıyor:

Bağlantı, kalem ve işlem referansları üzerinden kurulur. Aynı ürün birden fazla siparişte yer alıyorsa yalnız ürün adı veya ürün kodunun eşleşmesi yeterli değildir.

Entegrasyonun iç veri modelini belirlemek

Aşağıdaki kayıt, bu kurgusal durum için hazırlanmış özel bir tasarımdır; bir sağlayıcının API çağrısı değildir. Miktarlar ürün iadesi işlemine aittir; tutar EUR cent olarak yazılmıştır.

{
  "returnId": "R-86",
  "orderReference": "O-86",
  "shopOrderLine": "OL-86-A",
  "shopFulfillmentLine": "FL-86-A",
  "erpDeliveryLine": "DL-86-A",
  "receivedQuantity": 1,
  "saleableStockDelta": 0,
  "refund": {
    "paymentReference": "PAY-86",
    "amountMinor": 2400,
    "currency": "EUR",
    "state": "requested"
  }
}

Referanslar, mağaza sipariş kalemini, mağaza teslimat kalemini ve ilk ERP teslimat kalemini ödemeye bağlar. Ödeme hizmetinin döndürdüğü para iadesi referansını da bu işleme kaydedin. Kalem kesin olarak eşleştirilemiyorsa kayıt, ad karşılaştırmasıyla otomatik işlenmek yerine netleştirme için beklemelidir.

Her değişiklik için doğru kaynağı kullanmak

Örnekte mağaza, satın alınan kalemle bağlantıyı sağlar. ERP ürün girişini, inceleme sonucunu ve stoğun satışa açılmasını doğrular. Ödeme hizmeti para iadesinin durumunu sağlar. Bu sorumluluklar veri sözleşmesine yazılır; sistemlerin farklı iş bölümü, başka bir eşleme gerektirebilir.

Shopify’ın ReturnLineItem nesnesi bir Shopify teslimat kalemine bağlanır; ERP kalemiyle bağlantıyı entegrasyon kurmalıdır. Refund belgesi, bir kaydın varlığının başarılı para hareketini tek başına doğrulamadığını açıkça belirtir. Stripe da oluşturma, değişiklik ve başarısızlık için ayrı olaylar açıklar. Entegrasyon, gerçekten seçilen sağlayıcının durumlarını kendi iç modeline eşlemelidir.

Bu nedenle örnekte başarılı para iadesi yalnız ödeme durumunu değiştirmelidir. Hasarlı vazoyu satılabilir hâle getirmez. Ürünün depoya gelmesi de para iadesini kendiliğinden başarılı yapmaz.

Beklenen sonucu kontrol etmek

Durumu uygun bir test ortamında sınayın: Kısmi ürün iadesi doğru kaleme bağlı olmalı, stok değişimi 0 kalmalı ve 2400 cent doğru ödemeye ait olmalıdır. Başarılı para iadesi doğrulandığında ilgili durum değişir; ürün kullanıma kapalı kalır. Belirsiz ödeme yanıtı, belirsiz olarak görünmelidir. Yeniden gelen durum bildirimi aynı işlemi güncellemelidir. Teknik olarak tekrar işleme için ayrıca uygun bir idempotans stratejisi gerekir.

Kaynaklar

• Shopify — ReturnLineItem, GraphQL Admin API

• Shopify — Refund, GraphQL Admin API

• Stripe — Refund and cancel payments