Så här lägger du en beställning med en kundprodukt

Den här guiden leder dig genom processen att lägga en beställning med en kundprodukt via GelatoConnect API. Kundprodukter låter dig använda dina egna produktkonfigurationer när du lägger beställningar, vilket förenklar beställningsprocessen och säkerställer överensstämmelse med dina interna produktdefinitioner.

API-endpunkt

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

Begäransstruktur

Nyckelelementen för att använda en kundprodukt i din beställning är fälten productName och productVariant inom arrayen items. Här är ett exempel på en request-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
        }
    ]
}

Nyckelfält för kundprodukter

När du använder en kundprodukt, lägg särskild vikt vid dessa fält i items-arrayen:

productName: Detta ska matcha namnet på din kundprodukt som definieras i GelatoConnect.
productVariant: Det här objektet innehåller de specifika alternativen för din produkt. Nycklarna och värdena ska matcha variantalternativen du har ställt in för din kundprodukt.

I exemplet ovan:

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

Den här konfigurationen säger åt GelatoConnect att använda kundprodukten som heter "sample for order intake" med de angivna pappers- och färgalternativen.

Viktiga anteckningar

När du använder en anpassad produkt behöver du inte ange ett productUid för artikeln. Fälten productName och productVariant används istället för att bestämma den exakta produktkonfigurationen.
Se till att productName exakt matchar namnet på din kundprodukt i GelatoConnect.
productVariant-objektet ska endast innehålla alternativ som du har definierat för din kundprodukt. Om du inkluderar odefinierade alternativ kommer det att resultera i ett fel.
Resten av orderförfrågans struktur förblir densamma som en standardorder. Du kan inkludera flera artiklar, var och en med en annan kundprodukt om det behövs.
Se alltid till att filerna du tillhandahåller matchar kraven för din anpassade produktkonfiguration.

Svar

När du har lagt en beställning kommer du att få ett svar som innehåller detaljer om beställningen, inklusive ett beställnings-ID, tillverkningsstatus och mer. Kontrollera alltid svaret för att säkerställa att din beställning har behandlats korrekt.

Felsökning

Om du stöter på problem när du lägger en beställning med en kundprodukt, kontrollera följande:

Verifiera att productName exakt matchar ditt kundproduktnamn.
Se till att alla obligatoriska productVariant-alternativ tillhandahålls och matchar din Customer Product-konfiguration.
Kontrollera att de bifogade filerna uppfyller kraven för din kundprodukt.
Verifiera att dina API-uppgifter är korrekta och att du har behörighet att använda den angivna kundprodukten.

Relaterade artiklar

[Order Intake - GCW] Lägga en beställning med Customer Product