Compartilhar via

Criar um carrinho com um pedido do cliente

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para Microsoft Cloud for US Government

Você pode adicionar um pedido para um cliente em um carrinho. Para obter mais informações sobre o que está disponível para venda no momento, consulte as ofertas do Parceiro no programa Provedor de Soluções na Nuvem.

Observação

Os carrinhos expiram sete dias a partir da criação inicial.

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

  • Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá pesquisá-la no Partner Center selecionando o workspace Clientes e, em seguida, o cliente na lista de clientes e, em seguida, a Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente . A ID da Microsoft é a mesma que a ID do cliente (customer-tenant-id).

C#

Para criar um pedido para um cliente:

  1. Instancie um objeto Cart.

  2. Crie uma lista de objetos CartLineItem e atribua a lista à propriedade LineItems do carrinho. Cada item de linha do carrinho contém as informações de compra de um produto. Você deve ter pelo menos um item de linha de carrinho.

  3. Obtenha uma interface para operações de carrinho chamando o método IAggregatePartner.Customers.ById com a ID do cliente para identificar o cliente e, em seguida, recuperando a interface da propriedade Cart .

  4. Chame o método Create ou CreateAsync para criar o carrinho.

  5. Para concluir o atestado e incluir outros revendedores, confira os seguintes exemplos de Exemplo de Solicitação e Resposta:

Exemplo de solicitação


{
    "PartnerOnRecordAttestationAccepted":true,     "lineItems": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
            "quantity": 1,
            "billingCycle": "monthly",
            "termDuration": "P1M",
            "renewsTo": null,
            "provisioningContext": {},
            "customTermEndDate": "2022-02-19T00:00:00Z"
        },
        {
            "id": 1,
            "catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
            "quantity": 2,
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "participants": [
                {
                    "key": "transaction_reseller",
                    "value": "5357564"
                },
                 {
                    "key": "additional_transaction_reseller",                     
                    "value": "517285"
                },
                 {
                    "key": "additional_transaction_reseller", 
                    "value": "5357563"
                }
            ]
        }
    ]
}

Exemplo de resposta


{
    "id": "3e22b548-647d-4223-9675-1fcb6cb57665",
    "creationTimestamp": "2021-08-18T17:29:52.3517492Z",
    "lastModifiedTimestamp": "2021-08-18T17:29:52.3517553Z",
    "expirationTimestamp": "2021-08-25T17:30:11.2406416Z",
    "lastModifiedUser": "da62a0dc-35e9-4601-b48e-a047bd3ec7c1",
    "status": "Active",
    "lineItems": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
            "quantity": 1,
            "currencyCode": "USD",
            "billingCycle": "monthly",
            "termDuration": "P1M",
	    "customTermEndDate": "2022-02-19T00:00:00Z";
            "provisioningContext": {},
            "orderGroup": "0"
        },
        {
            "id": 1,
            "catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
            "quantity": 2,
            "currencyCode": "USD",
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "participants": [
                {
                    "key": "transaction_reseller",
                    "value": "5357564"
                },
                {
                    "key": "additional_transaction_reseller", 
                    "value": "517285"
                },
                {
                    "key": "additional_transaction_reseller", 
                    "value": "5357563"
                }
            ],
            "provisioningContext": {},
            "orderGroup": "0"
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/carts/3e22b548-647d-4223-9675-1fcb6cb57665",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Cart"
    }
}

Exemplo de C#

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

