Ordenar recursos

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.

Nota:

El recurso Order tiene un límite de velocidad de 500 solicitudes por minuto por identificador de inquilino.

compra

Describe el pedido de un asociado.

Propiedad Tipo Descripción
id string Identificador de pedido que se proporciona tras la creación correcta del pedido.
alternateId string Identificador descriptivo para el pedido.
referenceCustomerId string El identificador del cliente.
billingCycle string Indica la frecuencia con la que se factura al asociado para este pedido. Los valores admitidos son los nombres de los miembros que se encuentran en BillingCycleType. El valor predeterminado es Mensual o OneTime al crear el pedido. Este campo se aplica tras la creación correcta del pedido.
transactionType string Solo lectura Tipo de transacción del pedido. Los valores admitidos son UserPurchase, SystemPurchase o SystemBilling
lineItems matriz de recursos OrderLineItem Una lista desglosada de las ofertas que el cliente está comprando, incluida la cantidad.
currencyCode string Solo lectura Moneda utilizada al realizar el pedido. Aplicado tras la creación correcta del pedido.
currencySymbol string Solo lectura Símbolo de moneda asociado al código de moneda.
creationDate datetime Solo lectura La fecha en que se creó el pedido, en formato de fecha y hora. Aplicado tras la creación correcta del pedido.
status string Solo lectura Estado del pedido. Los valores admitidos son los nombres de miembro que se encuentran en OrderStatus.
vínculos OrderLinks Los vínculos de recursos correspondientes al pedido.
attributes ResourceAttributes Atributos de metadatos correspondientes al pedido.

OrderLineItem

Un pedido contiene una lista desglosada de ofertas y cada elemento se representa como OrderLineItem.

Propiedad Tipo Descripción
lineItemNumber int Cada elemento de línea de la colección obtiene un número de línea única, que comienza desde 0 hasta -1.
offerId string Identificador de la oferta.
subscriptionId string Identificador de la suscripción.
parentSubscriptionId string Opcional. El id.de la suscripción principal en una oferta de complemento. Solo se aplica a PATCH.
friendlyName string Opcional. Nombre descriptivo de la suscripción definida por el asociado para ayudar a desambiguar.
quantity int Número de licencias o instancias.
customTermEndDate DateTime Fecha de finalización del primer período de facturación de la nueva suscripción.
termDuration string Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (1 mes), P1Y (1 año) y P3Y (3 años).
transactionType string Solo lectura Tipo de transacción del elemento de línea. Los valores admitidos son nuevos, renovar, addQuantity, removeQuantity, cancelar, convertir o customerCredit.
partnerIdOnRecord string 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 de los incentivos.
provisioningContext ProvisioningContext 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.
vínculos OrderLineItemLinks Solo lectura Vínculos de recursos correspondientes al elemento de línea de pedido.
renewsTo RenewsTo Detalles de duración del período de renovación.
AttestationAccepted bool Indica el acuerdo para ofrecer o condiciones de SKU. Obligatorio solo para ofertas o sku donde SkuAttestationProperties o OfferAttestationProperties enforceAttestation es True.
Precios Precios Enumerar los detalles del precio.
purchaseCommitment PurchaseCommitment Cantidad fija confirmada en los servicios de proceso.

RenewsTo

Representa los detalles de duración del período de renovación.

Propiedad Type Obligatorio Descripción
termDuration string 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).

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 doble No Precio en la moneda de facturación aplicable después de que se apliquen todos los descuentos y se realice 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.

Representa los vínculos de recursos correspondientes al orden.

Propiedad Tipo Descripción
provisioningStatus Vínculo Cuando se rellena, el vínculo para recuperar el estado de aprovisionamiento del pedido.
self Vínculo Vínculo para recuperar el recurso de pedido.

Representa la suscripción completa asociada al pedido.

Propiedad Tipo Descripción
provisioningStatus Vínculo Cuando se rellena, el vínculo para recuperar el estado de aprovisionamiento del elemento de línea.
sku Vínculo Vínculo para recuperar información de SKU para el artículo de catálogo comprado.
subscription Vínculo Cuando se rellena, el vínculo a la información completa de la suscripción.
activationLinks Vínculo Cuando se rellena, el recurso GET para los vínculos para activar la suscripción.

OrderStatus

[Enum/dotnet/api/system.enum) con valores que indican el estado del orden.

Value Position Descripción
unknown 0 Inicializador de enumeración.
completada 1 El pedido se ha completado.
pending 2 El pedido se está procesando.
cancelled 3 El pedido se cancela.
suspended 4 Se suspende el pedido. Para obtener más información, consulte: Estados del ciclo de vida de la suscripción: NCE suspendido.
Revisión pendiente 5 El pedido está pendiente de revisión secundaria. Es posible que sea necesario que los asociados carguen documentación. Consulte La presentación de aprendizaje de revisión de la oferta secundaria para obtener información sobre lo que debe esperar si está seleccionado para una revisión de la oferta secundaria.
Carga de po pendiente 6 El asociado es cargar su pedido de compra de cliente y escribir los detalles como se describe en microsoft para su revisión.
carga de po completada 7 El asociado envió el pedido de compra (PO) y Microsoft está revisando. No es necesario realizar ninguna otra acción necesaria para el asociado.
revisión de po rechazada 8 Este orden no pasó la revisión secundaria y no se procesará.
operación correcta parcial 9 Una o varias suscripciones en el orden tienen un problema. Los partners deben volver a comprar suscripciones no rellenadas.
error 10 El orden produjo un error. Los asociados deben volver a comprar.

OrderLineItemProvisioningStatus

Representa el estado de aprovisionamiento de un orderLineItem.

Propiedad Tipo Descripción
lineItemNumber int Número de línea único del elemento de línea de pedido. Los valores van de 0 a count-1.
status string Estado de aprovisionamiento del elemento de línea de pedido. Los valores incluyen:
Completado: El cumplimiento del pedido se ha completado correctamente y el usuario podrá usar las reservas
No completadas: No completadas debido a la cancelación
PrefulfillmentPending: La solicitud sigue procesando, el suministro aún no se ha completado.
quantityProvisioningInformation List<QuantityProvisioningStatus> Lista de información de estado de aprovisionamiento de cantidad para el elemento de línea de pedido.

QuantityProvisioningStatus

Representa el estado de aprovisionamiento por cantidad.

Propiedad Tipo Descripción
quantity int Número de elementos.
status string Estado del número de elementos.

ProvisioningContext

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.

Propiedad Tipo Descripción
scope string Tipo de ámbito de una compra que indica dónde se aplican las ventajas: Single,Shared.
entitlementId string Identificador de la suscripción de Azure que se usaría para una compra. Necesario para un ámbito único.

PurchaseCommitment

Cantidad fija confirmada en los servicios de proceso.

Propiedad Tipo Descripción
amount int Compromiso fijo de importe.
currency string Moneda del compromiso.
Grano string Período del compromiso.