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. |
| atributos | 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. |
| cantidad | 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. |
OrderLinks
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. |
OrderLineItemLinks
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.
| Valor | 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: |
| 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 |
|---|---|---|
| cantidad | 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 | El 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. |