Crear un carro con un pedido de cliente

Se aplica a: Centro de asociados | Centro de asociados operado por 21Vianet | Centro de asociados para la Nube de Microsoft para el Gobierno de los EE. UU.

Puede agregar un pedido para un cliente en un carrito. Para obtener más información sobre lo que está disponible actualmente para vender, consulte Ofertas de partners en el programa Proveedor de soluciones en la nube.

Nota:

Los carritos expiran siete días desde la creación inicial.

Prerrequisitos

  • Credenciales tal como se describe en Autenticación del Centro de asociados. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.

  • Un identificador de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en Partner Center seleccionando el área de trabajo Clientes, luego el cliente de la lista de clientes y, a continuación, Cuenta. En la página Cuenta del cliente, busque el Id. de Microsoft en la sección Información de la cuenta de cliente. El identificador de Microsoft es el mismo que el identificador de cliente (customer-tenant-id).

C#

Para crear un pedido para un cliente:

  1. Cree una instancia de un objeto Cart.

  2. Cree una lista de objetos CartLineItem y asigne la lista a la propiedad LineItems del carro. Cada artículo del carrito contiene la información de compra de un producto. Debe tener al menos un artículo del carrito.

  3. Obtenga una interfaz para realizar operaciones de carro llamando al método IAggregatePartner.Customers.ById con el identificador de cliente para identificar al cliente y, a continuación, recuperando la interfaz de la propiedad Cart .

  4. Llame al método Create o CreateAsync para crear el carrito.

  5. Para completar la atestación e incluir otros revendedores, consulte los ejemplos de solicitud y respuesta siguientes:

Solicitar muestra


{
    "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"
                }
            ]
        }
    ]
}

Ejemplo de respuesta


{
    "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"
    }
}

Ejemplo 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

El SDK de Java de Partner Center se puede usar para administrar los recursos de Partner Center. Es un proyecto de código abierto mantenido por la comunidad de partners y no cuenta con soporte oficial de Microsoft. Puede obtener ayuda de la comunidad o abrir un problema en GitHub si experimenta un problema.

Para crear un pedido para un cliente:

  1. Cree una instancia de un objeto Cart.

  2. Cree una lista de objetos CartLineItem y asigne la lista a los elementos de línea del carrito. Cada elemento de línea del carrito contiene la información de compra de un producto. Debe tener al menos un artículo del carrito.

  3. Obtenga una interfaz para las operaciones de carro llamando a la función IAggregatePartner.getCustomers().byId con el identificador de cliente para identificar al cliente y, a continuación, recuperando la interfaz de la función getCart .

  4. Llame a la función create para crear el carrito.

Ejemplo 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

El módulo de PowerShell del Centro de partners se puede usar para administrar los recursos del Centro de partners. Es un proyecto de código abierto mantenido por la comunidad de partners y no cuenta con soporte oficial de Microsoft. Puede obtener ayuda de la comunidad o abrir un problema en GitHub si experimenta un problema.

Para crear un pedido para un cliente:

  1. Cree una instancia de un objeto Cart.

  2. Cree una lista de objetos CartLineItem y asigne la lista a los elementos de línea del carro. Cada línea del carrito contiene la información de compra de un producto. Debe tener al menos un elemento de línea de carro.

  3. Ejecute el comando New-PartnerCustomerCart para crear el carrito.

# $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

Solicitud REST

Sintaxis de la solicitud

Método Solicitud de URI
POST {baseURL}/v1/customers/{customer-id}/carts HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de ruta de acceso para identificar al cliente.

Nombre Tipo Obligatorio Description
customer-id cuerda / cadena Sí Identificador de cliente con formato GUID que identifica al cliente.

Encabezados de solicitud

Para más información, consulte Encabezados REST del Centro de partners.

Cuerpo de la solicitud

En esta tabla se describen las propiedadesCart en el cuerpo de la solicitud.

