Javaslat létrehozása

Ez a cikk bemutatja, hogyan hozhat létre ajánlást.

Előfeltételek

• Hitelesítő adatok a Referrals API-hitelesítés leírtak szerint. Ez a forgatókönyv támogatja az App+Felhasználói hitelesítő adatokkal való hitelesítést.

REST-kérelem

Kérés szintaxisa

Metódus	Kérés URI-ja
POSTA	https://api.partner.microsoft.com/v1.0/engagements/referrals

Kérésfejlécek

• További információ: Partner API REST-fejlécek.

Kérelem törzse

Ez a táblázat ismerteti a vadonatúj ajánlás kérés törzsének ajánlási tulajdonságait.

Ingatlan	Típus	Leírás
Név	húr	Az ajánlás neve.
KülsőReferenciaID	húr	A hivatkozás külső azonosítója. Például a saját Dynamics 365-ös érdeklődő azonosítója vagy lehetőség azonosítója.
Állapot	ReferralStatus	Egy Enum az ajánlás állapotát jelző értékekkel.
Alállapotok	ReferralSubstatus	Az Enum, amely értékeket tartalmaz, amelyek az átirányítási alállapotot jelzik.
Állapot oka	húr	Egy leíró üzenet az állapotról. Például magyarázza el, hogy miért veszett el az ajánlás.
Ajánlástípus	Ajánlástípus	A javaslat típusát jelöli. Szükséges.
Minősítés	Ajánlási Kvalifikáció	A javaslat minőségét jelöli.
Ügyfélprofil	Ügyfélprofil	Ügyfél kapcsolattartási adatai. Szükséges.
Hozzájárulás	Beleegyezés	A hozzájárulás jelzői az információk más szervezetekkel való megosztásával és a felhasználókkal való kapcsolatfelvétel engedélyezésével kapcsolatosak.Szükséges.
Részletek	UtalásiRészletek	Ügyféladatok, jegyzetek, ügyletérték, pénznem záró dátuma. Szükséges.
Csoport	Tag	A partnerkapcsolatban részt vevő szervezetek felhasználóit jelöli.
MeghívásiKontextus	MeghívásiKontextus	További információk, amelyeket a felhasználó megadhat, amikor más szervezetet hív meg a partneri együttműködésbe.
Cél	ReferralTarget	További információk, amelyeket a felhasználó megadhat, amikor más szervezetet hív meg a partneri együttműködésbe.
Partneri szerepkör	PartnerRole	Kizárólag szolgáltatások közös értékesítési ajánlásaihoz szükséges
Megoldásterület	Megoldásterület	Az ügyfél igényének megoldási területe a lehetőségek kontextusában. Kizárólag szolgáltatások közös értékesítési ajánlásaihoz szükséges
Megoldás lejátszása	SolutionPlay	Az ügyfél igényének megoldási játéka a lehetőségben. Kizárólag szolgáltatások közös értékesítési ajánlásaihoz szükséges

Példa kérése

Fontos

Ez a mintakérés bemutatja, hogyan hozhat létre privát javaslatot, minimális információval. Figyelje meg, hogy az ajánlás privát ügyletté alakításának legfontosabb paramétere a <em>consentToShareReferralWithMicrosoftSellers</em>.

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": "Contoso Test Deal - [Private]",
	"qualification": "SalesQualified",
	"type": "Independent",
	"customerProfile": {
		"name": "Contoso Customer Inc",
		"address": {
			"addressLine1": "One Microsoft Way",
			"addressLine2": "34",
			"city": "Redmond",
			"state": "WA",
			"postalCode": "98052",
			"country": "US"
		},
		"size": "10to50employees",
		"team": [
			{
				"firstName": "Sue",
				"lastName": "Smith",
				"phoneNumber": "1234567890",
				"email": "sue.smith@contosocustomer.com"
			}
		],
		"ids":[
			{
				"profileType":"moodys",
				"id":"IN0011234567"
			}
		]
	},
	"consent": {
		"ConsentToToShareInfoWithOthers": true,
		"ConsentToContact": true,
		"ConsentToMicrosoftToContactSpecificPartners": true,
		"consentToShareReferralWithMicrosoftSellers": false
	},
	"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": "2024-11-14T00:00:00Z",
		"requirements": {
			"solutions": [
				{
					"type": "Name",
					"id": "SOL-15974-MQF",
					"name": "Contoso-Ale_Test",
					"publisherName": "Contoso_Test",
					"solutionType": "3P"
				}
			],
			"additionalRequirements": {
				"iot": {},
				"attributes": [
					{
						"id": "HaveNotDecided",
						"type": "CustomerMarketplaceIntent"
					}
				]
			}
		}
	},
	"team": [
		{
			"firstName": "John",
			"lastName": "Doe",
			"phoneNumber": "1231231234",
			"email": "john.doe@contoso.com"
		}
	],
	"target": [],
	"mpnId": "<ENTER PARTNER_ID>"
}

REST-válasz

Ha sikeres, ez a metódus a válasz törzsében lévő kitöltött Ajánlási erőforrást adja vissza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikerességet vagy a hibát, valamint további hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok résznél találja.