var cart = new Cart()
{
    LineItems = new List<CartLineItem>()
    {
        new CartLineItem()
        {
      /* Microsoft Azure Subscription */
            Id = 0,
            CatalogItemId = "MS-AZR-0145P",
            Quantity = 1,
            BillingCycle = BillingCycleType.Monthly,
            TermDuration = "P1Y"
        },
        new CartLineItem()
        {
      /* Azure Reserved Instance */
            Id = 1,
            CatalogItemId = "DZH318Z0BQ36:004G:DZH318Z08C0S",
            Quantity = 1,
            BillingCycle = BillingCycleType.OneTime,
            TermDuration = "P1Y",
            ProvisioningContext = new Dictionary<string, string>
            {
                { "subscriptionId", subscriptionId },
                { "scope", "shared" }
            }
        },
        new CartLineItem()
        {
      /* Azure Reserved Instance */
            Id = 2,
            CatalogItemId = "DZH318Z0BQ36:004J:DZH318Z08B8X",
            Quantity = 1,
            BillingCycle = BillingCycleType.OneTime,
            TermDuration = "P3Y",
            ProvisioningContext = new Dictionary<string, string>
            {
                { "subscriptionId", subscriptionId },
                { "scope", "shared" }
            }
        },
        new CartLineItem()
        {
      /* Perpetual Software */
            Id = 3,
            CatalogItemId = "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
            Quantity = 1,
            BillingCycle = BillingCycleType.OneTime
        },
        new CartLineItem()
        {
      /* SaaS */
            Id = 4,
            CatalogItemId = "DZH318Z0BXWC:0002:DZH318Z0BMRV",
            Quantity = 1,
            BillingCycle = BillingCycleType.Monthly,
            TermDuration = "P1M"
        },
        new CartLineItem()
        {
      /* SaaS Free Trial */
            Id = 5,
            CatalogItemId = "DZH318Z0C0WF:0001:DZH318Z0BP69",
            Quantity = 10,
            BillingCycle = BillingCycleType.None,
            TermDuration = "P1M",
            RenewsTo = new RenewsTo
            {
                TermDuration = "P1Y"
            }
        }
    }
};

cart = partnerOperations.Customers.ById(customerId).Carts.Create(cart);

Java

O SDK java do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de software livre mantido pela comunidade de parceiros e não tem suporte oficial da Microsoft. Você pode obter ajuda da comunidade ou abrir um problema no GitHub se tiver um problema.

Para criar um pedido para um cliente:

  1. Instancie um objeto Cart.

  2. Crie uma lista de objetos CartLineItem e atribua a lista aos itens de linha do carrinho. Cada item de linha do carrinho contém as informações de compra de um produto. Você deve ter pelo menos um item de linha de carrinho.

  3. Obtenha uma interface para operações de carrinho chamando a função IAggregatePartner.getCustomers().byId com a ID do cliente para identificar o cliente e, em seguida, recuperando a interface da função getCart .

  4. Chame a função create para criar o carrinho.

Exemplo de Java

// IAggregatePartner partnerOperations;
// String customerId;
// String subscriptionId;
// String catalogItemId;

CartLineItem lineItem = new CartLineItem();

lineItem.setBillingCycle(BillingCycleType.OneTime);
lineItem.setCatalogItemId(catalogItemId);
lineItem.setFriendlyName("Sample RI Purchase");
lineItem.setQuantity(1);

Map<String, String> provisioningContext = new HashMap<String,String>();

provisioningContext.put("duration", "3Years");
provisioningContext.put("scope", "shared");
provisioningContext.put("subscriptionId", subscriptionId);

lineItem.setProvisioningContext(provisioningContext);

List<CartLineItem> lineItemList = new ArrayList<CartLineItem>();
lineItemList.add(lineItem);

Cart cart = new Cart();
cart.setLineItems(lineItemList);

Cart cartCreated = partnerOperations.getCustomers().byId(customerId).getCarts().create(cart);

PowerShell

O módulo powershell do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de software livre mantido pela comunidade de parceiros e não tem suporte oficial da Microsoft. Você pode obter ajuda da comunidade ou abrir um problema no GitHub se tiver um problema.

