convertLead methode
Inhoudsopgave
Doel
U kunt deze methode gebruiken voor het omzetten van een lead naar potentiële klant, account en contactpersoon. U kunt met deze methode ook een bestaand contactpersoon of account aan de om te zetten lead koppelen.
Voor meer informatie over het proces van leads omzetten, zie leads omzetten naar andere sales records in de gebruikershandleiding.
URL van het verzoek
XML-indeling:
https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=Auth Token&scope=crmapi &leadId=entity Id&xmlData=POTENTIALXMLDATA
JSON-indeling:
https://crm.zoho.com/crm/private/json/Leads/convertLead?authtoken=Auth Token&scope=crmapi &leadId=entity Id&xmlData=POTENTIALXMLDATA
Parameters van het verzoek
| Parameter | Gegevenstype | Beschrijving |
| authtoken* | String | Versleutelde alfanumerieke tekenreeks ter verificatie van uw Zoho inloggegevens. |
| scope* | String | Voer als waarde crmapi in |
| leadId* | String | Voer de unieke ID van de lead in |
| xmlData* | XML | Voer velden en corresponderende waarden in |
| newFormat | Integer | newFormat=1: Om velden met 'null'-waarden uit te sluiten wanneer u gegevens uit uw CRM-account invoegt. newFormat=2:Om velden met 'null'-waarden op te nemen wanneer u gegevens uit uw CRM-account invoegt. |
| version | Integer | version = 1: (standaardwaarde) Hiermee worden responses opgehaald op basis van de eerdere API-implementatie, d.w.z. van vóór de doorgevoerde verbeteringen. version = 2: Hiermee worden responses opgehaald op basis van de meest recente API-implementatie. |
* - Verplichte parameter
Opmerking:
- Raadpleeg de Releaseopmerkingen voor meer informatie over doorgevoerde verbeteringen in de API-implementatie.
Voorbeeld van XML voor het omzetten van een lead naar een account, contactpersoon en potentiële klant
<Potentials>
<row no="1">
<option val="createPotential">true</option>
<option val="assignTo">sample@zoho.com</option>
<option val="notifyLeadOwner">true</option>
<option val="notifyNewEntityOwner">true</option>
</row>
<row no="2">
<FL val="Potential Name">Samplepotential</FL>
<FL val="Closing Date">12/21/2009</FL><FL val="Potential Stage">Closed Won</FL>
<FL val="Contact Role">Purchasing</FL>
<FL val="Amount">3432.23</FL>
<FL val="Probability">100</FL>
</row>
</Potentials>
Opmerking:
- In deze XML, <row no='2'> is ALLEEN verplicht als de waarde voor 'createPotential is ingesteld op true. Als de waarde voor 'createPotential” is ingesteld op false, wordt er GEEN Potential aangemaakt bij het omzetten van de Lead.
Voorbeeld van XML voor het koppelen van de bestaande contactpersoon of account aan de om te zetten lead
<Potentials>
<row no="1">
<option val="createPotential">true</option>
<option val="assignTo">sample@zoho.com</option>
<option val="notifyLeadOwner">true</option>
<option val="notifyNewEntityOwner">true</option>
</row>
<row no="2">
<FL val="Potential Name">Samplepotential</FL>
<FL val="Closing Date">12/21/2009</FL><FL val="Potential Stage">Closed Won</FL>
<FL val="Contact Role">Purchasing</FL>
<FL val="Amount">3432.23</FL>
<FL val="Probability">100</FL>
<FL val="ACCOUNTID">543212345</FL>
<FL val="CONTACTID">1234554321</FL>
<FL val="OVERWRITE">true</FL>
</row>
</Potentials>
Opmerking:
- De assignTo waarde kan ofwel SMOWNERID of email id zijn.
- U kunt de bestaande contactpersoon of account aan de om te zetten lead koppelen, ongeacht of de lead wel of niet omgezet wordt naar een potentiële klant. Om dit te doen moet u ACCOUNTID en CONTACTID versturen via XML
- Als beide <FL val=”ACCOUNTID"></FL> en <FL val=”OVERWRITE”>true</FL> waarden worden gegeven, wordt de naam van het account vervangen door de bedrijfsnaam bij het koppelen aan het bestaande account. De gegevens van het desbetreffende account blijven echter hetzelfde
- Als de waarde OVERWRITE false is wordt alleen de koppeling uitgevoerd. Als de waarde OVERWRITE wordt gegeven zonder de ACCOUNTID, blijft de werking van deze methode echter onveranderd
- Als <FL val=”CONTACTID"></FL> wordt gegeven, dan zal de om te zetten lead gekoppeld worden aan de bestaande contactpersoon
Voorbeeld van XML voor het omzetten van een lead zonder een potentiële klant aan te maken
<Potentials>
<row no="1">
<option val="createPotential">false</option>
<option val="assignTo">sample@zoho.com</option>
<option val="notifyLeadOwner">true</option>
<option val="notifyNewEntityOwner">true</option>
</row>
</Potentials>