Testen Sie Ihre Produktkonfigurationen, Verpackungen und Bestellabläufe gründlich mit der GelatoConnect API.
1. So bereiten Sie eine Testbestellung vor
Bevor Sie eine Testbestellung aufgeben, stellen Sie bitte sicher, dass Sie Folgendes erledigt haben:
Kund:innen-Produkt einrichten: Legen Sie das Kund:innen-Produkt mit den erforderlichen Eigenschaften und Varianten an. Gehen Sie dabei wie folgt vor:
Wechseln Sie zum Bereich "Kundenprodukte" in GelatoConnect.
Wählen Sie das passende Produktmodell aus (zum Beispiel Poster-Produkt).
Definieren Sie die Basisattribute und Varianten, sodass sie mit dem bevorzugten Datenformat des Kunden übereinstimmen. Ordnen Sie die vom Kunden bereitgestellten Werte (z. B. Farbe oder Größe) den internen Gelato-Attributen zu.
Speichern Sie die Konfiguration.
API-Zugang: Stellen Sie sicher, dass Sie gültige API-Zugangsdaten und die erforderlichen Berechtigungen zum Aufgeben von Bestellungen haben.
Testdateien: Stellen Sie sicher, dass Sie Beispiel-Dateien zum Hochladen bereit haben (zum Beispiel druckfertige PDFs).
2. Einen Testauftrag mit der GelatoConnect API aufgeben
Folgen Sie diesen Schritten, um eine Testbestellung über die API aufzugeben:
API-Endpunkt
POST https://order.ie.live.gelato.tech/api/v4/orders
Beispiel für den Aufbau einer API-Anfrage
{
"clientId": "your-client-id",
"orderReferenceId": "test-order-ref",
"customerReferenceId": "test-customer-ref",
"orderType": "order",
"currency": "USD",
"retailCurrency": "USD",
"retailShippingPriceInclVat": 5.99,
"shippingAddress": {
"country": "US",
"firstName": "John",
"lastName": "Doe",
"addressLine1": "123 Test St",
"city": "Testville",
"postCode": "12345",
"state": "CA",
"email": "[email protected]",
"phone": "1234567890"
},
"items": [
{
"itemReferenceId": "test-item-ref",
"productName": "Sample Product",
"productVariant": {
"paper": "a1",
"color": "front"
},
"files": [
{
"type": "default",
"url": "https://example.com/test-file.pdf"
}
],
"quantity": 1,
"retailPriceInclVat": 19.99
}
]
}
Wichtige Angaben
Produktname: Muss genau mit dem Namen Ihres personalisierten Produkts in GelatoConnect übereinstimmen.
Produktvariante: Wählen Sie je nach Ihren Einstellungen Optionen wie Papiersorte, Größe oder Farbe aus.
Dateien: Geben Sie die URL der Datei an, die für die Produktion verwendet werden soll.
3. Die Testbestellung überprüfen
Sobald die Testbestellung aufgegeben wurde, prüfen Sie bitte Folgendes:
Bestellbestätigung: Prüfen Sie die API-Antwort, um sicherzustellen, dass die Bestellung erfolgreich erstellt wurde. Notieren Sie sich die Bestellnummer und den Fulfillment-Status.
Bestellübersicht in GNX: Melden Sie sich bei GelatoConnect (GNX) an, um die Details der Testbestellung einzusehen.
Stellen Sie sicher, dass alle Attribute und Varianten korrekt angewendet wurden.
Prüfen Sie, ob die Dateien erfolgreich hochgeladen wurden und den Produktionsanforderungen entsprechen.
Verpackungs-Check:
Prüfen Sie die Verpackungsdetails in der GNX-Anzeige.
Stellen Sie sicher, dass die ausgewählten Optionen (zum Beispiel Geschenkverpackung) Ihren Vorstellungen entsprechen.
Erstellen Sie personalisierte Verpackungsprüfungen (siehe Abschnitt 9 als Referenz)
Gestalten Sie personalisierte Regale (siehe Abschnitt 9 als Referenz)
Geben Sie den Barcode zusammen mit der Auftragsnummer manuell ein, um den Ablauf an der Verpackungsstation zu testen.
4. Probleme erkennen und lösen
Wenn die Testbestellung nicht Ihren Erwartungen entspricht:
Produktkonfiguration prüfen:
Überprüfen Sie, ob die Felder productName und productVariant in Ihrer API-Anfrage mit Ihrer Customer Product-Konfiguration übereinstimmen.
Stellen Sie sicher, dass alle erforderlichen Optionen enthalten und richtig zugeordnet sind.
Dateien prüfen: Stellen Sie sicher, dass die hochgeladenen Dateien die Größen- und Formatvorgaben für das Kundenprodukt erfüllen.
API-Zugangsdaten überprüfen: Stellen Sie sicher, dass die verwendeten Zugangsdaten die richtigen Berechtigungen zum Platzieren von Testbestellungen haben.
Support kontaktieren: Wenn das Problem weiterhin besteht, wenden Sie sich bitte mit der Bestellnummer und einer kurzen Beschreibung an den GelatoConnect Support.
Nächster Schritt: 🔗 [Erste Schritte – GCW] Produktion überwachen und Ausnahmen managen