Példa válaszra

{
	"id": "4eb82669-ccf8-4856-86fc-b9ffe116376b",
	"engagementId": "6d72b13d-8584-4bba-a642-6800b8e32330",
	"name": "Contoso Test Deal - [Private]",
	"organizationId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
	"organizationName": "Contoso Pvt Ltd",
	"lastModifiedVia": "4990cffe-04e8-4e8b-808a-1175604b879f",
	"target": [],
	"createdDateTime": "2024-07-27T14:57:00.0952954Z",
	"updatedDateTime": "2024-07-27T14:57:00.0952954Z",
	"status": "Active",
	"substatus": "Accepted",
	"qualification": "SalesQualified",
	"type": "Independent",
	"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@contosocustomer.com",
				"emailValidationStatus": "None",
				"phoneValidationStatus": "None"
			}
		],
		"ids": [
			{
				"profileType":"moodys",
				"id":"IN0011234567"
			}
		],
		"isMatchingComplete": false
	},
	"consent": {
		"consentToToShareInfoWithOthers": true,
		"consentToContact": true,
		"ConsentToMicrosoftToContactSpecificPartners": true,
		"consentToShareReferralWithMicrosoftSellers": false
	},
	"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.0,
		"currency": "USD",
		"closingDateTime": "2024-11-14T00:00:00Z",
		"requirements": {
			"industries": [],
			"products": [],
			"services": [],
			"solutions": [
				{
					"name": "Contoso-Ale_Test",
					"type": "Name",
					"publisherName": "Contoso_Test",
					"solutionType": "3P",
					"id": "SOL-15974-MQF"
				}
			],
			"additionalRequirements": {
				"iot": {
					"azureCertifiedDevice": false,
					"attachServices": false
				},
				"attributes": [
					{
						"type": "CustomerMarketplaceIntent",
						"id": "HaveNotDecided"
					}
				]
			}
		}
	},
	"team": [
		{
			"contactPreference": {
				"locale": "en-us",
				"disableNotifications": false
			},
			"firstName": "John",
			"lastName": "Doe",
			"phoneNumber": "1231231234",
			"email": "john.doe@contoso.com",
			"emailValidationStatus": "None",
			"phoneValidationStatus": "None"
		}
	],
	"inviteContext": {
		"invitedBy": {
			"organizationId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
			"organizationName": "Contoso Pvt Ltd"
		},
		"assistanceRequestCode": "Unknown",
		"invitedMpnId": "<PARTNER_ID>"
	},
	"favorite": false,
	"trackingInfo": {},
	"direction": "Outgoing",
	"mpnId": "<PARTNER_ID>",
	"dealSensitivity": "None",
	"createdVia": "4990cffe-04e8-4e8b-808a-1175604b879f",
	"acceptedDateTime": "2024-07-27T14:56:59.2938209Z",
	"registrationStatus": "None",
	"links": {
		"relatedReferrals": {
			"uri": "https://api.partner.microsoft.com/v1.0/engagments/referrals?$filter=engagementId eq '6d72b13d-8584-4bba-a642-6800b8e32330'",
			"method": "GET"
		},
		"self": {
			"uri": "https://api.partner.microsoft.com/v1.0/engagments/referrals/4eb82669-ccf8-4856-86fc-b9ffe116376b",
			"method": "GET"
		}
	}
}

Együttes értékesítési ügylet vagy megosztott javaslat létrehozása

Két lépésből áll egy megosztott átirányítási típusú együttes értékesítési ügylet vagy javaslat létrehozása:

1. Olyan partner által vezetett ügylet létrehozása, amely láthatóvá válik a Microsoft értékesítői számára
2. Microsoft-ajánlás létrehozása partneri ajánlás részleteivel

Az alábbi folyamatábra a megosztott javaslat létrehozásának két lépését mutatja be.

Az API-n keresztül összekapcsolt két ajánlással rendelkező megosztott ajánlást bemutató folyamatábra.

1. lépés: Partner által vezetett ügylet létrehozása látható a Microsoft értékesítői számára

Először hozzon létre egy partner által vezetett ügyletet, amely látható a Microsoft értékesítői számára az alábbi kéréscsomaggal.

Fontos

