Universal Commerce Protocol (UCP) Mimarisi ve Entegrasyon Rehberi

Universal Commerce Protocol (UCP), parçalanmış e-ticaret ekosistemini yapay zeka ajanları (AI Agents) için standardize eden, platformlar arası veri akışını ve işlem yetkilendirmesini yöneten dinamik bir koordinasyon sistemidir. Bu protokol, statik API entegrasyonlarının ötesine geçerek, keşiften ödemeye (checkout) kadar olan tüm ticaret yaşam döngüsünü ortak bir mesajlaşma şeması üzerinde birleştirir. Geleneksel "insan odaklı" arayüzlerin aksine, UCP makineler arası (M2M) semantik bir dil oluşturarak ajanların otonom işlem yapabilmesini sağlar.

E-ticaret altyapılarının her biri farklı veri yapılarına sahiptir. UCP, bu farklılıkları bir soyutlama katmanı ile giderir ve ajanların herhangi bir satıcıyla önceden entegrasyon kurmadan etkileşime girmesine olanak tanır. Protokol, "niyet" (intent) ve "yetenek" (capability) eşleşmesi üzerinden çalışarak, dijital ticaretin operasyonel yükünü minimize eder.

Bu rehber, UCP mimarisini oluşturan ilkel yapı taşlarını, güvenlik protokollerini ve entegrasyon standartlarını teknik derinlikte ele almaktadır.

Parçalanmış Ticaret Ekosisteminin Koordinasyonu ve Protokol İhtiyacı

1. N x N Entegrasyon Darboğazı ve Ölçeklenebilirlik Sorunu
2. Protokol Tabanlı Soyutlama Katmanı (Abstraction Layer)
3. Ortak Mesajlaşma Şemaları ve Veri Uyumluluğu

N x N Entegrasyon Sorunu ve Ortak Dil Gereksinimi

Mevcut e-ticaret ekosisteminde, her bir AI agentının (Executor) binlerce farklı satıcı (Provider) ile iletişim kurabilmesi için her biriyle ayrı ayrı API entegrasyonu yapması gerekmektedir. Bu durum, sürdürülemez bir "N to N" entegrasyon darboğazı yaratır. UCP, bu karmaşıklığı ortadan kaldırarak tek bir standart üzerinden evrensel erişim sağlar.

• Entegrasyon Maliyeti: Her yeni satıcı için özel kod yazma zorunluluğunu ortadan kaldırır.
• Standart Arayüzler: Farklı platformların envanter verilerini ortak bir formatta sunar.
• Ölçeklenebilirlik: Ajanların, protokolü destekleyen tüm satıcılarla anında çalışabilmesini mümkün kılar.
• Veri Tutarlılığı: Ürün, fiyat ve stok verilerinin ajanlar tarafından hatasız işlenmesini sağlar.

Bu yapı, satıcıların teknoloji yığınından bağımsız olarak, ideasoft'un modern altyapılarını kullanan işletmelerin dahi ajan tabanlı ekonomiye zahmetsizce dahil olmasını sağlar. Protokol, satıcı ve ajan arasına girerek veri çevirisini ve akış kontrolünü otomatikleştirir.

N x N entegrasyon sorununun çözülmesi, e-ticaretin sadece insanlar tarafından değil, otonom yazılımlar tarafından da yürütülebilir hale gelmesinin ön koşuludur; UCP bu sorunu yapısal bir "Common Language" (Ortak Dil) ile çözer.

Spesifikasyon Mimarisi: Primitives, Sürümleme ve Uyumluluk Normları

UCP mimarisi, ticaretin temel eylemlerini (arama, sepete atma, ödeme) tanımlayan "Primitives" (ilkel yapı taşları) üzerine kuruludur. Bu yapı taşları, katı "MUST" ve esnek "SHOULD" kuralları ile belirlenmiş uyumluluk normlarına tabidir. Sürümleme mekanizması, protokol geliştikçe geriye dönük uyumluluğun korunmasını garanti eder.

• Message Schema: İstek ve yanıtların JSON tabanlı yapısal formatı.
• Versioning: Protokol güncellemelerinde entegrasyonların kırılmasını önleyen sürüm kontrolü.
• Extension Points: Sektöre özel ihtiyaçlar (örn: reçeteli ilaç satışı) için özelleştirilebilir alanlar.
• Error Handling: Ajanların anlayabileceği standart hata kodları ve çözüm yolları.

