Compartir a través de


Manage orders - Get Offer by ID

Recupera una oferta por su identificador de un asociado mediante información de país y configuración regional.

GET https://api.partnercenter.microsoft.com/v{version}/offers/{offer_id}
GET https://api.partnercenter.microsoft.com/v{version}/offers/{offer_id}?country={country}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
offer_id
path True

string

Identificador de la oferta.

version
path True

string

country
query

string

Información del país. Representación en dos letras del país

Encabezado de la solicitud

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.

Respuestas

Nombre Tipo Description
200 OK

Contracts.V1.Models.Offer

La solicitud se realizó correctamente. La información de ofertas del asociado solicitada se devuelve en el cuerpo de la respuesta.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definiciones

Nombre Description
Contracts.V1.Models.Enums.OfferProduct
Contracts.V1.Models.Offer
Contracts.V1.Models.OfferAttestationProperties
Contracts.V1.Models.OfferCategory
Contracts.V1.Models.OfferLinks
Link
ResourceAttributes
ResourceLinks
SupportedBillingCycles
SupportedCatalogTypes
System.Collections.Generic.KeyValuePair[System.String,System.String]

Contracts.V1.Models.Enums.OfferProduct

Nombre Tipo Description
id

string

name

string

type

string

unit

string

Contracts.V1.Models.Offer

Nombre Tipo Description
acquisitionType enum:
  • purchase
  • referral
actions

string[]

additionalProperties

object

attestationProperties

Contracts.V1.Models.OfferAttestationProperties

attributes

ResourceAttributes

billing enum:
  • license
  • none
  • usage
category

Contracts.V1.Models.OfferCategory

conversionTargetOffers

string[]

country

string

description

string

hasAddOns

boolean

id

string

isAddOn

boolean

isAutoRenewable

boolean

isAvailableForPurchase

boolean

isInternal

boolean

isMicrosoftProduct

boolean

isTrial

boolean

limit

integer

limitUnitOfMeasure

string

links

Contracts.V1.Models.OfferLinks

locale

string

maximumQuantity

integer

minimumQuantity

integer

name

string

orderService

string

prerequisiteOffers

string[]

product

Contracts.V1.Models.Enums.OfferProduct

providerId

string

providerLocationId

string

providerName

string

rank

integer

reselleeQualifications

string[]

resellerQualifications

string[]

salesGroupId

string

supportedBillingCycles

SupportedBillingCycles[]

supportedCatalogTypes

SupportedCatalogTypes[]

term

integer

termUnitOfMeasure

string

unitType

string

upgradeTargetOffers

string[]

uri

string

Contracts.V1.Models.OfferAttestationProperties

Nombre Tipo Description
attestationType

string

enforceAttestation

boolean

Contracts.V1.Models.OfferCategory

Nombre Tipo Description
attributes

ResourceAttributes

country

string

id

string

links

ResourceLinks

locale

string

name

string

rank

integer

Nombre Tipo Description
learnMore

Link

next

Link

previous

Link

self

Link

Nombre Tipo Description
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Nombre Tipo Description
etag

string

objectType

string

Nombre Tipo Description
next

Link

previous

Link

self

Link

SupportedBillingCycles

Nombre Tipo Description
annual

string

monthly

string

none

string

one_time

string

triennial

string

unknown

string

SupportedCatalogTypes

Nombre Tipo Description
live

string

sandbox

string

System.Collections.Generic.KeyValuePair[System.String,System.String]

Nombre Tipo Description
key

string

value

string