Para criar um pedido para um cliente:

  1. Instancie um objeto Cart.

  2. Crie uma lista de objetos CartLineItem e atribua a lista aos itens de linha do carrinho. Cada item de linha do carrinho contém as informações de compra de um produto. Você deve ter pelo menos um item de linha de carrinho.

  3. Execute o comando New-PartnerCustomerCart para criar o carrinho.

# $customerId
# $subscriptionId
# $catalogItemId

$lineItem = New-Object -TypeName Microsoft.Store.PartnerCenter.PowerShell.Models.Carts.PSCartLineItem

$lineItem.BillingCycle = 'OneTime'
$lineItem.CatalogItemId = $catalogItemId
$lineItem.FriendlyName = 'Sample RI Purchase'
$lineItem.ProvisioningContext.Add('duration', '1Year')
$lineItem.ProvisioningContext.Add('scope', 'shared')
$lineItem.ProvisioningContext.Add('subscriptionId', $subsciptionId)
$lineItem.Quantity = 10

New-PartnerCustomerCart -CustomerId $customerId -LineItems $lineItem

Solicitação REST

Sintaxe da solicitação

Método URI de solicitação
POST {baseURL}/v1/customers/{customer-id}/carts HTTP/1.1

Parâmetro URI

Use o parâmetro de caminho a seguir para identificar o cliente.

Nome Tipo Obrigatório Description
customer-id cadeia Yes Uma ID do cliente formatada por GUID que identifica o cliente.

Cabeçalhos da solicitação

Para mais informações, consulte os cabeçalhos REST do Partner Center.

Corpo da solicitação

Esta tabela descreve as propriedades do Carrinho no corpo da solicitação.

Propriedade Tipo Obrigatório Description
id cadeia Não Um identificador de carrinho fornecido após a criação bem-sucedida do carrinho.
creationTimeStamp DateTime Não A data em que o carrinho foi criado, no formato de data e hora. Aplicado após a criação bem-sucedida do carrinho.
lastModifiedTimeStamp DateTime Não A data em que o carrinho foi atualizado pela última vez, no formato de data e hora. Aplicado após a criação bem-sucedida do carrinho.
expirationTimeStamp DateTime Não A data em que o carrinho expira, no formato de data e hora. Aplicado após a criação bem-sucedida do carrinho.
lastModifiedUser cadeia Não O usuário que atualizou o carrinho pela última vez. Aplicado após a criação bem-sucedida do carrinho.
lineItems Matriz de objetos Yes Uma matriz de recursos CartLineItem .
PartnerOnRecordAttestationAccepted booleano Yes Confirma a conclusão do Atestado

Esta tabela descreve as propriedades CartLineItem no corpo da solicitação.

Observação

Ao finalizar um carrinho por meio da API, os itens são processados na ordem em que são colocados no carrinho. A ordem pode afetar a elegibilidade para promoções com restrições de nova oferta se houver dois produtos do mesmo tipo no carrinho, um com a ID da promoção e o outro sem (por exemplo, com termos diferentes). Certifique-se de colocar todos os itens qualificados para uma promoção primeiro no carrinho se você estiver finalizando a compra de vários itens.

Propriedade Tipo Obrigatório Description
id cadeia Não Um identificador exclusivo para um item de linha do carrinho. Aplicado após a criação bem-sucedida do carrinho.
catalogId cadeia Yes O identificador de item do catálogo. Verifique se a disponibilidade do item de catálogo é para o segmento correto.
friendlyName cadeia Não Optional. O nome amigável do item definido pelo parceiro para ajudar a desambiguar.
promotionId cadeia Não Optional. A maioria das novas promoções de comércio se aplica automaticamente, no entanto, para promoções opcionais (como Bridge to the Cloud 2) se aplicarem a um item de linha no carrinho, os parceiros devem incluir a ID de promoção ao adicioná-lo ao carrinho.
quantidade int Yes O número de licenças ou instâncias.
código de moeda cadeia Não O código de moeda.
billingCycle Object Yes O tipo de ciclo de cobrança definido para o período atual.
customTermEndDate DateTime Não A data de término de uma assinatura existente à qual você deseja coterminar a nova assinatura.
Participantes Lista de pares de Cadeia de Caracteres de Objeto Não Uma coleção de PartnerId on Record (PartnerID) na compra.
provisioningContext Cadeia de caracteres de dicionário<, cadeia de caracteres> Não Informações necessárias para provisionamento para alguns itens no catálogo. A propriedade provisioningVariables em um SKU indica quais propriedades são necessárias para itens específicos no catálogo.
orderGroup cadeia Não Um grupo para indicar quais itens podem ser colocados juntos.
erro Object Não Aplicado após a criação do carrinho se houver um erro.
renewsTo Matriz de objetos Não Uma matriz de recursos RenewsTo .
AttestationAccepted booleano Não Indica o contrato para oferecer ou condições de sku. Necessário apenas para ofertas ou skus em que SkuAttestationProperties ou OfferAttestationProperties enforceAttestation é True.
transaction_reseller String Não Quando um provedor indireto faz um pedido em nome de um revendedor indireto, preencha esse campo com a PartnerID do revendedor indireto somente (nunca a ID do provedor indireto). Isso garante a contabilidade adequada para incentivos.
additional_transaction_reseller String Não Quando um provedor indireto faz um pedido em nome de um revendedor indireto, preencha esse campo com a PartnerID do revendedor indireto Extra somente (nunca a ID do provedor indireto). Os incentivos não são aplicáveis a esses outros revendedores. Somente um máximo de cinco revendedores indiretos podem ser inseridos. Essa requisição só é aplicável a parceiros que transacionam em países/regiões europeus.
scheduledNextTermInstructions Object Não Define as instruções do próximo termo para uma assinatura de avaliação. Os parceiros podem especificar a duração do termo, a frequência de faturamento e a quantidade que a assinatura paga possui na renovação.

Esta tabela descreve as propriedades RenewsTo no corpo da solicitação para ofertas do Microsoft Marketplace.

Propriedade Tipo Obrigatório Description
termDuration cadeia Não Uma representação ISO 8601 da duração do termo de renovação. Os valores atuais compatíveis são P1M (1 mês) e P1Y (1 ano).
ScheduledNextTermInstructions

Esta tabela descreve as propriedades scheduledNextTermInstructions no corpo da solicitação para ofertas de avaliação baseadas em licença NCE. Se nenhum valor for especificado, os períodos de avaliação serão renovados em assinaturas pagas com prazo anual, cobrança mensal e 25 licenças.

Propriedade Tipo Obrigatório Description
produto matriz Não Uma matriz que especifica a oferta em que uma assinatura de avaliação é renovada e o termo e a frequência de cobrança que a assinatura paga tem.
quantidade int Não A quantidade de licença que a assinatura paga correspondente tem depois que a oferta de avaliação é renovada.
Product

Esta tabela descreve as propriedades productTerm no corpo da solicitação para ofertas de avaliação baseadas em licença NCE. Se nenhum valor for especificado nesse array, as avaliações serão renovadas em assinaturas pagas com prazo anual e cobrança feita mensalmente.

Propriedade Tipo Obrigatório Description
ID do produto cadeia Não Um GUID formatado para representar o produto da assinatura paga na qual a avaliação se renova.
skuId cadeia Não Um GUID formatado para representar o SKU da assinatura paga na qual a avaliação é renovada.
availabilityId cadeia Não Um GUID formatado para representar a disponibilidade da assinatura paga na qual a avaliação é renovada.
billingCycle cadeia Não A frequência de cobrança que a assinatura paga correspondente tem depois que a oferta de avaliação é renovada.
termDuration cadeia Não A duração do termo que a assinatura paga correspondente tem depois que a oferta de avaliação é renovada.

Exemplo de solicitação

POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/carts HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 496
Expect: 100-continue