Spesifikasyonun katı kurallara bağlanması, farklı geliştiriciler tarafından yazılan ajanların ve satıcı sistemlerinin öngörülebilir şekilde çalışmasını sağlar. Bu deterministik yapı, otonom süreçlerdeki hata payını minimize eder.

Sonuç olarak, primitives ve uyumluluk normları, UCP'nin sadece bir öneri değil, uygulanabilir ve denetlenebilir bir teknik standart olarak işlev görmesini sağlar.

Ajan Tabanlı Keşif Süreçleri ve Yetenek Beyanı

1. Semantik Arama ve Niyet Eşleşmesi
2. Yapısal Veri ile Yetenek Bildirimi
3. Dinamik Fiyatlandırma ve Teklif Yönetimi

Satıcı Yeteneklerinin Ajanlara Bildirilmesi

Ticaretin başlatılma aşaması, ajanın kullanıcının niyetiyle eşleşen satıcıyı bulmasıyla başlar. İnsanların görsel arayüzlerde yaptığı eyleminin yerini, ajanların dosyalarını taraması alır. Satıcılar, ne satabildiklerini ve hangi kurallarla işlem yapabildiklerini bu deklarasyonlarla yayınlar.

• Catalog Source: Ürünlerin ve varyasyonların makine okunabilir formatta sunulması.
• Policy Definition: İade, kargo ve vergi kurallarının yapısal olarak belirtilmesi.
• Service Levels: Teslimat hızı ve destek seçeneklerinin yetenek olarak tanımlanması.
• Endpoint Discovery: Ajanın iletişim kuracağı API uç noktalarının dinamik keşfi.

Bu süreç, klasik SEO mantığından ayrılarak "Semantik Keşif" kavramını ortaya çıkarır. Ajanlar anahtar kelimelere göre değil, satıcının sunduğu yapısal yetenek setine ve işlem kapasitesine göre tercih yapar.

Yetenek beyanı, satıcının dijital varlığının ajanlar tarafından "görünür" ve "işlenebilir" kılınmasını sağlayan temel protokoldür; bu olmadan otonom ticaret başlayamaz.

Geleneksel vs. Agent Tabanlı Ticaret Karşılaştırması

Özellik / Bağlam	Geleneksel E-Ticaret (İnsan Odaklı)	UCP Destekli Ticaret (Ajan Odaklı)
Keşif Yöntemi	Görsel tarama, anahtar kelime arama (SEO)	Yetenek sorgulama, yapısal veri analizi
Sepet Mantığı	Kullanıcı tarafından manuel ekleme	Ajan tarafından mantıksal oluşturma
Kimlik/Ödeme	Her sitede form doldurma / Login olma	Identity Linking ile yetkilendirilmiş otomatik akış
Rekabet Alanı	Ön yüz (UI) tasarımı, görsel çekicilik	Fiyat, hız, envanter doğruluğu, veri kalitesi
Entegrasyon	Her pazar yeri için ayrı API	Tek protokol

Dinamik Teklif Oluşturma ve Pazarlık Altyapısı

UCP, statik fiyat listeleri yerine, ajanın bağlamına göre (örn: sadakat puanı, toplu alım) dinamik teklif (Offer) oluşturulmasına olanak tanır. "Negotiator" rolündeki ajan ile "Pricing Source" rolündeki satıcı sistemi arasında milisaniyeler içinde gerçekleşen bir pazarlık oturumu kurgulanır.

• Context Awareness: Alıcının geçmişi veya sepet büyüklüğüne göre özel fiyatlama.
• Real-time Inventory: Stok durumuna göre anlık fiyat veya promosyon değişimi.
• Bundling Logic: Ajanın talebine uygun paket ürün tekliflerinin oluşturulması.
• Validity Period: Teklifin geçerlilik süresinin (TTL) protokol ile belirlenmesi.

Dinamik teklif mekanizması, e-ticareti sabit bir katalogdan çıkarıp, her işlem için özelleşmiş bir "Ticaret Anlaşması" haline getirir. Bu yapı, B2B süreçlerinde ve kişiselleştirilmiş perakendede verimliliği artırır.

Pazarlık altyapısı, fiyatlandırmayı statik bir veri olmaktan çıkarıp, talep anında hesaplanan dinamik bir fonksiyona dönüştürür.

İşlem Yürütme: Dinamik Ödeme Oturumu ve Sepet Yönetimi

