Sdílet prostřednictvím


Vytvoření přímé nabídky nezávislých výrobců softwaru pro zákazníky

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 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

Zadejte podrobnosti o privátní nabídce pomocí schématu privátní nabídky nezávislých výrobců softwaru pro zákazníka. 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é zde:

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 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 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í.
customerContractRenewal value Popis
true Soukromá nabídka je prodloužení stávající smlouvy se zákazníkem. Sleva za 50% poplatek za agenturu se vztahuje na vaši soukromou nabídku na prodloužení platnosti zákazníka.
false (nepravda) Soukromá nabídka není prodloužením stávající smlouvy se zákazníkem. Platí váš standardní poplatek za agenturu.

Ukázky textu požadavku

Ukázkový text požadavku s využitím cen slev pro přizpůsobení cen pouze pro stávající veřejný plán

{
 "$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 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",
    "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

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/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 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/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"
        ]
     }
  ]
}

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/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.