Inovice and subscription feature update (#106)

* Inovice, order, and subscription feature update

Author: idwilliams-2

ChangeLog.md

@@ -67,8 +67,16 @@
     * PublisherName
   * Corrected an issue with requesting products by country, target view, and target segment
   * Removed the SKU download operations. No commands where impacted by this change
+* Subscriptions
+  * Added the following properties to the subscription model
+    * IsMicrosoftProduct
+    * PublisherName
+    * RefundOptions
+    * TermDuration
 * Users
   * Corrected an issue with performing a query for users from a customer
+* Utilization
+  * Addressed an issue caused by the Partner Center API return a HTTP 204 no content when Azure utilization data is not yet ready in a dependent system.
 * Validations
   * Added the ability to request validation codes used to create Government Community Cloud customers
 

src/PartnerCenter.TestFramework/PartnerCenter.TestFramework.csproj

@@ -12,7 +12,7 @@
     <PackageProjectUrl>https://github.com/Microsoft/Partner-Center-PowerShell</PackageProjectUrl>
     <RepositoryUrl>https://github.com/Microsoft/Partner-Center-PowerShell.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
-    <Version>1.5.1903.2</Version>
+    <Version>1.5.1903.5</Version>
     <NeutralLanguage>en-US</NeutralLanguage>
   </PropertyGroup>
 

src/PartnerCenter/Configuration/PartnerService.json

@@ -95,12 +95,6 @@
         "Country": "country"
       }
     },