1. Sepet Nesnesi ve Durum Yönetimi
2. Vergi, Kargo ve İndirimlerin Hesaplanması
3. Ödeme Sağlayıcı (PSP) ile Güvenli El Sıkışma

Birleşik Ödeme Oturumu Yaşam Döngüsü

UCP'de "Checkout", kullanıcının bir butona basması değil, ajanın yönettiği karmaşık bir durum makinesidir. "Unified Checkout Session", sepetin oluşturulmasından vergilerin hesaplanmasına ve işlemin kesinleşmesine kadar olan süreci standart bir yaşam döngüsü içinde yönetir.

• Cart Building: Ürünlerin mantıksal kurallarla sepete eklenmesi.
• Tax Calculation: Teslimat adresine göre dinamik vergi hesaplaması.
• Shipping Selection: Mevcut kargo seçeneklerinin maliyet ve süreyle sunulması.
• Finalization: Tüm parametrelerin kilitlenip ödeme emrinin oluşturulması.

Bu döngüde bağlam duyarlılığı kritiktir; basit bir dijital ürün satışı ile gümrük vergisi gerektiren fiziksel bir ihracat işlemi, aynı protokol üzerinde farklı parametre setleriyle işlenir.

Birleşik ödeme oturumu, sepetin terk edilme riskini azaltan ve karmaşık iş kurallarını standardize eden merkezi bir yürütme motorudur.

Ödeme Rayları ve Sağlayıcı Entegrasyonu

UCP bir ödeme yöntemi değildir; ödeme sağlayıcıları (PSP) ile ajanlar arasında güvenli bir köprü kuran protokoldür. "Funds Mover" rolündeki Stripe, PayPal veya yerel sanal POS sağlayıcıları, protokol üzerinden gelen yetkilendirilmiş ödeme emirlerini işler.

• Tokenization: Hassas kart verilerinin protokol üzerinde açık taşınmaması.
• PSP Agnosticism: Protokolün, altyapıdaki ödeme sağlayıcısından bağımsız çalışması.
• Transaction State: Ödeme başarısız olduğunda ajana dönen detaylı hata kodları.
• 3D Secure Handling: İnsan müdahalesi gerektiren doğrulama adımlarının yönetimi.

Bu ayrım, ödeme güvenliği standartlarının (PCI-DSS) korunmasını sağlarken, ajanların cüzdan seçimi konusunda esnek olmasını mümkün kılar. Ödeme rayları, finansal işlemin gerçekleştiği fiziksel katman iken, UCP bu katmanı yöneten mantıksal katmandır.

Ödeme sağlayıcı entegrasyonu, işlemin finansal bacağını "frictionless" (sürtünmesiz) hale getirerek, ajanın satın alma eylemini tamamlamasını sağlar.

Kimlik Doğrulama ve Yetkilendirilmiş Satın Alma Güvenliği

1. Kullanıcı Adına Hareket Etme
2. Rıza Token'ları ve Kapsam
3. Veri Gizliliği ve Sorumluluk Sınırları

Identity Linking: Kullanıcı Adına Hareket Etme İzni

Ajanların en büyük riski olan "yetkisiz işlem" sorunu, "Identity Linking" mekanizması ile çözülür. Kullanıcı ajana belirli sınırlar ve süreler dahilinde işlem yapma yetkisi verir. Bu süreç, OAuth benzeri akışlarla yönetilen "Consent Token"lar (Rıza Jetonları) üzerinden yürütülür.

• Scope Definition: Ajanın harcama limitinin ve işlem tipinin (örn: sadece kitap alabilir) kısıtlanması.
• Credential Provider: Kimlik doğrulama işlemini yürüten güvenilir otorite.
• Audit Logs: Ajanın yaptığı her işlemin kullanıcı tarafından denetlenebilir kaydı.
• Revocation: Verilen yetkinin kullanıcı tarafından anında geri alınabilmesi.

Bu güvenlik katmanı, kullanıcının kredi kartı bilgisini ajana vermesini değil, ajanı "yetkilendirmesini" sağlar. Böylece güvenlik riski dağıtılır ve kontrol kullanıcıda kalır.

Merchant of Record ve Sorumluluk Paylaşımı