Vegye figyelembe, hogy egy partner által vezetett javaslat létrehozásához a consentToShareReferralWithMicrosoftSellers igazként van megadva. Az aktív privát ajánlás egyszerűen partner által vezetetté alakítható, csak frissíteni kell az ajánlást ebben a mezőben.

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": "Contoso Test Deal - [PartnerLed]",
	"qualification": "SalesQualified",
	"type": "Shared",
	"customerProfile": {
		"name": "Contoso Customer Inc",
		"address": {
			"addressLine1": "One Microsoft Way",
			"addressLine2": "34",
			"city": "Redmond",
			"state": "WA",
			"postalCode": "98052",
			"country": "US"
		},
		"size": "10to50employees",
		"team": [
			{
				"firstName": "Sue",
				"lastName": "Smith",
				"phoneNumber": "1234567890",
				"email": "sue.smith@contosocustomer.com"
			}
		]
	},
	"consent": {
		"ConsentToToShareInfoWithOthers": true,
		"ConsentToContact": true,
		"ConsentToMicrosoftToContactSpecificPartners": true,
		"consentToShareReferralWithMicrosoftSellers": 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": "2024-11-14T00:00:00Z",
		"requirements": {
			"solutions": [
				{
					"type": "Name",
					"id": "SOL-15974-MQF",
					"name": "Contoso-Ale_Test",
					"publisherName": "Contoso_Test",
					"solutionType": "3P"
				}
			],
			"additionalRequirements": {
				"iot": {},
				"attributes": [
					{
						"id": "HaveNotDecided",
						"type": "CustomerMarketplaceIntent"
					}
				]
			}
		}
	},
	"team": [
		{
			"firstName": "John",
			"lastName": "Doe",
			"phoneNumber": "1231231234",
			"email": "john.doe@contoso.com"
		}
	],
	"target": [],
	"mpnId": "<ENTER PARTNER_ID>"
}

ReferralTarget olyan további információkat jelöl, amelyet a partner adhat meg, amikor más szervezeteket hív meg az előjegyzésbe. Ha egy hivatkozás során meg szeretné adni a "cél" értékét a SolutionProfiletípusnak, íme egy mintapélda:

"target": [
        {
            "type": "SolutionProfile",
            "id": "SOL-ABC-DEF"
        }
    ]

Feljegyzés

A kérelem bemenetében függetlenként vagy megosztottként megadott mezőtípus csak indikatív érték, és nem befolyásolja az ügylet típusát. Az aktuális értéket az API-ban más paraméterek, mint például hozzájárulás és inviteContext alapján rendelik hozzá.

2. lépés: Microsoft-javaslat létrehozása partneri javaslat részleteivel

Ezután hozzon létre egy Microsoft ajánlást egy másik API-híváson keresztül, és csatolja a partneri ajánláshoz az 1. lépésben visszaadott Engagement ID mező használatával.

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

{
    "engagementId": "<ENGAGEMENT_ID (FROM PARTNER REFERRAL)>",
    "organizationId": "msft",
    "organizationName": "Microsoft",
    "name": "Contoso Test Deal",
    "type": "Shared",
    "qualification": "SalesQualified",
    "customerProfile": {
		"name": "Contoso Customer Inc",
		"address": {
			"addressLine1": "One Microsoft Way",
			"addressLine2": "34",
			"city": "Redmond",
			"state": "WA",
			"postalCode": "98052",
			"country": "US"
		},
		"size": "10to50employees",
		"team": [
			{
				"firstName": "Sue",
				"lastName": "Smith",
				"phoneNumber": "1234567890",
				"email": "sue.smith@contosocustomer.com",
				"emailValidationStatus": "None",
				"phoneValidationStatus": "None"
			}
		],
		"isMatchingComplete": false
	},
    "consent": {
        "consentToToShareInfoWithOthers": true,
        "consentToContact": true,
        "ConsentToMicrosoftToContactSpecificPartners": true,
        "consentToShareReferralWithMicrosoftSellers": true
    },
    "details": {
        "notes": "Test notes to Microsoft.",
        "dealValue": 50000.0,
	"currency": "USD",
        "closingDateTime": "2024-11-14T00:00:00Z"
    },
    "team": [],
    "inviteContext": {
        "notes": "Proof of concept / Demo , Test notes to Microsoft.",
        "invitedBy": {
            "organizationId": "<ORGANIZATION_ID (FROM PARTNER REFERRAL)>",
            "organizationName": "<ORGANIZATION_NAME (FROM PARTNER REFERRAL)>"
        },
        "assistanceRequestCode": "ProofOfConceptOrDemo"
    },
    "target": []
}

Ha meg szeretné adni a ReferralTarget értéket egy Microsoft-javaslathoz, íme egy hivatkozási mintaérték:

"target": [
        {
            "type": "BusinessProfileLocation",
            "id": "msft"
        }
    ]

Szolgáltatások együttes értékesítési lehetőség létrehozása

1. A szolgáltatások együttes értékesítési lehetőségének létrehozásához meg kell adni a PartnerRole, a SolutionAreaés a SolutionPlay szerepköröket részletekben, valamint a > követelményeket és a > további követelményeket.
2. A megoldás részletei nem kötelezőek a szolgáltatások együttes értékesítési lehetőségei között.

"details": {
		"dealValue": 123456,
		"currency": "USD",
		"closingDateTime": "2025-01-21T18:30:00.000Z",
		"notes": "Test Notes",
		"requirements": {
			"solutions": [],
			"additionalRequirements": {
				"attributes": [
					{
						"id": "Adoption and change management",
						"type": "PartnerRole"
					},
					{
						"id": "Data and AI",
						"type": "SolutionArea"
					},
					{
						"id": "Enable Unified Data Governance",
						"type": "SolutionPlay"
					}
				]
			}
		}
	}

Kapcsolódó tartalom

• Ajánlói források