Recursos del carro
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
Un asociado realiza un pedido cuando un cliente quiere comprar una suscripción de una lista de ofertas.
Carro
Describe un carro.
| Propiedad | Type | Descripción |
|---|---|---|
| id | cadena | Identificador de carro que se suministra tras la creación correcta del carro. |
| creationTimeStamp | DateTime | Fecha en que se creó el carro, en formato de fecha y hora. Aplicado tras la creación correcta del carro. |
| lastModifiedTimeStamp | DateTime | 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 | La fecha en que expirará el carro, en formato de fecha y hora. Aplicado tras la creación correcta del carro. |
| lastModifiedUser | cadena | Usuario que actualizó por última vez el carro. Aplicado tras la creación correcta del carro. |
| lineItems | Matriz de objetos | Matriz de recursos CartLineItem . |
| status | cadena | Estado del carro. Los valores posibles son "Activo" (se puede actualizar o enviar) y "Ordenado" (ya se ha enviado). |
CartLineItem
Representa un elemento contenido en un carro.
| Propiedad | Type | Descripción |
|---|---|---|
| id | cadena | Identificador único de un elemento de línea de carro. Aplicado tras la creación correcta del carro. |
| catalogItemId | cadena | Identificador del elemento de catálogo. |
| friendlyName | cadena | Opcional. Nombre descriptivo del elemento definido por el asociado para ayudar a desambiguar. |
| quantity | int | Número de licencias o instancias. |
| currencyCode | cadena | El código de divisa. |
| billingCycle | Object | Tipo de ciclo de facturación establecido para el período actual. |
| termDuration | cadena | Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (un mes), P1Y (un año) y P3Y (tres años). |
| participants | Lista de pares de cadenas de objeto | Colección de PartnerID en Record en la compra. |
| provisioningContext | Cadena de diccionario<, cadena> | Contexto adicional utilizado al aprovisionar el elemento comprado. Para determinar qué valores son necesarios para un elemento determinado, consulte la propiedad provisioningVariables de la SKU. |
| orderGroup | cadena | Un grupo para indicar qué elementos se pueden enviar juntos en el mismo orden. |
| addonItems | Lista de objetos CartLineItem | Colección de artículos de línea de carro para complementos. Estos artículos se comprarán hacia la suscripción base que se obtiene de la compra del artículo de línea del carro raíz. |
| error | Object | Se aplica después de crear el carro si se produjo un error. |
| renewsTo | Matriz de objetos | Matriz de recursos RenewsTo . |
| AttestationAccepted | bool | Indica el acuerdo para ofrecer o condiciones de SKU. Obligatorio solo para ofertas o sku donde SkuAttestationProperties o OfferAttestationProperties enforceAttestation es True. |
| promotionId | cadena | Identificador de promoción que está a punto de aplicarse al elemento de línea del carro. |
| customTermEndDate | DateTime | Fecha de finalización del primer período de facturación de la nueva suscripción. |
Precios
Representa los detalles del precio. Los importes de los precios se proporcionan antes de la imposición.
| Propiedad | Type | Obligatorio | Descripción |
|---|---|---|---|
| listPrice | doble | No | Precio enumerado en el catálogo sin ningún modificador de precios aplicado. |
| discountedPrice | doble | No | Precio después de aplicar todos los modificadores de precios aplicables. |
| proratedratePrice | doble | No | Precio con descuento después de realizar la proración. |
| price | double | No | Precio en la moneda de facturación aplicable después de que se hayan aplicado todos los descuentos y se haya realizado la proración. |
| extendedPrice | doble | No | Precio del artículo de línea con cantidad, descuentos y proración aplicados, en la moneda de facturación aplicable. |
RenewsTo
Representa un elemento contenido en un elemento de línea de carro.
| Propiedad | Type | Obligatorio | Descripción |
|---|---|---|---|
| termDuration | cadena | No | Representación ISO 8601 de la duración del período de renovación. Los valores admitidos actuales son P1M (un mes) y P1Y (un año). |
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error del Centro de partners.
CartError
Representa un error que se produce después de crear un carro.
| Propiedad | Type | Descripción |
|---|---|---|
| errorCode | CartErrorCode | Tipo de error del carro. |
| errorDescription | cadena | La descripción del error, incluidas las notas sobre los valores admitidos, los valores predeterminados o los límites. |
| additionalInformation | AdditionalInformation | Información adicional para el error. |
AdditionalInformation
Información adicional sobre el error.
| Propiedad | Type | Descripción |
|---|---|---|
| availableQuantity | int | Número de licencias restantes que se pueden comprar para la SKU de producto especificada. |
| purchasedQuantity | int | Número de licencias que se van a comprar. |
CartErrorCode
Tipos de errores de carro.
| Nombre | ErrorCode | Descripción |
|---|---|---|
| CurrencyIsNotSupported | 10 000 | La moneda no se admite para un mercado determinado |
| CatalogItemIdIsNotValid | 10001 | El identificador del elemento de catálogo no es válido |
| QuotaNotAvailable | 10002 | No hay suficiente cuota disponible |
| InventoryNotAvailable | 10003 | El inventario no está disponible para la oferta seleccionada |
| ParticipantesIsNotSupportedForPartner | 10004 | No se admite la configuración de participantes para partner |
| UnableToProcessCartLineItem | 10006 | No se puede procesar el elemento de línea del carro. |
| SubscriptionIsNotValid | 10007 | La suscripción no es válida. |
| SubscriptionIsNotEnabledForRI | 10008 | La suscripción no está habilitada para las compras de reservas. |
| SandboxLimitExceed | 10009 | Se ha superado el límite de espacio aislado. |
| InvalidInput | 10010 | La entrada genérica no es válida. |
| SubscriptionNotRegistered | 10011 | La suscripción no es válida. |
| AttestationNotAccepted | 10012 | No se ha aceptado la atestación. |
| MaxAllowedSeatsPerSubscriptionExceeded | 10015 | El número solicitado de puestos supera el límite. |
| Unknown | 0 | Default value |
CartCheckoutResult
Representa el resultado de una compra de carro.
| Propiedad | Type | Descripción |
|---|---|---|
| pedidos | Lista de objetos Order . | Colección de pedidos. |
| orderErrors | Lista de objetos OrderError . | Colección de errores de orden. |
OrderError
Representa un error que se produce durante una compra del carro cuando se crea un pedido.
| Propiedad | Type | Descripción |
|---|---|---|
| orderGroupId | cadena | Identificador del grupo de pedidos del pedido con el error. |
| código | int | Código de error. |
| descripción | cadena | Descripción del error. |