İşlem sırasında yasal satıcının (Merchant of Record) kim olduğu ve sorumluluğun nerede başladığı UCP normlarıyla belirlenir. Satıcı (Merchant), yasal yükümlülükleri (vergi, ayıplı mal vb.) üstlenirken, platform veya ajan (Platform) sadece aracılık rolünü üstlenir.

• Legal Clarity: Faturayı kesen tarafın protokolde açıkça belirtilmesi.
• Privacy-Protecting Delegation: Müşteri verisinin (PII) sadece gerekli olduğunda satıcıyla paylaşılması.
• Dispute Resolution: Anlaşmazlık durumunda başvurulacak merciinin tanımlanması.
• Compliance Data: GDPR/KVKK uyumluluğu için veri işleme izinlerinin aktarımı.

Bu yapı, ideasoft kullanan bir satıcının, Google veya başka bir platformun ajanı üzerinden satış yaparken kendi yasal haklarını ve müşteri verisi üzerindeki kontrolünü korumasını sağlar.

Merchant of Record modeli, otonom ticarette yasal gri alanları ortadan kaldırarak, şeffaf ve hesap verebilir bir ticaret ortamı oluşturur.

Sipariş Yaşam Döngüsü Yönetimi ve Satış Sonrası Destek

1. Sipariş Durum Nesneleri
2. Asenkron Bildirimler ve Webhook'lar
3. İade ve Değişim Protokolleri

Asenkron Durum Güncellemeleri ve Takip

Satış işlemi tamamlandığında protokolün görevi bitmez; Sipariş Yönetimi fazı başlar. Ajan, kullanıcının sürekli siteye girip "Kargom nerede?" diye kontrol etmesi yerine, asenkron durum güncellemeleriyle süreci proaktif olarak takip eder.

• Status Objects: "Hazırlanıyor", "Kargoda", "Teslim Edildi" gibi standart durum kodları.
• Tracking URLs: Kargo firmasının takip verisinin yapısal olarak sunulması.
• Push Notifications: Durum değişikliğinin ajana anlık olarak bildirilmesi.
• Estimated Delivery: Tahmini teslimat süresinin dinamik güncellenmesi.

Bu akış, müşteri hizmetleri üzerindeki "Nerede?" yükünü azaltır ve ajanın kullanıcıyı bilgilendirmesini sağlar.

Asenkron takip sistemi, ticaret deneyimini "satın al ve unut" kolaylığına taşıyarak, satış sonrası memnuniyeti algoritmik olarak yönetir.

İade ve Destek Taleplerinin Protokol Üzerinden Yönetimi

İade talebinin ajan tarafından başlatılması ve satıcı sisteminin onayı, UCP'nin çift yönlü işlem yeteneğini gösterir. Kullanıcı, arayüzde form doldurmak yerine ajana "Bunu iade et" komutunu verir ve protokol arka planda süreci işletir.

• Return Eligibility: Ürünün iadeye uygun olup olmadığının (süre/hijyen) kontrolü.
• RMA Generation: İade onay kodunun ve kargo etiketinin otomatik üretimi.
• Refund Status: Para iadesinin durumunun takip edilmesi.
• Reason Codes: İade nedenlerinin standart kodlarla (örn: "Beden uymadı") iletilmesi.

Bu entegrasyon, tersine lojistik süreçlerini hızlandırır ve manuel operasyon maliyetlerini düşürür.

İade yönetimi protokolü, e-ticaretin en sancılı sürecini standart bir veri akışına dönüştürerek, hem satıcı hem de alıcı için sürtünmeyi ortadan kaldırır.

Otonom Ticaretin Yapısal Temeli

Universal Commerce Protocol (UCP), e-ticaretin geleceğini şekillendiren "Agent Tabanlı Ekonomi"nin (Agentic Economy) omurgasını oluşturmaktadır. Bu protokol, sadece bir teknoloji güncellemesi değil, ticaretin yürütülme şeklindeki köklü bir paradigma değişimidir; görsel arayüzlerden semantik veri akışlarına geçişi temsil eder. İşletmelerin bu yeni dönemde var olabilmesi, kataloglarını sadece insanların değil, yapay zeka ajanlarının da okuyup anlayabileceği standartlarda (Machine Readable) sunmasına bağlıdır. UCP, keşiften ödemeye, güvenlikten iade yönetimine kadar tüm süreçleri standardize ederek, küresel ticaretin birlikte çalışabilirliğini (Interoperability) garanti altına alan nihai koordinasyon sistemidir.

Sıkça Sorulan Sorular