Een verwijzing maken
In dit artikel wordt uitgelegd hoe u een verwijzing maakt. Er zijn twee typen ReferralType:
Onafhankelijk: waarbij een verwijzing zichtbaar is voor één partner.
Gedeeld: waarbij een verwijzing zichtbaar is voor twee partijen die samenwerken. Als Microsoft en een partner bijvoorbeeld samenwerken in een collectieve verkoopdeal, kan een verwijzing tussen beide partijen worden gedeeld. Zie de sectie Een gedeelde verwijzing maken voor meer informatie.
Notitie
MACC-geschiktheid en overeenkomende functies van klanten zijn niet beschikbaar bij het gebruik van API-integratie.
Dealtypen
Er zijn drie soorten collectieve verkoopkansen (of aanbiedingen of verwijzingen) die kunnen worden gemaakt vanuit het Partnercentrum- privé-, partner-led- en collectieve verkoopdeals. Normaal gesproken worden deze keuzes vanuit de gebruikersinterface van Het Partnercentrum aan de gebruiker gepresenteerd, maar tijdens het maken van deze opties vanuit de API zijn er bepaalde andere stappen die u moet uitvoeren. Wanneer u een nieuwe aanbieding maakt, is er vanuit het Partnercentrum een gebruikersinterface die nodig is voor Microsoft , waar deze opties aan de gebruiker worden gepresenteerd.
- Privédeal: U kiest ervoor om de deal niet met Microsoft te delen, selecteer 'Geen hulp nodig' en antwoordt u op 'Nee' op de vraag: 'Wilt u de deal delen met Microsoft-verkopers?'
- Partner geleid: U kiest 'Geen hulp nodig' maar beantwoordt 'ja' op de vraag: 'Wilt u de deal delen met Microsoft-verkopers?'
- Collectieve verkoop: U kiest ervoor om hulp te krijgen van Microsoft en antwoordt ook op 'ja' op de vraag: 'Wilt u de deal delen met Microsoft-verkopers?'
Vereisten
- Referenties zoals beschreven in partner-API-verificatie. Dit scenario ondersteunt verificatie met app+gebruikersreferenties.
REST-aanvraag
Aanvraagsyntaxis
| Wijze | Aanvraag-URI |
|---|---|
| POST | https://api.partner.microsoft.com/v1.0/engagements/referrals |
Aanvraagheaders
- Zie Rest-headers voor partner-API's voor meer informatie.
Aanvraagtekst
In deze tabel worden de verwijzingseigenschappen in de aanvraagtekst voor een gloednieuwe verwijzing beschreven.
| Eigenschap | Type | Description |
|---|---|---|
| Naam | tekenreeks | De naam van de verwijzing. |
| ExternalReferenceID | tekenreeks | Een externe id voor de verwijzing. Bijvoorbeeld uw eigen Dynamics 365-lead- of verkoopkans-id. |
| Status | ReferralStatus | Een enum met waarden die de verwijzingsstatus aangeven. |
| Substatus | ReferralSubstatus | Een opsomming met waarden die de substatus van de verwijzing aangeven. |
| StatusReden | tekenreeks | Een beschrijvend bericht over de status. Leg bijvoorbeeld uit waarom de verwijzing is verbroken. |
| ReferralType | ReferralType | Vertegenwoordigt het verwijzingstype. Vereist. |
| kwalificatie | ReferralQualification | Vertegenwoordigt de kwaliteit van de verwijzing. |
| CustomerProfile | CustomerProfile | Contactgegevens van de klant. Vereist. |
| Toestemming | Toestemming | Toestemmingsvlagken voor het delen van informatie met andere organisaties en het toestaan van contact met gebruikers.Vereist. |
| DETAILS | ReferralDetails | Klantgegevens, notities, dealwaarde, sluitingsdatum van valuta. Vereist. |
| Team | Lid | Vertegenwoordigt gebruikers in de organisaties die betrokken zijn bij de partnerbetrokkenheid. |
| InviteContext | InviteContext | Vertegenwoordigt meer informatie die een gebruiker kan opgeven bij het uitnodigen van een andere organisatie bij de partnerbetrokkenheid. |
| Doel | ReferralTarget | Vertegenwoordigt meer informatie die een gebruiker kan opgeven bij het uitnodigen van een andere organisatie bij de partnerbetrokkenheid. |
| Partnerrol | Alleen vereist voor collectieve verkoopverwijzingen van services | Kan een van de volgende waarden zijn: presales-inrichting, oplossingsontwerp, proof-of-concept, bedrijfsstrategie, implementatieservices, acceptatie en wijzigingsbeheer, transactie, beheerde services |
| Oplossingsgebied | Alleen vereist voor collectieve verkoopverwijzingen van services | Het gebied Oplossing van de klant nodig in de verkoopkans. Zie de volgende tabel voor waarden. |
| Oplossing afspelen | Alleen vereist voor collectieve verkoopverwijzingen van services | Het oplossingsspel van de klant moet in de gelegenheid zijn. Zie de volgende tabel voor waarden. |
Waarden voor oplossingsgebied en oplossingsplay
In de volgende tabel ziet u de waarden voor de velden Solution Area en Solution Play voor FY 24.
| Oplossingsgebied | Oplossing afspelen |
|---|---|
| Zakelijke toepassingen | Innovatie versnellen met weinig code |
| Zakelijke toepassingen | Omzet genereren versnellen |
| Zakelijke toepassingen | Service moderniseren |
| Zakelijke toepassingen | Financiën en toeleveringsketen optimaliseren |
| Zakelijke toepassingen | SMB-bedrijfsactiviteiten schalen |
| Gegevens en AI | Zakelijke beslissingen voor Power Met Cloud Scale Analytics |
| Gegevens en AI | AI-apps bouwen en moderniseren |
| Innovatie van digitale toepassingen en toepassingen | Bedrijfsapps migreren |
| Innovatie van digitale toepassingen en toepassingen | AI-apps bouwen en moderniseren |
| Innovatie van digitale toepassingen en toepassingen | Productiviteit van ontwikkelaars versnellen |
| Innovatie van digitale toepassingen en toepassingen | Innovatie versnellen met Integration Services |
| Infrastructuur | Windows Server en SQL Server migreren en beveiligen |
| Infrastructuur | SAP migreren |
| Infrastructuur | Innoveren met HPC, AI-infrastructuur |
| Infrastructuur | Linux-estate migreren |
| Infrastructuur | Oracle migreren |
| Modern werken | Frontlinewerkers |
| Modern werken | Werknemerservaring |
| Modern werken | Veilige productiviteit |
| Modern werken | Geconvergeerde communicatie |
| Modern werken | Cloudeindpunten |
| Modern werken | Moderniseren met Surface |
| Beveiliging | Bedreigingsbeveiliging met XDR en SIEM |
| Beveiliging | Multi-cloudbeveiliging |
| Beveiliging | Gegevensbeveiliging |
| Beveiliging | Gegevensgovernance |
| Beveiliging | Moderne sec ops |
| Beveiliging | Beveiligde identiteit en take-out Okta en Ping |
| Unified-ondersteuning | Een sterke basis bouwen met unified |
| Unified-ondersteuning | Succes van de cloud stimuleren met verbeterde oplossingen |
Status- en substatusovergangsstatussen
| Status | Toegestane statusovergang | Toegestane substatus |
|---|---|---|
| Nieuw | Nieuw, actief, gesloten | In behandeling, ontvangen |
| Actief | Actief, gesloten | Geaccepteerd |
| Gesloten | Gesloten | Gewonnen, Verloren, Geweigerd, Verlopen |
Aanvraagvoorbeeld
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"
}
}
}
REST-antwoord
Als dit lukt, retourneert deze methode de ingevulde verwijzingsresource in de hoofdtekst van het antwoord.
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout optreedt en meer informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodes voor de volledige lijst.
Responsvoorbeeld
{
"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 van private/partner-led naar collectieve verkoop deal
Als u een collectieve verkoopdeal wilt maken via de API, moet u eerst een privé- of partner-geleide deal maken en vervolgens de tweede verwijzing maken en deze verbinden met de eerste. De stappen worden beschreven in de volgende sectie.
Stap 1: Een door een partner geleide deal maken die zichtbaar is voor Microsoft-verkopers
Maak eerst een door partners geleide deal die zichtbaar is voor Microsoft-verkopers met behulp van de volgende nettolading van aanvragen.
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": {}
}
Stap 2: Een Microsoft-verwijzing maken met behulp van partnerverwijzingsgegevens
Maak vervolgens de Microsoft-verwijzing via een andere API-aanroep en koppel deze aan de partnerverwijzing met behulp van het veld Afspraak-id dat is geretourneerd uit stap 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": {}
}
Een gedeelde verwijzing maken
Er zijn twee stappen voor het maken van een verwijzing van het type gedeeldeverwijzing:
Het volgende stroomdiagram illustreert deze twee stappen bij het maken van een gedeelde verwijzing.
Uw verwijzing maken
- Maak een verwijzing met ReferralType ingesteld op gedeeld.
- Kopieer de engagementID uit het retourantwoord.
ReferralTarget-voorbeeld voor verwijzing
"target": [
{
"type": "SolutionProfile",
"id": "SOL-ABC-DEF"
}
]
Een verbonden verwijzing maken
- Maak een andere verwijzing voor Microsoft.
- Neem de enagementID van uw verwijzing op zodat deze aan elkaar zijn gekoppeld.
ReferralTarget-voorbeeld voor Microsoft-verwijzing
"target": [
{
"type": "BusinessProfileLocation",
"id": "msft"
}
]
Volgende stappen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor