Compartir a través de


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.