Mendapatkan tautan perkiraan faktur
Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Anda bisa mendapatkan perkiraan tautan untuk membantu detail kueri untuk item baris rekonsiliasi yang tidak tertagih.
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
Pengidentifikasi faktur. Ini mengidentifikasi faktur untuk mengambil item baris.
C#
Contoh kode berikut menunjukkan bagaimana Anda bisa mendapatkan perkiraan tautan untuk mengkueri item baris yang tidak ditagih untuk mata uang tertentu. Respons berisi tautan perkiraan untuk setiap periode (misalnya, bulan saat ini dan sebelumnya).
// IAggregatePartner partnerOperations;
// string curencyCode;
// all the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));
// read estimate links for currencycode
var estimateLinks = scopedPartnerOperations.Invoices.Estimates.Links.ByCurrency(curencyCode).Get();
Untuk contoh serupa, lihat yang berikut ini:
- Sampel: Aplikasi pengujian konsol
- Proyek: Sampel SDK Pusat Mitra
- Kelas: GetEstimatesLinks.cs
Permintaan REST
Minta sintaks
Metode | URI Permintaan |
---|---|
DAPATKAN | {baseURL}/v1/invoices/estimates/links?currencycode={currencycode} HTTP/1.1 |
Parameter URI
Gunakan URI dan parameter kueri berikut saat membuat permintaan.
Nama | Tipe | Wajib | Deskripsi |
---|---|---|---|
currencyCode | string | Ya | Kode mata uang untuk item baris yang tidak ditagih. |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tidak ada.
Contoh permintaan
GET https://api.partnercenter.microsoft.com/v1/invoices/estimates/links?currencycode=usd HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com
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.
Respons REST
Jika berhasil, respons berisi tautan untuk mengambil perkiraan yang tidak ditagih.
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 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 80EAA055-B5D3-4D88-BFE8-924A3F706462
MS-RequestId: 1b18689e-3fe3-4fdb-d09e-39d13941390b
X-Locale: en-US
X-SourceFiles: =?UTF-8?B?RDpcU291cmNlc1xSUEUuUGFydG5lci5TZXJ2aWNlLkJpbGxpbmdTZXJ2aWNlXHYxLjFcV2ViQXBpc1xCaWxsaW5nU2VydmljZS5WMi5XZWJcdjFcaW52b2ljZXNcZXN0aW1hdGVzXGxpbmtz?=
X-Powered-By: ASP.NET
Date: Thu, 14 Mar 2019 18:15:06 GMT
Content-Length: 1857
{
"totalCount": 4,
"items": [
{
"type": "daily_rated_usage",
"title": "Daily rated usage unbilled",
"description": "This invoice line items includes unbilled consumption based data only.",
"period": "Current",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=Marketplace&invoicelineitemtype=UsageLineItems¤cycode=USD&period=current&size=2000",
"method": "GET",
"headers": []
}
},
{
"type": "daily_rated_usage",
"title": "Daily rated usage unbilled",
"description": "This invoice line items includes unbilled consumption based data only.",
"period": "Previous",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=Marketplace&invoicelineitemtype=UsageLineItems¤cycode=USD&period=previous&size=2000",
"method": "GET",
"headers": []
}
},
{
"type": "non_consumption",
"title": "Unbilled reconciliation line items",
"description": "This includes reconciliation line items for unbilled data only.",
"period": "Current",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=all&invoicelineitemtype=billinglineitems¤cycode=USD&period=current&size=2000",
"method": "GET",
"headers": []
}
},
{
"type": "non_consumption",
"title": "Unbilled reconciliation line items",
"description": "This includes reconciliation line items for unbilled data only.",
"period": "Previous",
"link": {
"uri": "/invoices/unbilled/lineitems?provider=all&invoicelineitemtype=billinglineitems¤cycode=USD&period=previous&size=2000",
"method": "GET",
"headers": []
}
}
],
"attributes": {
"objectType": "Collection"
}
}
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