Sepet kaynakları

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

İş ortağı, müşteri teklif listesinden abonelik satın almak istediğinde sipariş verir.

Alışveriş sepeti

Bir sepeti açıklar.

Özellik	Tür	Açıklama
kimlik	dize	Sepetin başarıyla oluşturulmasından sonra sağlanan bir sepet tanımlayıcısı.
creationTimeStamp	Tarih-Saat	Sepetin oluşturulduğu tarih, tarih-saat biçiminde. Sepet başarıyla oluşturulduktan sonra uygulanır.
lastModifiedTimeStamp	Tarih-Saat	Sepetin son güncelleştirildiği tarih( tarih-saat biçiminde). Sepet başarıyla oluşturulduktan sonra uygulanır.
expirationTimeStamp	Tarih-Saat	Sepetin süresinin dolacağı tarih, tarih-saat biçimindedir. Sepet başarıyla oluşturulduktan sonra uygulanır.
lastModifiedUser	Dize	Sepeti son güncelleştiren kullanıcı. Sepet başarıyla oluşturulduktan sonra uygulanır.
lineItems	Nesne dizisi	CartLineItem kaynakları dizisi.
status	Dize	Sepetin durumu. Olası değerler "Etkin" (güncelleştirilebilir/gönderilebilir) ve "Sıralı" (zaten gönderildi) değerleridir.

CartLineItem

Sepette bulunan bir öğeyi temsil eder.

Özellik	Tür	Açıklama
kimlik	dize	Sepet satırı öğesi için benzersiz tanımlayıcı. Sepet başarıyla oluşturulduktan sonra uygulanır.
catalogItemId	Dize	Katalog öğesi tanımlayıcısı.
Friendlyname	Dize	isteğe bağlı. Belirsizliği gidermek için iş ortağı tarafından tanımlanan öğenin kolay adı.
quantity	int	Lisans veya örnek sayısı.
currencyCode	Dize	Para birimi kodu.
billingCycle	Nesne	Geçerli dönem için ayarlanan faturalama dönemi türü.
termDuration	Dize	Terimin süresinin ISO 8601 gösterimi. Desteklenen geçerli değerler P1M (bir ay), P1Y (bir yıl) ve P3Y (üç yıl) değerleridir.
Katılımcı	Nesne Dizesi çiftlerinin listesi	Satın alma işlemindeki Kayıtlı İş Ortağı Kimliği koleksiyonu.
provisioningContext	Sözlük<dizesi, dize>	Satın alınan öğe sağlanırken kullanılan ek bağlam. Belirli bir öğe için hangi değerlerin gerekli olduğunu belirlemek için SKU'nun provisioningVariables özelliğine bakın.
orderGroup	Dize	Hangi öğelerin aynı sırada birlikte gönderilebileceğini belirten bir grup.
addonItems	CartLineItem nesnelerinin listesi	Eklentiler için sepet satırı öğeleri koleksiyonu. Bu ürünler, kök sepet satırı öğesinin satın alınmasıyla sonuçlanan temel aboneliğe doğru satın alınır.
error	Nesne	Bir hata oluştuğunda sepet oluşturulduktan sonra uygulanır.
renewsTo	Nesne dizisi	RenewsTo kaynakları dizisi.
AttestationAccepted	ikili	Teklif veya sku koşullarının sözleşmesini gösterir. Yalnızca SkuAttestationProperties veya OfferAttestationProperties enforceAttestation değerinin True olduğu teklifler veya sku'lar için gereklidir.
promotionId	Dize	Sepet satırı öğesine uygulanmak üzere olan promosyon kimliği.
customTermEndDate	Tarih-Saat	Yeni aboneliğin ilk faturalama döneminin bitiş tarihi.

Fiyatlandırma

Fiyat ayrıntılarını temsil eder. Fiyat tutarları vergilendirmeden önce sağlanır.

Özellik	Türü	Zorunlu	Tanım
Listprice	çift	Hayır	Fiyat değiştirici uygulanmadan katalogda listelenen fiyat.
discountedPrice	çift	Hayır	Geçerli tüm fiyatlandırma değiştirici uygulandıktan sonra fiyat.
eşit dağıtılmışFiyat	çift	Hayır	Proration yapıldıktan sonra indirimli fiyat.
price	çift	Hayır	Tüm indirimler uygulandıktan ve dağıtım yapıldıktan sonra geçerli faturalama para birimi cinsinden fiyat.
Toplamfiyat	çift	Hayır	Geçerli faturalama para birimi cinsinden, miktar, indirimler ve proration uygulanmış olan satır öğesinin fiyatı.

Yenilenenler

Sepet satırı öğesinde bulunan bir öğeyi temsil eder.

Özellik	Türü	Zorunlu	Tanım
termDuration	Dize	Hayır	Yenileme döneminin süresinin ISO 8601 gösterimi. Desteklenen geçerli değerler P1M (bir ay) ve P1Y (bir yıl) değerleridir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi hata kodları.

CartError

Sepet oluşturulduktan sonra oluşan bir hatayı temsil eder.

Özellik	Tür	Tanım
errorCode	CartErrorCode	Sepet hatasının türü.
Errordescription	Dize	Desteklenen değerler, varsayılan değerler veya sınırlar hakkındaki notlar da dahil olmak üzere hata açıklaması.
additionalInformation	AdditionalInformation	Hata için ek bilgiler.

AdditionalInformation

Hata hakkında ek bilgiler.

Özellik	Tür	Tanım
availableQuantity	int	Verilen ürün SKU'su için satın alınabilecek kalan lisans sayısı.
purchasedQuantity	int	Satın alınan lisans sayısı.

CartErrorCode

Sepet hatası türleri.

Ad	ErrorCode	Tanım
CurrencyIsNotSupported	10000	Para birimi verilen pazar için desteklenmiyor
CatalogItemIdIsNotValid	10001	Katalog öğesi kimliği geçerli değil
QuotaNotAvailable	10002	Yeterli kota yok
InventoryNotAvailable	10003	Seçili teklif için stok kullanılamıyor
ParticipantsIsNotSupportedForPartner	10004	Katılımcıları ayarlama İş Ortağı için desteklenmez
UnableToProcessCartLineItem	10006	Sepet satırı öğesi işlenemedi.
SubscriptionIsNotValid	10007	Abonelik geçerli değil.
SubscriptionIsNotEnabledForRI	10008	Rezervasyon satın alma işlemleri için abonelik etkinleştirilmedi.
SandboxLimitExceeded	10009	Korumalı alan sınırı aşıldı.
InvalidInput	10010	Genel giriş geçerli değil.
SubscriptionNotRegistered	10011	Abonelik geçerli değil.
AttestationNotAccepted	10012	Kanıtlama kabul edilmemiş.
MaxAllowedSeatsPerSubscriptionExceeded	10015	İstenen koltuk sayısı sınırı aşıyor.
Bilinmiyor	0	Default value

CartCheckoutResult

Sepet kullanıma alma işleminin sonucunu temsil eder.

Özellik	Tür	Tanım
siparişler	Order nesnelerinin listesi.	Sipariş koleksiyonu.
orderErrors	OrderError nesnelerinin listesi.	Sipariş hataları koleksiyonu.

OrderError

Sipariş oluşturulduğunda sepet alışverişi sırasında oluşan bir hatayı temsil eder.

Özellik	Tür	Tanım
orderGroupId	Dize	Hatayla birlikte siparişin sipariş grubu kimliği.
kod	int	Hata kodu.
açıklama	Dize	Hatanın açıklaması.