Vytvoření vícedílné privátní nabídky pro zákazníka
Poskytovatel softwaru (původce) a spolupracovní partner (prodejce) by měli použít stejnou sadu volání rozhraní API k vytvoření privátní nabídky pro zákazníka. Tady je očekávaný tok.
- IsV vytvoří nabídku a odešle se k prodeji viditelnosti partnera.
- Výrobce softwaru oznámí prodejnímu partnerovi (prostřednictvím e-mailu nebo jiným způsobům), že nabídka je nyní k dispozici pro prodejní úpravy partnerů.
- Prodej recenzí partnerů a dokončení konfigurace privátní nabídky a odeslání k viditelnosti koncových zákazníků
Tady je metoda volání pro vytvoření nabídky.
Žádost
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
Hlavička požadavku
| Hlavička | Typ | Popis |
|---|---|---|
| Autorizace | String | Povinný: Přístupový token Microsoft Entra ve formuláři Bearer <token>. |
Volitelné: CLIENTID
Parametry požadavku
$version – povinné. Toto je verze schématu, které se používá v požadavku.
Text požadavku
Následující možnosti zrcadlí možnosti v Partnerském centru při vytváření vícedílné soukromé nabídky pro zákazníka. Tyto možnosti jsou definovány následujícími hodnotami offerPricingType :
| offerPricingType – hodnota | Ekvivalent možnosti vytvoření privátní nabídky v Partnerském centru |
|---|---|
| editExistingOfferPricingOnly | Přizpůsobte si ceny stávajících veřejných nabídek a plánů – Pomocí této možnosti můžete vytvořit soukromou nabídku pro všechny typy transakcí: SaaS, Azure Virtual Machines a Aplikace Azure lications. Ceny partnerů si můžete přizpůsobit prostřednictvím absolutních cen nebo procentuálních slev. |
| saasNewCustomizedPlans | Přizpůsobení cen, množství měřičů a uživatelských limitů pro nabídku SaaS – Pomocí této možnosti můžete vytvořit soukromou nabídku pro plán SaaS přizpůsobením absolutní ceny partnera, měřením množství dimenzí a uživatelských limitů. |
| vmSoftwareReservations | Přizpůsobte ceny a konkrétní množství nabídek rezervací softwaru virtuálních počítačů – pomocí této možnosti můžete vytvořit vícedílnou soukromou nabídku pro prodej rezervací softwaru virtuálních počítačů (1 rok nebo 3 roky) a přizpůsobit absolutní cenu partnera, velikost vCPU, množství, dobu trvání a platební plán. |
U předchozích tří možností cenového typu se mohou požadavky na prostředky specifické pro konkrétní plán lišit. Podrobnosti najdete v následující tabulce:
| Název prostředku | editExistingOfferPricingOnly | saasNewCustomizedPlans | vmSoftwareReservations |
|---|---|---|---|
| stanovení cen. Plán | Nastavte na ID plánu veřejného plánu, který se má nakonfigurovat v textu požadavku. | Nelze použít | Nelze použít |
| pricing.basePlan | Nelze použít | Nastavte na ID plánu veřejného plánu, který se má nakonfigurovat v textu požadavku. | Nastavte na ID plánu veřejného plánu, který se má nakonfigurovat v textu požadavku. |
| pricing.newPlanDetails.name | Nelze použít | Nastavte ho na název nového plánu, který se zákazníkovi zobrazí v textu požadavku. | Na text požadavku se nevztahuje, systém se vygeneruje a bude k dispozici v odpovědi úlohy po dokončení. |
| pricing.newPlanDetails.description | Nelze použít | Nastavte tento popis na popis, který se zobrazí zákazníkovi pro nový plán v textu požadavku. | Na text požadavku se nevztahuje, systém se vygeneruje a bude k dispozici v odpovědi úlohy po dokončení. |
Text požadavku se liší v závislosti na roli volajícího. Použijte privateOfferType k rozlišení volajícího nezávislých výrobců softwaru od prodejce volajícího partnera.
| Role volajícího | privateOfferType – hodnota |
|---|---|
| ISV (původce) | multipartyPromotionOriginator |
| Prodejní partner (prodejce) | multipartyPromotionChannelPartner |
Ukázky textu požadavku
Ukázkový text žádosti od nezávislých výrobců softwaru k vytvoření nabídky s využitím cen slevy k přizpůsobení cen pouze pro stávající veřejný plán
Poskytovatel softwaru (původce) je nutný k poskytnutí všech základních podrobností nabídky. Musí obsahovat název.
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"resourceName": "privateOffer",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "multipartyPromotionOriginator",
"offerPricingType": "editExistingOfferPricingOnly",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"termsAndConditionsDocs": [
{
"sasUrl": "https://promotionpmeprod.blob.core.windows.net/promotionsblobdata/44c2b38a-fa64-4861-806c-6c486ec19b6d-769f3960-45af-42db-ab3b-6391841683d6",
"fileName": "Test1.pdf",
"customerFacingDocumentName": "Test1 T&C"
} ],
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"partners": [
{
"id": "12345678",
"partnerName": "Market Place Test",
"location": "United States"
}
],
"pricing": [
{ "product": "product/34771906-9711-4196-9f60-4af380fd5042", "plan":"plan/123456","discountType": "percentage", "discountPercentage": 5 }
],
"notes": "ISV 123"
}
]
}
Ukázkový text požadavku s využitím absolutních cen pro přizpůsobení cen pouze pro stávající veřejný plán
Pokud místo slev založené na procentech používáte absolutní ceny, můžete vytvořit nový prostředek nad prostředkem vícedílné privátní nabídky, který definuje absolutní ceny, a pak tento nově vytvořený prostředek zahrnout jako jiný objekt do seznamu prostředků schématu konfigurace.
Tuto metodu použijte k získání cenového prostředku pro váš stávající veřejný plán, úpravě cen a následnému použití upraveného prostředku pro vaši nabídku.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Ukázka absolutního cenového prostředku
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newSimpleAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/987654",
"offerPricingType": "editExistingOfferPricingOnly",
"pricing": {
"recurrentPrice": {
"priceInputOption": "usd",
"prices": [
{
"pricePerPaymentInUsd": 1,
"billingTerm": {
"type": "month",
"value": 1
}
},
{
"pricePerPaymentInUsd": 2,
"paymentOption": {
"type": "month",
"value": 1
},
"billingTerm": {
"type": "year",
"value": 1
}
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"meter1": {
"pricePerPaymentInUsd": 1
}
}
}
}
}
Zahrnout tento prostředek jako objekt do cenového modulu
[
{
"product": "product/34771906-9711-4196-9f60-4af380fd5042",
"plan": "plan/123456",
"discountType": "percentage",
"discountPercentage": 5
},
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/987654",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newSimpleAbsolutePricing"
}
}
]
Ukázkový text požadavku s využitím absolutních cen pro přizpůsobení cen, měření a uživatelských limitů pro nabídku SaaS
Pomocí následující metody vytvořte absolutní cenu a prostředek dostupnosti pro privátní nabídku.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Ukázka absolutního cenového prostředku pro nabídku SaaS s plochou sazbou, která přizpůsobí množství cen a měřičů
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"resourceName": "newSaaSPlanAbsolutePricing",
"plan": "plan/123456",
"offerPricingType": "saasNewCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "flatRate",
"priceInputOption": "usd",
"prices": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.1
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.12
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"meter1": {
"includedQuantities": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"quantity": 10.0,
"isInfinite": false
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"quantity": 15.0,
"isInfinite": false
}
]
},
"meter2": {
"includedQuantities": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"isInfinite": true
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"isInfinite": true
}
]
}
}
}
}
}
Ukázka absolutního cenového prostředku pro nabídku SaaS pro jednotlivé uživatele, která přizpůsobí ceny a limity uživatelů
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newSaaSPlanAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/123456",
"offerPricingType": "saasNewCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "perUser",
"priceInputOption": "usd",
"userLimits": {
"min": 20,
"max": 100
},
"prices": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.01
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"paymentOption": {
"type": "year",
"value": 1
},
"pricePerPaymentInUsd": 0.02
}
]
}
}
}
Zahrnout tento prostředek jako objekt do cenového modulu
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "multipartyPromotionOriginator",
"offerPricingType": "newSimpleAbsolutePricing",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"partners": [
{
"id": "12345678",
"partnerName": "Market Place Test",
"location": "United States"
}
],
"termsAndConditionsDocs": [
{
"sasUrl": "https://promotionpmeprod.blob.core.windows.net/promotionsblobdata/44c2b38a-fa64-4861-806c-6c486ec19b6d-769f3960-45af-42db-ab3b-6391841683d6",
"fileName": "Test1.pdf",
"customerFacingDocumentName": "Test1 T&C"
} ],
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newSaaSPlanAbsolutePricing"
}
"basePlan": "plan/123456",
"newPlanDetails": {
"name": "newPlanName",
"description": "newPlanDescription"
}
],
"notes": "ISV 123"
}
]
}
Ukázkový text požadavku s využitím absolutních cen pro přizpůsobení cen a konkrétních množství nabídek rezervací softwaru virtuálních počítačů
Pomocí následující metody vytvořte pro nabídku absolutní cenu a prostředek dostupnosti.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
Ukázka absolutního cenového prostředku pro nabídku virtuálních počítačů, která přizpůsobí ceny a množství
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newVMSRAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"offerPricingType": "vmSoftwareReservations",
"plan": "plan/987654",
"softwareReservation": {
"reservationDuration": {
"type": "year",
"value": 1
},
"paymentSchedule": {
"type": "year",
"value": 1
},
"vmPrices": {
"36Core": {
"quantity": 4.0,
"unitPricePerPaymentPeriodInUsd": 0.04
}
}
}
}
Zahrnout tento prostředek jako objekt do cenového modulu
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "multipartyPromotionOriginator",
"offerPricingType": "vmSoftwareReservations",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"partners": [
{
"id": "12345678",
"partnerName": "Market Place Test",
"location": "United States"
}
],
"termsAndConditionsDocs": [
{
"sasUrl": "https://promotionpmeprod.blob.core.windows.net/promotionsblobdata/44c2b38a-fa64-4861-806c-6c486ec19b6d-769f3960-45af-42db-ab3b-6391841683d6",
"fileName": "Test1.pdf",
"customerFacingDocumentName": "Test1 T&C"
} ],
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newVMSRAbsolutePricing"
}
"basePlan": "plan/987654"
],
"notes": "ISV 123"
}
]
}
Ukázková žádost partnera k dokončení vytvoření nabídky
Prodejní partner by měl použít ID vícedílné soukromé nabídky poskytované isV ke konfiguraci % úprav zákazníka (přirážky), prodeje vlastních smluv s partnerem, připravených a prodejních kontaktů partnera.
Následující příklad vychází z textu odpovědi vráceného při načítání podrobností nabídky pomocí ID nabídky.
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"resourceName": "privateOffer",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "multipartyPromotionChannelPartner",
"offerPricingType": "editExistingOfferPricingOnly",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "tester@microsoft.com",
"originatorTermsAndConditionsDocs": [
{
"sasUrl": "https://promotionpmeprod.blob.core.windows.net/promotionsblobdata/44c2b38a-fa64-4861-806c-6c486ec19b6d-769f3960-45af-42db-ab3b-6391841683d6",
"fileName": "Test1.pdf",
"customerFacingDocumentName": "Test1 T&C"
} ],
"termsAndConditionsDocs": [
{
"sasUrl": "https://promotionpmeprod.blob.core.windows.net/promotionsblobdata/44c2b38a-fa64-4861-806c-6c486ec19b6d-769f3960-45af-42db-ab3b-6391841683d6",
"fileName": "Test1.pdf",
"customerFacingDocumentName": "Test1 T&C"
} ],
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"partners": [
{
"id": "12345678",
"partnerName": "Market Place Test",
"location": "United States"
}
],
"originatorPricing": [
{
"product": "product/34771906-9711-4196-9f60-4af380fd5042",
"plan":"plan/123456",
"discountType": "percentage",
"discountPercentage": 5
"markupPercentage": 1.0
}
],
"lastModified": "2023-01-19",
"eTag": "\"7f020249-0000-0800-0000-63c9b4ca0000\"",
}
]
}
Klíčové popisky v předchozím příkladu
- Prodejní partner musí poskytnout připravený atributBy .
- Vlastní podmínky a ujednání nezávislých výrobců softwaru jsou zobrazitelné, ale prodejce je nemůže upravit, jsou zachycené ve zdroji ZdrojeTermsAndConditionsDocs.
- Prodejce partnera může nahrát vlastní termín a podmínku v prostředku termsAndConditionsDocs .
- Prodejce partnera může přidat vlastní kontakty, které mají být upozorněny na nabídku v prostředku notificationContacts .
- Atributy Příjemce a Partneři jsou zobrazitelné, ale prodejce ho nemůže upravit.
- Cenový prostředek se zobrazí jako zdroj, vyžaduje se revizePercentage a musí ho při odesílání poskytnout prodejce, všechny ostatní atributy v cenovém prostředku jsou jen pro čtení.
Response
Odpověď obsahuje ID úlohy , kterou můžete později použít k dotazování stavu:
{
"$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
"jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
"jobStatus": "notStarted",
"jobResult": "pending",
"jobStart": "2021-12-21T21:29:54.9702903Z",
"jobEnd": "0001-01-01",
"errors": []
}
Kódy chyb
| Stavový kód HTTP | Popis |
|---|---|
| 401 | Chyba ověřování: Ujistěte se, že používáte platný přístupový token Microsoft Entra. |
| 400 | Ověřování schématu Ujistěte se, že text požadavku sleduje správné schéma a obsahuje všechna povinná pole. |
Související obsah
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro