View a markdown version of this page

EventBridge Eventos da Amazon - AWS Marketplace
Eventos para novas ofertasEventos para conjuntos de alteraçõesEventos para relatório resumido de segurançaEventos para pagamentosEventos para acordosEventos para licençasEventos para cancelamentosEventos para ajustes de faturamento

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á.

EventBridge Eventos da Amazon

Como vendedor, você pode usar EventBridge a Amazon para receber notificações de eventos em AWS Marketplace. Por exemplo, você pode receber um evento AWS Marketplace a partir da criação de uma oferta. O evento contém detalhes como ID, data de validade e detalhes do produto. EventBridge é um serviço de barramento de eventos que você pode usar para conectar seus aplicativos a dados de várias fontes. Para obter mais informações, consulte o Guia EventBridge do usuário da Amazon. As seções a seguir fornecem informações detalhadas sobre eventos no serviço Marketplace Catalog no EventBridge console.

Este tópico

Ação do vendedor Evento recebido Tópico relacionado
O provedor de software independente (ISV) cria uma oferta e a disponibiliza para compra Offer Released Eventos para novas ofertas
O produto do ISV é usado por um parceiro de canal para criar uma oferta Offer Released Eventos para novas ofertas
O parceiro de canal cria uma oferta Offer Released Eventos para novas ofertas
O ISV cria um novo conjunto de ofertas OfferSet Released Eventos para novas ofertas
O parceiro de canal cria um novo conjunto de ofertas OfferSet Released Eventos para novas ofertas
O conjunto de alterações foi bem-sucedido Change Set Succeeded Eventos para conjuntos de alterações
O conjunto de alterações falha Change Set Failed Eventos para conjuntos de alterações
O conjunto de alterações foi cancelado Change Set Cancelled Eventos para conjuntos de alterações
Vulnerabilidades de segurança foram detectadas no produto do ISV Products Security Report Created Eventos para relatório resumido de segurança
O cliente assina o produto SaaS Purchase Agreement Created Eventos para acordos
O contrato SaaS do cliente foi alterado Purchase Agreement Amended Eventos para acordos
O cliente cancela a assinatura de SaaS Purchase Agreement Ended Eventos para acordos
Os direitos de SaaS do cliente mudam License Updated Eventos para licenças
Os direitos de SaaS do cliente são revogados License Deprovisioned Eventos para licenças
O vendedor envia uma solicitação de cancelamento Agreement Cancellation Request Pending Approval - Proposer Eventos para cancelamentos
A solicitação de cancelamento foi aprovada ou aprovada automaticamente Agreement Cancellation Request Approved - Proposer Eventos para cancelamentos
A solicitação de cancelamento foi negada pelo comprador Agreement Cancellation Request Rejected - Proposer Eventos para cancelamentos
O vendedor retira uma solicitação de cancelamento Agreement Cancellation Request Cancelled - Proposer Eventos para cancelamentos
Falha na validação da solicitação de cancelamento Agreement Cancellation Request Validation Failed - Proposer Eventos para cancelamentos
O ajuste de cobrança é processado Purchase Agreement Billing Adjustment Completed - Proposer Eventos para ajustes de faturamento
Falha na validação do ajuste de cobrança Purchase Agreement Billing Adjustment Failed - Proposer Eventos para ajustes de faturamento

Eventos para novas ofertas

Quando os vendedores criam uma oferta e a disponibilizam para compra, eles podem receber um evento com o seguinte tipo de detalhe: Offer Released.

nota

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

Veja a seguir um exemplo de corpo de evento para uma nova oferta criada por um ISV.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:123456789012:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "123456789012",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": [
      "999988887777",
      "111122223333"
    ]
  }
}

Veja a seguir um exemplo de corpo de evento para quando o produto de um ISV é usado por um parceiro de canal para criar uma oferta.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "987654321098",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": ["999988887777", "111122223333"],
    }
  }
}

Veja a seguir um exemplo de corpo de evento para quando um parceiro de canal cria uma oferta.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "987654321098",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "987654321098",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": ["999988887777", "111122223333"],
    }
  }
}

Veja a seguir um exemplo de corpo de evento para um novo conjunto de ofertas publicado por um parceiro (ISV ou parceiro de canal).


{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "OfferSet Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/OfferSet/offerset-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offerSet": {
      "id": "offerset-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:OfferSet/offerset-1234567890123",
      "name": "Offer Set Name",
    },
    "associatedOffers": [
      {
        "offer": {
          "id": "offer-1234567890123",
          "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
          "name": "Offer Name",
        }
      },
      ...
    ]
  }
}

Eventos para conjuntos de alterações

Quando um conjunto de alterações é concluído, vendedores, parceiros de canal e administradores de mercados privados podem receber um evento. A API de AWS Marketplace catálogo envia um evento quando um conjunto de alterações é concluído com o status de bem-sucedido, falhado ou cancelado. A fonte desses eventos é aws.marketplacecatalog, e os valores possíveis do tipo de detalhe são Change Set Succeeded, Change Set Failed e Change Set Cancelled.

