When it comes to the snapADDY API, two different types of ID have to be considered: The first one is the ID of the contact within the snapADDY data-logic, which is called "id" with an automatically generated value. The other type of ID is a user submitted ID, which is optional and can be used in combination with the QR Code image. This ID is located in a "customFields" object, and is called "qrCodeId".

So we have to differentiate how a ContactItem can be created:

  1. when a ContactItem is created via UI in the Dashboard, (via Visitreport/Template/Inventory Data), either via "Import Inventory Data" or "Create Contact" button, snapADDY fills the ID field with the value specified by the user (by default in the field "Record ID"). If there is no ID specified by the user, the auto-generated ContactItem-ID ("id") will be assigned
  2. When the ID is created by a Rest-API via POST via https://api.snapaddy.com/grabber/v1/contactitem the "qrCodeId" information might be missing, so the field seems to be empty

If you want to have the user-specified ID (qrCodeId) to be displayed, it must be transmitted as follows when creating the CRM-ID:

{

"contactListId": "Ya3oXxweoP9kNAnq",

"customFields": {

"qrCodeId": "12345 <-- CRM-ID"

},

"firstName": "Irrelevant",

"lastName": "Irrelevant",

}

Only then, the corresponding CRM ID will be displayed in the QR-code field of the VisitReport.

_________________________________
(German version)

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:

  1. 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
  2. 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.

Did this answer your question?