As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Notificações do Amazon SNS para produtos de SaaS
**Importante**
As notificações do SNS para produtos AWS Marketplace SaaS estão sendo substituídas pelas notificações da Amazon EventBridge . Se você já tiver produtos SaaS integrados ao SNS, eles continuarão funcionando. Eventualmente, os novos anúncios passarão a usar a Amazon EventBridge em vez do SNS. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
Para receber notificações, você assina os tópicos do Amazon Simple Notification Service (Amazon SNS) fornecidos AWS Marketplace durante a criação do produto. Os tópicos fornecem notificações sobre alterações nas assinaturas e nos direitos contratuais dos clientes para seus produtos. Isso permite que você saiba quando fornecer e revogar o acesso de clientes específicos.
**nota**
Durante o processo de criação do produto, você receberá o nome do recurso da Amazon (ARN) para o tópico do SNS. Por exemplo: `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`
Os seguintes tópicos do Amazon SNS estão disponíveis para produtos de software como serviço (SaaS):
+ [Tópico do Amazon SNS: `aws-mp-entitlement-notification`](#saas-sns-message-body): este tópico notifica você quando os compradores criam um novo contrato, o atualizam, o renovam ou ele expira. Isso só está disponível para produtos com modelos de preços que incluem um contrato (também conhecido como **Contratos de SaaS** e **Contratos de SaaS com consumo (excedentes))**.
+ [Tópico do Amazon SNS: `aws-mp-subscription-notification`](#saas-sns-subscription-message-body): este tópico notifica você quando um comprador assina ou cancela a assinatura de um produto e inclui o `offer-identifier` para ofertas privadas e um sinalizador de avaliações gratuitas de SaaS. Isso está disponível para todos os modelos de preços, incluindo contratos e assinaturas (também conhecidos como **Assinaturas de SaaS**, **Contratos de SaaS** e **Contratos de SaaS com consumo (excedentes)**.
Para saber mais sobre os cenários nos quais você responde a essas notificações, consulte os seguintes tópicos:
+ [Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace](saas-integrate-subscription.md)
+ [Integrando seu produto de contrato SaaS com AWS Marketplace](saas-integrate-contract.md)
+ [Integrando seu produto baseado em contratos SaaS com AWS Marketplace](saas-integrate-contract-with-pay.md)
## Tópico do Amazon SNS: `aws-mp-entitlement-notification`
Cada mensagem no tópico `aws-mp-entitlement-notification` tem o formato a seguir.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}
```
Sempre ** serão` entitlement-updated`.
**nota**
Para mensagens de autorização, independentemente da ação (nova, atualização, renovação ou expirada), a mensagem é a mesma. É necessária uma chamada subsequente para `GetEntitlement` para descobrir o conteúdo da atualização.
Para **Contratos de SaaS com consumo (excedentes)**, os vendedores recebem o [tópico do SNS `aws-mp-subscription-notification`](#saas-sns-subscription-message-body). Essa é uma notificação extra que o vendedor recebe quando adiciona preços excedentes. Quando um vendedor adquire novos clientes, em vez de apenas obter `entitlement-updated` (o que pode se referir a qualquer tipo de ação), o vendedor recebe uma mensagem de assinatura indicando que se trata de um novo cliente.
Para contratos com data futura (FDAs), este tópico é iniciado na data de início do contrato (e não na data de assinatura do contrato). Também é iniciado quando ocorrem alterações subsequentes no direito, como cancelamento, substituição, renovação ou expiração do contrato.
Os produtos com preços contratuais (incluindo contratos com pay-as-you-go) devem responder a essas mensagens. Para obter mais informações sobre como responder, consulte [Cenário: monitorar as alterações nas assinaturas dos usuários](saas-integrate-contract.md#saas-contract-monitor-changes).
## Tópico do Amazon SNS: `aws-mp-subscription-notification`
Cada mensagem no tópico `aws-mp-subscription-notification` tem o formato a seguir.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123",
"isFreeTrialTermPresent":"true"
}
```
O `offer-identifier` só é incluído na notificação quando a ação é `subscribe-success` ou `subscribe-fail`. Ele não é incluído em notificações quando a ação é `unsubscribe-pending` ou `unsubscribe-success`. Para ofertas criadas antes de janeiro de 2024, esse identificador só é incluído na notificação para ofertas privadas. Para ofertas criadas em janeiro de 2024 e posteriores, esse identificador é incluído em notificações de todas as ofertas, inclusive ofertas privadas e ofertas públicas.
Para obter informações sobre os tipos de oferta, consulte a resposta da [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) ou a visibilidade da oferta de um contrato no [painel de renovações de contratos](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).
**nota**
Para a [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity), se você encontrar uma faceta de segmentação Conta da AWS na conta da regra de segmentação para essa oferta, é uma oferta privada. Se não houver uma faceta de segmentação Conta da AWS na conta da regra de segmentação para essa oferta, é uma oferta pública.
A propriedade `isFreeTrialTermPresent` indica se a assinatura do comprador é uma avaliação gratuita. O valor JSON dessa propriedade não é um tipo de dados *booleano*. Em vez disso, o valor é convertido em um tipo de dados de *string*. Para obter mais informações, consulte [Avaliações gratuitas de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html).
**Isso variará de acordo com a notificação. As ações possíveis são:
+ `subscribe-success`: a mensagem `subscribe-success` indica quando o vendedor pode começar a enviar registros de medição. Se uma [oferta baseada em contrato](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process) for aceita pelo comprador, essa mensagem será enviada novamente com o novo `offer-identifier`.
+ `subscribe-fail`— Se a `subscribe-fail` mensagem for gerada, o pagamento pode ter falhado, mesmo que o comprador já tenha feito a transição da página inicial SaaS AWS Marketplace para a página de destino SaaS do vendedor. O vendedor deve aguardar a mensagem `subscribe-success` antes de permitir o consumo do produto.
+ `unsubscribe-pending`: quando um comprador cancela a assinatura, uma mensagem `unsubscribe-pending` é enviada primeiro. Isso indica que o vendedor tem um tempo limitado (cerca de uma hora) para enviar os registros finais de medição antes que o comprador seja totalmente cancelado.
+ `unsubscribe-success`: a mensagem `unsubscribe-success` sinaliza a conclusão do cancelamento, após o qual nenhum outro registro de medição será aceito.
**nota**
Se um comprador cancelar a assinatura e se inscrever novamente imediatamente antes do envio da mensagem `unsubscribe-success` final, a mensagem `unsubscribe-success` final não será enviada e, em vez disso, uma mensagem `subscribe-success` será enviada.
Para contratos com data futura (FDAs), a `subscribe-success` ação é iniciada na data de início do contrato (e não na data de assinatura do contrato).
Os produtos com preços de assinatura (incluindo contratos com pay-as-you-go) devem responder a essas mensagens. Para obter mais informações sobre como responder, consulte os tópicos a seguir:
+ [Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace](saas-integrate-subscription.md)
+ [Integrando seu produto baseado em contratos SaaS com AWS Marketplace](saas-integrate-contract-with-pay.md)
## Assinar uma fila do SQS no tópico do SNS
Recomendamos assinar uma fila do Amazon SQS nos tópicos do SNS fornecidos. Para obter instruções detalhadas sobre como criar uma fila do SQS e assinar a fila em um tópico, consulte [Assinatura de uma fila do Amazon SQS em um tópico do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
**nota**
Você só pode se inscrever AWS Marketplace nos tópicos do SNS do site Conta da AWS usado para vender os produtos. No entanto, você pode encaminhar as mensagens para uma conta diferente. Para obter mais informações, consulte [Envio de mensagens do Amazon SNS para uma fila do Amazon SQS em uma conta diferente](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
### Pesquisar notificações na fila do SQS
Depois de assinar a fila do SQS em um tópico do SNS, as mensagens são armazenadas no SQS. Defina um serviço que continuamente sonde a fila, procure mensagens e manipule-as da forma adequada.