REST-API-Produktimport
Bitte verwenden Sie diese Ressource, um die Quant-Produktdatenbank zu aktualisieren. Derzeit wird JSON sowohl für die Eingabe als auch für die Ausgabe verwendet.
Der Import kann nur von einem Quant-Nutzer mit der Rolle Roboter aufgerufen werden, der diesen Import in den Einstellungen aktiviert hat. Andernfalls wird der Import nicht durchgeführt und die Status-Eigenschaft in der Antwort enthält eine Fehlermeldung:
HTTP 401 {"token":<TOKEN>,"status":"User is not authorized for this Resource."}
Aktiviert
- Request
Parameter | Wert |
URL | /productDataImport/json |
Debug | ?debug=true zur URL hinzugefügt wird, wird in der Antwort ebenfalls eine Warnung angezeigt. Ohne diese Angabe werden nur Fehler aufgelistet. |
Kopfzeile | Accept: application/json |
Kopfzeile | Content-type: application/json |
Kopfzeile | Authorization: Bearer <TOKEN> TOKEN wird erhalten durch / authenticate (siehe Login). |
Verfahren | POST |
Nutzlast | [{id1:value1, id2:value2}, {id1:value3, id2:value4}] Ein Array von JSON-Objekten, wobei jedes JSON-Objekt ein Produkt in Quant beschreibt. |
- Attribute
Die Importeinstellungen werden ebenfalls im Nutzerbereich eingerichtet (siehe Abbildung 1).
Attribute | Beschreibung | Typ |
Aktiviert | Gibt an, ob die automatisierte Aufgabe aktiv ist und Daten darüber gesendet werden können. | ja/nein |
Titel | Benutzerdefinierter Name der automatisierten Aufgabe. | Text |
Beschreibung | Benutzerdefinierte Beschreibung der Funktion für die automatische Aufgabe. | formatierter Text |
Notizen | Notizen. | langer Text |
Passende Eigenschaft | Eine Eigenschaft in Quant, die dabei hilft, Artikel aus dem Import mit Produkten in Quant zuzuordnen. Die hier ausgewählte Eigenschaft muss eine Zuordnung in der Produktattributzuordnung haben, andernfalls wird der Import mit einem Fehler beendet: HTTP 200 {"token":"<TOKEN>","status":"FAILURE","Errors":["Mapping not found for required attribute: Primary Product ID]} | Auswahl |
Neue Produkte erstellen | Wenn diese Option aktiviert ist, werden beim Import neue Produkte für nicht vorhandene Produkt-IDs erstellt. Diese Option ist nur aktiv, wenn im Eigenschaft Übereinstimmung die Option Primäre Produkt-ID ausgewählt ist. | ja/nein |
Neue Produkte für die Planogrammerstellung einrichten | Wenn diese Option aktiviert ist, werden neu erstellte Produkte für die Erstellung von Planogrammen vorgesehen. Diese Option ist nur aktiv, wenn Neue Produkte erstellen aktiviert ist. | ja/nein |
Löschen Sie entfernte Produkte | Wenn beim Import kein aktives Produkt für eine bestimmte ID gefunden wird, wird standardmäßig unter den gelöschten Produkten gesucht. Wird ein gelöschtes Produkt gefunden, wird es reaktiviert. Durch Aktivieren dieser Option werden gelöschte Produkte ignoriert, anstatt sie wiederherzustellen. | ja/nein |
Zuordnung von platzierten Produktattributen | Eine Zuordnung, die einen Eintrag für jedes zu importierende Produktattribut enthält. Dieser Eintrag definiert, wie die Werte aus der Eingabe interpretiert werden (siehe Abbildung unten). Weitere Informationen finden Sie unter Zuordnungsattribut. | komplexer Typ |
Maßeinheit | Maßeinheiten wie cm, mm usw. | Auswahl |
Dezimalpunkt | Zeichen, das den ganzen Teil und den Dezimalteil von Zahlen trennt. Wenn ein Komma ausgewählt wird, müssen numerische Werte zusätzlich in Anführungszeichen gesetzt werden, da das Komma Eigenschaften in JSON trennt. | Symbol |
Zeichenfolgewert für TRUE | Text, der (unabhängig von Groß- und Kleinschreibung) als „Ja“ für Ja/Nein-Eigenschaften gewertet wird. Alle anderen Werte werden in „Nein“ übersetzt. | Text |
Datumsformat | Datumsformat, z. B. 31.12.19 | Auswahl |
- Produktattributzuordnung
- Eigenschaft zuordnen
Attribute | Beschreiben | Typ |
Produkteigenschaft | Eine Produkt-Eigenschaft, die mit diesem Wert aktualisiert wird. | Auswahl |
Schlüssel | Die Schlüsseltexte sind im JSON-Format. | Text |
Genehmigung benötigt | Änderungen werden sofort in die Produkte geschrieben oder nur in der Registerkarte Quant-Änderungen zur Genehmigung unter Produkte in Quant erstellt, wo sie anschließend genehmigt oder abgelehnt werden können. | ja/nein |
Wertersetzung | Definiert eine Zuordnungsliste, in der der Textwert aus der Eingabe vor der Konvertierung in einen bestimmten Typ durch einen anderen Wert ersetzt wird. | komplexer Typ |
- Antwort
Parameter | Wert |
Körper | {"token":<TOKEN>,"status":"<STATUS>,"Total Lines":<LINE_COUNT>,"Ignored Products":<IGNORED>, "Duplicated Products":<DUPLICATED>,"Errors":[ERRORS], "Warnings":[WARNINGS]"} |
Attribute | Beschreibung | Typ |
Token | Token der Nutzerberechtigung. | Text |
Status | SUCCESS, wenn alles korrekt importiert wurde, PARTIAL_SUCCESS, wenn der Import erfolgreich war, jedoch einige Datensätze nicht importiert wurden, und FAILURE, wenn ein unerwarteter Fehler aufgetreten ist, der den Import vorzeitig beendet hat. | Text |
Gesamtzeilenzahl | Anzahl der Datensätze bei der Eingabe. | Zahl |
Nicht berücksichtigte Produkte | Anzahl der Datensätze, die nicht importiert wurden, aufgrund von:
| Zahl |
Duplizierte Produkte | Die Anzahl der Datensätze, die den Wert Übereinstimmende Eigenschaft enthalten, der zuvor in den Datensätzen aufgeführt war. Diese Datensätze werden ignoriert, um zu verhindern, dass Änderungen überschrieben werden. | Zahl |
Fehler | Eine Reihe von JSON-Objekten, die Fehler beschreiben. | JSON Array |
Warnungen | Ein Array von JSON-Objekten, die die Warnung beschreiben (nur wenn die Anfrage den Parameter debug = true enthielt). | JSON Array |
- Ausführungslog
In Quant können Sie zusätzlich zu den Importeinstellungen auf dem Roboter auch Aufzeichnungen einzelner Importe einsehen, einschließlich Statistiken, Fehlern, Warnungen und allgemeinen Informationen.
Wenn wir einen bestimmten Datensatz auswählen, können wir dessen Details anzeigen, indem wir auf die Schaltfläche Elemente anzeigen klicken. Nachdem wir die ausgewählten Elemente markiert haben, klicken wir auf Dateien herunterladen. Diese Dateien enthalten die Eingabedaten für den jeweiligen Importlauf.
- Anfrage
curl -H "accept: application/json" -H "content-type: application/json" -H "Authorization: Bearer i37YKbgCnJSXe2nvIrHA1fE8bLIE4RqROu4l1A- OTzHZXSmZ3CX"
https://[YOUR_COMPANY].iquant.eu/productDataImport/json?debug=true -d
"[{\"productId\":\"500001\",\"Store_ID\":\"1\",\"Sales Price\":\"1.23\"},{\"productId\":\"500001\",\"Store_ID\":\"2\",\"Sales Price\":\"2.34\"}]"
Dieses Beispiel veranschaulicht die Aktualisierung des Preises eines Produkts in zwei Filialen, nachdem zuvor durch Anmeldung ein TOKEN erhalten wurde.
- Antwort
{"token":"i37YKbgCnJSXe2nvIrHA1fE8bLIE4RqROu4l1AOTzHZXSmZ3CX","status":"SUCCESS","Total Lines":2,"Ignored Products":0, "Unknwon Store IDs":0,"Warnings":["There is a mapping with empty REST Element for attribute: Club Price"]}
Diese Antwort zeigt einen erfolgreichen Import mit einer Warnung an. Details und Statistiken finden Sie dann in Quant.