Propiedad Tipo Obligatorio Description
id cuerda / cadena No Identificador de carrito que se suministra tras la creación correcta del carrito.
marca de tiempo de creación DateTime No Fecha en que se creó el carrito, en formato de fecha y hora. Aplicado tras la creación correcta del carro.
lastModifiedTimeStamp DateTime No Fecha en que el carro se actualizó por última vez, en formato de fecha y hora. Aplicado tras la creación correcta del carro.
expirationTimeStamp DateTime No La fecha en que expira el carrito, en formato de fecha y hora. Aplicado tras la creación correcta del carro.
lastModifiedUser cuerda / cadena No El usuario que actualizó por última vez el carro. Aplicado tras la creación correcta del carro.
lineItems Matriz de objetos Sí Array de recursos CartLineItem.
PartnerOnRecordAttestationAccepted Boolean Sí Confirma que la certificación ha finalizado

En esta tabla se describen las propiedades CartLineItem en el cuerpo de la solicitud.

Nota:

Al finalizar la compra de un carro a través de la API, los elementos de línea se procesan en el orden en que se colocan en el carro. El pedido puede afectar a la elegibilidad para promociones con restricciones de New To Offer si hay dos productos del mismo tipo en el carrito, uno con el identificador de promoción y otro sin él (por ejemplo, con términos diferentes). Asegúrese de colocar los artículos aptos para una promoción primero en el carro si está comprando varios artículos.

Propiedad Tipo Obligatorio Description
id cuerda / cadena No Identificador único de un elemento de línea de carrito. Aplicado tras la creación correcta del carro.
catalogId cuerda / cadena Sí Identificador del elemento de catálogo. Asegúrese de que la disponibilidad del elemento de catálogo es para el segmento correcto.
friendlyName cuerda / cadena No Optional. Nombre descriptivo del elemento definido por el asociado para ayudar a desambiguar.
promotionId cuerda / cadena No Optional. La mayoría de las nuevas promociones comerciales se aplican automáticamente. Sin embargo, para que las promociones opcionales (como Bridge to the Cloud 2) se apliquen a un elemento de línea de carrito, los partners deben incluir el identificador de promoción al agregarlo al carrito.
cantidad int Sí Número de licencias o instancias.
código de moneda cuerda / cadena No El código de divisa.
ciclo de facturación Objeto Sí Tipo de ciclo de facturación establecido para el período actual.
customTermEndDate DateTime No Fecha de finalización de una suscripción existente con la que desea hacer coincidir la fecha de finalización de la nueva suscripción.
Participantes Lista de pares de cadenas de objeto No Colección de PartnerId en el registro (PartnerID) en la compra.
provisioningContext Dictionary<string, string> No Información necesaria para el aprovisionamiento de algunos elementos del catálogo. La propiedad provisioningVariables de una SKU indica qué propiedades son necesarias para elementos específicos del catálogo.
orderGroup cuerda / cadena No Un grupo para indicar qué elementos se pueden colocar juntos.
error Objeto No Se aplica después de crear el carrito si se produce un error.
renewsTo Matriz de objetos No Array de recursos RenewsTo.
AttestationAccepted Boolean No Indica la conformidad con las condiciones de la oferta o del SKU. Obligatorio solo para ofertas o SKU donde SkuAttestationProperties o OfferAttestationProperties tienen enforceAttestation establecido en True.
transaction_reseller String No Cuando un proveedor indirecto realiza un pedido en nombre de un revendedor indirecto, rellene este campo con el PartnerID del revendedor indirecto solo (nunca el identificador del proveedor indirecto). Esto garantiza una contabilidad adecuada para los incentivos.
transacción_adicional_del_revendedor String No Cuando un proveedor indirecto realiza un pedido en nombre de un revendedor indirecto, rellene este campo con el PartnerID del revendedor indirecto adicional ( nunca el identificador del proveedor indirecto). Los incentivos no son aplicables a estos otros revendedores. Solo se puede especificar un máximo de cinco revendedores indirectos. Esta solicitud solo es aplicable a los partners que realizan transacciones dentro de países o regiones europeos.
scheduledNextTermInstructions Objeto No Define las instrucciones para el siguiente periodo de una suscripción de prueba. Los asociados pueden especificar termDuration, billingFrequency y la cantidad que tiene la suscripción de pago correspondiente en la renovación.

En esta tabla se describen las propiedades RenewsTo del cuerpo de la solicitud para las ofertas de Microsoft Marketplace.

