Dit artikel biedt een uitgebreide handleiding voor het efficiënt importeren van bestellingen via een CSV-bestand. Stroomlijn je bestellingenbeheer door bestellingen in bulk te importeren, waardoor je ze niet meer handmatig hoeft in te voeren.
Je CSV-bestand voorbereiden voor import
Voordat je het importproces start, zorg ervoor dat je CSV-bestand goed is opgebouwd. Download het CSV-sjabloon om zeker te zijn van de juiste opmaak. Elke rij in het CSV-bestand staat voor één artikelregel, waardoor bestellingen over meerdere rijen kunnen lopen. Gebruik de kolom "orderReferenceId" om artikelregels aan de juiste bestelling te koppelen.
Opmerking: Als kolomkoppen in één kolom verschijnen bij het openen van een CSV in Excel, probeer dan deze oplossingen:
Gebruik Google Sheets: Opent CSV-bestanden correct met gescheiden kolommen.
Handmatig aanpassen in Excel: Converteer het bestand naar het juiste formaat door elke koptekst in een aparte kolom te plaatsen.
Neem voor elke rij de essentiële ordergegevens op:
Referentie-ID bestelling
Verzendgegevens
Artikelgegevens
URL's voor elk printgebied
Voor een gedetailleerde uitleg van de vereiste velden in het CSV-bestand, raadpleeg de \"Submit order\"-pagina in onze API-documentatie.
Bestellingen importeren: Een stap-voor-stap handleiding
Volg deze stappen om je bestellingen probleemloos te importeren:
Log in op Gelato Connect
Voeg een handmatige winkel toe.
Navigeer naar https://storefronts.gelato.com/orders/list
Ga naar de bestellingenpagina in GelatoConnect Storefronts en klik op de knop \"Importeren\".
Kies de aangewezen winkel voor je geïmporteerde bestellingen. Deze bestellingen worden gemarkeerd als geplaatst vanuit de geselecteerde winkel. Je hebt ook de mogelijkheid om ze als handmatige bestellingen te importeren.
Upload het CSV-bestand met de bestellingen die je wilt importeren. Je kunt ook een nieuw CSV-sjabloon downloaden vanaf deze pagina.
Controleer nogmaals of je de juiste doelwinkel en importbestand hebt geselecteerd. Zodra alles in orde is, klik je op \"Importeren\" om het importproces te starten.
Je ontvangt een melding die bevestigt dat het importproces is gestart.
Zodra het importproces is voltooid, sturen we je een e-mailnotificatie. Deze e-mail bevat een samenvatting van de import, inclusief:
Het totale aantal bestellingen in het importbestand.
Het aantal bestellingen dat succesvol is geïmporteerd.
Het aantal bestellingen dat niet kon worden geïmporteerd.
Daarnaast bevat de e-mail een CSV-bestand met gedetailleerde importresultaten. Dit bestand heeft drie kolommen:
bestelreferentieId
resultaat (geeft aan of een bestelling "geslaagd" of "mislukt" is)
fouten (met specifieke redenen voor eventuele importproblemen)
Vereiste parameters begrijpen voor CSV-bestand voor import
Hieronder vind je een duidelijk overzicht van de benodigde parameters en de bijbehorende documentatie, zodat je het spreadsheet makkelijk en correct kunt invullen.
Deze methode wordt vooral gebruikt door mensen die het platform willen uitproberen voordat ze onze API's koppelen of losse bestellingen plaatsen.
Algemene bestelinformatie
orderReferenceId – Toont het ordernummer in het Gelato dashboard. Voorbeeld:
G-250202201217.customerReferenceId – Interne klant-ID-referentie.
orderType – Kan worden ingesteld als
draft, maar staat standaard oporder.shipmentMethodUid – Specificeert de verzendmethode:
normal,standard, ofexpress.valuta – Valuta gebruikt voor betaling.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Wordt gebruikt in analyses en op verschillende plekken in het platform, zoals bij douaneformulieren.
Verzendadresgegevens
Deze parameters horen bij de standaard adresvelden:
verzendadres.voornaam
shippingAddress.achternaam
shippingAddress.addressLine1
shippingAddress.addressLine2
verzendadres.stad
shippingAddress.postCode
shippingAddress.provincie
shippingAddress.land
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName
Productinformatie
item.itemReferenceId – Komt overeen met
Item Reference IDin de bestelling. Voor Ecommerce platformbestellingen wordt dit automatisch toegekend. Bij handmatige bestellingen moet je dit zelf invullen.item.productUid
item.storeProductVariantId
item.quantity – Geeft aan hoeveel stuks er zijn besteld.
item.pageCount – Nodig voor producten met meerdere pagina’s (zoals brochures).
Parameters specifiek voor borduurwerk
Voor borduurontwerpen zijn extra gegevens nodig.
item.adjustProductUidByFileTypes
item.file1.id, item.file1.type, item.file1.url, item.file1.threadColors, item.file1.fitMethod, item.file1.fillMethod
item.file2.id, item.file2.type, item.file2.url, item.file2.threadColors, item.file2.fitMethod, item.file2.fillMethod
Omdat het indienen van bestellingen via CSV veel tijd kost aan spreadsheetbeheer en het klaarmaken van drukbestanden, raden we aan om gebruik te maken van soepelere fulfilment-opties via een API-integratie. Zo werk je slimmer en bespaar je jezelf een hoop handmatig gedoe.