aws-sdk-marketplacemetering 1.102.0 → 1.103.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22ed72ed4e6cbc7afe8dc188388b7e09b4eac1e93c7ada1934cdc8264454eb34
-  data.tar.gz: fee374a9be118a92b3185bb252f32f8e730675f075b574de1eaf1adaa23e99f7
+  metadata.gz: 4246d0117b180086a96a7793b03d4d24c0b003a7d9e41acd25b011ea6fe96d57
+  data.tar.gz: ce4aa00758b16e098ba9d04f9690383fd83b65a7be4dcbcf802fbb3fdac61a50
 SHA512:
-  metadata.gz: 678141d417a1a594b04ffc0c73d849e5a9e9a10721bf621e60d58a66c0203f17396dcbe0384268697a67c87b339c1b208c338e914dc982a05ca94c63fcf22976
-  data.tar.gz: fc73d175eba4c612b01c95e1fe1e31bd784a4def4ec5af85238fe107e01ce0deb0456aff75879d78e8fdf0e7025985ae0ce835c2d5d94249f940df7307c87305
+  metadata.gz: b77aa81f5d7efa532ce92553d8098703fac6896417fdf4d5514d3c5574362951a5dbbabe4d10133c89c67731d6af4807a82ceaef1f8d65ef308e7763b430999f
+  data.tar.gz: 20b4739c7310265f963a723257274d287455ac2f8d7dc803a71845352859a3bcdad06faf2f92503cfb62c7b854106f543c0b51310f267fd8ff8284ea2113b29a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.103.0 (2026-08-25)
+------------------
+
+* Feature - Updated documentation to clarify duplicate-billing prevention and BatchMeterUsage retry guidance
+
 1.102.0 (2026-07-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.102.0
+1.103.0

data/lib/aws-sdk-marketplacemetering/client.rb

@@ -488,7 +488,9 @@ module Aws::MarketplaceMetering
     # (instead of `ProductCode`) to support this feature. `BatchMeterUsage`
     # does not support `CustomerIdentifier` for new integrations. Existing
     # integrations continue to work. Review the new integration for
-    # Concurrent Agreements [here][1].
+    # Concurrent Agreements [here][1]. For additional implementation
+    # details, see [BatchMeterUsage code example with LicenseArn][2] in the
+    # *Amazon Web Services Marketplace Seller Guide*.
     #
     # To post metering records for customers, SaaS applications call
     # `BatchMeterUsage`, which is used for metering SaaS flexible
@@ -503,8 +505,11 @@ module Aws::MarketplaceMetering
     # an event. At the end of each billing cycle, a 6-hour grace period
     # applies. We accept usage records for the previous billing month until
     # 06:00 UTC on the first day of the next month. For example, you must
-    # submit March usage records before 06:00 UTC on April 1. After this
-    # grace period, we return a `TimestampOutOfBoundsException` error.
+    # submit March usage records before 06:00 UTC on April 1. On April 1 at
+    # 05:00 UTC, you can still submit records for March 31 (within the
+    # 6-hour grace period). After 06:00 UTC on April 1, March records are
+    # rejected regardless of the normal 24-hour submission window. After
+    # this grace period, we return a `TimestampOutOfBoundsException` error.
     #
     # `BatchMeterUsage` can process up to 25 `UsageRecords` at a time, and
     # each request must be less than 1 MB in size. Optionally, you can have
@@ -517,18 +522,19 @@ module Aws::MarketplaceMetering
     # should be retried.
     #
     # For Amazon Web Services Regions that support `BatchMeterUsage`, see
-    # [BatchMeterUsage Region support][2].
+    # [BatchMeterUsage Region support][3].
     #
     # <note markdown="1"> For an example of `BatchMeterUsage`, see [ BatchMeterUsage code
-    # example][3] in the *Amazon Web Services Marketplace Seller Guide*.
+    # example][4] in the *Amazon Web Services Marketplace Seller Guide*.
     #
     #  </note>
     #
     #
     #
     # [1]: https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements
-    # [2]: https://docs.aws.amazon.com/marketplace/latest/APIReference/metering-regions.html#batchmeterusage-region-support
-    # [3]: https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-example
+    # [2]: https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-licensearn-example
+    # [3]: https://docs.aws.amazon.com/marketplace/latest/APIReference/metering-regions.html#batchmeterusage-region-support
+    # [4]: https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-example
     #
     # @option params [required, Array<Types::UsageRecord>] :usage_records
     #   The set of `UsageRecords` to submit. `BatchMeterUsage` accepts up to
@@ -539,6 +545,18 @@ module Aws::MarketplaceMetering
     #   Services Marketplace. The product code should be the same as the one
     #   used during the publishing of a new product.
     #
+    #   `ProductCode` is required only for legacy integrations that use
+    #   `CustomerIdentifier`. For new integrations using `LicenseArn`
+    #   (Concurrent Agreements), do NOT include `ProductCode` at the request
+    #   level. The `LicenseArn` in each `UsageRecord` identifies both the
+    #   product and the specific agreement.
+    #
+    #    Sending metering records with both `ProductCode` and `LicenseArn` for
+    #   the same customer within the same hour will result in duplicate
+    #   billing. If you are migrating from product-based metering to
+    #   license-based metering, stop sending `ProductCode` before you start
+    #   sending `LicenseArn`.
+    #
     # @return [Types::BatchMeterUsageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::BatchMeterUsageResult#results #results} => Array&lt;Types::UsageRecordResult&gt;
@@ -956,7 +974,7 @@ module Aws::MarketplaceMetering
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-marketplacemetering'
-      context[:gem_version] = '1.102.0'
+      context[:gem_version] = '1.103.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-marketplacemetering/types.rb

@@ -22,6 +22,18 @@ module Aws::MarketplaceMetering
     #   Product code is used to uniquely identify a product in Amazon Web
     #   Services Marketplace. The product code should be the same as the one
     #   used during the publishing of a new product.
+    #
+    #   `ProductCode` is required only for legacy integrations that use
+    #   `CustomerIdentifier`. For new integrations using `LicenseArn`
+    #   (Concurrent Agreements), do NOT include `ProductCode` at the request
+    #   level. The `LicenseArn` in each `UsageRecord` identifies both the
+    #   product and the specific agreement.
+    #
+    #    Sending metering records with both `ProductCode` and `LicenseArn`
+    #   for the same customer within the same hour will result in duplicate
+    #   billing. If you are migrating from product-based metering to
+    #   license-based metering, stop sending `ProductCode` before you start
+    #   sending `LicenseArn`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/BatchMeterUsageRequest AWS API Documentation
@@ -626,14 +638,16 @@ module Aws::MarketplaceMetering
     #   The `CustomerAWSAccountId` parameter specifies the AWS account ID of
     #   the buyer.
     #
-    #   <note markdown="1"> For existing integrations, to access your `CustomerIdentifier` to
-    #   `CustomerAWSAccountId` mapping, see [Account Feeds][1].
-    #
-    #    </note>
+    #   If you have an existing integration and need the
+    #   `CustomerAWSAccountId` that corresponds to a `CustomerIdentifier`,
+    #   contact [AWS Marketplace Seller Operations][1] to obtain the
+    #   mapping. Do not request the `CustomerAWSAccountId` directly from
+    #   buyers. We cannot verify that a buyer-provided account ID is
+    #   authentic, which can result in incorrect metering or billing.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-account.html
+    #   [1]: https://aws.amazon.com/marketplace/management/contact-us/
     #   @return [String]
     #
     # @!attribute [rw] license_arn

data/lib/aws-sdk-marketplacemetering.rb

@@ -54,7 +54,7 @@ module Aws::MarketplaceMetering
   autoload :EndpointProvider, 'aws-sdk-marketplacemetering/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-marketplacemetering/endpoints'
 
-  GEM_VERSION = '1.102.0'
+  GEM_VERSION = '1.103.0'
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-marketplacemetering
 version: !ruby/object:Gem::Version
-  version: 1.102.0
+  version: 1.103.0
 platform: ruby
 authors:
 - Amazon Web Services