REST API Produktimport V1
Diese Quelle wird für den Import von Produktdaten in Quant verwendet. Eingabe- und Ausgabeformat ist JSON.
Benutzen Sie den Abschnitt Automatische Aufgaben , um einen Import zu erstellen und einzurichten. Nach der Erstellung hat die Aufgabenliste die ID, die Sie in der Anfrage-URL angeben.
- Einstellungen
Bevor Sie die API verwenden, müssen Sie die folgenden Attribute auf der Registerkarte "Einstellungen" bearbeiten:
- Kreuzen Sie das Attribut Enabled an, um die Aufgabe zu aktivieren.
- Wählen Sie im Feld Benutzer mit API-Zugriffsberechtigung einen oder mehrere Benutzer mit der Rolle "Roboter" aus, die zur Ausführung der Aufgabe berechtigt sind.
- Wählen Sie unter Produktdaten-Attribut-Zuordnung die zu importierenden Attribute aus und ändern Sie optional deren JSON-Schlüssel.
- Attribute
Attribut | Beschreibung | Typ |
Aktiviert | Gibt an, ob die automatische Aufgabe aktiv ist und ob die Daten durch sie gesendet werden können. | ja/nein |
Titel | Eigene Name der automatischen Aufgabe. | Text |
Beschreibung | Benutzerdefinierte Beschreibung der Funktion der automatischen Aufgabe. | Formatierter Text |
Hinweise | Notizen. | Langtext |
Benutzer mit API-Zugangsberechtigung | Benutzer mit der Rolle Roboter, die berechtigt sind, die Aufgabe auszuführen. | Liste der Benutzer |
Maßeinheit | Maßeinheit wie cm, mm usw. | Auswahl |
Datumsformat | Datumseingabeformat, z.B. 31.12.19 | Auswahl |
Datum und Zeitformat | Format für die Eingabe von Datum und Uhrzeit, z.B. 19.12.31 23:59:59 | Auswahl |
Matching Attribute | Ein Produktattribut in Quant, das verwendet wird, um Importartikel mit Produkten in Quant abzugleichen. | Auswahl |
Neue Produkte erstellen | Wenn aktiviert, werden beim Import neue Produkte für nicht vorhandene Produkt-IDs erstellt. | ja/nein |
Neue Produkte für Planogramming einstellen | Wenn diese Option aktiviert ist, werden neu erstellte Produkte zur Erstellung von Planogrammen entworfen. Diese Option ist nur aktiv, wenn Neue Produkte erstellen aktiviert ist. | ja/nein |
Löschte Produkte ignorieren | Wenn der Import kein aktives Produkt für eine gegebene ID findet, sucht er standardmäßig unter den gelöschten Produkten. Findet er ein gelöschtes Produkt, wird es wieder aktiviert. Wenn Sie diese Option aktivieren, werden gelöschte Produkte ignoriert und nicht wiederhergestellt. | ja/nein |
Nicht-Null-Messungen nicht überschreiben | Wenn aktiviert, werden Abmessungen aus importierten Datensätzen (z. B. Höhe, Breite) nur dann importiert, wenn das vorhandene Paket keine Abmessungen aufweist. | ja/nein |
Produktattribute zu löschen | Liste der Attribute, deren Werte vor dem Import aus allen Produkten gelöscht werden. | Liste der Attribute |
Produktdaten Attribut-Zuordnung | Ein Mapp ing mit einem Eintrag für jedes zu importierende Attribut. | komplexer Typ |
- Anfrage
/v1/import/product-data/{task_id}
Parameter | Wert |
URL | ?debug, das der URL hinzugefügt wird, zeigt auch Warnungen in der Antwort an. Ohne diese Option werden nur Fehler angezeigt. |
Kopfzeile | Accept: application/json |
Kopfzeile | Inhaltstyp: application/json |
Kopfzeile | Berechtigung: Bearer <TOKEN> TOKEN se získává pomocí /authenticate (siehe Login). |
Methode | POST |
Der Inhalt der Anfrage ist ein Array von JSON-Objekten, das die in der Einstellung Produktdatenattribut-Zuordnung definierten Schlüssel enthält.
Es ist wichtig, dass die Anfrage den Standards des JSON-Formats entspricht. Die vollständige Definition dieser Standards finden Sie hier. Bitte senden Sie die Werte der numerischen Attributeohne Anführungszeichen, wie im Beispiel dargestellt.
- Antwort
Schlüssel | Wert |
Status | Eine Zeichenfolge, die den endgültigen Zustand des Imports beschreibt.
|
Warnungen | Es ist optional, d.h. es ist nur enthalten, wenn der Parameter ?debug in der URL enthalten ist und der Import mindestens eine Warnung erzeugt hat. Liste der Warnzeichenfolgen. |
Fehler | Optional - nur enthalten, wenn der Import mindestens einen Fehler erzeugt hat. Liste der Fehlerzeichenfolgen. |
Gesamtzeilen | Optional - wird nur eingefügt, wenn der Import nicht mit dem Status "FAILURE" beendet wurdeAnzahl der eingegebenen Datensätze |
Duplizierte Pakete | Optional - wird nur eingefügt, wenn der Import nicht mit dem Status "FAILURE" beendet wurdeDie Anzahl der Datensätze, die übersprungen wurden, weil dieses Paket bereits im selben Auftrag importiert wurde. |
Ingnorierte Produkte | Standardmäßig durchsucht das System die gelöschten Produkte, wenn während des Importvorgangs ein aktives Produkt mit der angegebenen ID nicht gefunden werden kann. Wird ein solches Produkt gefunden, wird es wiederhergestellt. Wenn Sie diese Option aktivieren, werden gelöschte Produkte ignoriert und nicht wiederhergestellt. |
- Status Codes
Status | Wert |
200 OK | Import erfolgreich mit dem Status "SUCCESS" oder "PARTIAL_SUCCESS". Die Antwort kann Warnungen oder kleinere Fehler enthalten. |
400 Bad Request | Fehlerhafte Aufgabeneinstellungen oder falsche Anfrage. |
401 Nicht autorisiert | Das Autorisierungs-Token ist ungültig, oder der Benutzer, der mit dem Token angemeldet ist, hat keine Berechtigung zur Ausführung dieser Aufgabe. |
404 Nicht gefunden | Es wurde keine Aufgabe mit der in der URL angegebenen ID gefunden. |
500 Internal Server Error | Ein kritischer serverseitiger Fehler ist während des Imports aufgetreten. |
503 Dienst nicht verfügbar | Die Aufgabe wird bereits ausgeführt. Versuchen Sie, die Aufgabe nach der in der Antwortkopfzeile Retry-After angegebenen Anzahl von Sekunden erneut zu starten. |
- Ausführungsprotokoll
In Quant können Sie zusätzlich zu den Aufgabeneinstellungen auch Aufzeichnungen über einzelne Importe einsehen, einschließlich Statistiken, Fehler und Warnungen.
Wenn wir einen bestimmten Datensatz auswählen, können wir seine Details anzeigen, indem wir auf die Schaltfläche Elemente anzeigen klicken.
- Anfrage
curl -X POST --location "https://[IHR_COMPANY].iquant.eu/v1/import/product-data/145?debug" \
-H "Authorization: Bearer ywJqq25pXO6oaCPqgEAiTioBVwM8Ih2kOwzzd3eWK3R2oDSA5n" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-d "[{ \"Primäre Produkt-ID\": \"100001\", \"Name\": \"Testprodukt\",
- Antwort
{
"Status": "SUCCESS",
"Total Lines": 1,
"Doppelte Produkte": 0,
"Ignorierte Produkte": 0
}