Test produktoppsettene, emballasjen og bestillingsflyten grundig med GelatoConnect API.
1. Slik gjør du deg klar til å legge inn en testbestilling
Før du legger inn en testbestilling, sjekk at du har:
Oppsett av kundeprodukt: Lag kundeproduktet med nødvendige egenskaper og varianter. Følg disse stegene:
Gå til delen for kundeprodukter i GelatoConnect.
Velg riktig produktmodell (for eksempel Plakatprodukt).
Definer grunnleggende attributter og varianter, og sørg for at de passer med kundens foretrukne dataformat. Koble verdier fra kunden, som for eksempel farge eller størrelse, til Gelatos interne attributter.
Lagre oppsettet.
API-tilgang: Sjekk at du har gyldige API-opplysninger og nødvendige tillatelser for å legge inn bestillinger.
Testfiler: Sørg for at du har eksempelfiler klare til opplasting, for eksempel trykkeklare PDF-er.
2. Slik legger du inn en testbestilling med GelatoConnect API
Følg disse trinnene for å legge inn en testbestilling via API-et:
API-endepunkt
POST https://order.ie.live.gelato.tech/api/v4/orders
Eksempel på API-forespørsel
{
"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
}
]
}
Viktige felt
productName: Må være nøyaktig det samme som navnet på ditt kundeprodukt i GelatoConnect.
productVariant: Velg alternativer som papirtype, størrelse eller farge ut fra oppsettet ditt.
filer: Legg inn nettadressen til filen som skal brukes i produksjon.
3. Slik sjekker du testbestillingen
Når testbestillingen er lagt inn, sjekk dette:
Ordrebekreftelse: Sjekk API-svaret for å være sikker på at bestillingen ble opprettet. Noter deg ordre-ID og produksjonsstatus.
Ordrevisning i GNX: Logg inn på GelatoConnect (GNX) for å se detaljene for testordren.
Bekreft at alle attributter og varianter er riktig lagt inn.
Sjekk at filene er lastet opp og oppfyller kravene til produksjon.
Sjekk av emballasje:
Se over emballasjedetaljene i GNX-displayet.
Sjekk at valgene du har gjort (for eksempel gaveinnpakning) stemmer med det du ønsker.
Lag personlig tilpassede emballasjekontroller (se avsnitt 9 for referanse)
Lag personlig tilpassede hyller (se avsnitt 9 for mer informasjon)
Skriv inn strekkoden manuelt sammen med produksjonsnummeret for å teste flyten på pakkestasjonen
4. Feilsøking av problemer
Hvis testbestillingen ikke lever opp til forventningene:
Sjekk produktoppsettet:
Sjekk at feltene productName og productVariant i API-forespørselen stemmer med oppsettet for ditt personlig tilpassede produkt.
Sjekk at alle nødvendige valg er med og koblet riktig.
Se over filer: Sjekk at de opplastede filene oppfyller kravene til størrelse og format for kundens produkt.
Sjekk API-tilganger: Sørg for at tilgangene du bruker har riktige rettigheter for å legge inn testbestillinger.
Kontakt kundestøtte: Hvis problemet vedvarer, ta kontakt med GelatoConnect kundestøtte og oppgi ordre-ID og detaljer om problemet.