Vytvoření reference
Tento článek vysvětluje, jak vytvořit referenční seznam. Existují dva typy referenceType:
Nezávislé: Pokud je referenční seznam viditelný jednomu partnerovi.
Sdílené: Pokud je referenční seznam viditelný dvěma stranám, které spolupracují. Pokud například Microsoft a partner spolupracují na spoluprodeji, může být doporučení sdíleno mezi oběma stranami. Další informace najdete v části Vytvoření sdíleného referenčního seznamu.
Poznámka:
S využitím integrace rozhraní API není k dispozici způsobilost macC a funkce odpovídající zákazníkům.
Typy dohod
Existují tři typy příležitostí ke spoluprodeji (nebo nabídky nebo doporučení), které je možné vytvořit z Partnerského centra – soukromé, řízené partnery a nabídky spoluprodeje. Obvykle se uživatelům zobrazují tyto volby z uživatelského rozhraní Partnerského centra, ale při vytváření z rozhraní API existují určité další kroky, které je potřeba provést. V uživatelském rozhraní referenčních seznamů v Partnerském centru se při vytváření nové dohody zobrazí nápověda potřebná v části Microsoftu , kde se uživatelům zobrazí tyto volby.
- Soukromá dohoda: Rozhodnete se nesdílit dohodu s Microsoftem, vyberte Možnost Žádná pomoc a odpovězte na otázku "Ne", "Chcete sdílet dohodu s prodejci Microsoftu?".
- Vedoucí partner: Zvolíte možnost "Nepotřebujete pomoc", ale odpovíte na otázku "Ano", "Chcete sdílet dohodu s prodejci Microsoftu?".
- Spoluprodej: Rozhodnete se získat pomoc od Microsoftu a také odpovědět na otázku "Ano", "Chcete sdílet dohodu s prodejci Microsoftu?".
Požadavky
- Přihlašovací údaje, jak je popsáno v ověřování rozhraní Partner API. Tento scénář podporuje ověřování pomocí přihlašovacích údajů aplikace a uživatele.
Požadavek REST
Syntaxe požadavku
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://api.partner.microsoft.com/v1.0/engagements/referrals |
Záhlaví žádosti
- Další informace najdete v tématu Hlavičky REST partnerského rozhraní API.
Text požadavku
Tato tabulka popisuje vlastnosti referenčního seznamu v textu požadavku pro úplně nový referenční seznam.
| Vlastnost | Type | Popis |
|---|---|---|
| Name | string | Název referenčního seznamu. |
| ExternalReferenceID | string | Externí identifikátor referenčního seznamu. Například vlastní ID potenciálního zákazníka nebo příležitosti Dynamics 365. |
| Stav | ReferenceStatus | Výčet s hodnotami, které označují stav referenčního seznamu. |
| Dílčí statistiky | ReferenceSubstatus | Výčet s hodnotami, které označují dílčí stav referenčního seznamu. |
| StatusReason | string | Popisná zpráva o stavu Vysvětlete například, proč došlo ke ztrátě referenčního seznamu. |
| ReferralType | ReferralType | Představuje typ referenčního seznamu. Povinný: |
| Kvalifikace | ReferenceQualification | Představuje kvalitu referenčního seznamu. |
| CustomerProfile | CustomerProfile | Kontaktní informace zákazníka. Povinný: |
| Souhlas | Souhlas | Příznaky souhlasu týkající se sdílení informací s jinými organizacemi a umožňují jim kontaktovat uživatele.Požadované. |
| Detaily | ReferenceDetails | Podrobnosti o zákaznících, poznámky, hodnota obchodu, datum uzavření měny. Povinný: |
| Tým | Člen | Představuje uživatele v organizacích, které jsou zapojeny do zapojení partnerů. |
| InviteContext | InviteContext | Představuje další informace, které může uživatel poskytnout při pozvání jiné organizace do zapojení partnera. |
| Cíl | ReferenceTarget | Představuje další informace, které může uživatel poskytnout při pozvání jiné organizace do zapojení partnera. |
| Role partnera | Vyžaduje se pouze pro referenční seznamy ke spoluprodeji služeb. | Může to být jedna z následujících hodnot : Presalesing, Solution design, Proof of concept, Business strategy, Deployment services, Adoption and Change Management, Transaction, Managed Services |
| Oblast řešení | Vyžaduje se pouze pro referenční seznamy ke spoluprodeji služeb. | Oblast řešení potřebná zákazníkem v příležitosti. Hodnoty najdete v následující tabulce. |
| Přehrávání řešení | Vyžaduje se pouze pro referenční seznamy ke spoluprodeji služeb. | Řešení potřebuje zákazníka v příležitosti. Hodnoty najdete v následující tabulce. |
Oblasti řešení a hodnoty přehrávání řešení
V následující tabulce jsou uvedeny hodnoty polí Oblast řešení a Hra řešení pro FY 24.
| Oblast řešení | Přehrávání řešení |
|---|---|
| Obchodní aplikace | Zrychlení inovací s využitím nízkého kódu |
| Obchodní aplikace | Zrychlení generování výnosů |
| Obchodní aplikace | Modernizace služby |
| Obchodní aplikace | Optimalizace finančního a dodavatelského řetězce |
| Obchodní aplikace | Obchodní operace smb scale |
| Data a AI | Power Business Decisions with Cloud Scale Analytics |
| Data a AI | Vytváření a modernizace aplikací AI |
| Digitální inovace a inovace aplikací | Migrace podnikových aplikací |
| Digitální inovace a inovace aplikací | Vytváření a modernizace aplikací AI |
| Digitální inovace a inovace aplikací | Zrychlení produktivity vývojářů |
| Digitální inovace a inovace aplikací | Zrychlení inovací s využitím integračních služeb |
| Infrastruktura | Migrace a zabezpečení Windows Serveru a SQL Serveru |
| Infrastruktura | Migrace SAP |
| Infrastruktura | Inovace s využitím prostředí HPC, infrastruktury AI |
| Infrastruktura | Migrace linuxových aktiv |
| Infrastruktura | Migrace Oraclu |
| Moderní práce | Pracovníci front-line |
| Moderní práce | Zkušenosti zaměstnanců |
| Moderní práce | Zabezpečení produktivity |
| Moderní práce | Sblížená komunikace |
| Moderní práce | Koncové body cloudu |
| Moderní práce | Modernizace pomocí zařízení Surface |
| Zabezpečení | Ochrana před hrozbami pomocí XDR a SIEM |
| Zabezpečení | Více cloudových zabezpečení |
| Zabezpečení | Zabezpečení dat |
| Zabezpečení | Zásady správného řízení dat |
| Zabezpečení | Moderní operace sec Ops |
| Zabezpečení | Zabezpečení identity a takeout Okta a Ping |
| Jednotná podpora | Vytvoření silného základu pomocí sjednocené architektury |
| Jednotná podpora | Podpora úspěchu cloudu s využitím vylepšených řešení |
Stavy přechodu stavu a dílčích stavů
| Stav | Povolený přechod stavu | Povolené dílčí statistiky |
|---|---|---|
| Nová | Nový, Aktivní, Uzavřeno | Čeká na vyřízení, přijato |
| Aktivní | Aktivní, uzavřeno | Přijato |
| Uzavřené | Uzavřené | Won, Lost, Declined, Expired |
Příklad požadavku
POST https://api.partner.microsoft.com/v1.0/engagements/referrals HTTP/1.1
Authorization: Bearer <token>
Host: api.partner.microsoft.com
Content-Type: application/json
{
"name": "Test Cosell Invite_20",
"status": "New",
"substatus": "Pending",
"statusReason": "Customer engagement was a success!",
"qualification": "SalesQualified",
"type": "Shared",
"target": [
{
"type": "SolutionProfile",
"id": "SOL-34104-EBB"
}
],
"customerProfile": {
"name": "Contoso Customer Inc",
"address": {
"addressLine1": "One Microsoft Way",
"addressLine2": "34",
"city": "Redmond",
"state": "WA",
"postalCode": "98052",
"country": "US"
},
"size": "10to50employees",
"team": [
{
"contactPreference": {
"locale": "en-us",
"disableNotifications": false
},
"firstName": "Sue",
"lastName": "Smith",
"phoneNumber": "1234567890",
"email": "sue.smith@contoso.com"
},
{
"contactPreference": {
"locale": "en-us",
"disableNotifications": false
},
"firstName": "Joe",
"lastName": "Hansen",
"phoneNumber": "4035698759",
"email": "joe.hansen@contoso.com"
}
],
"ids": []
},
"consent": {
"consentToToShareInfoWithOthers": true,
"consentToContact": true
},
"details": {
"notes": "Customer is looking to leverage Dynamics 365 to manage their supply chain. There's also a need to leverage a set of custom apps to enable their business processes.",
"dealValue": 50000,
"currency": "USD",
"closingDateTime": "2018-11-14T00:00:00Z",
"requirements": {
"industries": [
{
"id": "Manufacturing"
}
],
"products": [
{
"id": "Dynamics365Enterprise"
}
],
"services": [
{
"id": "DeploymentOrMigration"
}
],
"solutions": [
{
"name": "Dynamics 365 for Field Service",
"type": "Category",
"id": "Dynamics365forFieldService"
}
]
}
},
"team": [
{
"contactPreference": {
"locale": "en-us",
"disableNotifications": false
},
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "1231231234",
"email": "john.doe@microsoft.com"
}
],
"inviteContext": {
"notes": "Hi ABC Partner, hoping you can help this customer. Thanks, John @ Microsoft",
"invitedBy": {
"organizationId": "msft"
}
}
}
Odpověď REST
Pokud je tato metoda úspěšná, vrátí naplněný prostředek referenčního seznamu v textu odpovědi.
Kódy úspěšnosti a chyb odpovědi
Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.
Příklad odpovědi
{
"id": "4111fffc-f9ee-4d53-bba6-569135228642",
"engagementId": "37ef26aa-1d15-4533-9f93-a69bd33ab1e5",
"organizationId": "7d23e5ca-19dc-4eaa-aac8-5e6b559f0d1d",
"organizationName": "Contoso Company",
"name": "Test Cosell Invite_20",
"externalReferenceId": null,
"createdDateTime": "2019-02-23T02:05:23.2931817Z",
"updatedDateTime": "2019-02-23T02:05:23.2931817Z",
"expirationDateTime": null,
"status": "Active",
"substatus": "Accepted",
"statusReason": "Customer engagement was a success!",
"qualification": "SalesQualified",
"type": "Shared",
"eTag": "\"00006d10-0000-0000-0000-5c70aa630000\"",
"target": [
{
"type": "SolutionProfile",
"id": "SOL-34104-EBB"
}
],
"customerProfile": {
"name": "Contoso Customer Inc",
"address": {
"addressLine1": "One Microsoft Way",
"addressLine2": "34",
"city": "Redmond",
"state": "WA",
"postalCode": "98052",
"country": "US"
},
"size": "10to50employees",
"team": [
{
"contactPreference": {
"locale": "en-us",
"disableNotifications": false
},
"firstName": "Sue",
"lastName": "Smith",
"phoneNumber": "1234567890",
"email": "sue.smith@contoso.com"
},
{
"contactPreference": {
"locale": "en-us",
"disableNotifications": false
},
"firstName": "Joe",
"lastName": "Hansen",
"phoneNumber": "4035698759",
"email": "joe.hansen@contoso.com"
}
],
"ids": []
},
"consent": {
"consentToToShareInfoWithOthers": true,
"consentToContact": true
},
"details": {
"notes": "Customer is looking to leverage Dynamics 365 to manage their supply chain. There is also a need to leverage a set of custom apps to enable their business processes.",
"dealValue": 50000,
"currency": "USD",
"requirements": {
"industries": [
{
"id": "Manufacturing"
}
],
"products": [
{
"id": "Dynamics365Enterprise"
}
],
"services": [
{
"id": "DeploymentOrMigration"
}
],
"solutions": [
{
"name": "Dynamics 365 for Field Service",
"type": "Category",
"id": "Dynamics365forFieldService"
}
]
}
},
"team": [
{
"contactPreference": {
"locale": "en-us",
"disableNotifications": false
},
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "1231231234",
"email": "john.doe@microsoft.com"
}
],
"inviteContext": {
"notes": "Hi ABC Partner, hoping you can help this customer. Thanks, John @ Microsoft",
"invitedBy": {
"organizationId": "msft"
}
},
"links": {
"relatedReferrals": {
"uri": "https://api.partner.microsoft.com/v1.0/engagments/referrals?$filter=engagementId eq '37ef26aa-1d15-4533-9f93-a69bd33ab1e5'",
"method": "GET"
},
"self": {
"uri": "https://api.partner.microsoft.com/v1.0/engagments/referrals/4111fffc-f9ee-4d53-bba6-569135228642",
"method": "GET"
}
}
}
Upgrade z nabídky Private/Partner-led to Co-sell deal
Pokud chcete vytvořit dohodu o spoluprodeji prostřednictvím rozhraní API, musíte nejprve vytvořit soukromou dohodu nebo smlouvu pod vedením partnera a pak vytvořit druhé doporučení a připojit ho k prvnímu. Kroky jsou popsané v následující části.
Krok 1: Vytvoření obchodu řízeného partnerem, který je viditelný pro prodejce Microsoftu
Nejprve pomocí následující datové části žádosti vytvořte obchod s partnerem, který je pro prodejce Microsoftu viditelný.
POST https://api.partner.microsoft.com/v1.0/engagements/referrals
{
"name": "TEST Contoso Cosell Deal",
"externalReferenceId": "",
"campaignId": "",
"customerProfile": {
"isMatchingComplete": true,
"name": "Contoso Test Test",
"address": {
"addressLine1": "One Microsoft Way",
"addressLine2": "",
"city": "Redmond",
"state": "",
"region": "",
"country": "US"
},
"size": "",
"team": [
{
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "123345667",
"email": "john@doe.com",
"title": "",
"phoneValidationStatus": "None",
"emailValidationStatus": "None",
"contactPreference": {
"disableNotifications": true
}
}
],
"ids": [
{
"profileType": "external",
"id": "9-XIPFFGUQI"
}
],
"type": ""
},
"consent": {
"ConsentToToShareInfoWithOthers": true,
"ConsentToContact": true,
"ConsentToMicrosoftToContactSpecificPartners": true,
"consentToShareReferralWithMicrosoftSellers": true
},
"details": {
"dealValue": 100000,
"currency": "USD",
"closingDateTime": "2024-11-23T18:30:00.000Z",
"notes": "",
"requirements": {
"solutions": [
{
"type": "Name",
"id": "SOL-8163-XCJ",
"name": "Contoso Solution",
"publisherName": "Contoso-ISV",
"price": null,
"currency": null,
"quantity": null,
"solutionType": "3P"
}
],
"additionalRequirements": {
"iot": {},
"attributes": [
{
"id": "HaveNotDecided",
"type": "CustomerMarketplaceIntent"
}
]
}
}
},
"team": [
{
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "12345667",
"email": "john@doe.com",
"title": "",
"phoneValidationStatus": "None",
"emailValidationStatus": "None"
}
],
"type": "Shared",
"qualification": "SalesQualified",
"attributes": {
"objectType": "Referral"
},
"target": [],
"mpnId": "<ENTER PARTNER_MPN_ID>",
"trackingInfo": {}
}
Krok 2: Vytvoření referenčního seznamu Microsoftu pomocí podrobností o referenčním seznamu partnerů
Pak vytvořte referenční seznam Microsoftu prostřednictvím jiného volání rozhraní API a propojte ho s referenčním seznamem partnera pomocí pole ID rezervace vrácené z kroku 1.
POST https://api.partner.microsoft.com/v1.0/engagements/referrals
{
"engagementId": "<ENTER_ENGAGEMENT_ID_OF_PARTNER_REFERRAL>",
"organizationId": "msft",
"organizationName": "Microsoft",
"name": "TEST Contoso Cosell Deal",
"customerProfile": {
"name": "Contoso Test Test",
"size": "",
"isMatchingComplete": true,
"isMaccEligible": null,
"address": {
"addressLine1": "One Microsoft Way",
"addressLine2": "",
"city": "Redmond",
"state": "",
"postalCode": null,
"country": "US",
"region": ""
},
"team": [
{
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "123345667",
"email": "john@doe.com",
"title": "",
"emailValidationStatus": "None",
"phoneValidationStatus": "None",
"linkedInProfileUrl": null,
"contactPreference": {
"disableNotifications": true
}
}
],
"ids": [
{
"profileType": "External",
"id": "9-XIPFFGUQI"
}
],
"activities": null
},
"consent": {
"consentToToShareInfoWithOthers": true,
"consentToContact": true,
"consentToShareReferralWithMicrosoftSellers": true
},
"details": {
"notes": "Test notes to Microsoft.",
"dealValue": 100000,
"currency": "USD",
"closingDateTime": "2024-11-23T18:30:00Z",
"requirements": {
"solutions": [],
"additionalRequirements": {
"iot": {},
"attributes": []
}
}
},
"team": [],
"inviteContext": {
"notes": "Proof of concept / Demo , Test notes to Microsoft.",
"invitedBy": {
"organizationId": "<PARTNER_ORGANIZATION_ID (ACCOUNT_ID GUID)>",
"organizationName": "<INVITING_PARTNERS_ORGANIZATION_NAME>"
},
"assistanceRequestCode": "ProofOfConceptOrDemo"
},
"type": "Shared",
"qualification": "SalesQualified",
"attributes": {
"objectType": "Referral"
},
"target": [],
"dealSensitivity": "None",
"trackingInfo": {}
}
Vytvoření sdíleného referenčního seznamu
Existují dva kroky k vytvoření referenčního seznamu sdílenéhotypu referenčního seznamu:
- Vytvoření sdíleného referenčního seznamu
- Vytvoření připojeného referenčního seznamu pro druhou stranu
Následující vývojový diagram znázorňuje tyto dva kroky při vytváření sdíleného referenčního seznamu.
Vytvoření referenčního seznamu
- Vytvořte referenční seznam s typem referenčního seznamu nastaveným na sdílený.
- Zkopírujte ID rezervace z odpovědi pro vrácení.
ReferenceTarget – ukázka referenčního seznamu
"target": [
{
"type": "SolutionProfile",
"id": "SOL-ABC-DEF"
}
]
Vytvoření připojeného referenčního seznamu
- Vytvořte pro Microsoft další referenční seznam.
- Zahrňte id enagementu z referenčního seznamu, aby byly svázané dohromady.
Ukázka referenceTarget pro referenční seznamy Microsoftu
"target": [
{
"type": "BusinessProfileLocation",
"id": "msft"
}
]
Další kroky
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