Test je productinstellingen, verpakkingen en bestelprocessen grondig met de GelatoConnect API.
1. Je voorbereiden op het plaatsen van een testbestelling
Voordat je een testbestelling plaatst, zorg ervoor dat je het volgende hebt gedaan:
Klantproduct instellen: Maak het klantproduct aan met de vereiste eigenschappen en varianten. Volg deze stappen:
Navigeer naar het gedeelte Klantproducten in GelatoConnect.
Selecteer het relevante productmodel (bijv. Poster Product).
Definieer de basisattributen en varianten, en zorg ervoor dat deze overeenkomen met het voorkeursgegevensformaat van de klant. Koppel door de klant opgegeven waarden (bijv. kleur of maat) aan interne Gelato-attributen.
Sla de configuratie op.
API-toegang: Controleer of je geldige API-inloggegevens en toegangsrechten hebt voor het plaatsen van bestellingen.
Testbestanden: Zorg ervoor dat je voorbeeldbestanden klaar hebt om te uploaden (bijv. drukklare PDF's).
2. Een testbestelling plaatsen met de GelatoConnect API
Volg de volgende stappen om een testbestelling te plaatsen via de API:
API-eindpunt
POST https://order.ie.live.gelato.tech/api/v4/orders
Voorbeeld van API-aanvraagstructuur
{
"clientId": "your-client-id",
"orderReferenceId": "test-order-ref",
"customerReferenceId": "test-customer-ref",
"orderType": "order",
"currency": "USD",
"retailCurrency": "USD",
"retailShippingPriceInclVat": 5.99,
"shippingAddress": {
"country": "US",
"firstName": "John",
"lastName": "Doe",
"addressLine1": "123 Test St",
"city": "Testville",
"postCode": "12345",
"state": "CA",
"email": "[email protected]",
"phone": "1234567890"
},
"items": [
{
"itemReferenceId": "test-item-ref",
"productName": "Sample Product",
"productVariant": {
"paper": "a1",
"color": "front"
},
"files": [
{
"type": "default",
"url": "https://example.com/test-file.pdf"
}
],
"quantity": 1,
"retailPriceInclVat": 19.99
}
]
}
Belangrijke velden
productName: Moet exact overeenkomen met de naam van je klantproduct in GelatoConnect.
productVariant: Specificeer opties zoals papiersoort, formaat of kleur op basis van je instellingen.
bestanden: Geef de URL op voor het bestand dat in productie gebruikt moet worden.
3. De testbestelling valideren
Zodra de testbestelling is geplaatst, controleer het volgende:
Orderbevestiging: Controleer de API-respons om te verzekeren dat de order succesvol is aangemaakt. Let op het ordernummer en de fulfilment-status.
Weergave van bestelling in GNX: Log in op GelatoConnect (GNX) om de details van de testbestelling te bekijken.
Bevestig dat alle kenmerken en varianten correct zijn toegepast.
Controleer of de bestanden succesvol zijn geüpload en voldoen aan de productievereisten.
Verpakkingscontrole:
Bekijk de verpakkingsdetails in het GNX-display.
Zorg ervoor dat de geselecteerde opties (bijv. cadeauverpakking) overeenkomen met je verwachtingen.
Maak gepersonaliseerde verpakkingscontroles (zie sectie 9 ter referentie)
Maak gepersonaliseerde planken (zie sectie 9 ter referentie)
Voer de barcode handmatig in met het printopdrachtnummer om de verpakkingsstationworkflow te testen
4. Problemen oplossen
Als de testbestelling niet aan de verwachtingen voldoet:
Controleer productconfiguratie:
Controleer of de velden productName en productVariant in het API-verzoek overeenkomen met je Customer Product-instellingen.
Zorg ervoor dat alle vereiste opties zijn opgenomen en correct zijn toegewezen.
Bestanden controleren: Bevestig dat de geüploade bestanden voldoen aan de vereisten voor formaat en bestandstype van het Gepersonaliseerde Product.
Controleer API-inloggegevens: Verifieer dat de gebruikte inloggegevens de juiste rechten hebben voor het plaatsen van testbestellingen.
Contact Support: Neem bij aanhoudende problemen contact op met de klantenservice van GelatoConnect en vermeld het ordernummer en de details van het probleem.
Volgende stap: 🔗 [Aan de slag - GCW] Productie monitoren en uitzonderingen beheren