Testa dina produktinställningar, förpackningar och orderflöden ordentligt med GelatoConnect API.
1. Så förbereder du dig för att lägga en testorder
Innan du lägger en testbeställning, se till att du har:
Så här sätter du upp en kundprodukt: Skapa kundprodukten med de egenskaper och varianter som behövs. Gör så här:
Gå till avsnittet Kundprodukter i GelatoConnect.
Välj den produktmodell som passar (t.ex. posterprodukt).
Bestäm grundegenskaperna och varianterna så att de passar kundens önskade dataformat. Matcha de värden kunden skickar in (till exempel färg eller storlek) med Gelatos interna attribut.
Spara inställningarna.
API-åtkomst: Bekräfta att du har giltiga API-uppgifter och åtkomstbehörigheter för att lägga beställningar.
Testfiler: Se till att du har exempelfiler redo att ladda upp, till exempel tryckfärdiga PDF:er.
2. Så här lägger du en testorder med GelatoConnect API
Följ de här stegen för att lägga en testorder via API:et:
API-endpunkt
POST https://order.ie.live.gelato.tech/api/v4/orders
Exempel på API-förfrågningsstruktur
{
"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
}
]
}
Viktiga fält
produktnamn: Måste stämma exakt överens med namnet på din kundprodukt i GelatoConnect.
produktvariant: Välj alternativ som papperstyp, storlek eller färg beroende på hur du har ställt in det.
filer: Ange webbadressen till filen som ska användas i produktionen.
3. Så här kollar du att testordern är giltig
När testordern är lagd, kolla in följande:
Orderbekräftelse: Kolla API-svaret för att se att din beställning har gått igenom. Spara order-ID och kolla hur det går med leveransen.
Ordervisning i GNX: Logga in på GelatoConnect (GNX) för att se detaljerna om testordern.
Dubbelkolla att alla attribut och varianter är rätt inställda.
Dubbelkolla att filerna har laddats upp som de ska och att de uppfyller kraven för produktion.
Kolla förpackningen:
Kolla in förpackningsdetaljerna i GNX-vyn.
Dubbelkolla att de valda alternativen (till exempel presentinslagning) stämmer med vad du vill ha.
Skapa personliga förpackningskontroller (se avsnitt 9 för mer info)
Skapa personliga hyllor (se avsnitt 9 för mer info)
Mata in streckkoden manuellt tillsammans med tryckjobbsnumret för att testa flödet i packstationen
4. Felsök vanliga problem
Om testordern inte lever upp till förväntningarna:
Kolla produktinställningarna:
Dubbelkolla att fälten productName och productVariant i din API-förfrågan stämmer överens med hur du har lagt upp din kundprodukt.
Se till att alla nödvändiga val finns med och är rätt kopplade.
Granska filer: Kolla att de uppladdade filerna har rätt storlek och format för kundens produkt.
Granska API-uppgifter: Kolla att uppgifterna du använder har rätt behörighet för att lägga testbeställningar.
Kontakta supporten: Om problemet inte försvinner, hör av dig till GelatoConnects support och ange order-ID och vad som har hänt.