Se reestructuró la referencia de la API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia [ de API de ](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html) AWS Marketplace.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Trabaje con ofertas privadas mediante el AWS Marketplace API
Puedes utilizarlas AWS Marketplace Catalog API para automatizar las tareas relacionadas con las ofertas.
Si bien el * producto * describe lo que se vende AWS Marketplace, la * oferta * describe los términos y las reglas de compra y consumo de un producto. AWS Marketplace los productos pueden tener varias ofertas vendidas por diferentes vendedores. Sin embargo, cada AWS Marketplace oferta solo se puede crear para un producto. Una * oferta * contiene un conjunto de condiciones de acuerdo entre dos partes. Los términos de la oferta aceptados se traducen en un acuerdo como prueba de una transacción.
Hay dos tipos de ofertas:
+ ****Las ofertas privadas sirven para que vendedores y compradores negocien los precios. Los vendedores firman un acuerdo de licencia de usuario final (EULA) para comprar software en. AWS Marketplace La oferta solo está visible para un comprador específico. Para obtener más información, consulta las ofertas [ privadas ](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-overview.html) en la Guía del *AWS Marketplace vendedor*.
+ ****Las ofertas públicas son para programas de compras globales. Los vendedores identifican a los clientes en función de los programas disponibles y las ubicaciones geográficas, lo que hace que la oferta solo sea accesible para clientes específicos.
Consulte los siguientes recursos:
+ Para ver ejemplos de códigos que funcionan, consulta [ Gestionar ofertas con la API ](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api) en el taller para *AWS Marketplace vendedores*.
+ Para ver ejemplos de código de solicitud de API, consulta los [ ejemplos de [ Python ](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/python/src/catalog_api/offers) y ](https://github.com/aws-samples/aws-marketplace-reference-code/tree/main/java/resources/changeSets/offers) Java en *AWS Samples * on GitHub.
+ Para ver un vídeo sobre la creación de ofertas privadas, consulta Cómo [ crear una oferta privada con la API de AWS Marketplace catálogo ](https://www.youtube.com/watch?v=Gg9JR0tB330) en YouTube.
+ Para ver un vídeo sobre la actualización de los precios de la AMI, consulta [ Cómo actualizar los precios de los productos de AMI mediante la API de AWS Marketplace catálogo ](https://www.youtube.com/watch?v=AVIRlzHKEJw) en YouTube.
En los siguientes temas se describe cómo usar la API de catálogo para crear y actualizar ofertas:
**Topics**
+ [Crea una oferta](#create-offer)
+ [Crea una oferta de reemplazo](#create-replacement-offer)
+ [Actualizar la información de la oferta](#update-offer-information)
+ [Actualizar la configuración de segmentación](#update-targeting-offers)
+ [Actualizar la política de reembolsos](#update-support-terms)
+ [Actualizar los recursos legales](#update-legal-terms)
+ [Actualizar los precios](#update-pricing-terms)
+ [Actualiza la visibilidad de la oferta](#update-availability)
+ [Defina la fecha de caducidad de los acuerdos creados con la oferta](#update-validity-terms)
+ [Actualizar los detalles del calendario de pagos](#update-payment-schedule-terms)
+ [Actualizar las condiciones de pago neto](#update-net-payment-terms)
+ [Modificar las opciones de renovación](#update-renewal-terms)
+ [Publica una oferta](#release-offer)
+ [Describe los detalles de la oferta existente](#describe-entity)
## Crea una oferta
Puedes usar la API de catálogo para crear una nueva oferta en AWS Marketplace. Si tu solicitud se procesa correctamente, se AWS Marketplace Catalog API crea una`Draft`, que es una oferta incompleta que es invisible para los compradores. Para completar una oferta, usa el tipo de `Update` cambio. Cuando la oferta esté completa, usa el tipo de [`ReleaseOffer`](#release-offer) cambio para crearla y publicarla. La publicación de una oferta la valida y la hace visible para los compradores en AWS Marketplace.
Para crear una nueva oferta, llama a la operación de la `StartChangeSet` API con el tipo de `CreateOffer` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test Offer",
"OfferSetId": "offerset-b3f9EXAMPLE27"
}
}
]
}
```
Proporciona información sobre los campos para agregar el tipo de `CreateOffer` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **ProductId**(cadena) (obligatorio): el identificador único del producto que se ofrece.
+ **Nombre ** (cadena) (opcional): el nombre asociado a la oferta para que usted y sus clientes puedan leerla mejor. También se muestra como parte de la información del acuerdo.
+ **OfferSetId**(cadena) (opcional): el identificador de la oferta establecida para asociar esta oferta. Especifique este campo únicamente al crear una oferta que formará parte de un conjunto de ofertas. Si no OfferSetId se proporciona, se creará una oferta individual que se puede comprar de forma independiente. Ten en cuenta que especificar una OfferSetId durante la creación de la oferta solo indica tu intención de asociar la oferta a ese conjunto de ofertas. Para completar la asociación, debes [ usar el tipo de AssociateOffers cambio una ](work-with-offer-sets.md#associate-offers) vez creada la oferta.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
Si `Status` es así`SUCCEEDED`, `OfferId` se genera una nueva.
La respuesta tiene este aspecto:
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
"ChangeSetName": "Submitted by 123456789012",
"StartTime": "2021-05-27T22:21:26Z",
"EndTime": "2021-05-27T22:32:19Z",
"Status": "SUCCEEDED",
"ChangeSet": [
{
"ChangeType": "CreateOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"ProductId": "prod-ad8EXAMPLE51",
"Name": "Test Offer"
},
"ErrorDetailList": []
}
]
}
```
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `CreateOffer` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| ProductId | Obligatorio
La longitud debe estar entre 1 y 50 caracteres
No debe contener caracteres no válidos (\\, <, >) | 422 |
| ProductId | ObligatorioEl usuario debe estar autorizado a crear una oferta para un producto determinado | 403 |
| ProductId | ObligatorioDebe ser un producto existente en el catálogo o que se esté creando en el mismo conjunto de cambios | 404 |
| Name | Opcional
La longitud debe estar entre 1 y 150 caracteres
No debe contener caracteres no válidos (\\, <, >) | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `CreateOffer` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| PRODUCTO\_INCOMPATIBLE | Usa un producto activo en nuestro estado. Limited Public |
| PRODUCTO\_INCOMPATIBLE | La gestión de ofertas para el tipo de producto que has elegido no está disponible actualmente en. AWS Marketplace Catalog API |
| PRODUCTO\_INCOMPATIBLE | La gestión de las ofertas del producto no está disponible actualmente en. AWS Marketplace Catalog API |
| PRODUCTO\_INCOMPATIBLE | OfferSetId no está incluido en las ofertas del producto. |
| PRODUCTO\_INCOMPATIBLE | CreateOffer no se puede invocar el tipo de cambio para crear una oferta para el producto. Usa el tipo de CreateOfferUsingResaleAuthorization cambio. |
## Crea una oferta de reemplazo
Puedes usar la API de catálogo para crear una oferta de reemplazo (también conocida como oferta basada en un acuerdo) en. AWS Marketplace
Si tu solicitud se ha procesado correctamente, se AWS Marketplace Catalog API generará una oferta en `Draft` estado para ti, que es una oferta incompleta que los compradores no podrán ver en ella. AWS Marketplace Usarás los tipos de `Update` cambio para completar la oferta. Una vez finalizada la oferta, utilizarás el tipo de [`ReleaseOffer`](#release-offer) cambio para completar el proceso de creación de la oferta y liberarla, lo que validará toda la oferta y la hará visible para los compradores en el momento AWS Marketplace. A partir de ahí, el comprador tiene la opción de aceptar la oferta de sustitución o seguir operando con arreglo al acuerdo original.
Para crear una oferta de reemplazo, llama a la operación de la `StartChangeSet` API con el tipo de `CreateReplacementOffer` cambio y proporciona un identificador de acuerdo preexistente, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "CreateReplacementOffer",
"Entity": {
"Type": "Offer@1.0"
},
"DetailsDocument": {
"AgreementId": "agmt-12345",
"Name": "Offer name"
}
}
]
}
```
Proporciona información sobre los campos para agregar el tipo de `CreateReplacementOffer` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **AgreementId**(cadena) (obligatorio): el identificador único del acuerdo actual que se va a reemplazar.
+ **Nombre ** (cadena) (opcional): el nombre asociado a la oferta para que usted y sus clientes puedan leerla mejor. También se mostrará como parte de la información del acuerdo.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `CreateReplacementOffer` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| AgreementId | ObligatorioLa longitud debe estar entre 1 y 64 caracteres | 422 |
| AgreementId | ObligatorioEl usuario debe estar autorizado a crear una oferta para el acuerdo en cuestión | 403 |
| Name | OpcionalLa longitud debe estar entre 1 y 150 caracteres
No debe contener caracteres no válidos (\\, <, >) | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `CreateReplacementOffer` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| PRODUCTO\_INCOMPATIBLE | No se admiten ofertas de reemplazo para el producto. |
| ACUERDO\_INCOMPATIBLE | CreateReplacementOffer no se puede invocar el tipo de cambio para crear una oferta de reemplazo para el acuerdo. Usa el tipo de CreateReplacementOfferUsingResaleAuthorization cambio. |
## Actualizar la información de la oferta
Puedes usar la API de catálogo para actualizar la información de la oferta en AWS Marketplace.
Para actualizar la información de la oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateInformation` cambio, como se muestra en el siguiente ejemplo. El resto de la información permanecerá sin cambios.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateInformation",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Name": "New offer name",
"Description": "New offer description",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
}
}
}
]
}
```
Proporcione información sobre los campos para agregar el tipo de `UpdateInformation` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **Nombre ** (cadena) (opcional): nombre asociado a la oferta para facilitar la lectura. Se muestra como parte de la información del acuerdo.
+ **Descripción ** (cadena) (opcional): texto de formato libre destinado a ser utilizado únicamente por ti y que los compradores nunca podrán verlo.
+ **PreExistingAgreement**(objeto) (opcional): determina si esta oferta es una renovación de un acuerdo existente con un cliente existente para el mismo producto subyacente. El acuerdo existente puede ser interno o externo AWS Marketplace. AWS puede auditar y verificar que su oferta es una renovación. Si AWS no puede verificar su oferta, AWS puede revocar la oferta y los derechos de su cliente.
+ **AcquisitionChannel**(cadena) (obligatorio): indica si el acuerdo existente se firmó de forma externa AWS Marketplace o interna. AWS Marketplace
Valores posibles: `External`, `AwsMarketplace`
+ **PricingModel**(cadena) (obligatorio): indica qué modelo de precios utiliza el acuerdo existente.
Valores posibles: `Contract`, `Usage`, `Byol`, `Free`
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateInformation` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| Propiedades | Debe proporcionarse al menos una de las siguientes propiedades | 422 |
| Name | Opcional
La longitud debe estar entre 1 y 150 caracteres
No debe contener caracteres no válidos (\\, <, >) | 422 |
| Description (Descripción) | Opcional
La longitud debe estar entre 1 y 255 caracteres | 422 |
| PreExistingAgreement | OpcionalPuede ser nulo para eliminarlo `PreExistingAgreement` de la oferta | 422 |
| PreExistingAgreement.PricingModel | Obligatorio
Puede ser uno de estos valores: [`Byol`,`Free`,`Usage`,`Contract`] | 422 |
| PreExistingAgreement.AcquisitionChannel | Obligatorio
Puede ser uno de estos valores: [`AwsMarketplace`,`External`] | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateInformation` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| ACUERDO INCOMPATIBLE\_PRE\_EXISTING\_ | PreExistingAgreement no se puede cambiar una vez publicada la oferta. |
## Actualizar la configuración de segmentación
Puedes usar la API de catálogo para actualizar la configuración de segmentación de tu oferta en AWS Marketplace.
Todas las opciones de segmentación existentes que no estén incluidas en la última solicitud se eliminarán de la oferta.
**nota**
Una oferta puede incluir `PositiveTargeting` o`NegativeTargeting`, de forma opcional, pero no ambas.
**Opciones de segmentación positiva: **
**Solo códigos de país**: crea una oferta pública disponible para los compradores de los países especificados.
**Solo cuentas de compradores**: crea una oferta privada dirigida a cuentas de AWS específicas.
**Tanto los códigos de país como las cuentas de compradores**: crea una oferta privada en la que las cuentas objetivo solo pueden aceptar la oferta si se encuentran en uno de los países especificados.
**Opciones de segmentación negativa: **
**Códigos de país**: se excluyen los compradores de los países especificados. Esto crea una oferta pública disponible en todos los países, excepto en los que figuran en la lista.
Para actualizar la configuración de segmentación de tu oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateTargeting` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateTargeting",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"111122223333"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `UpdateTargeting` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **PositiveTargeting**(objeto) (opcional): la segmentación positiva define los criterios que debe cumplir el perfil de cualquier comprador para poder acceder a la oferta. Este campo es opcional, pero se debe proporcionar al menos una opción de segmentación cuando este campo esté presente.
+ **CountryCodes**(matriz de cadenas) (opcional): lista como opción para permitir la segmentación por país. Si la intención no es orientar la oferta a un país, se debe omitir este campo. Si está presente, la lista debe contener al menos un código de país. Cada elemento de esta lista debe ser un código de país válido de 2 letras con este formato: ISO 3166-1 alpha-2.
+ **BuyerAccounts**(conjunto de cadenas) (opcional): lista como una opción para permitir la segmentación basada en Cuentas de AWS (también conocida como oferta privada). Si la intención es no segmentar la oferta a un Cuenta de AWS, este campo debe omitirse.
+ **NegativeTargeting**(objeto) (opcional): la segmentación negativa define los criterios que debe cumplir el perfil de cualquier cliente para que se le restrinja el acceso a la oferta. Aunque este campo es opcional, se debe proporcionar al menos una opción de segmentación cuando este campo esté presente.
+ **CountryCodes**(conjunto de cadenas) (obligatorio): lista como opción para permitir la segmentación por país. Si la intención no es orientar la oferta a un país específico, este campo debe omitirse. Si está presente, la lista debe contener al menos un código de país. Cada elemento de esta lista debe ser un código de país válido de 2 letras con este formato: ISO 3166-1 alpha-2.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateTargeting` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| NegativeTargeting | Opcional
Puede tener una de las siguientes opciones: [`CountryCodes`] | 422 |
| NegativeTargeting.CountryCodes | Opcional
El tamaño de la lista debe estar comprendido entre 1 y 244
Los códigos de país deben ser válidos (ISO 3166-1 alpha-2) | 422 |
| PositiveTargeting | Opcional
Puede tener una de las siguientes opciones: [`CountryCodes`,`BuyerAccounts`] | 422 |
| PositiveTargeting.BuyerAccounts | Opcional
El tamaño de la lista debe estar comprendido entre 1 y 26
Cuenta de AWS Los ID deben tener un formato válido (número de 12 dígitos) | 422 |
| PositiveTargeting.CountryCodes | Opcional
El tamaño de la lista debe estar comprendido entre 1 y 244
Los códigos de país deben ser válidos (ISO 3166-1 alpha-2) | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateTargeting` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| CUENTAS\_COMPRADOR\_INVÁLIDAS | Proporciona cuentas de comprador válidas. Cuentas no válidas: [x]. |
| CÓDIGOS DE PAÍS NO VÁLIDOS | Proporcione los códigos de país compatibles. |
| SEGMENTACIÓN NO VÁLIDA | Usa la segmentación negativa o positiva en el mismo atributo. |
| PRODUCTO\_INCOMPATIBLE | Country-based la segmentación no es compatible con el producto. |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Proporcione que sean compatibles con. BuyerAccounts ResaleAuthorization |
| SEGMENTACIÓN INCOMPATIBLE | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| SEGMENTACIÓN INCOMPATIBLE | El cambio solicitado no se puede realizar una vez caducada la oferta. |
| SEGMENTACIÓN INCOMPATIBLE | La segmentación no se puede actualizar en una oferta de reemplazo. Si el comprador no está asociado a la oferta AgreementId, crea una nueva oferta privada proporcionando una AgreementId asociada al comprador. |
| DEMASIADAS CUENTAS DE COMPRADORES | Proporcione dentro de los límites permitidos. BuyerAccounts |
| SEGMENTACIÓN INCOMPATIBLE | BuyerAccounts no se puede eliminar después de que se publique la oferta. |
| SEGMENTACIÓN INCOMPATIBLE | BuyerAccounts no se puede añadir después de que se publique la oferta. |
| CÓDIGOS DE PAÍS FALTANTES | Proporcione: [x PositiveTargeting ] CountryCodes. |
| CÓDIGOS DE PAÍS INCOMPATIBLES | Proporcione que sean compatibles. CountryCodes |
| CUENTAS\_COMPRADORAS\_INCOMPATIBLES | Siempre BuyerAccounts que sean compatibles con el acuerdo. |
## Actualizar la política de reembolsos
Puedes usar la API de catálogo para actualizar la política de reembolsos de tu oferta en AWS Marketplace.
Este cambio no afecta a los acuerdos existentes. Las condiciones de soporte que no estén incluidas en la última solicitud se eliminarán de la oferta.
Para actualizar la política de reembolsos, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateSupportTerms` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateSupportTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "Updated refund policy description"
}
]
}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `UpdateSupportTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **Términos ** (conjunto de estructuras) (obligatorio): lista de términos de soporte que te gustaría actualizar. Los términos de soporte aceptados son:
+ **SupportTerm**(objeto) (obligatorio): define el servicio de atención al cliente disponible para los usuarios que compren el software.
+ **Tipo ** (cadena) (obligatorio): tipo del término que se está actualizando. Este es el valor del objeto:`"SupportTerm"`.
+ **RefundPolicy**(cadena) (obligatorio): Free-text campo sobre la descripción de la política de reembolsos que se mostrará a los clientes tal como está en el sitio web y la consola.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateSupportTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| Términos | Obligatorio | 422 |
| Términos []. RefundPolicy | Obligatorio
La longitud debe estar entre 1 y 500
No puede empezar ni terminar con espacios | 422 |
| Términos []. Tipo | ObligatorioSolo puede ser `SupportTerm` | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateSupportTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| PRODUCTO\_INCOMPATIBLE | SupportTerm no está disponible en las ofertas privadas del producto. |
| TERMINOS\_INCOMPATIBLES | SupportTerm no es compatible con las ofertas de prueba gratuita. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar una vez caducada la oferta. |
## Actualizar los recursos legales
Puedes usar la API de catálogo para reemplazar los documentos legales existentes, como un acuerdo de licencia de usuario final (EULA). Las condiciones legales que no estén incluidas en la última solicitud se eliminarán de la oferta.
Para actualizar los recursos legales de tu oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateLegalTerms` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateLegalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
}
]
}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `UpdateLegalTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **LegalTerm**(objeto) (obligatorio): define la lista de acuerdos de texto que se propondrán a los aceptantes. Un ejemplo de este tipo de acuerdo es el acuerdo de licencia de usuario final (EULA).
+ **Tipo ** (cadena) (obligatorio): tipo del término que se está actualizando. Este es el valor del objeto:`"LegalTerm"`.
+ **Documentos ** (conjunto de estructuras) (obligatorio): lista de referencias a los recursos legales que se propondrán a los compradores. Un ejemplo de este tipo de recurso es el acuerdo de licencia de usuario final (EULA). Cada referencia se compone de un `Type` y un`URL`:
+ **Tipo ** (cadena) (obligatorio): tipo de documento. Los tipos de documentos disponibles son:
+ **CustomEula**— Un EULA personalizado proporcionado por ti como vendedor. Para este tipo de documento se requiere una URL [ S3 pública o una URL ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html) prefirmada.
+ **StandardEula**— Contrato estándar para AWS Marketplace (SCMP). Para obtener más información sobre SCMP, consulta la Guía del AWS Marketplace vendedor. No proporcionas una URL para este tipo porque está gestionada por AWS Marketplace.
+ **URL ** (cadena) (obligatoria de forma condicional): la URL del documento legal para que la lean los compradores. Obligatorio cuando `Type` es uno de los siguientes [`CustomEula`].
+ **Versión ** (cadena) (obligatoria condicionalmente): versión de los contratos estándar proporcionada por AWS Marketplace. Obligatorio cuando `Type` es [`StandardEula`]. Versión disponible:
+ **14 de julio de 2022 ** — Esta versión del contrato estándar AWS Marketplace está disponible en este bucket de Amazon S3: [ https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf ](https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf)
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateLegalTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| Términos | Obligatorio
Solo `LegalTerm` está permitido en la lista
El tamaño de la lista debe ser 1 | 422 |
| Términos []. Tipo | ObligatorioSolo puede ser `LegalTerm` | 422 |
| Términos []. LegalTerm.Documents | Obligatorio | 422 |
| Condiciones []. LegalTerm.Documents[]. Escriba | Obligatorio
Valores permitidos:+ `CustomEula`
+ `StandardEula` | 422 |
| Términos []. LegalTerm.Documents[] .Url | Obligatorio y debe ser una URL válida cuando Type es CustomEula | 422 |
| Condiciones []. LegalTerm.Documents[]. Versión | Obligatorio y debe ser una versión válida cuando Type sea StandardEula`StandardEula`Versiones válidas: ["2019-04-24", «2022-07-14"] | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateLegalTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar una vez caducada la oferta. |
| DOCUMENTOS\_LEGALES\_INVÁLIDOS | Proporcione las URL de los documentos legales almacenados en depósitos S3 accesibles. |
| DOCUMENTOS\_LEGALES\_INVÁLIDOS | Solo la versión más reciente de es compatible con las ofertas nuevas StandardEula . |
| DOCUMENTOS\_LEGALES\_INVÁLIDOS | Proporcione los documentos legales en los formatos de archivo compatibles. |
| DOCUMENTOS\_LEGALES\_INVÁLIDOS | Proporcione documentos legales utilizando los tipos de documentos compatibles. |
| LÍMITE DE TAMAÑO DEL DOCUMENTO LEGAL EXCEDIDO | Proporcione los documentos legales dentro de los límites de tamaño permitidos. |
| DOCUMENTOS\_LEGALES\_INVÁLIDOS | LegalTerm contiene documentos protegidos con contraseña. Proporcione documentos accesibles en LegalTerm. |
| DOCUMENTOS\_LEGALES\_INVÁLIDOS | LegalTerm contiene documentos PDF no válidos. Proporcione documentos accesibles en LegalTerm. |
## Actualizar los precios
Puedes usar la API de catálogo para reemplazar por completo las condiciones de precios existentes. Las condiciones de precios que no estén incluidas en la última solicitud se eliminarán de la oferta.
Para actualizar las condiciones de precios de tu oferta, llama a la operación de la `StartChangeSet` API indicando el tipo de `UpdatePricingTerms` cambio, como se muestra en el siguiente ejemplo.
**nota**
La siguiente sintaxis de solicitud combina varios ejemplos. Esta combinación no funciona como una carga útil válida. Por ejemplo, una `Terms` matriz no puede incluir tanto el tipo de término como el tipo `FixedUpfrontPricingTerm` de término. `ConfigurableUpfrontPricingTerm` Para ver ejemplos de cómo se combinan diferentes tipos de términos para diferentes casos de uso de precios, consulta [ Gestionar ofertas con la API ](https://catalog.workshops.aws/mpseller/en-US/manage-offers-with-api) en el taller para *AWS Marketplace vendedores*.
**nota**
En el caso de los productos SaaS con un modelo de precios gratuito, debes incluir una `UsageBasedPricingTerm` o `ConfigurableUpfrontPricingTerm` al menos una RateCard (dimensión) y todos los precios se fijan en 0,00$. Este requisito es exclusivo de los productos SaaS.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "ByolPricingTerm"
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "100.0"
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "m3.xlarge",
"MaxQuantity": 10
},
{
"DimensionKey": "m4.xlarge",
"MaxQuantity": 10
}
]
}
]
}
}
]
}
```
Proporcione información sobre los campos para agregar el tipo de `UpdatePricingTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **PricingModel**(cadena) (obligatorio): modelo de precios para tu oferta. Los valores posibles para el modelo de precios son:
+ **Uso**: modelo Usage-based de precios en el que se facturará a los compradores por el uso que hagan de tu producto.
+ **Contrato**: modelo de Contract-based precios en el que a los compradores se les factura por adelantado por el uso de tu producto o se les ofrece un calendario de pagos flexible. Los compradores también pueden pagar por un uso adicional por encima de lo estipulado en el contrato.
+ **Gratis**: modelo de precios gratuito en el que no se cobrará a los compradores por el uso del producto. Al utilizar este modelo de precios, ninguna de las condiciones de precios o plazos del calendario de pagos puede tener tasas distintas de cero.
+ **Byol**: modelo de precios de Byol en el que los compradores deben traer su propia licencia para usar el producto.
+ **Condiciones ** (conjunto de estructuras) (obligatorio): lista de condiciones de precios que desea actualizar. Los términos de precios admitidos son:
+ **FreeTrialPricingTerm**(objeto): define un modelo de precios gratuitos a corto plazo en el que no se cobra nada a los compradores dentro de un límite específico.
+ **Tipo ** (cadena): tipo del término que se está actualizando. Este es el valor del objeto:`"FreeTrialPricingTerm"`.
+ **Duración ** (cadena): duración del período de prueba gratuito.
+ **Becas ** (conjunto de estructuras): derechos que se concederán a quien acepte una prueba gratuita como parte de la ejecución de un acuerdo.
+ **DimensionKey**(cadena): clave de dimensión única definida en el documento del producto. Las dimensiones representan las categorías de capacidad de un producto y se especifican cuando el producto aparece en la lista AWS Marketplace.
+ **MaxQuantity**(entero) (opcional): cantidad máxima de capacidad a la que puede tener derecho el comprador en una dimensión determinada del producto. Si no `MaxQuantity` se proporciona, el comprador podrá usar una cantidad ilimitada de la dimensión dada.
+ **UsageBasedPricingTerm**(objeto): define un modelo de precios de pago por uso (PAYG) en el que se cobra a los clientes en función del uso del producto.
+ **Tipo ** (cadena) (obligatorio): categoría del término que se está actualizando. Este es el valor del objeto:`UsageBasedPricingTerm`.
+ **CurrencyCode**(cadena): define la divisa para los precios mencionados en este término. Actualmente, solo se admite el USD.
+ **RateCards**(conjunto de estructuras): lista de tarjetas de tarifas.
+ **RateCard**(conjunto de estructuras): una tabla de tarifas define las tarifas por unidad para las dimensiones del producto.
+ **DimensionKey**(cadena): dimensión a la que se aplica el derecho dado. Las dimensiones representan las categorías de capacidad de un producto y se especifican cuando el producto aparece en la lista. AWS Marketplace
+ **Precio ** (cadena): Per-unit precio de la dimensión del producto que se utilizará para calcular el importe que se cobrará al comprador.
+ **ConfigurableUpfrontPricingTerm**(objeto): define un modelo de pago anticipado que permite a los compradores configurar los derechos que desean adquirir y la duración de los mismos. Puedes actualizar la lista de tarifas para cada duración del contrato y los derechos para cada dimensión.
+ **Tipo ** (cadena) (obligatorio): tipo del plazo que se está actualizando. Este es el valor del objeto:`ConfigurableUpfrontPricingTerm`.
+ **CurrencyCode**(cadena) (obligatorio): define la divisa de los precios mencionados en este término. Para las ofertas públicas, solo se admite el USD. Para las ofertas privadas, se admiten USD, AUD, EUR, GBP y JPY.
+ **RateCards**(conjunto de estructuras) (obligatorio): lista de tablas de tarifas.
+ **Selector ** (objeto) (obligatorio): el selector se utiliza para diferenciar entre las tablas de tarifas que se excluyen mutuamente y que se encuentran en el mismo plazo de precios, a ser seleccionadas por el comprador.
+ **Tipo ** (cadena) (obligatorio): categoría del selector. Por el momento, solo `Duration` es compatible.
+ **Valor ** (cadena) (obligatorio): duración del contrato. Este campo admite el formato ISO 8601.
+ **RateCard**(conjunto de estructuras) (obligatorio): una tabla de tarifas define las tarifas por unidad para las dimensiones del producto.
+ **DimensionKey**(cadena) (obligatorio): clave de dimensión única definida en el documento del producto. Las dimensiones representan las categorías de capacidad de un producto y se especifican cuando el producto aparece en la lista AWS Marketplace.
+ **Precio ** (cadena) (obligatorio): Per-unit precio de la dimensión del producto que se utilizará para calcular el importe que se cobrará al comprador.
+ **Restricciones ** (objeto) (obligatorio): define las restricciones sobre la forma en que los aceptadores pueden configurar el término.
**nota**
Actualmente, ** MultipleDimensionSelection ** los ** QuantityConfiguration ** valores deben ser los mismos.
+ **MultipleDimensionSelection**(cadena) (obligatorio): determina si los compradores pueden seleccionar varias dimensiones en la tabla de tarifas. Los posibles valores son `Allowed` y `Disallowed`.
+ **QuantityConfiguration**(cadena) (obligatorio): determina si los usuarios pueden configurar la cantidad para cada dimensión de la tabla de tarifas. Los posibles valores son `Allowed` y `Disallowed`.
+ **ByolPricingTerm**(objeto): les permite a usted y a sus clientes trasladar sus acuerdos actuales a AWS Marketplace. Al cliente no se le cobrará por el uso del producto en, AWS Marketplace ya que ya pagó por el producto fuera de ella AWS Marketplace.
+ **Tipo ** (cadena) (obligatorio): tipo del término que se está actualizando. Este es el valor del objeto:`ByolPricingTerm`.
+ **RecurringPaymentTerm**(objeto): define un modelo de precios en el que se cobra a los clientes un precio fijo recurrente al final de cada período de facturación.
+ **Tipo ** (cadena) (obligatorio): tipo de plazo que se está actualizando. Este es el valor del objeto:`RecurringPaymentTerm`.
+ **BillingPeriod**(cadena) (obligatorio): define la periodicidad con la que se cobra a los compradores. Solo `Monthly` se admite hoy en día.
+ **Precio ** (cadena) (obligatorio): importe cobrado al comprador en cada período de facturación.
+ **CurrencyCode**(cadena) (obligatorio): define la divisa de los precios mencionados en este término. En la actualidad, solo se admite `USD`.
+ **FixedUpfrontPricingTerm**(objeto): define un modelo de precios de prepago en el que se cobra a los clientes un importe inicial fijo.
+ **Tipo ** (cadena) (obligatorio): tipo del término que se está actualizando. Este es el valor del objeto:`FixedUpfrontPricingTerm`.
+ **CurrencyCode**(cadena) (obligatorio): define la divisa de los precios mencionados en este término. Para las ofertas públicas, solo se admite el USD. Para las ofertas privadas, se admiten USD, AUD, EUR, GBP y JPY.
+ **Precio ** (cadena) (obligatorio): importe fijo que se cobrará al cliente cuando se acepte este plazo.
+ **Subvenciones ** (conjunto de estructuras) (obligatorio): derechos que se concederán al aceptador de una cantidad fija por adelantado como parte de la ejecución del acuerdo.
+ **DimensionKey**(cadena) (obligatorio): clave de dimensión única definida en el documento del producto. Las dimensiones representan las categorías de capacidad de un producto y se especifican cuando el producto aparece en la lista AWS Marketplace.
+ **MaxQuantity**(entero) (obligatorio): cantidad máxima de capacidad a la que puede tener derecho el comprador en una dimensión determinada del producto. Si no `MaxQuantity` se proporciona, el comprador podrá usar una cantidad ilimitada de la dimensión dada.
+ **Duración ** (cadena) (opcional): define el tiempo que el plazo permanece activo. Este campo admite el formato ISO 8601.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdatePricingTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | HTTP |
| --- | --- | --- |
| PricingModel | ObligatorioModelos de precios permitidos: ["Byol», «Free», «Usage», «Contract"] | 422 |
| Términos | ObligatorioTérminos permitidos: [» ConfigurableUpfrontPricingTerm «," ByolPricingTerm «," FreeTrialPricingTerm «," UsageBasedPricingTerm «," RecurringPaymentTerm «," FixedUpfrontPricingTerm «] | 422 |
| Términos []. ByolPricingTerm | Obligatorio | 422 |
| Condiciones []. ByolPricingTerm.Type | ObligatorioSolo puede ser "ByolPricingTerm» | 422 |
| Términos []. ConfigurableUpfrontPricingTerm | Obligatorio | 422 |
| Condiciones []. ConfigurableUpfrontPricingTerm.Type | ObligatorioSolo puede ser "ConfigurableUpfrontPricingTerm» | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.CurrencyCode | ObligatorioDivisas admitidas: ["USD», «AUD», «EUR», «GBP», «JPN"] | 422 |
| Condiciones []. ConfigurableUpfrontPricingTerm.RateCards | ObligatorioEl tamaño de la lista debe estar entre 1 y 5 | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. Restricciones | Obligatorio | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. Contraints.MultipleDimensionSelection | ObligatorioValores permitidos: ["Permitido», «No permitido"] | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. Contraints.QuantityConfiguration | ObligatorioValores permitidos: ["Permitido», «No permitido"] | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard | ObligatorioEl tamaño de la lista debe estar entre 1 y 800 | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard[]. DimensionKey | ObligatorioLa longitud debe estar entre 1 y 100 | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. RateCard[]. Precio | ObligatorioEl tipo de datos es «Cadena»
Non-negativeSe admiten decimales con hasta 3 decimales | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[] .Selector | Obligatorio | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. Selector.Type | ObligatorioValores permitidos: ["Duración"] | 422 |
| Términos []. ConfigurableUpfrontPricingTerm.RateCards[]. Selector.Value | ObligatorioFormato esperado por tipo de selector: duración ISO 8601 | 422 |
| Condiciones []. FixedUpfrontPricingTerm | Obligatorio | 422 |
| Condiciones []. FixedUpfrontPricingTerm.Type | ObligatorioSolo puede ser "FixedUpfrontPricingTerm» | 422 |
| Términos []. FixedUpfrontPricingTerm.CurrencyCode | ObligatorioDivisas admitidas: ["USD», «AUD», «EUR», «GBP», «JPN"] | 422 |
| Condiciones []. FixedUpfrontPricingTerm.Duration | ObligatorioFormato esperado por tipo de selector: duración ISO 8601 | 422 |
| Condiciones []. FixedUpfrontPricingTerm.Grants | ObligatorioEl tamaño de la lista debe estar entre 1 y 200 | 422 |
| Términos []. FixedUpfrontPricingTerm.Grants[]. DimensionKey | ObligatorioLa longitud debe estar entre 1 y 100 | 422 |
| Términos []. FixedUpfrontPricingTerm.Grants[]. MaxQuantity | RequiredValue debe ser mayor que 0 | 422 |
| Términos []. FixedUpfrontPricingTerm.Price | ObligatorioEl tipo de datos es «Cadena»
Non-negativeSe admiten decimales con hasta 3 decimales | 422 |
| Términos []. FreeTrialPricingTerm | Obligatorio | 422 |
| Condiciones []. FreeTrialPricingTerm.Type | ObligatorioSolo puede ser "FreeTrialPricingTerm» | 422 |
| Términos []. FreeTrialPricingTerm.Duration | ObligatorioFormato esperado: duración ISO 8601 | 422 |
| Condiciones []. FreeTrialPricingTerm.Grants | ObligatorioEl tamaño de la lista debe estar entre 1 y 800 | 422 |
| Términos []. FreeTrialPricingTerm.Grants[]. DimensionKey | ObligatorioLa longitud debe estar entre 1 y 100 | 422 |
| Términos []. FreeTrialPricingTerm.Grants[]. MaxQuantity | OpcionalEl valor debe ser mayor que 0 | 422 |
| Términos []. RecurringPaymentTerm | Obligatorio | 422 |
| Condiciones []. RecurringPaymentTerm.Type | ObligatorioSolo puede ser "RecurringPaymentTerm» | 422 |
| Términos []. RecurringPaymentTerm.BillingPeriod | ObligatorioValores permitidos: ["Mensualmente"] | 422 |
| Condiciones []. RecurringPaymentTerm.CurrencyCode | ObligatorioDivisas admitidas: ["USD"] | 422 |
| Condiciones []. RecurringPaymentTerm.Price | ObligatorioEl tipo de datos es «Cadena»
Non-negativeSe admiten decimales con hasta 3 decimales | 422 |
| Términos []. UsageBasedPricingTerm | Obligatorio | 422 |
| Condiciones []. UsageBasedPricingTerm.Type | ObligatorioSolo puede ser "UsagedBasedPricingTerm» | 422 |
| Términos []. UsageBasedPricingTerm.CurrencyCode | ObligatorioDivisas admitidas: ["USD"] | 422 |
| Condiciones []. UsageBasedPricingTerm.RateCards | ObligatorioDebe ser de talla 1 | 422 |
| Términos []. UsageBasedPricingTerm.RateCards[]. RateCard | ObligatorioEl tamaño de la lista debe estar entre 1 y 800 | 422 |
| Términos []. UsageBasedPricingTerm.RateCards[]. RateCard[]. DimensionKey | ObligatorioLa longitud debe estar entre 1 y 100 | 422 |
| Términos []. UsageBasedPricingTerm.RateCards[]. RateCard[]. Precio | ObligatorioEl tipo de datos es «Cadena»
Non-negativeSe admiten decimales con hasta 8 decimales | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdatePricingTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| DUPLICATE\_DIMENSION\_KEYS | Proporcione a Grants una lista única de claves de dimensión en [x]. |
| CLAVES\_DIMENSIONAL\_DUPLICADAS | Proporcione RateCard una lista única de claves de dimensión en [x]. |
| SELECTORES DUPLICADOS | Proporcione una lista única de selectores en. ConfigurableUpfrontPricingTerm |
| TIPOS\_DE\_TÉRMINOS DUPLICADOS | Proporcione una lista única de tipos de términos. |
| ACUERDO\_INCOMPATIBLE | Los siguientes términos no se pueden eliminar de la oferta de reemplazo: [x, y, z]. |
| ACUERDO\_INCOMPATIBLE | Los siguientes términos no se pueden agregar a la oferta de reemplazo: [x, y, z]. |
| CÓDIGO\_DE DIVISA INCOMPATIBLE | CurrencyCode no se puede cambiar después de que se publique la oferta. |
| CONFIGURACIÓN\_DE\_PAGO INCOMPATIBLES | Actualiza tu configuración de pago para que sea compatible con. CurrencyCode |
| PRODUCTO\_INCOMPATIBLE | El modelo de precios de uso no es compatible con el producto. |
| PRODUCTO\_INCOMPATIBLE | El modelo de precios por contrato no es compatible con el producto. |
| PRODUCTO\_INCOMPATIBLE | El modelo de precios Byol no es compatible con el producto. |
| PRODUCTO\_INCOMPATIBLE | El modelo de precios gratuito no es compatible con el producto. |
| PRODUCTO\_INCOMPATIBLE | [x] no está incluido en la oferta del producto. |
| PRODUCTO\_INCOMPATIBLE | Siempre que las condiciones de pago y precios sean incompatibles. |
| PRODUCTO\_INCOMPATIBLE | Usa las dimensiones existentes y disponibles en el producto en [x]. |
| PRODUCTO\_INCOMPATIBLE | FreeTrialPricingTerm ya que el único plazo de precios de la oferta no es compatible con el producto. |
| PRODUCTO\_INCOMPATIBLE | Los siguientes términos no son compatibles con el producto: [x, y, z]. |
| PRODUCTO\_INCOMPATIBLE | Las ofertas de reemplazo solo son compatibles con el modelo de precios por contrato. |
| PRODUCTO\_INCOMPATIBLE | Proporciona condiciones de precios que sean compatibles con las dimensiones del producto. Condiciones de precios incompatibles: [x, y, z]. |
| RESTRICCIONES\_TARIFAS\_TARJETAS\_INCOMPATIBLES | Establece y selecciona Permitido para el modelo de precios de uso MultipleDimensionSelection . QuantityConfiguration ConfigurableUpfrontPricingTerm |
| RESTRICCIONES\_TARIFAS\_TARJETAS\_INCOMPATIBLES | Establece y MultipleDimensionSelection no está permitido en el modelo de precios de uso. QuantityConfiguration ConfigurableUpfrontPricingTerm |
| RESTRICCIONES\_TARIFAS\_TARJETAS\_INCOMPATIBLES | QuantityConfiguration no se ConfigurableUpfrontPricingTerm puede cambiar después de que se publique la oferta. |
| RESTRICCIONES\_TARIFAS\_TARJETAS\_INCOMPATIBLES | MultipleDimensionSelection no se ConfigurableUpfrontPricingTerm puede cambiar después de que se publique la oferta. |
| TARIFAS\_INCOMPATIBLES | Establece todos los importes de cargos y precios en cero (0) cuando utilices el modelo de precios gratuito. |
| TARIFAS\_INCOMPATIBLES | En una oferta de prueba gratuita del producto solo se permite el pago UsageBasedPricingTerm de cero (0) precios. |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Proporcione lo mismo CurrencyCode que se especifica en ResaleAuthorization. |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que la duración coincide con la duración especificada en. FixedUpfrontPricingTerm ResaleAuthorization |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Proporcione términos que sean compatibles con. ResaleAuthorization Términos incompatibles: [x, y, z]. |
| DURACIÓN\_SELECTOR\_INCOMPATIBLE | No se permite eliminar las duraciones de las tarjetas de tarifas una vez publicada la oferta. ConfigurableUpfrontPricingTerm |
| VERIFICACIÓN\_DE\_VENDEDOR INCOMPATIBLE | Completa todos los procesos de verificación del vendedor requeridos. |
| TERMINOS\_INCOMPATIBLES | [x] no se admite junto con los siguientes términos: [y, z]. |
| TERMINOS\_INCOMPATIBLES | No se pueden añadir los siguientes términos una vez publicada la oferta: [x, y, z]. |
| TERMINOS\_INCOMPATIBLES | Los siguientes términos no se pueden eliminar una vez publicada la oferta: [x, y, z]. |
| TERMINOS\_INCOMPATIBLES | [x] no es compatible con ofertas privadas. |
| TERMINOS\_INCOMPATIBLES | No se admiten los siguientes términos FreeTrialPricingTerm que conceden un uso ilimitado: [x, y, z]. |
| TERMINOS\_INCOMPATIBLES | El producto no admite los siguientes términos: [x, y, z]. FreeTrialPricingTerm |
| TERMINOS\_INCOMPATIBLES | Indica un precio cero (0) FixedUpfrontPricingTerm cuando la oferta contenga un. PaymentScheduleTerm |
| TERMINOS\_INCOMPATIBLES | Los siguientes términos no son compatibles con PricingModel: [x, y, z]. |
| TERMINOS\_INCOMPATIBLES | FixedUpfrontPricingTerm no se admite cuando MarkupPercentage es mayor que cero (0). |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar una vez caducada la oferta. |
| DURACIÓN\_DE\_ACUERDO INVÁLIDA | Indica una duración entre [x] e [y] meses. |
| DURACIÓN\_DE\_ACUERDO INVÁLIDA | Asegúrese de que la granularidad de la duración esté en el nivel del día para las dimensiones medidas. |
| CÓDIGO\_DE\_DIVISA NO VÁLIDO | Proporcione un soporte. CurrencyCode |
| CÓDIGO\_DE\_DIVISA NO VÁLIDO | Proporcione lo mismo en CurrencyCode todos los precios y condiciones de pago. |
| CÓDIGO\_DE\_DIVISA NO VÁLIDO | Proporcione un soporte. CurrencyCode |
| CÓDIGO\_DE\_DIVISA NO VÁLIDO | Proporcione lo mismo en CurrencyCode todos los precios y condiciones de pago. |
| DURACIÓN\_INVÁLIDA | Asegúrese de que la duración en FreeTrialPricingTerm esté dentro del rango permitido. |
| DURACIÓN\_INVÁLIDA | Proporcione una duración FixedUpfrontPricingTerm que coincida con la duración entre y. AgreementStartDate AgreementEndDate |
| DURACIÓN\_INVÁLIDA | Indica una duración entre [x] e [y] meses. |
| DURACIÓN\_INVÁLIDA | Asegúrese de que la granularidad de la duración sea igual al día para las dimensiones medidas. |
| SUBVENCIONES\_INVÁLIDAS | Proporcione lo mismo MaxQuantity para todas las subvenciones de. FreeTrialPricingTerm |
| SUBVENCIONES\_INVÁLIDAS | Otorgue subvenciones para todas las dimensiones medidas disponibles en. FreeTrialPricingTerm |
| SUBVENCIONES\_INVÁLIDAS | The combination of Dimensions in grants is invalid in FixedUpfrontPricingTerm for the product. |
| SUBVENCIONES\_INVÁLIDAS | The combination of Dimensions in grants is invalid in FreeTrialPricingTerm for the product. |
| SUBVENCIONES\_INVÁLIDAS | FixedUpfrontPricingTerm with MaxQuantity is not supported for this product. |
| CAMBIO\_DE\_PRECIO INVÁLIDO | [x] no se puede actualizar hasta [y] porque has solicitado un aumento de precio en los últimos 120 días. Para cancelar su solicitud anterior de aumento de precio o para obtener más información, póngase en contacto con el equipo de operaciones de AWS Marketplace gestión del catálogo. |
| CAMBIO DE PRECIO NO VÁLIDO | El aumento de precio y la adición de dimensiones en [x] no se admiten en la misma solicitud. Añada las dimensiones primero. |
| CAMBIO DE PRECIO NO VÁLIDO | UsageBasedPricingTermNo se admite el aumento y la disminución del precio en la misma solicitud. Disminuya los precios primero. |
| CAMBIO DE PRECIO NO VÁLIDO | UsageBasedPricingTerm No se admiten el aumento RecurringPaymentTerm y la disminución del precio en en la misma solicitud. Disminuya los precios primero. |
| CAMBIO DE PRECIO NO VÁLIDO | La reducción de precio RecurringPaymentTerm y el aumento de precio en UsageBasedPricingTerm no se admiten en la misma solicitud. Disminuya los precios primero. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | ConfigurableUpfrontPricingTerm le faltan una o más claves de dimensión durante el tiempo [x]. Proporcione precios para el mismo conjunto de claves de dimensión para todas las duraciones. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Proporcione una tabla de tarifas solo para las dimensiones medidas en pulgadas. UsageBasedPricingTerm |
| TARJETA DE TARIFACIÓN NO VÁLIDA | No se pueden eliminar las tarifas de [x]. Indica los precios de todas las dimensiones en la tabla de tarifas existente. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Indica dimensiones que tengan la misma unidad en [x]. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Escriba en [x] todas las dimensiones medidas o todas las dimensiones autorizadas. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Indique solo las dimensiones autorizadas en [x]. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Proporcione las tarifas basadas en el uso para todas las dimensiones medidas disponibles en. UsageBasedPricingTerm |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Proporcione tarifas basadas en el uso para todas las dimensiones de la prueba gratuita. |
| TARJETA DE TARIFACIÓN NO VÁLIDA | Indica los precios con un máximo de 8 decimales. UsageBasedPricingTerm |
| TARJETA DE TARIFACIÓN NO VÁLIDA | The combination of Dimensions in rate card is invalid in UsageBasedPricingTerm for the product. |
| VALOR\_DE\_DURACIÓN\_SELECTOR\_INVÁLIDO | Indica una duración entre [x] e [y] meses. |
| VALOR\_DE\_DURACIÓN\_SELECTOR\_INVÁLIDO | Asegúrese de que la granularidad de la duración esté en el nivel del día para las dimensiones medidas. |
| VALOR\_DE\_DURACIÓN\_SELECTOR\_INVÁLIDO | Asegúrese de que la duración ConfigurableUpfrontPricingTerm esté dentro del rango permitido. |
| VALOR\_DE\_DURACIÓN\_SELECTOR\_INVÁLIDO | Proporcione una o más duraciones de contrato admitidas. |
| VALOR\_DE\_DURACIÓN\_SELECTOR\_INVÁLIDO | Proporcione una o más duraciones de contrato admitidas o una única duración personalizada. |
| VALOR\_DE\_DURACIÓN\_SELECTOR\_INVÁLIDO | Proporcione una duración que coincida con la duración entre y. ConfigurableUpfrontPricingTerm AgreementStartDate AgreementEndDate |
| DURACIÓN\_FALTANTE | Proporcione la duración en. FixedUpfrontPricingTerm |
| TERMINOS\_OBLIGATORIOS\_FALTANTES | FixedUpfrontPricingTerm solo se admite cuando se combina con o. ByolPricingTerm PaymentScheduleTerm |
| TERMINOS\_OBLIGATORIOS\_FALTANTES | Proporcione al menos uno de [x, y, z]. |
| TERMINOS\_OBLIGATORIOS\_FALTANTES | Proporcione un cuando utilice el modelo de precios de ByolPricingTerm Byol. |
| DEMASIADAS SUBVENCIONES | Otorga hasta [x] subvenciones en [y]. |
| DEMASIADAS TARJETAS DE TARIFAS | Solo se permite introducir una tarjeta de tarifas para el producto. ConfigurableUpfrontPricingTerm |
| DEMASIADAS TARJETAS DE TARIFAS | Se permiten tarjetas de tarifas de hasta [x] para el producto. ConfigurableUpfrontPricingTerm |
| DEMASIADAS TARIFAS | Proporcione RateCards dentro de los límites permitidos en. ConfigurableUpfrontPricingTerm |
| DEMASIADAS TARIFAS | Proporcione RateCards dentro de los límites permitidos en. UsageBasedPricingTerm |
| RESTRICCIONES\_TARIFAS\_TARJETAS\_INCOMPATIBLES | Establezca ambos valores en el mismo valor ( MultipleDimensionSelection permitido o no QuantityConfiguration permitido) en. ConfigurableUpfrontPricingTerm |
| RESTRICCIONES\_TARIFAS\_TARJETAS\_INCOMPATIBLES | Establezca las mismas restricciones para todas las tarjetas de tarifas de. ConfigurableUpfrontPricingTerm |
| SOLICITUD\_ACTUALIZACIÓN\_INVÁLIDA | [x] no se puede actualizar. Para solicitar un cambio de precios o para obtener más información, póngase en contacto con el equipo de operaciones de catálogos AWS Marketplace gestionados. |
| MODELO\_DE\_PRECIOS INCOMPATIBLE | PricingModel no se puede cambiar de [x] a [y]. |
| SUBVENCIONES\_INVÁLIDAS | MaxQuantity para FreeTrialPricingTerm está limitado para el producto. Proporcione un valor MaxQuantity inferior o igual a [x]. Para obtener más información, póngase en contacto con el equipo de operaciones de AWS Marketplace gestión del catálogo. |
| SUBVENCIONES\_INVÁLIDAS | Prevea todas MaxQuantity las subvenciones en. FixedUpfrontPricingTerm |
| SUBVENCIONES\_INVÁLIDAS | MaxQuantity no es compatible con el producto FixedUpfrontPricingTerm . |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que las subvenciones coincidan con lo especificado en el. FixedUpfrontPricingTerm RateCards ResaleAuthorization |
## Actualiza la visibilidad de la oferta
Puedes usar la API de catálogo para controlar la visibilidad de tu oferta en. AWS Marketplace
Puedes elegir establecer una fecha específica en el futuro para restringir la visibilidad de tu oferta o en el pasado para que caduque tu oferta. El tipo de `UpdateAvailability` cambio no afecta a los acuerdos existentes.
**nota**
Puedes usar el tipo de `UpdateAvailability` cambio en una oferta privada que ya se haya [ publicado ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (también conocida como * lanzada*). Si los compradores ya han aceptado la oferta privada, los acuerdos existentes no se verán afectados.
Al `AvailabilityEndDate` modificar una oferta privada existente, se [ deben cumplir las ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-validity-terms) restricciones de duración del acuerdo. Si no lo es, incluye un tipo de `UpdateValidityTerms` cambio adicional en este conjunto de cambios para modificar la duración del acuerdo y cumplir con el nuevo vencimiento. El tipo de `UpdateValidityTerms` cambio se puede usar en una oferta privada que esté disponible o que aún no se haya publicado.
Al `AvailabilityEndDate` modificar una oferta privada existente, se [ deben cumplir las ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-payment-schedule-terms) restricciones del calendario de pagos. Si no lo es y la oferta privada aún * no se ha publicado*, incluye un tipo de `UpdatePaymentScheduleTerms` cambio adicional en este conjunto de cambios para modificar el calendario de pagos y cumplir con el nuevo vencimiento. Si la oferta privada * ya está * disponible, solo podrás modificarla siempre y `AvailabilityEndDate` cuando la nueva fecha cumpla con las restricciones del calendario de pagos.
Para controlar la visibilidad de tu oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateAvailability` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateAvailability",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"AvailabilityEndDate": "2024-05-31"
}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `UpdateAvailability` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **AvailabilityEndDate**(cadena) (obligatorio): es la fecha hasta que la oferta se puede descubrir y comprar en. AWS Marketplace Puedes elegir establecer una fecha específica en el futuro para restringir la disponibilidad o en el pasado para que caduque la oferta. Las fechas se representan en `YYYY-MM-DD` formato.
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona el ID y el ARN del conjunto de cambios y tiene el siguiente aspecto.
**Sintaxis de respuesta **
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos. Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o en la API de catálogo con la `DescribeChangeSet` acción.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateAvailability` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| AvailabilityEndDate | Obligatorio
Formato: "YYYY-MM-DD» | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateAvailability` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre el uso `DescribeChangeSet` para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| INVALID\_AVAILABILITY\_END\_DATE | AvailabilityEndDate no es compatible con las ofertas públicas. |
| FECHA\_FINALIZACIÓN\_DISPONIBILIDAD\_NO VÁLIDA | Proporcione un futuro. AvailabilityEndDate |
| FECHA\_FINALIZACIÓN\_DISPONIBILIDAD\_NO VÁLIDA | Proporcione una que sea anterior. AvailabilityEndDate AgreementEndDate |
| FALTA LA FECHA\_FINALIZACIÓN\_DE DISPONIBILIDAD | Proporcione una que AvailabilityEndDate sea anterior a la fecha de finalización del acuerdo. |
## Defina la fecha de caducidad de los acuerdos creados con la oferta
Puedes usar la API de catálogo para definir los detalles de la fecha de vencimiento de los acuerdos creados con la oferta en AWS Marketplace.
Este tipo de cambio no afecta a los acuerdos existentes.
**nota**
Puedes usar el tipo de `UpdateValidityTerms` cambio en una oferta privada que ya se haya [ publicado ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (también conocida como * lanzada*). Si los compradores ya han aceptado la oferta privada, los acuerdos existentes no se verán afectados.
En el caso de ** los productos ** basados en contenedores, si las condiciones de [ precios de tu oferta privada ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-pricing-terms) incluyen un tipo de plazo que tiene un `Duration` (por ejemplo, los tipos de términos `FixedUpfrontPricingTerm` o`ConfigurableUpfrontPricingTerm`), lo que hayas `AgreementDuration` establecido en este tipo de cambio debe ser superior al siguiente: el número de días desde hoy hasta el [ vencimiento de la oferta privada ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-availability) más el número de días establecido en esos tipos `Duration` de términos. ** AMI-based ** Esto se debe a que, una vez que el comprador acepta la oferta privada y se crea el acuerdo, puede comprar de forma opcional derechos adicionales especificados en esos tipos de términos hasta que caduque la oferta privada. Además, todos los derechos adicionales deben finalizar antes de que finalice el acuerdo. Por ejemplo, si el comprador acepta la oferta privada el primer día disponible y adquiere los derechos el último día disponible, esos derechos no deben finalizar tras la fecha de finalización del acuerdo.
Para definir los detalles de la fecha de caducidad de los acuerdos creados con la oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateValidityTerms` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateValidityTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "ValidityTerm",
"AgreementDuration": "P12M",
"AgreementStartDate": "2021-08-01",
"AgreementEndDate": "2022-08-01"
}
]
}
}
]
}
```
Proporciona información sobre los campos para agregar el tipo de `UpdateValidityTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **Términos ** (matriz de estructuras): lista de términos de validez que deseas actualizar. Los términos de validez admitidos son:
+ **ValidityTerm**(objeto): define las condiciones que mantendrán la validez de un acuerdo creado a partir de esta oferta.
+ **Tipo ** (cadena): categoría del término que se está actualizando. `ValidityTerm`
+ **AgreementDuration**(cadena): define el tiempo durante el que el acuerdo permanece activo. Si `AgreementStartDate` no se proporciona, la duración del acuerdo es relativa a la hora de la firma del acuerdo. La duración se representa en el formato ISO\_8601.
+ **AgreementStartDate**(cadena): define la fecha en la que comienza el acuerdo. `AgreementStartDate`se representa en `YYYY-MM-DD` formato. El acuerdo comienza a las 00:00:00.000 UTC de la fecha indicada. Si `AgreementStartDate` no se proporciona, la fecha de inicio del acuerdo se determina en función de la hora de firma del acuerdo.
+ **AgreementEndDate**(cadena): define la fecha en la que finaliza el acuerdo. El `AgreementEndDate` se representa en `YYYY-MM-DD` formato. El acuerdo finaliza a las 23:59:59.999 UTC de la fecha indicada. Si `AgreementEndDate` no se proporciona, la fecha de finalización del acuerdo se determina en función de la validez de las condiciones individuales.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateValidityTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| Términos | Obligatorio | 422 |
| Términos []. Tipo | Obligatorio
Solo puede ser `"ValidityTerm"` | 422 |
| Términos []. AgreementDuration | Opcional
Formato esperado por tipo de selector: duración ISO 8601
Puede ser independiente o en combinación con `AgreementStartDate` | 422 |
| Términos []. AgreementEndDate | Opcional
La fecha debe tener el formato siguiente `"YYYY-MM-DD"` | 422 |
| Términos []. AgreementStartDate | Opcional
La fecha debe tener el formato siguiente `"YYYY-MM-DD"`
Solo se puede combinar con y `AgreementEndDate` `AgreementDuration` | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateValidityTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| ACUERDO\_INCOMPATIBLE | AgreementStartDate no puede estar en el futuro si el acuerdo actual que se va a reemplazar no tiene una fecha futura. |
| FECHA\_FINALIZACIÓN\_DEL\_ACUERDO INCOMPATIBLE | AgreementEndDate no se puede actualizar una vez publicada la oferta. |
| FECHA\_INICIO\_DE\_ACUERDO\_INCOMPATIBLE | AgreementStartDate no se puede actualizar una vez publicada la oferta. |
| PRODUCTO\_INCOMPATIBLE | AgreementStartDate en el futuro no es compatible. |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que la duración entre y sea compatible con. AgreementStartDate AgreementEndDate ResaleAuthorization |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que es compatible con. AgreementStartDate ResaleAuthorization |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que es compatible con. AgreementEndDate ResaleAuthorization |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que la duración entre y sea compatible con. AgreementStartDate AgreementEndDate ResaleAuthorization |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que coincida con la duración especificada en. AgreementDuration ResaleAuthorization |
| TERMINOS\_INCOMPATIBLES | ValidityTerm no es compatible con las ofertas públicas. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar una vez caducada la oferta. |
| DURACIÓN\_DE\_ACUERDO INVÁLIDA | Siempre AgreementDuration que sea mayor o igual a [x] días. |
| FECHA\_FINALIZACIÓN\_DE\_CONTRATO INVÁLIDA | Proporcione un futuro. AgreementEndDate |
| FECHA\_FINALIZACIÓN\_DE\_CONTRATO INVÁLIDA | Proporcione AgreementEndDate que esté después de [x] o sea igual a [x]. |
| FECHA\_DE\_INICIO DEL ACUERDO\_INVÁLIDA | Proporcione una que esté después. AgreementStartDate AvailabilityEndDate |
| FECHA\_DE\_INICIO DEL ACUERDO\_INVÁLIDA | Proporcione un que esté antes del. AgreementStartDate AgreementEndDate |
| FECHA\_DE\_INICIO DEL ACUERDO\_INVÁLIDA | Proporcione una que esté dentro de [x] AgreementStartDate años a partir de hoy. |
| INTERVALO DE TIEMPO DE ACUERDO NO VÁLIDO | ValidityTerm con ambos y no es compatible. AgreementDuration AgreementEndDate |
| INTERVALO DE TIEMPO DE ACUERDO NO VÁLIDO | ValidityTerm con ambos AgreementStartDate y AgreementDuration no está incluido en la oferta del producto. |
| INTERVALO DE TIEMPO DE ACUERDO NO VÁLIDO | ValidityTerm con AgreementStartDate no está incluido en la oferta del producto. |
| INTERVALO DE TIEMPO DE ACUERDO NO VÁLIDO | ValidityTerm solo no se admite con. AgreementStartDate |
| INTERVALO DE TIEMPO DE ACUERDO NO VÁLIDO | AgreementEndDate no está disponible a menos que se utilice en combinación con una oferta futura o para sustituirla. AgreementStartDate |
| INTERVALO DE TIEMPO DE ACUERDO NO VÁLIDO | Indique AgreementStartDate y AgreementEndDate cuando la diferencia sea inferior o igual a [x] años. |
| FECHA DE INICIO DEL ACUERDO FALTANTE | Asegúrese de que esté presente cuando se utilice junto AgreementStartDate con. ValidityTerm ConfigurableUpfrontPricingTerm |
| FECHA\_FINALIZACIÓN\_DE\_CONTRATO INVÁLIDA | Proporcione una que esté dentro de [x] AgreementEndDate años a partir de hoy. |
| FECHA\_INICIO\_DE\_ACUERDO\_INCOMPATIBLE | Proporcione lo mismo que se define en el acuerdo AgreementStartDate cuando el acuerdo tenga una fecha de inicio futura. |
| ACUERDO\_INCOMPATIBLE | AgreementStartDate no puede tener fecha futura si el acuerdo no tiene fecha futura. |
## Actualizar los detalles del calendario de pagos
Puedes usar la API de catálogo para actualizar los detalles del calendario de pagos de tu oferta, como el calendario de pagos flexible, en AWS Marketplace.
**nota**
No puedes usar el tipo de `UpdatePaymentScheduleTerms` cambio en una oferta que ya se haya [ publicado ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#release-offer) (también conocida como * lanzada*).
La oferta privada se puede aceptar en cualquier momento entre la creación de la oferta privada y su [ fecha de caducidad ](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-availability) (se establece en`AvailabilityEndDate`). Solo un `ChargeDate` valor del calendario de pagos puede ser una fecha igual o anterior al último día en que el comprador puede aceptar la oferta privada (la fecha de caducidad de la oferta privada). Los valores restantes de `ChargeDate` deben ser posteriores al vencimiento de la oferta privada, pero no más tarde del final del acuerdo si la oferta privada se aceptó de inmediato. La finalización del acuerdo se basa en el momento en que se acepta la oferta privada (momento en el que se crea el acuerdo) más la [ duración del acuerdo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/offers.html#update-validity-terms).
Para actualizar los detalles del calendario de pagos de tu oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdatePaymentScheduleTerms` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePaymentScheduleTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "PaymentScheduleTerm",
"Schedule": [
{
"ChargeDate": "2021-12-01",
"ChargeAmount": "200.00"
},
{
"ChargeDate": "2022-03-01",
"ChargeAmount": "250.00"
}
]
}
]
}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `UpdatePaymentScheduleTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **Condiciones ** (conjunto de estructuras): lista de condiciones de pago que deseas actualizar. Las condiciones de pago admitidas son:
+ **PaymentScheduleTerm**(objeto): define un modelo de precios basado en cuotas en el que se cobra a los clientes un precio fijo en diferentes fechas durante el período de validez del acuerdo.
+ **Tipo ** (cadena): tipo del término que se está actualizando. Este es el valor del objeto:`"PaymentScheduleTerm"`.
+ ****Cronograma (conjunto de estructuras): lista del cronograma de pagos donde cada elemento define una cuota de pago. Contiene la información necesaria para calcular el precio a pagar y la fecha en la que se cobraría al cliente.
+ **ChargeDate**(cadena): la fecha en la que el cliente pagaría el precio definido en este plazo del calendario de pagos. `ChargeDate`se representa en YYYY-MM-DD formato. Las facturas se generan en la fecha indicada.
+ **ChargeAmount**(cadena): el precio que el cliente pagaría en la fecha programada (`ChargeDate`).
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdatePaymentScheduleTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | HTTP |
| --- | --- | --- |
| Términos | Obligatorio
Solo `PaymentScheduleTerm` está permitido
El tamaño de la lista debe ser inferior a 2 | 422 |
| Términos []. Tipo | Obligatorio
Solo puede ser `PaymentScheduleTerm` | 422 |
| Términos []. PaymentScheduleTerm.CurrencyCode | Obligatorio
Divisas admitidas: ["USD», «AUD», «EUR», «GBP», «JPY"] | 422 |
| Condiciones []. PaymentScheduleTerm.Schedule[] | Obligatorio | 422 |
| Términos []. PaymentScheduleTerm.Schedule[]. ChargeAmount | ObligatorioEl tipo de fecha es «Cadena»
Non-negativeSe admiten decimales con hasta 2 decimales | 422 |
| Términos []. PaymentScheduleTerm.Schedule[]. ChargeDate | Obligatorio
La fecha debe tener el formato "» YYYY-MM-DD | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdatePaymentScheduleTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| DUPLICATE\_CHARGE\_DATES | Proporcione fechas de cobro únicas en. PaymentScheduleTerm |
| CÓDIGO\_DE DIVISA INCOMPATIBLE | CurrencyCode no se puede cambiar después de que se publique la oferta. |
| PERCENTAJE\_MARKUP\_INCOMPATIBLE | PaymentScheduleTerm no se admite cuando MarkupPercentage es mayor que cero (0). |
| CONFIGURACIÓN\_DE\_PAGO INCOMPATIBLES | Actualiza tu configuración de pago para que sea compatible con. CurrencyCode |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Proporcione términos que sean compatibles con. ResaleAuthorization Términos incompatibles: [PaymentScheduleTerm]. |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que la entrada total sea compatible con. ChargeAmounts PaymentScheduleTerm ResaleAuthorization |
| VERIFICACIÓN\_DE\_VENDEDOR INCOMPATIBLE | Completa todos los procesos de verificación del vendedor requeridos. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar una vez caducada la oferta. |
| FECHAS\_DE\_CARGO INVÁLIDAS | Indica las fechas de cobro anteriores. AgreementEndDate |
| CÓDIGO\_DE\_DIVISA NO VÁLIDO | Proporcione un soporte. CurrencyCode |
| CÓDIGO\_DE\_DIVISA NO VÁLIDO | Proporcione lo mismo en CurrencyCode todos los precios y condiciones de pago. |
| DEMASIADOS CARGOS ATRASADOS | Realiza hasta 1 pago programado antes. AvailabilityEndDate |
| FECHAS\_DE\_CARGO INVÁLIDAS | Indica una última fecha de cobro anterior. AgreementEndDate |
| FECHAS\_DE\_CARGO INVÁLIDAS | Indica una fecha de primer cargo que no esté en el pasado. |
| DEMASIADOS CARGOS | Proporciona hasta [x] pagos programados en. PaymentScheduleTerm |
## Actualizar las condiciones de pago neto
Puedes usar la API de catálogo para establecer las condiciones de pago netas de tu oferta AWS Marketplace. Un plazo de pago neto es un plazo en el que especificas el número de días transcurridos desde la emisión de la factura en los que vence el pago.
**nota**
Las condiciones de pago neto solo se admiten en las ofertas privadas y solo se aplican a los compradores que tengan un método de pago mediante factura con. AWS Si no estableces condiciones de pago netas, se aplicarán las condiciones de pago de tu comprador con. AWS
Para establecer el plazo de pago neto de tu oferta, llama a la operación de la `StartChangeSet` API con el tipo de `UpdateNetPaymentTerms` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateNetPaymentTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "NetPaymentTerm",
"PaymentDuePeriod": "P30D"
}
]
}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `UpdateNetPaymentTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **Condiciones ** (conjunto de estructuras) (obligatorio): lista de condiciones de pago netas que deseas actualizar. Una oferta puede contener como máximo un plazo de pago neto. Los términos admitidos son:
+ **NetPaymentTerm**(objeto): define las condiciones de pago netas que se negocian con el comprador.
+ **Tipo ** (cadena): tipo del término que se está actualizando. Este es el valor del objeto:`"NetPaymentTerm"`.
+ **PaymentDuePeriod**(cadena): el número de días transcurridos desde la fecha de emisión de la factura en los que vence el pago. Este campo admite el formato ISO 8601. Los valores admitidos son `P15D`, `P30D`, `P45D`, `P60D` y `P90D` y `P120D`.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateNetPaymentTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | HTTP |
| --- | --- | --- |
| Términos | Obligatorio
Solo `NetPaymentTerm` está permitido
El tamaño de la lista debe ser inferior a 2 | 422 |
| Términos []. Tipo | Obligatorio
Solo puede ser `NetPaymentTerm` | 422 |
| Términos []. NetPaymentTerm.PaymentDuePeriod | Obligatorio
Formato esperado: duración ISO 8601
Valores permitidos: ["P15D», «P30D», «P45D», «P60D», «P90D», «P120D"] | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateNetPaymentTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| INVALID\_PAYMENT\_DEVENCE\_PERIOD | Proporcione un soporte. PaymentDuePeriod |
| PRODUCTO\_INCOMPATIBLE | Los siguientes términos no son compatibles con el producto: [x, y, z]. |
| TERMINOS\_INCOMPATIBLES | NetPaymentTerm no es compatible con las ofertas públicas. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | NetPaymentTerm no es compatible porque no contiene un. ResaleAuthorization NetPaymentTerm |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | NetPaymentTerm no se puede eliminar porque contiene un. ResaleAuthorization NetPaymentTerm |
| AUTORIZACIÓN\_DE REVENTA INCOMPATIBLE | Asegúrese de que es compatible con. PaymentDuePeriod NetPaymentTerm ResaleAuthorization |
| TIPOS DE TÉRMINOS DUPLICADOS | Proporcione una lista única de tipos de términos. |
## Modificar las opciones de renovación
Puedes usar la API de catálogo para controlar las opciones de renovación de los acuerdos que se crean con esta oferta en AWS Marketplace.
En el caso de las ofertas creadas mediante la API de catálogo, la renovación automática permanece desactivada de forma predeterminada hasta que actives el tipo de `UpdateRenewalTerms` cambio que permite la renovación automática. Este cambio no afecta a los acuerdos existentes.
Para controlar las opciones de renovación de los acuerdos que se crean con esta oferta, llame a la operación de la `StartChangeSet` API con el tipo de `UpdateRenewalTerms` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdateRenewalTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {
"Terms": [
{
"Type": "RenewalTerm"
}
]
}
}
]
}
```
Proporcione información sobre los campos para agregar el tipo de `UpdateRenewalTerms` cambio:
+ **Entidad ** (objeto) (obligatorio): su oferta.
+ **Tipo ** (cadena) (obligatorio): `Type` es siempre`Offer@1.0`.
+ **Identificador ** (cadena) (obligatorio): el identificador de tu oferta. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto) (obligatorio): el valor JSON de los detalles de la solicitud.
+ **Términos ** (conjunto de estructuras): lista de los términos de renovación que deseas actualizar. Los términos de renovación admitidos son:
+ **RenewalTerm**(objeto): define que, en caso de rescisión gradual (caducidad del contrato`ValidityTerm`, no del comprador o AWS Marketplace cancelación), se creará un nuevo acuerdo utilizando las condiciones aceptadas en el acuerdo existente. En otras palabras, el acuerdo se renovará. La presencia de `RenewalTerm` en la oferta significa que se permite la renovación automática. Los compradores tendrán la opción de aceptar o rechazar la renovación automática al crear la oferta acceptance/agreement .
+ **Tipo ** (cadena): tipo del término que se está actualizando. `RenewalTerm`
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `UpdateRenewalTerms` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación | Código de HTTP |
| --- | --- | --- |
| Términos | Obligatorio | 422 |
| Términos []. Tipo | ObligatorioSolo puede ser "» RenewalTerm | 422 |
**Errores asincrónicos **
Los siguientes errores son específicos de `UpdateRenewalTerms` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre el uso `DescribeChangeSet` para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| PRODUCTO\_INCOMPATIBLE | RenewalTerm no está disponible en las ofertas privadas del producto. |
| TERMINOS\_INCOMPATIBLES | RenewalTerm no se admite junto con. PaymentScheduleTerm |
| TERMINOS\_INCOMPATIBLES | RenewalTerm no es compatible con. PricingModel |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| TERMINOS\_INCOMPATIBLES | El cambio solicitado no se puede realizar una vez caducada la oferta. |
## Publica una oferta
Puedes usar la API de catálogo para combinar la información recopilada de todos los tipos de cambios de actualización y, a continuación, publicar la oferta.
Las ofertas permanecen en un `Draft` estado hasta que `ReleaseOffer` se cancelen. Una vez publicada la oferta, se podrá descubrir en AWS Marketplace.
Para publicar tu oferta, llama a la operación de la `StartChangeSet` API con el tipo de `ReleaseOffer` cambio, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "ReleaseOffer",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "offer-123456789"
},
"DetailsDocument": {}
}
]
}
```
Proporciona información sobre los campos para añadir el tipo de `ReleaseOffer` cambio:
+ **Entidad ** (objeto): el tipo de entidad con nombre que se está creando. `Identifier`Es el identificador de tu oferta y siempre `Type` está ahí`Offer@1.0`. Para obtener más información, consulte [Identificador](catalog-apis.md#identifier).
+ **DetailsDocument**(objeto): el valor JSON de los detalles de la solicitud. Debe estar vacío para`ReleaseOffer`.
**Sintaxis de respuesta **
Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud le proporciona la dirección `ChangeSetId` y `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto.
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
La solicitud de cambio se agrega a una cola y se procesa. Esto incluye la validación de la información para garantizar que cumple con las AWS Marketplace directrices. El proceso de validación puede tardar unos minutos.
Puedes comprobar el estado de la solicitud a través de la AWS Marketplace Management Portal API de catálogo o directamente a través de la operación de la `[DescribeChangeSet](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_DescribeChangeSet.html)` API.
**Validaciones sincrónicas **
Las siguientes validaciones de esquema son específicas de las acciones del. `ReleaseOffer` AWS Marketplace Catalog API Estas validaciones se realizan al llamar. `StartChangeSet` Si la solicitud no cumple los siguientes requisitos, generará un error y recibirá una respuesta HTTP.
| Campo de entrada | Regla de validación |
| --- | --- |
| DetailsDocument | Debe estar vacía ({}) |
**Errores asincrónicos **
Los siguientes errores son específicos de `ReleaseOffer` las acciones del. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` utilizarlos para obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets).
| Código de error | Mensaje de error |
| --- | --- |
| INCOMPATIBLE\_PAYMENT\_SETTINGS | Actualiza tu configuración de pago para que sea compatible con. CurrencyCode |
| PRODUCTO\_INCOMPATIBLE | En primer lugar, cree una oferta pública para el producto. |
| VERIFICACIÓN\_DE\_VENDEDOR INCOMPATIBLE | Completa todos los procesos de verificación del vendedor requeridos. |
| SEGMENTACIÓN INCOMPATIBLE | PreExistingAgreement solo está disponible para ofertas dirigidas al comprador. |
| SEGMENTACIÓN INCOMPATIBLE | OfferSetId solo está disponible para ofertas dirigidas al comprador. |
| INFORMACIÓN\_IMPUESTA\_INVÁLIDA | Tu información tributaria está incompleta. Para vender servicios profesionales AWS Marketplace, debe completar el cuestionario fiscal del DAC7. Dirígete a la sección Información de pago y selecciona el formulario fiscal del DAC7. La actualización de su información tributaria puede tardar hasta dos horas. |
| SOLICITUD\_ACTUALIZACIÓN\_INVÁLIDA | El cambio solicitado no se puede realizar después de que se publique la oferta. |
| FALTA LA FECHA\_FINALIZACIÓN\_DEL ACUERDO | Proporcione un formulario para ofertas de reemplazo. AgreementEndDate |
| FALTA LA FECHA\_DE FINALIZACIÓN\_DISPONIBILIDAD\_ | Proporcione una oferta privada. AvailabilityEndDate |
| CUENTAS DE COMPRADOR FALTANTES | Proporcione para las ofertas creadas PositiveTargeting con. BuyersAccounts ResaleAuthorization |
| CUENTAS DE COMPRADOR FALTANTES | Todas las ofertas del producto deben ser privadas. PositiveTargeting Proporcionar BuyersAccounts. |
| DESCRIPCIÓN FALTANTE | Establece la descripción antes de lanzar la oferta. |
| TERMINOS\_OBLIGATORIOS\_FALTANTES | Añade [x] a la oferta. |
| TERMINOS\_OBLIGATORIOS\_FALTANTES | Proporcione un cuando la oferta contenga un FixedUpfrontPricingTerm . PaymentScheduleTerm |
| NOMBRE\_FALTANTE | Establece el nombre antes de lanzar la oferta. |
| MUCHAS\_OFERTAS | Solo se puede crear una oferta pública de prueba gratuita por producto. |
| MUCHAS\_OFERTAS | Solo se puede crear una oferta pública por producto. |
| TERMINOS\_OBLIGATORIOS\_FALTANTES | Proporcione un formulario RenewalTerm para ofertas públicas con precios contractuales para el producto. |
| FALTA LA FECHA\_FINALIZACIÓN\_DEL ACUERDO | Proporcione un formulario para ofertas de reemplazo. AgreementEndDate |
## Describe los detalles de la oferta existente
Puedes usar la API de catálogo para describir los detalles de la oferta existente en AWS Marketplace.
Para describir los detalles de la oferta existente, llama a la operación de la `DescribeEntity` API con el tipo de `Offer@1.0` entidad, como se muestra en el siguiente ejemplo.
**Sintaxis de la solicitud**
```
GET /DescribeEntity?catalog=&entityId= HTTP/1.1
```
Proporciona información sobre los campos para agregar el tipo de `DescribeEntity` cambio:
+ **catálogo ** (cadena): el catálogo relacionado con la solicitud. Valor fijo:`AWSMarketplace`.
+ **entityID ** (cadena): el ID único de la oferta que se va a describir.
**Sintaxis de respuesta **
La respuesta a esta solicitud proporciona los detalles de la oferta y tiene el siguiente aspecto.
```
{
"EntityType": "Offer@1.0",
"EntityIdentifier": "offer-ad8EXAMPLE51@1",
"EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/Offer/offer-ad8EXAMPLE51",
"LastModifiedDate": "2021-03-10T21:57:16Z",
"DetailsDocument": {
"Id": "offer-3rEXAMPLErn",
"State": "Released",
"Name": "Test Offer",
"Description": "Worldwide offer for Test Product",
"PreExistingAgreement": {
"AcquisitionChannel": "External",
"PricingModel": "Contract"
},
"ProductId": "prod-ad8EXAMPLE51",
"OfferSetId": "offerset-b3f9EXAMPLE27",
"Terms": [
{
"Type": "SupportTerm",
"RefundPolicy": "If you need to request a refund for software sold by Amazon Web Services, LLC, please contact AWS Customer Service."
},
{
"Type": "LegalTerm",
"Documents": [
{
"Type": "CustomEula",
"Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "m3.xlarge",
"MaxQuantity": 10
},
{
"DimensionKey": "m4.xlarge",
"MaxQuantity": 10
}
]
},
{
"Type": "ConfigurableUpfrontPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"Selector": {
"Type": "Duration",
"Value": "P365D"
},
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "300.00"
},
{
"DimensionKey": "m4.xlarge",
"Price": "400.00"
}
],
"Constraints": {
"MultipleDimensionSelection": "Allowed",
"QuantityConfiguration": "Allowed"
}
}
]
},
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "m3.large",
"Price": "0.10"
},
{
"DimensionKey": "m4.xlarge",
"Price": "0.20"
}
]
}
]
},
{
"Type": "FixedUpfrontPricingTerm",
"CurrencyCode": "USD",
"Price": "200.00",
"Grants": [
{
"DimensionKey": "Users",
"MaxQuantity": 10
}
]
},
{
"Type": "RecurringPaymentTerm",
"CurrencyCode": "USD",
"BillingPeriod": "Monthly",
"Price": "100.0"
},
{
"Type": "PaymentScheduleTerm",
"CurrencyCode": "USD",
"Schedule": [
{
"ChargeDate": "2020-12-01T00:00:00.000Z",
"ChargeAmount": "1000.00"
},
{
"ChargeDate": "2021-06-15T00:00:00.000Z",
"ChargeAmount": "1250.00"
}
]
},
{
"Type": "ByolPricingTerm"
},
{
"Type": "RenewalTerm"
},
{
"Type": "NetPaymentTerm",
"PaymentDuePeriod": "P30D"
}
],
"Rules": [
{
"Type": "TargetingRule",
"PositiveTargeting": {
"CountryCodes": [
"US",
"CA"
],
"BuyerAccounts": [
"444455556666"
]
},
"NegativeTargeting": {
"CountryCodes": [
"XX"
]
}
},
{
"Type": "AvailabilityRule",
"AvailabilityEndDate": "2024-08-30T01:56:03.000Z"
}
]
}
}
```
La siguiente es información sobre los campos que ves en la `DescribeEntity` respuesta.
+ **EntityType**(cadena): el tipo denominado de la entidad, que es`Offer@1.0`.
+ **EntityIdentifier**(cadena): el identificador de la entidad, en el formato de`EntityId@RevisionId`.
+ **EntityArn**(cadena): el ARN asociado al identificador único del conjunto de cambios al que se hace referencia en esta solicitud.
+ **LastModifiedDate**(cadena): la fecha de la última modificación de la entidad, en formato ISO 8601 (por ejemplo:`2018-02-27T13:45:22Z`).
+ **Detalles ** (cadena): este objeto JSON en cadena incluye los siguientes detalles de la entidad:
+ **Id ** (cadena): identificador único de una entidad de oferta que se encuentra en una oferta AWS Marketplace y se genera durante la creación de una oferta.
+ **Estado ** (cadena): el estado de la oferta.
+ **Nombre ** (cadena): el nombre asociado a la oferta para que usted y sus clientes puedan leerla mejor. También se mostrará como parte de la información del acuerdo.
+ **Descripción ** (cadena): la descripción es un texto de formato libre destinado a ser utilizado únicamente por ti y nunca estará expuesto a los compradores.
+ **PreExistingAgreement**(cadena): determina si esta oferta es una renovación de un acuerdo existente con un cliente existente para el mismo producto subyacente. El acuerdo existente puede ser interno o externo AWS Marketplace. AWS puede auditar y verificar que su oferta es una renovación. Si AWS no puede verificar su oferta, AWS puede revocar la oferta y los derechos de su cliente.
+ **AcquisitionChannel**(cadena): indica si el acuerdo existente se firmó de forma externa AWS Marketplace o interna. AWS Marketplace Valores posibles:`External`,`AwsMarketplace`.
+ **PricingModel**(cadena): indica qué modelo de precios utiliza el acuerdo existente. Valores posibles:`Contract`,`Usage`,`Byol`,`Free`.
+ **ProductId**(cadena): el identificador único del producto que se ofrece.
+ **OfferSetId**(cadena): el identificador único de la oferta establecida para asociar esta oferta.
+ **Términos ** (matriz de estructuras): lista de términos.
+ **Reglas ** (conjunto de estructuras): lista de reglas.