Venditori
Riferimento endpoint persona di vendita
Le API addetto alle vendite sono di sola lettura per le sottoscrizioni che dispongono di Sincronizzazione SFDC o Sincronizzazione Microsoft Dynamics abilitata. Le persone di vendita sono un tipo di record persona che sono i proprietari delle vendite dei record lead. Sono correlati ai record Lead dal campo externalSalesPersonId di ogni record Lead. Quando un lead viene correlato a una persona di vendita da un campo externalSalesPersonId popolato, i campi di ricerca del proprietario del lead corrispondenti vengono compilati per tale record di lead in Marketo, consentendo l'utilizzo dei filtri e dei token corrispondenti.
I venditori sono correlati ai record dei lead utilizzando l'endpoint Sync Leads e passando l'attributo externalSalesPersonId.
I venditori sono correlati ai record Opportunità utilizzando l'endpoint Opportunità di sincronizzazione e passando l'attributo externalSalesPersonId.
Gli addetti alle vendite sono correlati ai record aziendali utilizzando l'endpoint Sync Companies e passando l'attributo externalSalesPersonId.
I record Persona di vendita sono modificabili solo tramite l’API.
Descrivere
La descrizione dei record Venditore segue il modello standard per gli oggetti di database dei lead.
GET /rest/v1/salespersons/describe.json
{
"requestId":"185d6#14b51985ff0",
"success":true,
"result":[
{
"name":"SalesPerson",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:24Z",
"idField":"id",
"dedupeFields":[
"externalSalesPersonId"
],
"searchableFields":[
[
"email"
],
[
"id"
],
[
"externalSalesPersonId"
]
],
"fields":[
{
"name":"id",
"displayName":"Marketo Id",
"dataType":"integer",
"updateable":false
},
{
"name":"createdAt",
"displayName":"Created At",
"dataType":"datetime",
"updateable":false
},
{
"name":"updatedAt",
"displayName":"Updated At",
"dataType":"datetime",
"updateable":false
},
{
"name":"email",
"displayName":"Email",
"dataType":"string",
"length":255,
"updateable":false
},
{
"name":"externalSalesPersonId",
"displayName":"External Sales Person Id",
"dataType":"string",
"length":255,
"updateable":false
}
]
}
]
}
Per impostazione predefinita, il idField di Sales Person è "id" e il dedupeFields è solo "externalSalesPersonId".
Query
Venditori che utilizzano il modello di query standard per le chiavi semplici. Questo esempio mostra l’e-mail dell’utente utilizzata come externalSalesPersonId. Per impostazione predefinita, la query restituisce tutti i campi compilati per i record restituiti.
GET /rest/v1/salespersons.json?filterType=dedupeFields&filterValues=david@test.com,sam@test.com
{
"requestId":"e42b#14272d07d78",
"success":true,
"result":[
{
"seq":0,
"id":53453,
"externalSalesPersonId":"sam@test.com",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:23Z"
},
{
"seq":1,
"id":53454,
"externalSalesPersonId":"david@test.com",
"createdAt":"2015-02-03T22:36:23Z",
"updatedAt":"2015-02-03T22:36:23Z"
}
]
}
Crea e aggiorna
Il modello per gli aggiornamenti è standard.
POST /rest/v1/salespersons.json
{
"action":"createOrUpdate",
"dedupeBy":"dedupeFields",
"input":[
{
"externalSalesPersonId":"sam@test.com",
"email":"sam@test.com",
"firstName":"Sam",
"lastName":"Sanosin"
},
{
"externalSalesPersonId":"david@test.com",
"email":"david@test.com",
"firstName":"David",
"lastName":"Aulassak"
}
]
}
{
"requestId":"e42b#14272d07d78",
"success":true,
"result":[
{
"seq":0,
"status": "updated",
"id":45232
},
{
"seq":1,
"status": "created",
"id":45236
}
]
}
Elimina
Il modello per le eliminazioni è standard.
L’eliminazione di Sales Persons (Persone vendita) non è consentita quando "in uso". In questo caso il venditore viene ignorato. Esempi:
- Quando la persona di vendita è associata ai lead attivi
- Quando il venditore è associato a una società che è stata eliminata
POST /rest/v1/salespersons/delete.json
{
"deleteBy":"dedupeFields",
"input":[
{
"externalSalesPersonId":"sam@test.com"
},
{
"externalSalesPersonId":"david@test.com"
},
{
"externalSalesPersonId":"raj@test.com"
}
]
}
{
"requestId":"e42b#14272d07d78",
"success":true,
"result":[
{
"seq":0,
"id":56343,
"status": "deleted"
},
{
"seq":1,
"id":53453,
"status": "deleted"
},
{
"seq":2,
"status": "skipped"
"reasons":[
{
"code":"1013",
"message":"Record not found"
}
]
}
]
}
Timeout
-
Gli endpoint persona di vendita hanno un timeout di 30 secondi, a meno che non sia indicato di seguito
- Sincronizza addetti alle vendite: anni 60
- Cancella Venditori: 60s