Sdílet prostřednictvím


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:

  1. Vytvoření nového prostředku nad prostředkem privátní nabídky, který definuje absolutní ceny
  2. 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.