So platzieren Sie eine Bestellung mit einem personalisierten Kundenprodukt

In dieser Anleitung führen wir Sie Schritt für Schritt durch den Prozess, eine Bestellung mit einem Customer Product über die GelatoConnect API aufzugeben. Customer Products ermöglichen es Ihnen, bei Bestellungen Ihre eigenen Produktkonfigurationen zu verwenden, wodurch der Bestellprozess vereinfacht wird und die Konsistenz mit Ihren internen Produktdefinitionen gewährleistet ist.

API-Endpunkt

POST https://order.ie.live.gelato.tech/api/v4/orders

Aufbau der Anfrage

Die Schlüsselelemente für die Verwendung eines Customer-Produkts in Ihrer Bestellung sind die Felder productName und productVariant im items-Array. Hier ist eine Beispielanfrage-Struktur:

{
    "clientId": "your-client-id",
    "orderReferenceId": "your-order-reference",
    "customerReferenceId": "your-customer-reference",
    "orderType": "order",
    "currency": "USD",
    "retailCurrency": "USD",
    "retailShippingPriceInclVat": 5.99,
    "shippingAddress": {
        "country": "US",
        "firstName": "John",
        "lastName": "Doe",
        "addressLine1": "123 Main St",
        "city": "Anytown",
        "postCode": "12345",
        "state": "CA",
        "email": "[email protected]",
        "phone": "1234567890"
    },
    "items": [
        {
            "itemReferenceId": "your-item-reference",
            "productName": "sample for order intake",
            "productVariant": {
                "paper": "a1",
                "color": "front"
            },
            "files": [
                {
                    "type": "default",
                    "url": "https://example.com/your-file.pdf"
                }
            ],
            "quantity": 1,
            "retailPriceInclVat": 79.99
        }
    ]
}

Wichtige Felder für personalisierte Kundenprodukte

Wenn Sie ein personalisiertes Produkt verwenden, achten Sie besonders auf diese Felder im items-Array:

productName: Dies sollte mit dem Namen Ihres personalisierten Produkts übereinstimmen, wie er in GelatoConnect definiert ist.
productVariant: Dieses Objekt enthält die spezifischen Optionen für Ihr Produkt. Die Schlüssel und Werte sollten mit den Variantenoptionen übereinstimmen, die Sie für Ihr Customer Product festgelegt haben.

Im obigen Beispiel:

"productName": "sample for order intake",
"productVariant": {
    "paper": "a1",
    "color": "front"
}

Diese Konfiguration weist GelatoConnect an, das Customer Product mit dem Namen "sample for order intake" mit den angegebenen Papier- und Farboptionen zu verwenden.

Wichtige Hinweise

Wenn Sie ein Customer Product verwenden, müssen Sie für den Artikel keine productUid angeben. Stattdessen werden die Felder productName und productVariant verwendet, um die genaue Produktkonfiguration zu bestimmen.
Stellen Sie sicher, dass der productName genau mit dem Namen Ihres Customer Product in GelatoConnect übereinstimmt.
Das Objekt productVariant sollte nur Optionen enthalten, die Sie für Ihr Customer Product definiert haben. Wenn nicht definierte Optionen enthalten sind, führt dies zu einem Fehler.
Der Rest der Bestellanfrage-Struktur bleibt der gleiche wie bei einer Standardbestellung. Sie können mehrere Artikel einschließen, die bei Bedarf jeweils ein anderes Customer Product verwenden.
Stellen Sie immer sicher, dass die von Ihnen bereitgestellten Dateien den Anforderungen Ihrer Customer-Product-Konfiguration entsprechen.

Antwort

Nachdem du eine Bestellung erfolgreich aufgegeben hast, erhältst du eine Antwort mit Details zur Bestellung, einschließlich einer Bestell-ID, dem Fulfillment-Status und weiteren Informationen. Überprüfe diese Antwort immer, um sicherzustellen, dass deine Bestellung korrekt verarbeitet wurde.

Fehlerbehebung

Wenn Sie beim Aufgeben einer Bestellung mit einem personalisierten Produkt auf Probleme stoßen, überprüfen Sie Folgendes:

Überprüfen Sie, ob productName genau mit dem Namen Ihres Customer Product übereinstimmt.
Stellen Sie sicher, dass alle erforderlichen productVariant-Optionen angegeben sind und mit Ihrer Customer-Product-Konfiguration übereinstimmen.
Überprüfen Sie, ob die bereitgestellten Dateien die Anforderungen Ihres Customer Product erfüllen.
Überprüfen Sie, ob Ihre API-Zugangsdaten korrekt sind und ob Sie die Berechtigung haben, das angegebene Customer Product zu verwenden.

Verwandte Artikel

[Order Intake - GCW] Eine Bestellung mit Customer Product aufgeben