nota

Para obter informações sobre conjuntos de alterações, consulte Como trabalhar com conjuntos de alterações na Referência da API de catálogo do AWS Marketplace .

Cada evento contém detalhes da solicitação de alteração, como ID do conjunto de alterações, nome do conjunto de alterações, tipo de detalhe do evento, código de falha (para solicitações com falha) e horários de início e término da solicitação. Isso permite que você monitore seus conjuntos de alterações sem consultar continuamente a DescribeChangeSet ação ou verificar o Portal de gerenciamento do AWS Marketplace status de suas solicitações de alteração.

nota

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe Change Set Succeeded.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Succeeded",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z"
  }
}

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe Change Set Failed.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Failed",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z",
    "FailureCode": "CLIENT_ERROR"
  }
}

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe Change Set Cancelled.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Cancelled",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z"
  }
}

Eventos para relatório resumido de segurança

Quando vulnerabilidades de segurança são detectadas nos produtos de um vendedor, ele pode receber um relatório resumido do evento e lembretes periódicos sobre problemas pendentes do produto. A fonte desses eventos é aws.marketplacecatalog, e o tipo de detalhe é Products Security Report Created.

Cada evento inclui um resumo da contagem de produtos e versões com problemas detectados, uma contagem de quantas versões mais recentes foram afetadas e a data em que a resolução é necessária para evitar uma restrição temporária desses produtos ou versões.

nota

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

Para obter detalhes sobre o gerenciamento de eventos de segurança, veja a postagem Como melhorar a segurança do seu catálogo de produtos no AWS Marketplace no Blog da AWS .

O seguinte é um exemplo do corpo de um evento para o tipo de detalhe Products Security Report Created.

{
  "version": "0",
   "id": "01234567-0123-0123-0123-0123456789ab",
   "detail-type": "Products Security Report Created",
   "source": "aws.marketplacecatalog",
   "account": "123456789012",
   "time": "2023-10-31T00:00:00Z",
   "region": "us-east-1",
   "resources": [],
   "detail": {
     "numberOfProductsWithIssues": 1,
     "numberOfVersionsWithIssues": 1,
     "numberOfLatestVersionsWithIssues": 1,
     "newIssuesFound": true,
     "upcomingResolutionDueDate": "2023-12-01T00:00:00Z",
     "requestId": "533fa17d-3e97-5051-bcaf-1fae45fb3f8b"
   }
  }

Eventos para pagamentos

Quando um desembolso para a conta bancária do vendedor falha devido a detalhes inválidos da conta bancária, AWS Marketplace ISVs os parceiros de canal podem receber um evento.

No código de evento JSON a seguir, o valor source desses eventos é aws.marketplace, e o valor detail-type é Disbursement Paused. O valor resources mostra o Número de recurso da Amazon (ARN) da conta bancária inválida.

{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab", 
"detail-type": "Disbursement Paused",
"source": "aws.marketplace",
"account":"<account id of end user>",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": ["arn:aws:payments:us-east-1:1234567890:paymentinstrument:123"],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace"
 }
}

Para resolver o problema de detalhes da conta bancária inválida, adicione os detalhes da sua conta bancária no Portal AWS Marketplace de Gerenciamento. Para instruções, consulte Para adicionar detalhes da conta bancária.

Para obter mais informações sobre a criação de EventBridge regras da Amazon, consulte Regras na Amazon EventBridge no Guia EventBridge do usuário da Amazon.

Eventos para acordos

Quando ocorrem eventos de contrato, os vendedores podem receber notificações sobre alterações no ciclo de vida do contrato de compra.

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

A seguir está um exemplo de corpo de evento para Contrato de Compra Criado - Proponente.

nota

O ID de autorização de revenda no caso da oferta privada do parceiro de canal (CPPO) será preenchido e, no caso da oferta direta do Marketplace (MPPO), esse valor seria nulo.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Created - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's or CP's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "NEW",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}

A seguir está um exemplo de corpo de evento para Contrato de compra criado - Fabricante.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Created - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "NEW",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}

A seguir está um exemplo de corpo de evento para o Contrato de Compra Alterado - Proponente.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Amended - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV or CP's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "AMEND",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}

A seguir está um exemplo de corpo de evento para o Contrato de Compra Alterado - Fabricante.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Amended - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "AMEND",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}

A seguir está um exemplo de corpo de evento para Contrato de Compra Encerrado - Proponente.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Ended - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "status": "CANCELLED"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}

A seguir está um exemplo de corpo de evento para Contrato de compra encerrado - Fabricante.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Ended - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "status": "CANCELLED"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}

Eventos para licenças

