Aggiornare un lead o un'opportunità

Questo articolo illustra come aggiornare i dettagli del lead o dell'opportunità, ad esempio il valore della trattativa, la data di chiusura stimata o gestire le fasi di vendita tra gli altri dettagli.

Prerequisiti

  • Credenziali come descritto in Autenticazione dell'API Segnalazioni. Questo scenario supporta l'autenticazione con le credenziali dell'app e dell'utente.
  • Questa API supporta attualmente solo l'accesso utente in cui i partner devono trovarsi in uno dei ruoli seguenti: Amministratore delle segnalazioni o Utente segnalazione.

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
PATCH https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID}

Parametro URI

Nome Digita Obbligatorio Descrizione
Identificativo string Sì Identificatore univoco per un'opportunità di lead o co-selling

Intestazioni delle richieste

Per ulteriori informazioni, vedere Intestazioni REST dei partner.

Testo della richiesta

Il corpo della richiesta segue il formato Json Patch. Un documento JSON Patch ha un array di operazioni. Ogni operazione identifica un particolare tipo di modifica. Esempi di tali modifiche includono l'aggiunta di un elemento matrice o la sostituzione di un valore della proprietà.

Importante

L'API al momento supporta solo le replace e add operazioni.

Esempio di richiesta

PATCH https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID} HTTP/1.1
Authorization: Bearer <token>
Prefer: return=representation
Content-Type: application/json

[
    {
        "op": "replace",
        "path": "/details/dealValue",
        "value": "10000"
    },
    {
        "op": "add",
        "path": "/team/-",
        "value": {
            "email": "jane.doe@contoso.com",
            "firstName": "Jane",
            "lastName": "Doe",
            "phoneNumber": "0000000001"
        }
    }
]

Nota

Se viene passata l'intestazione If-Match, verrà usata per il controllo della concorrenza.

Risposta REST

In caso di esito positivo, il corpo della risposta contiene il lead o opportunità aggiornato.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica il successo o il fallimento e altre informazioni di diagnostica. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri.

Risposta di esempio

HTTP/1.1 204 No Content
Content-Length: 0
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731

Suggerimento

Il corpo della risposta dipende dall'intestazione Prefer. Se il valore dell'intestazione viene omesso nella richiesta, il corpo della risposta è vuoto con un codice di stato HTTP 204. Aggiungere Prefer: return=representation all'intestazione per ottenere il lead o l'opportunità aggiornati.

Richieste di esempio

  1. Aggiorna il valore dell'affare per l'opportunità a 10000 e aggiorna le note. Non sono presenti controlli di concorrenza a causa dell'assenza dell'intestazione If-Match.

    PATCH https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID}
Authorization: Bearer <token>
Content-Type: application/json

[
    {"op":"replace","path":"/details/dealValue","value":"10000"},
    {"op":"replace","path":"/details/notes","value":"Lorem ipsum dolor sit amet."}
]

  2. Aggiorna lo stato di un lead o di un'opportunità a Won.

    PATCH https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID}
Authorization: Bearer <token>
Content-Type: application/json

[
    {"op":"replace", "path":"/status", "value":"Closed"},
    {"op":"replace", "path":"/substatus", "value":"Won"}
]

    Importante

    I campi e devono essere conformi al set consentito di valori di transizione .

  3. Aggiunge un nuovo membro della tua organizzazione al team di gestione o al team delle opportunità. La risposta contiene il lead o l'opportunità aggiornati per via dell'intestazione Prefer: return=representation.

    PATCH https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID} HTTP/1.1
Authorization: Bearer <token>
Prefer: return=representation
Content-Type: application/json

[
    {
        "op": "add",
        "path": "/team/-",
        "value": {
            "email": "jane.doe@contoso.com",
            "firstName": "Jane",
            "lastName": "Doe",
            "phoneNumber": "0000000001"
        }
    }
]

Creare iscrizioni affari

Usare l'API di registrazione delle trattative per effettuare la registrazione di una trattativa nel Partner Center quando sia il partner che il riferimento sono idonei. Per altre informazioni sui concetti di registrazione delle trattative e sui flussi di lavoro, vedere Registrare le trattative nel Centro per i partner.

Requisiti di idoneità

  • Il partner deve essere approvato per la registrazione della trattativa in base ai criteri di idoneità di Microsoft.
  • La segnalazione deve supportare la registrazione dell'affare.

Come funziona l'idoneità?

  • L'idoneità dei partner è determinata da Microsoft e non viene gestita tramite l'area di lavoro Segnalazioni del Centro per i partner.
  • È possibile convalidare programmanticamente l'idoneità dei partner chiamando l'API per verificare l'idoneità alla registrazione degli affari dei partner prima di creare una registrazione dell'affare.
  • La risposta DELL'API indica se il chiamante è autorizzato a procedere con la creazione della registrazione della trattativa.

I requisiti di idoneità assicurano che solo i partner idonei possano registrare le trattative e impedire invii non riusciti o non validi.

API di idoneità per la registrazione delle offerte dei partner

Sintassi della richiesta

