Manage orders - Create a transfer
Crea una nueva entidad de transferencia.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfersParámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Identificador del cliente. |
|
version
|
path | True |
string |
El número de versión de la API. |
Encabezado de 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 |
Identificador alternativo para la entidad de transferencia. El valor suele ser un GUID. |
| attributes |
Atributos adicionales asociados a la entidad de transferencia. |
|
| completedTime |
string (date-time) |
El tiempo completado para la entidad de transferencia. Utiliza el formato de fecha y hora ISO 8601. |
| createdTime |
string (date-time) |
La fecha y hora en que se creó la entidad de transferencia, en formato ISO 8601. Utiliza el formato de fecha y hora ISO 8601. |
| customerEmailId |
string |
El identificador único del correo electrónico del cliente. El valor suele ser un GUID. |
| customerName |
string |
El nombre del cliente para la entidad de transferencia. |
| customerTenantId |
string |
El identificador único del inquilino cliente. El valor suele ser un GUID. |
| expirationTime |
string (date-time) |
El tiempo de caducidad de la entidad de transferencia. Utiliza el formato de fecha y hora ISO 8601. |
| id |
string |
Identificador único para la entidad de transferencia. El valor suele ser un GUID. |
| ignoreEligibilityCheck |
boolean |
Si esta entidad de transferencia ignora la verificación de elegibilidad. |
| lastModifiedTime |
string (date-time) |
El último tiempo modificado para la entidad de transferencia. Utiliza el formato de fecha y hora ISO 8601. |
| lastModifiedUser |
string |
El usuario que modificó por última vez la entidad de transferencia. |
| lineItems |
La colección de partidas asociadas a esta entidad de transferencia. |
|
| links |
Enlaces a recursos relacionados. |
|
| participants |
Los participantes asociados a este artículo. |
|
| partnerOnRecord |
string |
El socio registrado para la entidad de transferencia. |
| partnertenantid |
string |
El identificador único de la entidad de transferencia. El valor suele ser un GUID. |
| sourcePartnerEmailId |
string |
El identificador único del correo de origen del socio. El valor suele ser un GUID. |
| sourcePartnerName |
string |
El nombre del socio fuente para la entidad transferida. |
| sourcePartnerTenantId |
string |
El identificador único del inquilino del socio de origen. El valor suele ser un GUID. |
| status |
string |
Estado actual de la entidad de transferencia. |
| targetPartnerEmailId |
string |
El identificador único del correo del socio objetivo. El valor suele ser un GUID. |
| targetPartnerName |
string |
El nombre del socio objetivo para la entidad de transferencia. |
| targetPartnerTenantId |
string |
El identificador único del inquilino socio objetivo. El valor suele ser un GUID. |
| targetProductTypes |
string[] |
La colección de tipos de productos objetivo asociados a esta entidad de transferencia. |
| transferDirection |
enum:
|
La dirección de transferencia para la entidad de transferencia. Los valores posibles incluyen: 0, 1, 2. |
| transferType |
enum:
|
El tipo de transferencia, enviado como entero. Los valores posibles incluyen: 0 (Desconocido), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce). |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 201 Created |
La solicitud se realizó correctamente. El cuerpo de la respuesta contiene la información de transferencia. 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
| Nombre | Description |
|---|---|
|
Last |
Representa el último recurso conocido de detalles de facturación. |
|
Last |
Representa un último recurso conocido del periodo de facturación. |
| Link |
Representa un recurso de enlace. |
|
Resource |
Representa un recurso de atributos de recurso. |
|
Resource |
Representa un recurso de enlaces de recursos. |
|
String |
Representa un recurso de par de valor clave. |
|
Transfer |
Representa un recurso de entidad de transferencia. |
|
Transfer |
Representa el tipo de elemento que se transfiere, enviado como entero. Los valores posibles incluyen: 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Software), 7 (SaaS). |
|
Transfer |
Representa un recurso de línea de transferencia. |
|
Transfer |
Representa un recurso de error de línea de transferencia. |
|
Transfer |
Representa un recurso de precio de línea de transferencia. |
LastKnownBillingDetails
Representa el último recurso conocido de detalles de facturación.
| Nombre | Tipo | Description |
|---|---|---|
| billingAmount |
number (double) |
El importe de facturación para los últimos detalles de facturación conocidos. |
| billingCycle |
enum:
|
Frecuencia de facturación. Los valores posibles incluyen: 'desconocido', 'mensual', 'anual', 'ninguno', 'one_time'. |
| billingPeriod |
Periodo adicional de facturación asociado con los últimos detalles de facturación conocidos. |
|
| billingType |
enum:
|
El tipo de facturación para los últimos detalles de facturación conocidos. Los valores posibles incluyen: 'ninguno', 'uso', 'licencia'. |
| currency |
string |
El código de moneda ISO de tres letras. |
LastKnownBillingPeriod
Representa un último recurso conocido del periodo de facturación.
| Nombre | Tipo | Description |
|---|---|---|
| endDate |
string (date-time) |
La fecha de finalización de este disco, en formato ISO 8601. Utiliza el formato de fecha y hora ISO 8601. |
| startDate |
string (date-time) |
La fecha de inicio de este registro, en formato ISO 8601. Utiliza el formato de fecha y hora ISO 8601. |
Link
Representa un recurso de enlace.
| Nombre | Tipo | Description |
|---|---|---|
| body |
string |
El cuerpo del enlace. |
| headers |
La colección de cabeceras asociada a este enlace. |
|
| method |
string |
El método para el enlace. |
| uri |
string |
El URI del recurso relacionado. |
ResourceAttributes
Representa un recurso de atributos de recurso.
| Nombre | Tipo | Description |
|---|---|---|
| etag |
string |
La etiqueta de entidad utilizada para el control de concurrencia. |
| objectType |
string |
El tipo de objeto para los atributos de recurso. |
ResourceLinks
Representa un recurso de enlaces de recursos.
| Nombre | Tipo | Description |
|---|---|---|
| next |
Más información relacionada con los enlaces de recursos. |
|
| previous |
Otros anteriores asociados con los enlaces de recursos. |
|
| self |
Otros vínculos de recursos asociados. |
StringStringKeyValuePair
Representa un recurso de par de valor clave.
| Nombre | Tipo | Description |
|---|---|---|
| key |
string |
La clave para el par clave-valor. |
| value |
string |
El valor para el par clave-valor. |
TransferEntity
Representa un recurso de entidad de transferencia.
| Nombre | Tipo | Description |
|---|---|---|
| alternateId |
string |
Identificador alternativo para la entidad de transferencia. El valor suele ser un GUID. |
| attributes |
Atributos adicionales asociados a la entidad de transferencia. |
|
| completedTime |
string (date-time) |
El tiempo completado para la entidad de transferencia. Utiliza el formato de fecha y hora ISO 8601. |
| createdTime |
string (date-time) |
La fecha y hora en que se creó la entidad de transferencia, en formato ISO 8601. Utiliza el formato de fecha y hora ISO 8601. |
| customerEmailId |
string |
El identificador único del correo electrónico del cliente. El valor suele ser un GUID. |
| customerName |
string |
El nombre del cliente para la entidad de transferencia. |
| customerTenantId |
string |
El identificador único del inquilino cliente. El valor suele ser un GUID. |
| expirationTime |
string (date-time) |
El tiempo de caducidad de la entidad de transferencia. Utiliza el formato de fecha y hora ISO 8601. |
| id |
string |
Identificador único para la entidad de transferencia. El valor suele ser un GUID. |
| ignoreEligibilityCheck |
boolean |
Si esta entidad de transferencia ignora la verificación de elegibilidad. |
| lastModifiedTime |
string (date-time) |
El último tiempo modificado para la entidad de transferencia. Utiliza el formato de fecha y hora ISO 8601. |
| lastModifiedUser |
string |
El usuario que modificó por última vez la entidad de transferencia. |
| lineItems |
La colección de partidas asociadas a esta entidad de transferencia. |
|
| links |
Enlaces a recursos relacionados. |
|
| participants |
Los participantes asociados a este artículo. |
|
| partnerOnRecord |
string |
El socio registrado para la entidad de transferencia. |
| partnertenantid |
string |
El identificador único de la entidad de transferencia. El valor suele ser un GUID. |
| sourcePartnerEmailId |
string |
El identificador único del correo de origen del socio. El valor suele ser un GUID. |
| sourcePartnerName |
string |
El nombre del socio fuente para la entidad transferida. |
| sourcePartnerTenantId |
string |
El identificador único del inquilino del socio de origen. El valor suele ser un GUID. |
| status |
string |
Estado actual de la entidad de transferencia. |
| targetPartnerEmailId |
string |
El identificador único del correo del socio objetivo. El valor suele ser un GUID. |
| targetPartnerName |
string |
El nombre del socio objetivo para la entidad de transferencia. |
| targetPartnerTenantId |
string |
El identificador único del inquilino socio objetivo. El valor suele ser un GUID. |
| targetProductTypes |
string[] |
La colección de tipos de productos objetivo asociados a esta entidad de transferencia. |
| transferDirection |
enum:
|
La dirección de transferencia para la entidad de transferencia. Los valores posibles incluyen: 0, 1, 2. |
| transferType |
enum:
|
El tipo de transferencia, enviado como entero. Los valores posibles incluyen: 0 (Desconocido), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce). |
TransferItemType
Representa el tipo de elemento que se transfiere, enviado como entero. Los valores posibles incluyen: 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Software), 7 (SaaS).
| Valor | Description |
|---|---|
| 0 | |
| 1 | |
| 2 | |
| 3 | |
| 4 | |
| 5 | |
| 6 | |
| 7 |
TransferLineItem
Representa un recurso de línea de transferencia.
| Nombre | Tipo | Description |
|---|---|---|
| addonItems |
La colección de elementos adicionales asociados a esta línea de transferencia. |
|
| billingCycle |
enum:
|
Frecuencia de facturación. Los valores posibles incluyen: 'desconocido', 'mensual', 'anual', 'ninguno', 'one_time'. |
| billingDetails |
Detalles adicionales de facturación asociados con la partida de transferencia. |
|
| currencyCode |
string |
El código de moneda ISO de tres letras. |
| errors |
La colección de errores asociados a esta línea de transferencia. |
|
| friendlyName |
string |
Un nombre de exhibición amigable para este artículo. |
| id |
integer (int32) |
Identificador único para la línea de transferencia (línea de transferencia). |
| offerId |
string |
El identificador único de la oferta. El valor suele ser un GUID. |
| orderId |
string |
El identificador único del pedido. El valor suele ser un GUID. |
| partnerIdOnRecord |
string |
El identificador del socio registrado para la línea de transferencia. |
| price |
El precio asociado a este artículo. |
|
| productType |
Transfer |
Tipo adicional de producto asociado a la línea de transferencia. |
| quantity |
integer (int32) |
Número de unidades. |
| sourceSubscriptionTermEndDate |
string (date-time) |
La fecha y hora en que finaliza el plazo de la suscripción fuente, en UTC. |
| sourceSubscriptionTermStartDate |
string (date-time) |
La fecha de inicio del periodo de suscripción fuente, en formato ISO 8601. Utiliza el formato de fecha y hora ISO 8601. |
| status |
string |
Estado actual de la línea de transferencia. |
| subscriptionId |
string |
El identificador único (GUID) de la suscripción. El valor suele ser un GUID. |
| transferError |
string |
El error de transferencia para la línea de transferencia. |
| transferGroupId |
string |
El identificador único del grupo de transferencia. El valor suele ser un GUID. |
TransferLineItemError
Representa un recurso de error de línea de transferencia.
| Nombre | Tipo | Description |
|---|---|---|
| code |
string |
El código para el error de línea de transferencia. |
| description |
string |
La descripción de este objeto. |
TransferLineItemPrice
Representa un recurso de precio de línea de transferencia.
| Nombre | Tipo | Description |
|---|---|---|
| currencyCode |
string |
El código de moneda ISO de tres letras. |
| discountedPrice |
number (double) |
El precio descontado para el precio de la línea de transferencia. |
| erpPrice |
number (double) |
El precio estimado al público (ERP). La cantidad única estimada del precio al público que aparece en el catálogo antes de que se apliquen cualquier modificador de precio, en la moneda del artículo. Este es el precio de venta a plazo completo cuando se especifica un plazo de disponibilidad. La cantidad es antes de impuestos, excepto en países o regiones que incluyen impuestos donde el precio incluye impuestos. Esta propiedad está en proceso de implementación y no se devuelve a todos los socios. |
| extendedPrice |
number (double) |
El precio extendido para el precio de la línea de transferencia. |
| listPrice |
number (double) |
El precio de lista antes de que se apliquen los descuentos. |
| price |
number (double) |
El precio asociado a este artículo. |
| proratedPrice |
number (double) |
El precio prorrateado para el precio de la línea de transferencia. |