Manage orders - Create a new order
Crea un nuevo orden.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/orders
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Identificador del cliente. |
|
version
|
path | True |
string |
Encabezado de la solicitud
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nombre | Requerido | Tipo | Description |
|---|---|---|---|
| Authorization | True |
string |
Token de portador de autorización |
| ms-correlationid |
string |
Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid, el servidor generará uno nuevo para cada solicitud. |
|
| ms-cv |
string |
Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-cv, el servidor generará uno nuevo para cada solicitud. |
|
| ms-requestid |
string |
Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud. |
Cuerpo de la solicitud
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nombre | Tipo | Description |
|---|---|---|
| alternateId |
string |
|
| attributes | ||
| billingCycle |
enum:
|
|
| client | ||
| creationDate |
string (date-time) |
|
| currencyCode |
string |
|
| currencySymbol |
string |
|
| id |
string |
|
| lineItems | ||
| links | ||
| referenceCustomerId |
string |
|
| status |
enum:
|
|
| totalPrice |
number (double) |
|
| transactionType |
string |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 201 Created |
La solicitud se realizó correctamente. El cuerpo de la respuesta contiene el nuevo orden creado. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
Faltaba o faltaba una entrada no válida. El cuerpo de la respuesta proporcionará los detalles del error. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
La solicitud no se autenticó. El cliente debe autenticarse primero con el servicio de API del asociado. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
La solicitud se autenticó pero se rechazó, ya que el autor de la llamada no tiene los derechos para invocarla. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
El recurso no se encuentra o no está disponible con los parámetros de entrada especificados. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud. Los autores de llamadas pueden volver a intentarlo. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definiciones
Microsoft.Partner.Core.Collections.Link
| Nombre | Tipo | Description |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
Microsoft.Partner.Core.Collections.ResourceAttributes
| Nombre | Tipo | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
Microsoft.Partner.Services.Orders.V2.Models.ClientContext
| Nombre | Tipo | Description |
|---|---|---|
| deviceFamily |
string |
|
| marketplaceCountry |
string |
|
| name |
string |
Microsoft.Partner.Services.Orders.V2.Models.Order
| Nombre | Tipo | Description |
|---|---|---|
| alternateId |
string |
|
| attributes | ||
| billingCycle |
enum:
|
|
| client | ||
| creationDate |
string (date-time) |
|
| currencyCode |
string |
|
| currencySymbol |
string |
|
| id |
string |
|
| lineItems | ||
| links | ||
| referenceCustomerId |
string |
|
| status |
enum:
|
|
| totalPrice |
number (double) |
|
| transactionType |
string |
Microsoft.Partner.Services.Orders.V2.Models.OrderLineItem
| Nombre | Tipo | Description |
|---|---|---|
| attestationAccepted |
boolean |
|
| customTermEndDate |
string (date-time) |
|
| friendlyName |
string |
|
| lineItemNumber |
integer (int32) |
|
| links |
Microsoft. |
|
| offerId |
string |
|
| parentSubscriptionId |
string |
|
| partnerIdOnRecord |
string |
|
| pricing | ||
| promotionId |
string |
|
| provisioningContext |
object |
|
| purchaseCommitment |
Microsoft. |
|
| quantity |
integer (int32) |
|
| renewsTo | ||
| scheduledNextTermInstructions |
Microsoft. |
|
| subscriptionId |
string |
|
| termDuration |
string |
|
| transactionType |
string |
Microsoft.Partner.Services.Orders.V2.Models.OrderLineItemLinks
| Nombre | Tipo | Description |
|---|---|---|
| activationLinks | ||
| availability | ||
| product | ||
| provisioningStatus | ||
| sku | ||
| subscription |
Microsoft.Partner.Services.Orders.V2.Models.OrderLinks
| Nombre | Tipo | Description |
|---|---|---|
| patchOperation | ||
| provisioningStatus | ||
| self |
Microsoft.Partner.Services.Orders.V2.Models.Pricing
| Nombre | Tipo | Description |
|---|---|---|
| discountedPrice |
number (double) |
|
| extendedPrice |
number (double) |
|
| listPrice |
number (double) |
|
| price |
number (double) |
|
| proratedPrice |
number (double) |
Microsoft.Partner.Services.Orders.V2.Models.ProductTerm
| Nombre | Tipo | Description |
|---|---|---|
| availabilityId |
string |
|
| billingCycle |
enum:
|
|
| productId |
string |
|
| skuId |
string |
|
| termDuration |
string |
Microsoft.Partner.Services.Orders.V2.Models.PurchaseCommitment
| Nombre | Tipo | Description |
|---|---|---|
| amount |
number (double) |
|
| currency |
string |
|
| grain |
string |
Microsoft.Partner.Services.Orders.V2.Models.RenewsTo
| Nombre | Tipo | Description |
|---|---|---|
| termDuration |
string |
Microsoft.Partner.Services.Orders.V2.Models.ScheduledNextTermInstructions
| Nombre | Tipo | Description |
|---|---|---|
| product | ||
| quantity |
number (int32) |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| Nombre | Tipo | Description |
|---|---|---|
| key |
string |
|
| value |
string |