-    "GetSkuDownloadOptions": {
-      "Path": "products/{0}/skus/{1}/downloadoptions",
-      "Parameters": {
-        "Country": "country"
-      }
-    },
     "GetAvailabilities": {
       "Path": "products/{0}/skus/{1}/availabilities",
       "Parameters": {
@@ -133,9 +127,6 @@
     "GetCustomerSku": {
       "Path": "customers/{0}/products/{1}/skus/{2}"
     },
-    "GetCustomerSkuDownloadOptions": {
-      "Path": "customers/{0}/products/{1}/skus/{2}/downloadoptions"
-    },
     "GetCustomerAvailabilities": {
       "Path": "customers/{0}/products/{1}/skus/{2}/availabilities",
       "Parameters": {

src/PartnerCenter/Factories/IPartnerFactory.cs

@@ -6,6 +6,7 @@
 
 namespace Microsoft.Store.PartnerCenter.Factories
 {
+    using System;
     using System.Net.Http;
     using RequestContext;
 
@@ -51,7 +52,7 @@ internal interface IPartnerFactory
         /// Builds a <see cref="IPartner" /> instance and configures it using the provided partner credentials.
         /// </summary>
         /// <param name="credentials">The partner credentials.</param>
-        /// <param name="httpClient">The HTTP client to be used.</param>
+        /// <param name="httpClient">The client used to perform HTTP operations.</param>
         /// <returns>A configured partner object.</returns>
         IPartner Build(IPartnerCredentials credentials, HttpClient httpClient);
 
@@ -60,7 +61,7 @@ internal interface IPartnerFactory
         /// </summary>
         /// <param name="credentials">The partner credentials.</param>
         /// <param name="requestContext">The context used to perform operations.</param>
-        /// <param name="httpClient">The HTTP client to be used.</param>
+        /// <param name="httpClient">The client used to perform HTTP operations.</param>
         /// <returns>A configured partner object.</returns>
         IPartner Build(IPartnerCredentials credentials, IRequestContext requestContext, HttpClient httpClient);
     }

src/PartnerCenter/Factories/StandardPartnerFactory.cs

@@ -6,6 +6,7 @@
 
 namespace Microsoft.Store.PartnerCenter.Factories
 {
+    using System;
     using System.Net.Http;
     using RequestContext;
 
@@ -62,7 +63,7 @@ public IPartner Build(IPartnerCredentials credentials, IRequestContext requestCo
         /// Builds a <see cref="IPartner" /> instance and configures it using the provided partner credentials.
         /// </summary>
         /// <param name="credentials">The partner credentials. Use the extensions to obtain these.</param>
-        /// <param name="httpClient">The HTTP client to be used.</param>
+        /// <param name="httpClient">The client used to perform HTTP operations.</param>
         /// <returns>A configured partner object.</returns>
         public IPartner Build(IPartnerCredentials credentials, HttpClient httpClient)
         {
@@ -74,7 +75,7 @@ public IPartner Build(IPartnerCredentials credentials, HttpClient httpClient)
         /// </summary>
         /// <param name="credentials">The partner credentials. Use the extensions to obtain these.</param>
         /// <param name="requestContext">The context used to perform operations.</param>
-        /// <param name="httpClient">The HTTP client to be used.</param>
+        /// <param name="httpClient">The client used to perform HTTP operations.</param>
         /// <returns>A configured partner object.</returns>
         public IPartner Build(IPartnerCredentials credentials, IRequestContext requestContext, HttpClient httpClient)
         {

src/PartnerCenter/Invoices/InvoiceOperations.cs

@@ -55,7 +55,7 @@ public IInvoiceLineItemCollection By(BillingProvider billingProvider, InvoiceLin
         /// <param name="period">The period for unbilled recon.</param>
         /// <param name="size">The page size.</param>
         /// <returns>The recon line item collection operations.</returns>
-        public IReconLineItemCollection By(BillingProvider provider, InvoiceLineItemType invoiceLineItemType, string currencyCode, BillingPeriod period, int? size)
+        public IReconLineItemCollection By(BillingProvider provider, InvoiceLineItemType invoiceLineItemType, string currencyCode, BillingPeriod period, int? size = null)
             => new ReconLineItemCollectionOperations(Partner, Context, provider, invoiceLineItemType, currencyCode, period, size);
 
         /// <summary>

src/PartnerCenter/Models/Invoices/DailyRatedUsageLineItem.cs

@@ -244,4 +244,4 @@ public sealed class DailyRatedUsageLineItem : InvoiceLineItem
         /// </summary>
         public override BillingProvider BillingProvider => BillingProvider.Marketplace;
     }
-}
+}

src/PartnerCenter/Models/Invoices/Invoice.cs

@@ -68,24 +68,29 @@ public sealed class Invoice : ResourceBaseWithLinks<StandardResourceLinks>
         /// <remarks>
         /// Paid amount is negative if a payment is received.
         /// </remarks>
-        public Decimal PaidAmount { get; set; }
+        public decimal PaidAmount { get; set; }
 
         /// <summary>
         /// Gets or sets the link to download the invoice PDF document.
         /// </summary>
         /// <remarks>
         /// This value is not returned as part of the search results, and will only
-        /// get populated if invoice is accessed by Id.
+        /// get populated if invoice is accessed by identifier.
         /// This link auto expires in 30 minutes.
         /// </remarks>
         public Uri PdfDownloadLink { get; set; }
-
+        
+        /// <summary>
+        /// Gets or sets the invoice tax receipts
+        /// </summary>
+        public IEnumerable<TaxReceipt> TaxReceipts { get; set; }
+        
         /// <summary>
         /// Gets or sets the total charges in this invoice.
         /// </summary>
         /// <remarks>
         /// Total charges includes the transactions charges and any adjustments.
         /// </remarks>
-        public Decimal TotalCharges { get; set; }
+        public decimal TotalCharges { get; set; }
     }
 }

src/PartnerCenter/Models/Invoices/TaxReceipt.cs

@@ -0,0 +1,26 @@
+// -----------------------------------------------------------------------
+// <copyright file="TaxReceipt.cs" company="Microsoft">
+//     Copyright (c) Microsoft Corporation. All rights reserved.
+// </copyright>
+// -----------------------------------------------------------------------
+
+namespace Microsoft.Store.PartnerCenter.Models.Invoices
+{
+    using System;
+
+    /// <summary>
+    /// Represents the tax receipt details.
+    /// </summary>
+    public sealed class TaxReceipt
+    {
+        /// <summary>
+        /// Gets or sets the tax receipt unique identifier.
+        /// </summary>
+        public string Id { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tax receipt download link.
+        /// </summary>
+        public Uri TaxReceiptPdfDownloadLink { get; set; }
+    }
+}

src/PartnerCenter/Models/Orders/Order.cs

@@ -30,6 +30,11 @@ public sealed class Order : ResourceBase
         /// </summary>
         public string CurrencyCode { get; set; }
 
+        /// <summary>
+        /// Gets or sets the currency symbol.
+        /// </summary>
+        public string CurrencySymbol { get; set; }
+
         /// <summary>
         /// Gets or sets the order identifier.
         /// </summary>