Quando ocorrem eventos de licença, os vendedores podem receber notificações sobre alterações nos direitos do cliente.

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

A seguir está um exemplo de corpo de evento para License Updated - Manufacturer.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "License Updated - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV/CP account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs"
    },
    "product": {
      "code": "aw4fgf5tyo5w2ap6fEXAMPLE",
      "id": "prod-qtwveEXAMPLE"
    },
    "license": {
      "arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "8kkr91jo647j3qxlcjhlqce7y"
    }
  }
}

A seguir está um exemplo de corpo de evento para License Deprovisioned - Manufacturer.

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "License Deprovisioned - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV/CP account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs"
    },
    "product": {
      "code": "aw4fgf5tyo5w2ap6fEXAMPLE",
      "id": "prod-qtwveEXAMPLE"
    },
    "license": {
      "arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "8kkr91jo647j3qxlcjhlqce7y"
    }
  }
}

Eventos para cancelamentos

Quando o status de uma solicitação de cancelamento muda, vendedores, compradores e ISVs (para CPPO) recebem eventos. Cada evento é enviado à parte relevante com um tipo de detalhe específico da função (Proponente para vendedores, Aceitante para compradores, Fabricante para). ISVs A fonte desses eventos éaws.agreement-marketplace.

Para obter informações sobre a criação de EventBridge regras, consulte EventBridge as regras da Amazon no Guia EventBridge do usuário da Amazon.

A seguir está um exemplo de corpo de evento para Solicitação de cancelamento de contrato com aprovação pendente - Proponente. Esse evento é enviado quando você envia uma solicitação de cancelamento e está aguardando a aprovação do comprador.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Pending Approval - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "",
      "statusCode": "PENDING_APPROVAL",
      "statusMessage": "",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-01T13:12:22Z"
    }
  }
}

A seguir está um exemplo de corpo de evento para Solicitação de cancelamento de contrato aprovada - Proponente. Esse evento é enviado quando o comprador aprova sua solicitação de cancelamento ou quando é aprovado automaticamente após 7 dias.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Approved - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:16:07Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "The terms accepted in agreement had wrong rate",
      "statusCode": "APPROVED",
      "statusMessage": "",
      "createdAt": "2025-01-03T16:16:22Z",
      "updatedAt": "2025-01-03T16:20:08Z"
    }
  }
}

A seguir está um exemplo de corpo de evento para Solicitação de cancelamento de contrato rejeitada - Proponente. Esse evento é enviado quando o comprador nega sua solicitação de cancelamento.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Rejected - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-02T10:30:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "",
      "statusCode": "REJECTED",
      "statusMessage": "We still need this product",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-02T10:30:00Z"
    }
  }
}

A seguir está um exemplo de corpo de evento para Solicitação de cancelamento de contrato cancelada - Proponente. Esse evento é enviado quando você retira uma solicitação de cancelamento.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Cancelled - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-02T08:00:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "",
      "statusCode": "CANCELLED",
      "statusMessage": "Seller withdrew the request",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-02T08:00:00Z"
    }
  }
}

A seguir está um exemplo de corpo de evento para Falha na validação da solicitação de cancelamento do contrato - Proponente. Esse evento é enviado somente ao vendedor quando uma validação assíncrona falha após o envio.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Validation Failed - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:15:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "The terms accepted in agreement had wrong rate",
      "statusCode": "VALIDATION_FAILED",
      "statusMessage": "Agreement has a renewal agreement that must be canceled first",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-01T13:15:00Z"
    }
  }
}

Eventos para ajustes de faturamento

Quando o status de um ajuste de faturamento muda, vendedores, compradores e ISVs (para CPPO) recebem eventos. Cada evento é enviado à parte relevante com um tipo de detalhe específico da função (Proponente para vendedores, Aceitante para compradores, Fabricante para). ISVs A fonte desses eventos éaws.agreement-marketplace.

A seguir está um exemplo de corpo de evento para Contrato de Compra e Faturamento: Ajuste Concluído - Proponente.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Purchase Agreement Billing Adjustment Completed - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid"
    },
    "billingAdjustmentRequest": {
      "id": "ba-abcdexampleid",
      "adjustmentAmount": "-100.00",
      "currencyCode": "USD",
      "adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
    },
    "invoice": {
      "originalInvoiceId": "2028746221"
    }
  }
}

A seguir está um exemplo de corpo de evento para Purchase Agreement Billing Adjustment Failed - Proposer. Esse evento é enviado somente ao vendedor quando um ajuste de cobrança falha na validação assíncrona.

{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Purchase Agreement Billing Adjustment Failed - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:15:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid"
    },
    "billingAdjustmentRequest": {
      "id": "ba-abcdexampleid",
      "adjustmentAmount": "-1000.00",
      "currencyCode": "USD",
      "adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
    },
    "invoice": {
      "originalInvoiceId": "2028746221"
    }
  }
}