AWS marketplace documentation change
Summary
Updated terminology from 'purchase order' to 'PO' for brevity, clarified permissions requirements, added guidance for suspended/expired POs, and updated links/instructions for post-purchase PO management.
Security assessment
Changes focus on terminology simplification and operational clarifications (e.g., handling of suspended/expired POs). While permissions are mentioned (`aws-marketplace:ListAgreementCharges` and `aws-marketplace:UpdatePurchaseOrders`), this is routine IAM documentation rather than addressing a security vulnerability. No evidence of security incident remediation or vulnerability disclosure.
Diff
diff --git a/marketplace/latest/buyerguide/buyer-purchase-order-troubleshooting.md b/marketplace/latest/buyerguide/buyer-purchase-order-troubleshooting.md index 31f1fde49..5a05d371d 100644 --- a//marketplace/latest/buyerguide/buyer-purchase-order-troubleshooting.md +++ b//marketplace/latest/buyerguide/buyer-purchase-order-troubleshooting.md @@ -7 +7 @@ -The information in the following table can help you troubleshoot issues with purchase orders, or understand what happens in different scenarios. +The information in the following table can help you troubleshoot issues with purchase orders (POs) and understand what happens in different scenarios. @@ -12,10 +12,10 @@ Insufficient permissions—during purchase | The note appears near the **Purchas -Insufficient permissions—after purchase | To add or update a purchase order post-subscription, the following permissions are required: `aws-marketplace:ListAgreementCharges` and `aws-marketplace:UpdatePurchaseOrders`. -Purchase order does not exist | AWS Marketplace creates a new purchase order for you. The new purchase order has default information, with no contact information. -Missing purchase order notifications | Purchase orders without contact information (including the purchase orders created by AWS Marketplace) do not receive email notifications. You can add contact information to a purchase order in the [ Purchase Orders dashboard in the Billing and Cost Management](https://aws.amazon.com/aws-cost-management/aws-purchase-order-management) console. -Incorrect purchase order number added | If you enter an incorrect purchase order number and need to update it, you can add the PO number from the AWS Marketplace console for any future charges. If you've already received the invoice, contact Support to update the purchase order number. For more information, see [Updating a purchase order post-purchase](./buyer-purchase-orders.html#update-po-post-purchase). -Subscribing account moves to a different organization | For purchase orders to work in the new organization, the integration must be completed in the new organization. If integration has been completed, and purchase order support is working in the new organization, then when the subscribing account moves between organizations, new invoices show the purchase order number in the new organization (and a new purchase order is created, if necessary). -Purchase order option not available when checking out | After purchasing a product, go to your subscription page in AWS Marketplace to update the purchase order. If you're not able to update the purchase order, contact Support. For more information, see [Updating a purchase order post-purchase](./buyer-purchase-orders.html#update-po-post-purchase). -Contracts with pay-as-you-go | You can choose to use a purchase order that covers all charges, only pay-as-you-go (usage) charges, or individual charges. For more information, see [Using purchase orders for AWS Marketplace transactions](./buyer-purchase-orders.html#buyer-using-purchase-orders). -One PO for all AWS Marketplace charges | If you want to use one PO number for all charges, you can [add a purchase order with blanket usage](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-purchase-orders.html#buyer-using-blanket-usage) in the AWS Billing console. -Suspended purchase order | When a purchase order number is provided, and the purchase order is marked as suspended in the Purchase Orders dashboard in the Billing and Cost Management console, the new line item is added to the purchase order, but the invoice does not include the purchase order. The billing admin for the AWS account must make the purchase order active, and contact Support to regenerate the invoice with the active purchase order. -Expired purchase order | When a purchase order number is provided, and the purchase order is expired, the new line item is created, and the purchase order is marked as active. The line item's end date is used as the new purchase order expiration date. +Insufficient permissions—after purchase | To add or update a PO after subscribing, the following permissions are required: `aws-marketplace:ListAgreementCharges` and `aws-marketplace:UpdatePurchaseOrders`. +PO doesn't exist | AWS Marketplace creates a new PO for you. The new PO has default information, with no contact information. +Missing PO notifications | POs without contact information (including AWS Marketplace POs) do not receive email notifications. You can add contact information to a PO in the [Purchase orders dashboard in the Billing and Cost Management](https://aws.amazon.com/aws-cost-management/aws-purchase-order-management) console. +Incorrect PO number added | If you enter an incorrect PO number and need to update it, you can add the PO number from the AWS Marketplace console for any future charges. If you've already received the invoice, contact Support to update the PO number. For more information, see [Updating a purchase order after a transaction](./buyer-purchase-orders.html#update-po-post-purchase). +Subscribing account moves to a different organization | For POs to work in the new organization, the integration must be completed in the new organization. If integration has been completed, and PO support is working in the new organization, then when the subscribing account moves between organizations, new invoices show the PO number in the new organization (and a new PO is created, if necessary). +PO option unavailable when checking out | After purchasing a product, go to your subscription page in AWS Marketplace to update the PO. If you're unable to update the PO, contact Support. For more information, see [Updating a purchase order after a transaction](./buyer-purchase-orders.html#update-po-post-purchase). +Contracts with pay-as-you-go | You can choose to use a PO that covers all charges, only pay-as-you-go (usage) charges, or individual charges. For more information, see [Using purchase orders for AWS Marketplace transactions](./buyer-purchase-orders.html#buyer-using-purchase-orders). +One PO for all AWS Marketplace charges | If you want to use one PO number for all charges, you can [add a PO with blanket usage](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-purchase-orders.html#buyer-using-blanket-usage) in the AWS Billing console. +Suspended PO | When a PO number is provided, and the PO is marked as suspended in the **Purchase Orders** dashboard in the Billing and Cost Management console, the new line item is added to the PO, but the invoice doesn't include the PO. The billing admin for the AWS account must make the PO active, and contact Support to regenerate the invoice with the active PO. +Expired PO | When you provide a PO number that's expired, a new line item is created, and the PO is marked as active. The line item's end date is used as the new PO expiration date. @@ -24,2 +24,2 @@ Procurement system integration | From your management account, you must set up -Flexible payment schedule — multiple purchase orders | If you need your individual payments for a flexible payment schedule to show up with different purchase orders, you can add multiple POs at the time of purchase, or update the purchase order from the AWS Marketplace subscription page before invoice creation. For more information, see [Updating a purchase order post-purchase](./buyer-purchase-orders.html#update-po-post-purchase). -Purchase order option missing from procurement page | Purchase orders are supported for most products in AWS Marketplace. However, you cannot add a purchase order for the following: +Flexible payment schedule — multiple POs | If you need your individual payments for a flexible payment schedule to show up with different POs, you can add multiple POs at the time of purchase, or update the PO from the AWS Marketplace subscription page before invoice creation. For more information, see [Updating a purchase order after a transaction](./buyer-purchase-orders.html#update-po-post-purchase). +PO option missing from procurement page | POs are supported for most AWS Marketplace products, but you can't add a PO for the following: @@ -31,2 +31,2 @@ Purchase order option missing from procurement page | Purchase orders are suppor -If you're purchasing products outside of AWS Marketplace, such as in the Amazon EC2 console, you cannot add a PO while subscribing. You can, however, update purchase orders post-purchase in the AWS Marketplace console for machine learning products and products purchased through other AWS consoles. For more information, see [Updating a purchase order post-purchase](./buyer-purchase-orders.html#update-po-post-purchase). -Purchase orders with license manager | Your purchase order will only apply to subscription-related charges. Grant charges will not inherit the PO applied to the original subscription. +If you're purchasing products outside of AWS Marketplace, such as in the Amazon EC2 console, you cannot add a PO while subscribing. You can, however, update POs post-purchase in the AWS Marketplace console for machine learning products and products purchased through other AWS consoles. For more information, see [Updating a purchase order after a transaction](./buyer-purchase-orders.html#update-po-post-purchase). +POs with license manager | Your PO applies only to subscription-related charges. Grant charges will not inherit the PO applied to the original subscription.