Hvordan legge inn en bestilling med et personlig kundens produkt

Denne veiledningen tar deg gjennom hvordan du legger inn en ordre ved å bruke et kundeprodukt via GelatoConnect API. Kundeprodukter lar deg bruke dine egne produktkonfigurasjoner når du legger inn ordre, noe som gjør bestillingsprosessen enklere og sikrer at den er i tråd med dine interne produktdefinisjoner.

API-endepunkt

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

Struktur for forespørsel

Nøkkelelementene for å bruke et Customer Product i bestillingen din er feltene productName og productVariant i items-arrayen. Her er et eksempel på en forespørselsstruktur:

{
    "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økkelfelt for kundeprodukter

Når du bruker et kundeprodukt, legg ekstra godt merke til disse feltene i items-arrayet:

productName: Dette må være lik navnet på kundeproduktet ditt som definert i GelatoConnect.
productVariant: Dette objektet inneholder de spesifikke valgene for produktet ditt. Nøklene og verdiene må samsvare med variantvalgene du har satt opp for Customer Product-en din.

I eksempelet over:

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

Denne konfigurasjonen forteller GelatoConnect at det skal bruke kundeproduktet som heter «sample for order intake» med de angitte papir- og fargevalgene.

Viktige merknader

Når du bruker et kundeprodukt, trenger du ikke å oppgi en productUid for varen. Feltene productName og productVariant brukes i stedet til å bestemme den eksakte produktkonfigurasjonen.
Sørg for at productName er helt lik navnet på Kundeproduktet ditt i GelatoConnect.
productVariant-objektet skal bare inneholde alternativer som du har definert for Customer Product. Hvis du inkluderer alternativer som ikke er definert, vil det føre til en feil.
Resten av strukturen for ordreforespørselen er den samme som for en standardordre. Du kan inkludere flere produkter, der hvert produkt bruker en annen Customer Product om nødvendig.
Sørg alltid for at filene du leverer samsvarer med kravene i konfigurasjonen av det personaliserte kundeproduktet ditt.

Svar

Når du har sendt inn en ordre, får du et svar med detaljer om ordren, blant annet ordre-ID, produksjonsstatus og mer. Sjekk alltid svaret for å være sikker på at ordren ble behandlet riktig.

Feilsøking

Hvis du får problemer når du legger inn en bestilling med et personalisert produkt, sjekk følgende:

Kontroller at productName er helt likt navnet på kundens produkt.
Sørg for at alle nødvendige productVariant-alternativer er oppgitt og samsvarer med kundens produktkonfigurasjon.
Sjekk at de leverte filene oppfyller kravene til din personaliserte kundeprodukt.
Sjekk at API-legitimasjonen din er riktig, og at du har tillatelse til å bruke det angitte Customer Product.

Relaterte artikler

[Order Intake - GCW] Legge inn en bestilling ved hjelp av Customer Product