Vytvořte soukromou nabídku nezávislého výrobce softwaru přímo pro zákazníka.
Pomocí této metody můžete vytvořit soukromou nabídku pro zákazníka přímo jako výrobce softwaru.
Žádost
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
Hlavička požadavku
| Hlavička | Typ | Popis |
|---|---|---|
| Autorizace | řetězec | 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.
Tělo žádosti
Zadejte podrobnosti o soukromé nabídce pomocí schématu ISV to Customer private offer. Musí obsahovat název.
Následující možnosti zrcadlí možnosti v Partnerském centru při vytváření privátní nabídky pro zákazníka. Možnosti jsou definovány hodnotami offerPricingType uvedenými zde:
| offerPricingType – hodnota | Ekvivalent možnosti vytvoření privátní nabídky v Partnerském centru |
|---|---|
| upravitCenovouNabídkuPouzeExistující | 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 transakčních nabídek: SaaS, Azure Virtual Machines a Aplikace Azure. Ceny partnerů si můžete přizpůsobit prostřednictvím absolutních cen nebo procentuálních slev. |
| saasNovéPřizpůsobenéPlány | Přizpůsobit ceny, množství měřicích jednotek a uživatelské limity pro SaaS nabídku - Použijte tuto možnost k vytvoření soukromé nabídky pro plán SaaS úpravou vaší absolutní partnerské ceny, množství měřicích jednotek a uživatelských limitů. |
| nové na míru přizpůsobené plány | Přizpůsobení plánů SaaS a profesionálních služeb – tato možnost slouží k přizpůsobení cen a podmínek pro produkty SaaS a profesionální služby. Kromě toho můžete přizpůsobit rozměry měření a limity uživatelů pro produkty SaaS. |
| vmSoftwareReservations | Přizpůsobte ceny a konkrétní množství pro nabídky rezervací softwaru pro virtuální počítače - Pomocí této možnosti můžete vytvořit vícestrannou soukromou nabídku k prodeji rezervací softwaru pro virtuální počítače (na 1 rok nebo 3 roky) a přizpůsobit absolutní cenu pro partnera, velikost vCPU, množství, dobu trvání a rozvrh plateb. |
U předchozích tří možností cenového typu se požadavky na prostředky specifické pro konkrétní plán mohou lišit, podrobnosti najdete v následující tabulce.
| Název prostředku | upravitPouzeCenovouExistujiciNabídku | saasNovéIndividuálníPlány | nové přizpůsobené plány | novéPřizpůsobenéPlányVMSoftwareRezervace |
|---|---|---|---|---|
| cenový plán | Nastavte tuto hodnotu na ID veřejného plánu, který se má nakonfigurovat v těle požadavku. | Nelze použít | Nelze použít | Nelze použít |
| pricing.basePlan | Nelze použít | Nastavte tuto hodnotu na ID veřejného plánu, který má být nakonfigurován v těle požadavku. | Nastavte na ID veřejného plánu, který je třeba nakonfigurovat v těle požadavku. | Nastavte to na ID veřejného plánu, který je třeba nakonfigurovat v těle požadavku. |
| cena.podrobnostiNovéhoPlánu.jméno | Nelze použít | Nastavte ho na název nového plánu, který se zákazníkovi zobrazí v textu požadavku. | Nastavte ho na název nového plánu, který se zákazníkovi zobrazí v textu požadavku. | Na tělo požadavku se to nevztahuje, bude vygenerováno systémem a dostupné v odpovědi úlohy po jejím dokončení. |
| podrobnostiNovéhoPlánuCeny.popis | Nelze použít | Nastavte tento popis na popis, který se zobrazí zákazníkovi pro nový plán v textu požadavku. | Nastavte toto jako popis, který bude zákazníkovi zobrazen pro nový plán v těle žádosti. | Na tělo požadavku se nevztahuje, bude vygenerováno systémem a dostupné v odpovědi úlohy po jejím dokončení. |
| hodnota obnovení zákaznické smlouvy | Popis |
|---|---|
| pravda | Soukromá nabídka je prodloužení stávající smlouvy se zákazníkem. Na vaši soukromou nabídku pro obnovení smlouvy zákazníků platí 50% sleva z poplatku za agenturu. |
| nepravda | Soukromá nabídka není prodloužením stávající zákaznické smlouvy. Platí váš standardní poplatek za agenturu. |
Ukázky těla požadavku
Ukázkový příklad těla požadavku s využitím strategie slevového stanovení cen pro úpravu cen pouze pro stávající veřejný tarif.
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2024-09-30",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "editExistingOfferPricingOnly",
"customerContractRenewal": false,
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA ",
"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/34771906-9711-4196-9f60-4af380fd5042", "plan":"plan/123456","discountType": "percentage", "discountPercentage": 5 }
]
}
]
}
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ých na procentech používáte absolutní ceny:
- Vytvoření nového prostředku nad prostředkem privátní nabídky, který definuje absolutní ceny
- Tento nově vytvořený prostředek zahrňte 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 soukromou 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 zdroje
{
"$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",
"offerPricingType": "editExistingOfferPricingOnly",
"plan": "plan/987654",
"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 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
Příklad absolutního cenového zdroje pro nabídku SaaS s paušální sazbou, který přizpůsobuje cenu a množství měřidel.
{
"$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ázkový cenový zdroj pro nabídku SaaS s účtováním za uživatele, která přizpůsobuje 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/2024-09-30",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "saasNewCustomizedPlans",
"customerContractRenewal": false,
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA",
"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"
}
]
}
]
}
Ukázkový text požadavku, který zahrnuje profesionální službu i plán SaaS s vlastními cenami
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
// Pricing details for professional service product with custom flat rate
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2024-03-01-preview1",
"resourceName": "cmPricing",
"product": "product/c4a46f0a-9552-47cb-b15b-c5bf23a85aac",
"plan": "plan/c4a46f0a-9552-47cb-b15b-c5bf23a85aac/24b93378-fa94-4656-813a-2eef6fd83341",
"offerPricingType": "newCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "flatRate",
"priceInputOption": "usd",
"prices": [{
"contractDuration": {
"type": "month",
"value": 1
},
"billingFrequency": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 2
}
]
}
}
},
// Pricing details for SaaS product with custom flat rate and custom meters
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2024-03-01-preview1",
"resourceName": "cmPricing1",
"product": "product/ea95b54f-2989-4a89-9913-f64503b100d7",
"plan": "plan/ea95b54f-2989-4a89-9913-f64503b100d7/21915afa-0663-460f-8566-06f8958efaaf",
"offerPricingType": "newCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "flatRate",
"priceInputOption": "usd",
"prices": [{
"contractDuration": {
"type": "month",
"value": 1
},
"billingFrequency": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 3.5
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"id003": {
"includedQuantities": [{
"billingTerm": {
"type": "month",
"value": 1
},
"isInfinite": false,
"quantity": 10.0
}
],
"pricePerPaymentInUsd": 1
},
"id001": {
"includedQuantities": [{
"billingTerm": {
"type": "month",
"value": 1
},
"isInfinite": false,
"quantity": 10.0
}
],
"pricePerPaymentInUsd": 1
},
"id002": {
"includedQuantities": [{
"billingTerm": {
"type": "month",
"value": 1
},
"isInfinite": false,
"quantity": 10.0
}
],
"pricePerPaymentInUsd": 1
}
}
}
}
},
// Private offer details
{
"resourceName": "privateoffer",
"name": "private_offer_for_customer_xyz",
"privateOfferType": "customerPromotion",
"variableStartDate": true,
"offerPricingType": "newCustomizedPlans",
"end": "2025-02-28",
"acceptBy": "2025-02-17",
"preparedBy": "example@outlook.com",
"notificationContacts": [],
"state": "live",
"beneficiaries": [{
"id": "7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31",
"description": ""
}
],
"pricing": [
// Pricing details for the Professional Service
{
"product": "product/ea95b54f-2989-4a89-9913-f64503b100d7",
"discountType": "absolute",
"priceDetails": {
"resourceName": "cmPricing1"
},
"basePlan": "plan/ea95b54f-2989-4a89-9913-f64503b100d7/21915afa-0663-460f-8566-06f8958efaaf",
"newPlanDetails": {
"name": "custom_saas",
"description": "customized saas plan for customer xyz"
}
},
// Pricing details for the SaaS offer
{
"product": "product/c4a46f0a-9552-47cb-b15b-c5bf23a85aac",
"discountType": "absolute",
"priceDetails": {
"resourceName": "cmPricing"
},
"basePlan": "plan/c4a46f0a-9552-47cb-b15b-c5bf23a85aac/24b93378-fa94-4656-813a-2eef6fd83341",
"newPlanDetails": {
"name": "custom_professional_service",
"description": "customized professional service plan for customer xyz"
}
}
],
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2024-09-30"
}
]
}
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ázkový zdroj absolutního cenování pro nabídku VM, která přizpůsobuje cenu 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/2024-09-30",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "vmSoftwareReservations",
"customerContractRenewal": false,
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA",
"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"
]
}
]
}
Odpověď
Odpověď obsahuje ID úlohy, kterou můžete později použít k dotazování stavu:
{
"$schema": "https://schema.mp.microsoft.com/schema/configure-status/2023-07-15",
"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
- Správa existujících privátních nabídek
- Stav úlohy a API pro načtení detailů soukromé nabídky
- Řešení potíží a další zdroje informací