{
  "lineItems": [
    {
    /* Microsoft Azure Subscription */
      "id": 0,
      "catalogItemId": "MS-AZR-0145P",
      "quantity": 1,
      "billingCycle": "monthly",
      "termDuration": "P1Y"
    },
    {
    /* Azure Reserved Instance */
      "id": 1,
      "catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
      "quantity": 1,
      "billingCycle": "one_time",
      "termDuration": "P1Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "shared"
      }
    },
    {
    /* Azure Reserved Instance */
      "id": 2,
      "catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
      "quantity": 1,
      "billingCycle": "one_time",
      "termDuration": "P3Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "single"
      }
    },
    {
    /* Perpetual Software */
      "id": 3,
      "catalogItemId": "DG7GMGF0DWTL:0001:DG7GMGF0DSFM",
      "quantity": 1,
      "billingCycle": "one_time"
    },
    {
    /* SaaS */
      "id": 4,
      "catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
      "quantity": 1,
      "billingCycle": "monthly",
      "termDuration": "P1M"
    },
  {
    /* SaaS Free Trial */
       "id": 5,
       "catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
       "quantity": 10,
       "billingCycle": "none",
       "termDuration": "P1M",
       "renewsTo": {
         "termDuration": "P1Y"
       }
    }
  ]
}

Importante

A partir de junho de 2023, a versão mais recente do SDK do .NET do Partner Center 3.4.0 já está arquivada. Você pode baixar a versão do SDK no GitHub, juntamente com um arquivo 'readme' que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

Resposta REST

Se tiver êxito, esse método retornará o recurso cart preenchido no corpo da resposta.

Códigos de erro e êxito de resposta

Cada resposta vem com um código de status HTTP que indica informações de êxito ou falha e depuração. Use uma ferramenta de rastreamento de rede para ler este código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de Erro.

Exemplo de resposta

HTTP/1.1 201 Created
Content-Length: 764
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
X-Locale: en-US,en-US
MS-CV: sF/wRa2ih0CzbABc.0
MS-ServerId: 000001
Date: Thu, 15 Mar 2018 17:15:01 GMT
{
  "id": "3655b1a0-b1c9-4268-9824-577fdbc4d0be",
  "creationTimestamp": "2019-01-16T00:45:41.6062996Z",
  "lastModifiedTimestamp": "2019-01-16T00:45:41.6062996Z",
  "expirationTimestamp": "2019-01-16T01:00:54.4188497Z",
  "lastModifiedUser": "1824b7fc-2fac-4478-b177-66823c40ab75",
  "status": "Active",
  "lineItems": [
    {
      "id": 0,
      "catalogItemId": "MS-AZR-0145P",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "monthly",
      "termDuration": "P1Y",
      "orderGroup": "OMS-0"
    },
    {
      "id": 1,
      "catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "one_time",
      "termDuration": "P1Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "shared"
      },
      "orderGroup": "0"
    },
    {
      "id": 2,
      "catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "one_time",
      "termDuration": "P3Y",
      "provisioningContext": {
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "scope": "shared"
      },
      "orderGroup": "0"
    },
    {
      "id": 3,
      "catalogItemId": "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "one_time",
      "orderGroup": "0"
    },
    {
      "id": 4,
      "catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
      "quantity": 1,
      "currencyCode": "USD",
      "billingCycle": "monthly",
      "termDuration": "P1M",
      "orderGroup": "1"
    },
  {
      "id": 5,
      "catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
      "quantity": 10,
      "currencyCode": "USD",
      "billingCycle": "none",
      "termDuration": "P1M",
      "renewsTo": {
  "termDuration": "P1Y"
      },
    "orderGroup": "2"
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/28045616-f6b9-462f-9701-0d89b5e65c44/carts/3655b1a0-b1c9-4268-9824-577fdbc4d0be",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Cart"
  }
}

