Test dine produktopsætninger, emballage og ordreflow grundigt med GelatoConnect API'et, så du er sikker på, at alt spiller, før du går i luften.
1. Sådan gør du klar til at lægge en testordre
Før du laver en testordre, skal du sikre dig, at du har:
Opsætning af kundetilpasset produkt: Opret det tilpassede produkt med de nødvendige egenskaber og varianter. Følg disse trin:
Gå til sektionen Kundeprodukter i GelatoConnect.
Vælg den relevante produkttype (for eksempel Plakat-produkt).
Definér grundattributterne og varianterne, så de passer til kundens foretrukne dataformat. Tilknyt de værdier, kunden har givet (f.eks. farve eller størrelse), til Gelatos interne attributter.
Gem indstillingerne.
API-adgang: Tjek, at du har gyldige API-oplysninger og de rette tilladelser til at lægge ordrer.
Testfiler: Sørg for, at du har eksempler klar til upload – for eksempel printklare PDF'er.
2. Sådan laver du en testordre med GelatoConnect API'et
Følg disse trin for at lave en testordre via API'en:
API-endepunkt
POST https://order.ie.live.gelato.tech/api/v4/orders
Eksempel på API-anmodningsstruktur
{
"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
}
]
}
Vigtige felter
productName: Skal matche det præcise navn på dit kundeprodukt i GelatoConnect.
productVariant: Vælg muligheder som papirkvalitet, størrelse eller farve, alt efter hvordan du har sat det op.
filer: Giv URL'en til den fil, der skal bruges i produktionen.
3. Bekræftelse af testordren
Når testordren er lagt, skal du tjekke følgende:
Ordrebekræftelse: Tjek API-svaret for at sikre, at ordren er oprettet. Husk ordrenummeret og Fulfillment-status.
Ordrevisning i GNX: Log ind på GelatoConnect (GNX) for at se detaljerne om testordren.
Bekræft, at alle attributter og varianter er sat rigtigt op.
Tjek, at filerne er uploadet korrekt og lever op til produktionskravene.
Tjek af emballage:
Gennemgå emballagedetaljerne i GNX-displayet.
Sørg for, at de valgte muligheder (f.eks. gaveindpakning) passer til det, du forventer.
Lav tilpassede emballagetjek (se afsnit 9 for reference)
Lav tilpassede hylder (se afsnit 9 for reference)
Indtast stregkoden manuelt sammen med printjobnummeret for at teste flowet i pakkestationen
4. Løs problemer
Hvis testordren ikke lever op til dine forventninger:
Tjek produktopsætning:
Tjek, at felterne productName og productVariant i din API-anmodning passer med din opsætning af Customer Product.
Sørg for, at alle nødvendige valg er med og sat rigtigt op.
Tjek filer: Sørg for, at de uploadede filer lever op til kravene for størrelse og format til kundens produkt.
Tjek API-oplysninger: Sørg for, at de oplysninger du bruger, har de rigtige tilladelser til at lave testordrer.
Kontakt support: Hvis problemet bliver ved, så kontakt GelatoConnect support med ordrenummeret og en beskrivelse af problemet.
Næste skridt: 🔗 [Kom i gang – GCW] Overvåg produktionen og håndter undtagelser