Mengubah siklus penagihan langganan pelanggan
Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Tip
API ini memungkinkan Anda memodifikasi frekuensi penagihan hanya untuk langganan warisan.
Untuk memodifikasi frekuensi penagihan untuk langganan Pengalaman Perdagangan Baru (NCE) dan langganan warisan, Anda dapat menggunakan Perbarui langganan berdasarkan ID - Pengembang aplikasi mitra | Microsoft Learn API.
Memperbarui Pesanan dari tagihan bulanan ke tahunan atau dari penagihan tahunan ke bulanan.
Di Pusat Mitra, operasi ini dapat dilakukan dengan menavigasi ke halaman detail langganan pelanggan. Setelah berada di sana, Anda akan melihat opsi yang menentukan siklus penagihan saat ini untuk langganan dengan kemampuan untuk mengubah dan mengirimkannya.
Di luar cakupan untuk artikel ini:
- Mengubah siklus penagihan untuk uji coba
- Mengubah siklus penagihan untuk setiap penawaran jangka waktu non-tahunan (bulanan, enam tahun) & langganan Azure
- Mengubah siklus penagihan untuk langganan yang tidak aktif
- Mengubah siklus penagihan untuk langganan berbasis lisensi Microsoft layanan online
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
ID pelanggan (
customer-tenant-id
). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan , lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id
).ID pesanan.
C#
Untuk mengubah frekuensi siklus penagihan, perbarui properti Order.BillingCycle.
// IAggregatePartner partnerOperations;
// string customerId;
// string offerId;
// string orderId;
var order = new Order()
{
ReferenceCustomerId = customerId,
BillingCycle = BillingCycleType.Annual,
LineItems = new List<OrderLineItem>()
{
new OrderLineItem()
{
LineItemNumber = 0,
OfferId = offerId,
SubscriptionId = "69829602-C219-40FD-A3D5-4150FCA41A19",
Quantity = 1
}
}
};
var createdOrder = partnerOperations.Customers.ById(customerId).Orders.ById(orderId).Patch(order);
Permintaan REST
Minta sintaks
Metode | URI Permintaan |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1 |
Parameter URI
Tabel ini mencantumkan parameter kueri yang diperlukan untuk mengubah kuantitas langganan.
Nama | Tipe | Wajib | Deskripsi |
---|---|---|---|
customer-tenant-id | GUID | Y | ID penyewa pelanggan berformat GUID yang mengidentifikasi pelanggan |
id pesanan | GUID | Y | Pengidentifikasi pesanan |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tabel berikut ini menjelaskan properti dalam isi permintaan.
Pesanan
Properti | Tipe | Wajib | Deskripsi |
---|---|---|---|
Id | string | N | Pengidentifikasi pesanan yang disediakan setelah pembuatan pesanan berhasil |
ReferenceCustomerId | string | Y | Pengidentifikasi pelanggan |
BillingCycle | string | Y | Menunjukkan frekuensi yang ditagih mitra untuk pesanan ini. Nilai yang didukung adalah nama anggota yang ditemukan di BillingCycleType. |
LineItems | array objek | Y | Array sumber daya OrderLineItem |
CreationDate | datetime | N | Tanggal pesanan dibuat, dalam format tanggal-waktu |
Atribut | Objek | N | Berisi "ObjectType": "OrderLineItem" |
OrderLineItem
Properti | Tipe | Wajib | Deskripsi |
---|---|---|---|
LineItemNumber | number | Y | Nomor item baris, dimulai dengan 0 |
OfferId | string | Y | ID penawaran |
SubscriptionId | string | Y | ID langganan |
FriendlyName | string | N | Nama yang mudah diingat untuk langganan yang ditentukan oleh mitra untuk membantu memisahkan |
Quantity | number | Y | Jumlah lisensi atau instans |
PartnerIdOnRecord | string | N | PartnerID mitra rekaman |
Atribut | Objek | N | Berisi "ObjectType": "OrderLineItem" |
Contoh permintaan
Memperbarui ke penagihan tahunan
PATCH https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/orders/CF3B0E37-BE0B-4CDD-B584-D1A97D98A922 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 17a2658e-d2cc-439b-a2f0-2aefd9344fbc
MS-CorrelationId: 60efdd24-17ef-4080-9b02-4fc315f916ff
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 414
Expect: 100-continue
{
"Id": null,
"ReferenceCustomerId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
"BillingCycle" : "Annual",
"LineItems": [{
"LineItemNumber": 0,
"OfferId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"SubscriptionId": "69829602-C219-40FD-A3D5-4150FCA41A19",
"FriendlyName": "Some friendly name",
"Quantity": 2,
"PartnerIdOnRecord": null,
"Attributes": {
"ObjectType": "OrderLineItem"
}
}
],
"CreationDate": null,
"Attributes": {
"ObjectType": "Order"
}
}
Respons REST
Jika berhasil, metode ini mengembalikan urutan langganan yang diperbarui dalam isi respons.
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.
Contoh tanggapan
HTTP/1.1 200 OK
Content-Length: 1135
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 60efdd24-17ef-4080-9b02-4fc315f916ff
MS-RequestId: 17a2658e-d2cc-439b-a2f0-2aefd9344fbc
MS-CV: WtFy3zI8V0u2lnT9.0
MS-ServerId: 020021921
Date: Wed, 25 Jan 2017 23:01:08 GMT
{
"id": "cf3b0e37-be0b-4cdd-b584-d1a97d98a922",
"referenceCustomerId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
"billingCycle": "Annual",
"lineItems": [{
"lineItemNumber": 0,
"offerId": "195416C1-3447-423A-B37B-EE59A99A19C4",
"subscriptionId": "1C2B75C1-74A5-472A-A729-7F8CEFC477F9",
"friendlyName": "new offer purchase",
"quantity": 5,
"links": {
"subscription": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/1C2B75C1-74A5-472A-A729-7F8CEFC477F9",
"method": "GET",
"headers": []
}
}
},
{
"lineItemNumber": 1,
"offerId": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"subscriptionId": "69829602-C219-40FD-A3D5-4150FCA41A19",
"friendlyName": "Some friendly name",
"quantity": 2,
"links": {
"subscription": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/subscriptions/69829602-C219-40FD-A3D5-4150FCA41A19",
"method": "GET",
"headers": []
}
}
}
],
"creationDate": "2017-01-25T14:53:12.093-08:00",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/orders/cf3b0e37-be0b-4cdd-b584-d1a97d98a922",
"method": "GET",
"headers": []
}
},
"attributes": {
"etag": "eyJpZCI6ImNmM2IwZTM3LWJlMGItNGNkZC1iNTg0LWQxYTk3ZDk4YTkyMiIsInZlcnNpb24iOjJ9",
"objectType": "Order"
}
}
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk