Sådan afgiver du en ordre ved hjælp af et kundeprodukt

Denne guide vil føre dig gennem processen med at afgive en ordre ved hjælp af et kundeprodukt via GelatoConnect API'en. Kundeprodukter giver dig mulighed for at bruge dine egne produktkonfigurationer, når du afgiver ordrer, hvilket forenkler ordreprocessen og sikrer konsistens med dine interne produktdefinitioner.

API-endepunkt

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

Anmodningsstruktur

De vigtigste elementer til at bruge et kundeprodukt i din ordre er felterne productName og productVariant i items-arrayet. Her er et eksempel 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
        }
    ]
}

Nøglefelter til kundeprodukter

Når du bruger et kundeprodukt, skal du være særligt opmærksom på disse felter i items-arrayet:

productName: Dette skal matche navnet på dit kundeprodukt som defineret i GelatoConnect.
productVariant: Dette objekt indeholder de specifikke muligheder for dit produkt. Nøglerne og værdierne skal matche de variantmuligheder, du har sat op for dit kundeprodukt.

I eksemplet ovenfor:

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

Denne konfiguration fortæller GelatoConnect, at den skal bruge kundeproduktet med navnet "sample for order intake" med de angivne papir- og farveindstillinger.

Vigtige bemærkninger

Når du bruger et tilpasset produkt, behøver du ikke at angive en productUid for varen. Felterne productName og productVariant bruges i stedet til at bestemme den præcise produktkonfiguration.
Sørg for, at productName nøjagtigt matcher navnet på dit kundeprodukt i GelatoConnect.
productVariant-objektet bør kun indeholde valgmuligheder, som du har defineret for dit kundeprodukt. Hvis du inkluderer udefinerede valgmuligheder, vil det resultere i en fejl.
Resten af ordreforespørgselsstrukturen forbliver den samme som en standardordre. Du kan inkludere flere varer, hver med et forskelligt kundeprodukt, hvis det er nødvendigt.
Sørg altid for, at de filer, du leverer, matcher kravene i din tilpassede produktkonfiguration.

Svar

Når du har afgivet en ordre, modtager du et svar, der indeholder detaljer om ordren, herunder et ordre-ID, fulfillment-status og mere. Tjek altid svaret for at sikre, at din ordre blev behandlet korrekt.

Fejlfinding

Hvis du støder på problemer, når du afgiver en ordre med et kundeprodukt, så tjek følgende:

Bekræft, at productName matcher dit kundeprodukt navn præcist.
Sørg for, at alle nødvendige productVariant-indstillinger er angivet og matcher din Customer Product-konfiguration.
Tjek, at de uploadede filer opfylder kravene til dit kundeprodukt.
Bekræft, at dine API-legitimationsoplysninger er korrekte, og at du har tilladelse til at bruge det angivne kundeprodukt.

Relaterede artikler

[Order Intake - GCW] Afgiv en ordre ved hjælp af Customer Product