Exemplo para novos serviços baseados em licença de comércio

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (Provedores de Soluções na Nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Exemplo de solicitação

POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165

{
	"LineItems": [
		{
			"CatalogItemId":"CFQ7TTC0LFLZ:0002:CFQ7TTC0K4TS",
			"Quantity": 1,
			"TermDuration": "P1M",
			"BillingCycle": "Monthly"
		}
	]
}

Importante

O plano do Azure e os itens de linha de software perpétuos não dão suporte à propriedade termDuration. Evite incluir isso ao adquirir esses tipos de itens.

// request example where several renewal values for an NCE license-based trial are specified
http
POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165
{
  "lineItems": [
    {
      "id": 0,
      "catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
      "quantity": 25,
      "currencyCode": "USD",
      "billingCycle": "none",
      "termDuration": "P1M",
      "promotionId": null,
      "provisioningContext": {},
      "customTermEndDate": null,
      "scheduledNextTermInstructions": {
        "product": {
          "billingCycle": "monthly",
          "termDuration": "P1M" 
        }
      }
    }
  ],
  "partnerOnRecordAttestationAccepted": true
}

Resposta REST

Se tiver êxito, esse método retornará o recurso cart preenchido no corpo da resposta.

Códigos de erro e êxito de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e outras informações de depuração. Use uma ferramenta de rastreamento de rede para ler este código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de Erro.

Exemplo de resposta


{
    "id": "2517c51b-58cd-4abe-87ed-3ab812401ab4",
    "creationTimestamp": "2023-07-11T21:16:11.55149Z",
    "lastModifiedTimestamp": "2023-07-11T21:16:11.5515713Z",
    "expirationTimestamp": "2023-07-18T21:16:17.2480482Z",
    "lastModifiedUser": "9db12087-fbc3-481c-8965-73d44ff88e27",
    "status": "Active",
    "lineItems": [
        {
            "id": 0,
            "catalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0VZW5",
            "quantity": 1,
            "currencyCode": "USD",
            "billingCycle": "monthly",
            "termDuration": "P1Y",
            "provisioningContext": {},
            "orderGroup": "0",
            "pricing": {
                "listPrice": 30.4,
                "discountedPrice": 30.4,
                "proratedPrice": 30.4,
                "price": 30.4,
                "extendedPrice": 364.8
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/ebd8b4c2-4069-46a8-bd70-123d6dec3e39/carts/2517c51b-58cd-4abe-87ed-3ab812401ab4",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Cart"
    }
}

// response content for an order containing an NCE license-based trial
{
  "id": "99d3777b-61da-4c95-aefa-203c248c4180",
  "creationTimestamp": "2025-02-04T22:22:36.7924103Z",
  "lastModifiedTimestamp": "2025-02-04T22:22:36.7924109Z",
  "expirationTimestamp": "2025-02-11T22:23:34.5190698Z",
  "lastModifiedUser": "b5109661-56c5-45ed-9447-f67463458a97",
  "status": "Active",
  "lineItems": [
    {
      "id": 0,
      "catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
      "quantity": 25,
      "currencyCode": "USD",
      "billingCycle": "none",
      "termDuration": "P1M",
      "provisioningContext": {},
      "orderGroup": "0",
      "pricing": {
        "listPrice": 0.0,
        "discountedPrice": 0.0,
        "proratedPrice": 0.0,
        "price": 0.0,
        "extendedPrice": 0.0
      },
      "scheduledNextTermInstructions": {
        "product": {
          "productId": "CFQ7TTC0LCHC",
          "skuId": "0002",
          "availabilityId": "CFQ7TTC0XL82",
          "billingCycle": "monthly",
          "termDuration": "P1M"
        },
        "quantity": 25
      }
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/81e78b53-9aa8-44e7-a041-3b15272d8f84/carts/99d3777b-61da-4c95-aefa-203c248c4180",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Cart"
  }
}
  • Last updated on