Mengonfirmasi penerimaan pelanggan atas Perjanjian Pelanggan Microsoft menggunakan API Pusat Mitra

Artikel
07/28/2023

Berlaku untuk: Pusat Mitra

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

Pusat Mitra saat ini mendukung konfirmasi penerimaan pelanggan Perjanjian Pelanggan Microsoft hanya di cloud publik Microsoft.

Artikel ini menjelaskan cara mengonfirmasi atau mengonfirmasi kembali penerimaan pelanggan atas Perjanjian Pelanggan Microsoft.

Prasyarat

Jika Anda menggunakan Pusat Mitra .NET SDK, versi 1.14 atau yang lebih baru diperlukan.

Penting

Pada Juni 2023, Pusat Mitra terbaru .NET SDK rilis 3.4.0 sekarang diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan file readme yang berisi informasi yang berguna.

Mitra didorong untuk terus menggunakan REST API Pusat Mitra.

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi 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).
Tanggal (dateAgreed) ketika pelanggan menerima Perjanjian Pelanggan Microsoft.
Informasi tentang pengguna dari organisasi pelanggan yang menerima Perjanjian Pelanggan Microsoft. Drive ini termasuk:
- Nama depan
- Nama belakang
- Alamat email
- nomor Telepon (opsional)
Jika nilai berikut berubah untuk pelanggan, Pusat Mitra akan memungkinkan perjanjian lain dibuat untuk pelanggan tersebut: Alamat Email Nama Belakang Nama Depan Telepon nomor Jika tidak, mitra akan menerima kode kesalahan berikut, karena pelanggan duplikat dibuat

{
"code": 600061,
"message": "A partner confirmed agreement already exists for the customer.",
"description": "A partner confirmed agreement already exists for the customer.",
"errorName": "PartnerConfirmedAgreementAlreadyExists",
"isRetryable": false,
"parameters": {},
"errorMessageExtended": "InternalErrorCode=600061"
}

.NET

Untuk mengonfirmasi atau mengonfirmasi kembali penerimaan pelanggan atas Perjanjian Pelanggan Microsoft:

Ambil metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Anda harus mendapatkan templateId dari Perjanjian Pelanggan Microsoft. Untuk informasi selengkapnya, lihat Mendapatkan metadata perjanjian untuk Perjanjian Pelanggan Microsoft.
```
// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
```
Buat objek Perjanjian baru yang berisi detail konfirmasi.
Gunakan koleksi IAgreggatePartner.Customers dan panggil metode ById dengan customer-tenant-id yang ditentukan.

Gunakan properti Perjanjian, diikuti dengan memanggil Create atau CreateAsync.

// string selectedCustomerId;

var agreementToCreate = new Agreement
{
    DateAgreed = DateTime.UtcNow,
    TemplateId = microsoftCustomerAgreementDetails.TemplateId,
    PrimaryContact = new Contact
    {
        FirstName = "Tania",
        LastName = "Carr",
        Email = "someone@example.com",
        PhoneNumber = "1234567890"
    }
};

Agreement agreement = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Create(agreementToCreate);

Sampel lengkap dapat ditemukan di kelas CreateCustomerAgreement dari proyek aplikasi pengujian konsol.

Permintaan REST

Untuk mengonfirmasi atau mengonfirmasi kembali penerimaan pelanggan atas Perjanjian Pelanggan Microsoft:

Ambil metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Anda harus mendapatkan templateId dari Perjanjian Pelanggan Microsoft. Untuk informasi selengkapnya, lihat Mendapatkan metadata perjanjian untuk Perjanjian Pelanggan Microsoft.
Buat sumber daya Perjanjian baru untuk mengonfirmasi bahwa pelanggan telah menerima Perjanjian Pelanggan Microsoft. Gunakan sintaks permintaan REST berikut.

Minta sintaks

Metode	URI Permintaan
POST	{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk menentukan pelanggan yang Anda konfirmasi.

Nama	Tipe	Wajib	Deskripsi
customer-tenant-id	GUID	Ya	Nilainya adalah id penyewa pelanggan berformat GUID, yang merupakan pengidentifikasi yang memungkinkan Anda menentukan pelanggan.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tabel ini menjelaskan properti yang diperlukan dalam isi permintaan REST.

Nama	Tipe	Deskripsi
Perjanjian	object	Detail yang diberikan oleh mitra untuk mengonfirmasi penerimaan pelanggan atas Perjanjian Pelanggan Microsoft.

Perjanjian

Tabel ini menjelaskan bidang minimum yang diperlukan untuk membuat sumber daya Perjanjian.

Properti	Tipe	Deskripsi
primaryContact	Kontak	Informasi tentang pengguna dari organisasi pelanggan yang menerima Perjanjian Pelanggan Microsoft, termasuk: firstName, lastName, email, dan phoneNumber (opsional)
dateAgreed	string dalam format waktu tanggal UTC	Tanggal ketika pelanggan menerima perjanjian.
templateId	string	Pengidentifikasi unik dari jenis perjanjian yang diterima oleh pelanggan. Anda dapat memperoleh templateId untuk Perjanjian Pelanggan Microsoft dengan mengambil metadata perjanjian untuk Perjanjian Pelanggan Microsoft. Lihat Mendapatkan metadata perjanjian untuk Perjanjian Pelanggan Microsoft untuk detailnya.
jenis	string	Jenis perjanjian yang diterima oleh pelanggan. Gunakan "MicrosoftCustomerAgreement" jika pelanggan menerima Perjanjian Pelanggan Microsoft.

Contoh permintaan

POST https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

Respons REST

Jika berhasil, metode ini mengembalikan sumber daya Perjanjian.

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 REST Pusat Mitra.

Contoh tanggapan

HTTP/1.1 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "userId": "3d6f2c09-eb40-48ca-a4b3-d24c9c007531",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}