Sumber daya keranjang

Artikel
03/07/2025

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Mitra melakukan pemesanan saat pelanggan ingin membeli langganan dari daftar penawaran.

Keranjang

Menjelaskan keranjang.

Harta benda	Jenis	Deskripsi
id	tali	Pengidentifikasi keranjang yang disediakan setelah keberhasilan pembuatan keranjang.
creationTimeStamp	TanggalWaktu	Tanggal keranjang dibuat, dalam format tanggal dan waktu. Diterapkan ketika pembuatan keranjang berhasil.
lastModifiedTimeStamp	TanggalWaktu	Tanggal kereta terakhir diperbarui, dalam format tanggal-waktu. Diterapkan setelah pembuatan keranjang yang berhasil.
cap waktu kedaluwarsa	Tanggal dan Waktu	Tanggal kadaluwarsa keranjang dalam format tanggal dan waktu. Diterapkan setelah pembuatan keranjang berhasil.
lastModifiedUser	string	Pengguna yang terakhir memperbarui keranjang. Diterapkan setelah keranjang berhasil dibuat.
lineItems	Array dari objek	Sebuah array sumber daya CartLineItem .
keadaan	string	Status keranjang. Nilai yang mungkin adalah "Aktif" (dapat diperbarui/dikirimkan) dan "Diurutkan" (telah dikirimkan).

CartLineItem

Mewakili satu item yang terkandung dalam keranjang.

Harta benda	Jenis	Deskripsi
Id	tali	Pengidentifikasi unik untuk item garis keranjang. Diterapkan setelah keberhasilan pembuatan keranjang.
catalogItemId	string	Pengidentifikasi item dalam katalog.
friendlyName	tali	Fakultatif. Nama yang ramah untuk item yang ditentukan oleh mitra untuk membantu membedakan.
jumlah	Int	Jumlah lisensi atau jumlah instance.
kodeMataUang	string	Kode mata uang.
billingCycle	Objek	Jenis siklus penagihan yang ditetapkan untuk periode saat ini.
durasiMasa	string	Representasi ISO 8601 dari durasi periode. Nilai yang didukung saat ini adalah P1M (satu bulan), P1Y (satu tahun) dan P3Y (tiga tahun).
Peserta	Daftar pasangan Objek dan String	Kumpulan PartnerID yang tercatat pada pembelian.
konteks penyediaan	Kamus<string, string>	Konteks tambahan yang digunakan saat menyediakan item yang dibeli. Untuk menentukan nilai yang dibutuhkan untuk item tertentu, cari referensi pada properti provisioningVariables SKU.
orderGroup	tali	Grup untuk menunjukkan item mana yang dapat dikirimkan bersama-sama dalam urutan yang sama.
item tambahan	Daftar objek CartLineItem	Kumpulan item baris untuk tambahan. Item-item ini akan dibeli untuk langganan dasar yang berasal dari pembelian item baris keranjang utama.
kesalahan	Objek	Diterapkan setelah keranjang dibuat jika terjadi kesalahan.
memperbarui ke	Array dari objek	Array sumber daya RenewsTo.
Pengesahan Diterima	bool	Menunjukkan persetujuan terhadap penawaran atau ketentuan SKU. Diperlukan hanya untuk penawaran atau sku di mana SkuAttestationProperties atau OfferAttestationProperties memiliki enforceAttestation yang bernilai True.
promotionId	tali	ID promosi yang akan diterapkan ke item baris keranjang.
Tanggal Akhir Ketentuan Khusus	TanggalWaktu	Tanggal akhir jangka waktu penagihan pertama langganan baru.

Harga

Mewakili detail harga. Jumlah harga disediakan sebelum perpajakan.

Harta benda	Jenis	Diperlukan	Deskripsi
listPrice	ganda	Tidak	Harga yang tercantum dalam katalog tanpa pengubah harga apa pun yang diterapkan.
harga diskon	ganda	Tidak	Harga setelah menerapkan semua pengubah harga yang berlaku.
harga pro-rata	ganda	Tidak	Diskon harga setelah prorasi dilakukan.
harga	ganda	Tidak	Harga dalam mata uang penagihan yang berlaku setelah semua diskon diterapkan dan perhitungan prorata telah dilakukan.
Harga Diperpanjang	ganda	Tidak	Harga item baris dengan kuantitas, diskon, serta prorasi yang sudah diterapkan, dalam mata uang penagihan yang berlaku.

Perpanjang Ke

Mewakili satu item yang terkandung dalam item garis keranjang.

Harta benda	Jenis	Diperlukan	Deskripsi
durasi periode	tali	Tidak	Representasi ISO 8601 dari durasi jangka waktu perpanjangan. Nilai yang didukung saat ini adalah P1M (satu bulan) dan P1Y (satu tahun).

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat kode kesalahan Pusat Mitra .

CartError

Mewakili kesalahan yang terjadi setelah keranjang dibuat.

Harta benda	Jenis	Deskripsi
kodeError	CartErrorCode	Jenis kesalahan pada keranjang.
deskripsiKesalahan	string	Deskripsi kesalahan, termasuk catatan apa pun tentang nilai yang didukung, nilai default, atau batasan.
informasi tambahan	Informasi Tambahan	Informasi tambahan tentang kesalahan.

Informasi Tambahan

Informasi tambahan tentang kesalahan.

Harta benda	Jenis	Deskripsi
jumlahTersedia	Int	Jumlah sisa lisensi yang dapat dibeli untuk SKU produk yang diberikan.
jumlahDibeli	Int	Jumlah lisensi yang dibeli.

CartErrorCode

Jenis kesalahan keranjang.

Nama	Kode Kesalahan	Deskripsi
Mata uang tidak didukung	10.000	Mata uang tidak didukung untuk pasar tertentu
IdItemKatalogTidakValid	10001	ID katalog item tidak valid
KuotaTidakTersedia	10002	Tidak tersedia cukup kuota
PersediaanTidakTersedia	10003	Inventori tidak tersedia untuk penawaran yang dipilih
PesertaTidakDidukungUntukMitra	10004	Mengatur peserta tidak didukung untuk Mitra
Tidak Dapat Memproses Item Keranjang	10006	Tidak dapat memproses item lini keranjang.
LanggananTidakValid	10007	Langganan tidak valid.
LanggananTidakDiaktifkanUntukRI	10008	Langganan tidak diaktifkan untuk pembelian reservasi.
Batas Sandbox Terlampaui	10009	Batas kotak pasir telah terlampaui.
Input Tidak Valid	10010	Input generik tidak valid.
LanggananBelumDidaftarkan	10011	Langganan tidak valid.
Pernyataan Tidak Diterima	10012	Pengesahan belum diterima.
Jumlah Maksimal Kursi per Langganan Terlampaui	10015	Jumlah seat yang diminta melebihi batas.
Tidak Diketahui	0	Nilai default

HasilPembayaranKeranjang

Mewakili hasil checkout keranjang.

Harta benda	Jenis	Deskripsi
Pesanan	Daftar objek Urutan .	Pengumpulan pesanan.
orderErrors	Daftar objek OrderError.	Kumpulan kesalahan pesanan.

Kesalahan Pesanan

Mewakili kesalahan yang terjadi selama proses pembayaran saat pesanan dibuat.

Harta benda	Jenis	Deskripsi
IDKelompokPesanan	tali	ID grup pesanan dengan kesalahan.
kode	Int	Kode kesalahan.
deskripsi	string	Deskripsi kesalahan.

Bagikan melalui