Recursos del carroCart resources

Se aplica a:Applies to:

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Un asociado realiza un pedido cuando un cliente desea comprar una suscripción de una lista de ofertas.A partner places an order when a customer wants to buy a subscription from a list of offers.

CarroCart

Describe un carro.Describes a cart.

PropiedadProperty TipoType DescripciónDescription
idid stringstring Un identificador de carro que se proporciona cuando se crea correctamente el carro.A cart identifier that is supplied upon successful creation of the cart.
creationTimeStampcreationTimeStamp DateTimeDateTime Fecha en que se creó el carro, en formato de fecha y hora.The date the cart was created, in date-time format. Se aplica cuando se crea correctamente el carro.Applied upon successful creation of the cart.
lastModifiedTimeStamplastModifiedTimeStamp DateTimeDateTime Fecha en que se actualizó por última vez el carro, en formato de fecha y hora.The date the cart was last updated, in date-time format. Se aplica cuando se crea correctamente el carro.Applied upon successful creation of the cart.
expirationTimeStampexpirationTimeStamp DateTimeDateTime Fecha en que el carro expirará, en formato de fecha y hora.The date the cart will expire, in date-time format. Aplicado tras la creación correcta del carro.Applied upon successful creation of cart.
lastModifiedUserlastModifiedUser stringstring El usuario que actualizó por última vez el carro.The user who last updated the cart. Aplicado tras la creación correcta del carro.Applied upon successful creation of cart.
lineItemslineItems Matriz de objetosArray of objects Una matriz de recursos CartLineItem .An Array of CartLineItem resources.
statusstatus stringstring Estado del carro.The status of the cart. Los valores posibles son "Active" (se puede actualizar o enviar) y "ordenado" (ya enviado).Possible values are "Active" (can be updated/submitted) and "Ordered" (has already been submitted).

CartLineItemCartLineItem

Representa un elemento incluido en un carro.Represents one item contained in a cart.

PropiedadProperty TipoType DescripciónDescription
idid stringstring Identificador único para un elemento de línea del carro.A unique identifier for a cart line item. Aplicado tras la creación correcta del carro.Applied upon successful creation of cart.
catalogItemIdcatalogItemId stringstring Identificador del elemento de catálogo.The catalog item identifier.
friendlyNamefriendlyName stringstring Opcional.Optional. Nombre descriptivo para el elemento definido por el asociado para ayudar a eliminar la ambigüedad.The friendly name for the item defined by the partner to help disambiguate.
quantityquantity intint El número de licencias o instancias.The number of licenses or instances.
currencyCodecurrencyCode stringstring Código de divisa.The currency code.
billingCyclebillingCycle ObjectObject El tipo de ciclo de facturación establecido para el período actual.The type of billing cycle set for the current period.
termDurationtermDuration stringstring Representación ISO 8601 de la duración del término.An ISO 8601 representation of the term's duration. Los valores admitidos actualmente son P1M (1 mes), P1Y (1 año) y P3Y (3 años).The current supported values are P1M (1 month), P1Y (1 year) and P3Y (3 years).
participantsparticipants Lista de pares de cadena de objetoList of Object String pairs Colección de PartnerId en el registro (MPNID) de la compra.A collection of PartnerId on Record (MPNID) on the purchase.
provisioningContextprovisioningContext Dictionary<String, String>Dictionary<string, string> Contexto adicional que se usa al aprovisionar el artículo adquirido.Additional context used when provisioning the purchased item. Para determinar qué valores son necesarios para un elemento determinado, consulte la propiedad provisioningVariables de la SKU.To determine which values are needed for a particular item, refer to the SKU's provisioningVariables property.
orderGrouporderGroup stringstring Un grupo para indicar qué elementos se pueden enviar juntos en el mismo orden.A group to indicate which items can be submitted together in the same order.
addonItemsaddonItems Lista de objetos CartLineItemList of CartLineItem objects Colección de elementos de línea del carro para los complementos.A collection of cart line items for addons. Estos elementos se adquirirán en la suscripción base resultante de la compra del artículo de la línea del carro raíz.These items will be purchased towards the base subscription that results from the root cart line item's purchase.
errorerror ObjectObject Se aplica después de crear el carro si se produce un error.Applied after cart is created if an error occurred.
NoticiasrenewsTo Matriz de objetosArray of objects Una matriz de renews en los recursos.An array of RenewsTo resources.

NoticiasRenewsTo

Representa un elemento contenido en un elemento de línea del carro.Represents one item contained in a cart line item.

PropiedadProperty TipoType ObligatorioRequired DescripciónDescription
termDurationtermDuration stringstring NoNo Representación ISO 8601 de la duración del período de renovación.An ISO 8601 representation of the renewal term's duration. Los valores admitidos actualmente son P1M (1 mes) y P1Y (1 año).The current supported values are P1M (1 month) and P1Y (1 year).

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte códigos de error del centro de Partners.For the full list, see Partner Center error codes.

CartErrorCartError

Representa un error que se produce después de crear un carro.Represents an error that occurs after a cart is created.

PropiedadProperty TipoType DescripciónDescription
errorCodeerrorCode Códigos de error del centro de PartnersPartner Center error codes El tipo de error del carro.The type of cart error.
errorDescriptionerrorDescription stringstring La descripción del error, incluidas las notas sobre los valores admitidos, los valores predeterminados o los límites.The error description, including any notes about supported values, default values, or limits.

CartCheckoutResultCartCheckoutResult

Representa el resultado de una desprotección del carro.Represents the result of a cart checkout.

PropiedadProperty TipoType DescripciónDescription
pedidosorders Lista de objetos de pedido .List of Order objects. La colección de pedidos.The collection of orders.
orderErrorsorderErrors Lista de objetos OrderError .List of OrderError objects. La colección de errores de orden.The collection of order errors.

OrderErrorOrderError

Representa un error que se produce durante la extracción del carro cuando se crea un pedido.Represents an error that occurs during a cart checkout when an order is created.

PropiedadProperty TipoType DescripciónDescription
orderGroupIdorderGroupId stringstring IDENTIFICADOR del grupo de pedidos del pedido con el error.The order group ID of the order with the error.
códigocode intint Código de error.The error code.
descriptiondescription stringstring Descripción del error.The description of the error.