snapADDY data-logic & QRCodeIDs
Wenn es um die snapADDY API geht, müssen zwei verschiedene Arten von ID berücksichtigt werden: einmal die ID des Kontakts "innerhalb der snapADDY-Daten", mit dem Namen "id", die man niemals vorgeben kann, und einmal eine "eventuell vom Benutzer übermittelte ID des Kontakts im CRM", welche nur im Zusammenspiel mit der QR-Code-Darstellung genutzt wird. Diese steht in einem "customFields"-Objekt , und trägt dort den Namen "qrCodeId" .
Wir müssen also differenzieren, wie ein ContactItem zustande kommen kann:
-
bei einer Anlage per UI im Dashboard, (via Visitreport/Vorlage/Bestandsdaten), entweder per "Bestandsdaten importieren"- oder "Kontakt anlegen"-Knopf, befüllt snapADDY das ID-Feld entweder mit demjenigen Wert, den der Benutzer vorgibt (per Vorgabe im Feld "Datensatz-ID"), welcher effektiv der ID des Datensatzes im CRM entspricht, oder alternativ mit der ID des ContactItems im snapADDY-Datenpool, sofern keine CRM-Datensatz-ID vergeben wurde
-
bei einer Anlage per Rest-API via POST auf https://api.snapaddy.com/grabber/v1/contactitem fehlt diese "qrCodeId"-Information unter Umständen, weshalb das Feld dann leer scheint
Soll im Fall 2 eine CRM-ID dargestellt werden, so muss diese beim Anlegen wie folgt mit übermittelt werden:
{
"contactListId": "Ya3oXxweoP9kNAnq",
"customFields": {
"qrCodeId": "12345 <-- CRM-ID"
},
"firstName": "Irrelevant",
"lastName": "Irrelevant",
}
Erst dann wird im QR-Code des VisitReports auch die entsprechende CRM-ID dargestellt.
Falls Sie noch Fragen haben, kontaktieren Sie gerne support@snapaddy.com oder Ihren Customer Success Manager.