Hoe plaatst u een bestelling met een klantproduct

In deze gids laten we je stap voor stap zien hoe je een bestelling plaatst met een customer product via de GelatoConnect API. Met customer products kun je je eigen productconfiguraties gebruiken wanneer je bestellingen plaatst, zodat het bestelproces eenvoudiger wordt en aansluit bij je interne productdefinities.

API-eindpunt

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

Structuur van het verzoek

De belangrijkste onderdelen voor het gebruik van een customer product in je bestelling zijn de velden productName en productVariant binnen de items-array. Hier zie je een voorbeeld van de structuur van een request:

{
    "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
        }
    ]
}

Belangrijke velden voor klantproducten

Als u een klantproduct gebruikt, let dan extra goed op deze velden in de items-array:

productName: dit moet overeenkomen met de naam van uw klantproduct zoals gedefinieerd in GelatoConnect.
productVariant: Dit object bevat de specifieke opties voor je product. De keys en waarden moeten overeenkomen met de variantopties die je hebt ingesteld voor je klantproduct.

In het voorbeeld hierboven:

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

Deze configuratie vertelt GelatoConnect om het klantproduct met de naam "sample for order intake" te gebruiken met de opgegeven papier- en kleuropties.

Belangrijke opmerkingen

Als u een klantproduct gebruikt, hoeft u geen productUid op te geven voor het item. In plaats daarvan worden de velden productName en productVariant gebruikt om de exacte productconfiguratie te bepalen.
Zorg ervoor dat de productName exact overeenkomt met de naam van uw klantproduct in GelatoConnect.
Het object productVariant mag alleen opties bevatten die je hebt gedefinieerd voor je klantproduct. Het opnemen van niet-gedefinieerde opties resulteert in een foutmelding.
De rest van de structuur van de orderaanvraag blijft de zelfde als bij een standaard bestelling. Je kunt meerdere items opnemen, waarbij elk item indien nodig een ander customer product gebruikt.
Zorg er altijd voor dat de bestanden die je aanlevert aansluiten bij de vereisten van de productconfiguratie van je klant.

Reactie

Nadat je met succes een bestelling hebt geplaatst, ontvang je een antwoord met alle details over de bestelling, waaronder een bestel-ID, de status van de afhandeling en meer. Controleer dit antwoord altijd om zeker te weten dat je bestelling correct is verwerkt.

Probleemoplossing

Als je problemen tegenkomt tijdens het plaatsen van een bestelling met een klantproduct, controleer dan het volgende:

Controleer of de productName exact overeenkomt met de productnaam van uw klant.
Zorg ervoor dat alle vereiste productVariant-opties zijn opgegeven en overeenkomen met de configuratie van uw klantproduct.
Controleer of de aangeleverde bestanden voldoen aan de vereisten van uw klantproduct.
Controleer of je API-inloggegevens kloppen en of je toestemming hebt om het opgegeven customer product te gebruiken.

[Order Intake - GCW] Een bestelling plaatsen met klantproduct