Propiedad Tipo Obligatorio Description
termDuration cuerda / cadena No Representación ISO 8601 de la duración del período de renovación. Los valores admitidos actuales son P1M (1 mes) y P1Y (1 año).
ScheduledNextTermInstructions

En esta tabla se describen las propiedades scheduledNextTermInstructions en el cuerpo de la solicitud para las ofertas de evaluación basadas en licencias NCE. Si no se especifica ningún valor, las evaluaciones se renuevan en suscripciones de pago con periodo anual, facturación mensual y 25 licencias.

Propiedad Tipo Obligatorio Description
producto array No Una matriz que especifica la oferta en la que se renueva una suscripción de prueba y el término y la frecuencia de facturación que tiene la suscripción de pago.
cantidad int No Cantidad de licencia que la suscripción de pago correspondiente tiene una vez que se renueva la oferta de prueba.
Grupos de pedidos

La API asigna el orderGroup valor devuelto en los elementos de línea del carro durante la creación o actualización del carro. La API sobrescribe cualquier valor que proporcione. Durante la compra, cada grupo de pedidos se convierte en un pedido independiente.

Coloque los elementos de línea en el mismo grupo de orden solo cuando coincidan todos los valores siguientes:

  • Ciclo de facturación, como annual, monthlyo pruebas
  • Segmento, como commercial o education
  • Código de moneda
  • Familia de productos, como OnlineServicesNCE
  • Legacy frente a NCE

Un grupo de pedidos puede contener hasta 10 líneas de pedido. El sistema coloca líneas de pedido adicionales en un nuevo grupo de pedidos. No hay límite para el número de grupos de pedidos que pueden aparecer en un carrito.

El sistema coloca los siguientes tipos de elementos en grupos de orden independientes:

  • Reservas de Azure
  • Azure Benefits, incluyen promociones y FlexSpendPlan
Producto

En esta tabla se describen las propiedades productTerm del cuerpo de la solicitud para las ofertas de prueba basadas en licencias NCE. Si no se especifican valores en esta matriz, las pruebas se renuevan como suscripciones de pago con un término anual y facturación mensual.

Propiedad Tipo Obligatorio Description
ID de producto cuerda / cadena No GUID con formato para representar el producto de la suscripción de pago a la que se convierte la versión de prueba al renovarse.
skuId cuerda / cadena No GUID con formato para representar el SKU de la suscripción de pago a la que se convierte la versión de prueba al renovarse.
availabilityId cuerda / cadena No GUID con formato para representar la disponibilidad de la suscripción de pago a la que se convierte la versión de prueba al renovarse.
ciclo de facturación cuerda / cadena No Frecuencia de facturación de la que dispone la suscripción de pago correspondiente una vez renovada la oferta de prueba.
termDuration cuerda / cadena No Duración del período que tiene la suscripción de pago correspondiente una vez que se renueva la oferta de prueba.

Ejemplo de solicitud

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 junio de 2023, la versión 3.4.0 más reciente del SDK de .NET de Partner Center ahora está archivada. Puede descargar la versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

Se recomienda a los partners seguir usando las API REST de Partner Center.

Respuesta REST

Si se ejecuta correctamente, este método devuelve el recurso Cart rellenado en el cuerpo de la respuesta.

Códigos de éxito y de error de la respuesta

Cada respuesta incluye un código de estado HTTP que indica si la solicitud se ha realizado correctamente o ha fallado, además de información de depuración. Utilice una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

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"
  }
}

Ejemplo de servicios basados en licencias de comercio nuevos

Nota:

Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para obtener más información, consulte información general sobre las nuevas experiencias comerciales.

Ejemplo de solicitud

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

Los elementos de línea del plan de Azure y del software perpetuo no admiten la propiedad termDuration. Evite incluir esto al adquirir este tipo de elementos.

// 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
}

Respuesta REST

Si se ejecuta correctamente, este método devuelve el recurso Cart rellenado en el cuerpo de la respuesta.

Códigos de éxito y de error de la respuesta

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Utilice una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta


{
    "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"
  }
}
  • Se actualizó por última vez el