Kodu kimliğe göre al
Uygulama hedefi: Iş Ortağı Merkezi | 21Vianet tarafından işletilen iş ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi | Microsoft Cloud for US Government için iş ortağı Merkezi
Fatura KIMLIĞINI kullanarak belirli bir faturayı alır.
Önkoşullar
Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Geçerli bir fatura KIMLIĞI.
C#
Bir faturayı KIMLIĞE göre almak için:
Ipartner. Invoices koleksiyonunuzu kullanın ve byıd () yöntemini çağırın.
Get () veya GetAsync () yöntemlerini çağırın.
// IPartner scopedPartnerOperations;
// string selectedInvoiceId;
var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();
Örnek: konsol test uygulaması. Project: partnersdk. featuresample sınıfı: getınvoice. cs
REST isteği
İstek sözdizimi
| Yöntem | İstek URI'si |
|---|---|
| AL | {BaseUrl}/v1/faturalar/{INVOICE-ID} http/1.1 |
URI parametresi
Faturayı almak için aşağıdaki sorgu parametresini kullanın.
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
| Fatura kimliği | string | Yes | Değer, satıcının belirli bir faturaya ait sonuçları filtrelemesine olanak tanıyan bir Fatura kimliğidir . |
İstek üst bilgileri
Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.
İstek gövdesi
Yok
İstek örneği
GET https://api.partnercenter.microsoft.com/v1/invoices/<invoice-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
MS-CorrelationId: 57eb2ca7-755f-450f-9187-eae1e75a0114
REST yanıtı
Başarılı olursa, bu yöntem yanıt gövdesinde bir Fatura kaynağı döndürür.
Yanıt başarısı ve hata kodları
Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. hata kodları.
Yanıt örneği
HTTP/1.1 200 OK
Content-Length: 676
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 57eb2ca7-755f-450f-9187-eae1e75a0114
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
Date: Thu, 24 Mar 2016 05:22:14 GMT
{
"id": "G000024135",
"invoiceDate": "2018-02-08T22:40:37.5897767Z",
"billingPeriodStartDate": "2018-02-01T22:40:37.5897767Z",
"billingPeriodEndDate": "2018-02-28T22:40:37.5897767Z",
"totalCharges": 2076.63,
"paidAmount": 0,
"currencyCode": "USD",
"currencySymbol": "$",
"pdfDownloadLink": "/invoices/G000024135/documents/statement",
"taxReceipts": [
{
"id": "123456",
"taxReceiptPdfDownloadLink": "/invoices/G000024135/receipts/123456/documents/statement"
}
],
"invoiceDetails": [
{
"invoiceLineItemType": "billing_line_items",
"billingProvider": "one_time",
"links": {
"self": {
"uri": "/invoices/OneTime-G000024135/lineitems/OneTime/BillingLineItems",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "InvoiceDetail"
}
}
],
"documentType": "invoice",
"invoiceType": "OneTime",
"links": {
"self": {
"uri": "/invoices/OneTime-G000024135",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Invoice"
}
}