metodo URI della richiesta
GET https://api.partner.microsoft.com/v1.0/engagements/partners/dealregistrationeligibility

Esempio di richiesta

GET https://api.partner.microsoft.com/v1.0/engagements/partners/dealregistrationeligibility HTTP/1.1
Authorization: Bearer <token>
Prefer: return=representation

Risposta REST

In caso di esito positivo, il corpo della risposta contiene lo stato di idoneità.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica il successo o il fallimento e le informazioni per il debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore ed eventuali parametri.

Risposta di esempio

HTTP/1.1 200 OK
Request-ID: 2d1bed51-2fd9-adfc-h4a7-019kk87c0627
Content-Type: application/json

{
  "isEligible": true,
  "policies": [
    {
      "isEligible": true
    }
  ]
}

Idoneità per la registrazione dell'accordo di riferimento

Una segnalazione è idonea per la registrazione della trattativa se vengono soddisfatte tutte le condizioni seguenti:

  • Il tipo di trattativa è co-vendita.
  • Il cliente è gestito da Microsoft.
  • Il valore totale della trattativa è maggiore di 25.000 USD.
  • Almeno una soluzione associata è idonea per Azure IP Co-sell.
  • Lo stato del riferimento Microsoft è Accettato.

È anche possibile convalidare l'idoneità delle segnalazioni programmaticamente chiamando l'API di Eligibilità per la Registrazione delle Offerte. La risposta dell'API conferma se un determinato riferimento di Co-sell è idoneo per la registrazione dell'affare.

API di idoneità alla registrazione dell'offerta

Sintassi della richiesta

metodo URI della richiesta
POST https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID}/dealregistrations/eligibility

Parametro URI

Nome Digita Obbligatorio Descrizione
Identificativo string Sì Identificatore univoco per un'opportunità di co-vendita

Esempio di richiesta

POST https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID}/dealregistrations/eligibility HTTP/1.1
Authorization: Bearer <token>
Prefer: return=representation

Nota

Anche se si tratta di una richiesta POST, tuttavia non è necessario fornire payload per questa richiesta HTTP.

Risposta REST

In caso di esito positivo, il corpo della risposta contiene lo stato di idoneità e il set di criteri di idoneità non riusciti e superati.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica il successo o il fallimento e le informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore ed eventuali parametri.

Risposta di esempio

HTTP/1.1 200 OK
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Content-Type: application/json

{
  "isEligible": true,
  "passedPolicies": [
    {
      "policyName": "isDealTypeCosellOrPartnerLed",
      "isEligible": true,
      "referralProperties": {
        "type": "Shared"
      }
    },
    {
      "policyName": "isMicrosoftReferralAcceptedOrWon",
      "isEligible": true,
      "referralProperties": {
        "status": "Active",
        "substatus": "Accepted"
      }
    },
    {
      "policyName": "isSolutionIncentiveEligible",
      "isEligible": true,
      "referralProperties": {
        "solutionId": "DEAL-123456-XYZ",
        "solutionName": "Contoso Experience Platform"
      },
      "additionalProperties": [
        "MSFT Internal Azure IP Co-Sell"
      ]
    },
    {
      "policyName": "isDealValueEligible",
      "isEligible": true,
      "referralProperties": {
        "currency": "USD",
        "dealValue": "30000"
      }
    },
    {
      "policyName": "isCustomerManaged",
      "isEligible": true,
      "referralProperties": {
        "isMatchingComplete": "true"
      },
      "additionalProperties": [
        "Managed"
      ]
    }
  ],
  "failedPolicies": []
}

API registrazione trattative

Usare l'operazione di aggiornamento dell'offerta esistente (API PATCH) per eseguire la registrazione di un'offerta.

Esempio di richiesta

PATCH https://api.partner.microsoft.com/v1.0/engagements/referrals/{ID} HTTP/1.1
Authorization: Bearer <token>
Prefer: return=representation
Content-Type: application/json

[
    {
        "op":"add",
        "path":"/registrations/-",
        "value":{
            "type":"AzureIPCoSell",
            "contract":{
                "currency":"USD",
                "endDateTime":"2026-02-28T09:14:19.454Z",
                "signDateTime":"2026-02-12T09:14:10.783Z",
                "startDateTime":"2026-02-12T09:14:16.319Z",
                "term":"Finite",
                "value":250000
            },
            "solutionDetails":[
                {
                    "id":"DEAL-123456-XYZ",
                    "isDeployedOnAzure":true,
                    "marketplaceTransactionDetails":{
                        "isMarketplaceTransacted":true,
                        "marketplaceTransactionDateTime":"2026-02-11T09:13:52.105Z"
                    },
                    "primaryDeploymentOn":"Partner",
                    "pricingModel":"Other",
                    "value":250000,
                    "currency":"USD"
                }
            ]
        }
    }
]

Risposta di esempio

HTTP/1.1 204 No Content
Content-Length: 0
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731

Nota

Una volta ricevuta la risposta di esecuzione riuscita, il partner può recuperare la segnalazione di origine per visualizzare la registrazione della trattativa che è stata creata.

Contenuto correlato

  • Creare una segnalazione
  • Last updated on