Wat doet het importeren van historische Shopify-bestellingen in Alva?
Het importeren van historische Shopify-bestellingen in Alva Digital Downloads herstelt de aankoopregistraties voor bestellingen die zijn geplaatst voordat de app werd geïnstalleerd. De importtool leest een CSV van eerdere bestellingen, koppelt elk regelitem aan een bestaande productkoppeling en schrijft de ontbrekende aankoop weg. Downloads verschijnen vervolgens met terugwerkende kracht op de klantaccountpagina en de bestelstatuspagina.
Zie het als een backfill. Aan de oorspronkelijke bestellingen verandert niets in Shopify. Alva krijgt simpelweg de leveringsregistraties die het de eerste keer nooit ontving, en elke gekoppelde klant krijgt weer selfservicetoegang tot precies de bestanden die aan hun aankoop zijn verbonden.
Waarom bestellingen van vóór de installatie hun bestanden niet kunnen downloaden
Alva levert bestanden door te luisteren naar Shopify's ORDERS_PAID-webhook. Elke betaalde bestelling activeert die webhook, Alva maakt een aankoopregistratie aan, en de klant krijgt downloadtoegang. Bestellingen die zijn geplaatst voordat je de app installeerde, hebben die webhook nooit voor Alva geactiveerd, dus er is nooit een aankoopregistratie voor gemaakt.
Zonder aankoopregistratie is er niets voor de klantgerichte oppervlakken om te tonen. Een koper die zijn bestelstatuspagina of het downloadtabblad in zijn Shopify-account opent, ziet een lege plek waar zijn bestand zou moeten staan. Er is geen link om op te klikken, omdat Alva geen registratie heeft dat de verkoop heeft plaatsgevonden.
In de praktijk mondt dit uit in een stroom van "waar is mijn bestand?"-tickets — en het treft het hardst in de dagen direct nadat je van app wisselt, wanneer trouwe klanten terugkomen en verwachten dat de downloadknop die ze eerder gebruikten nog werkt.
De drie harde garanties: geen e-mails, geen fraudechecks, geen licentiesleutels
Een historische import kan duizenden oude bestellingen tegelijk raken, dus Alva behandelt deze als een stille operatie met drie in code afgedwongen garanties. De import verstuurt geen e-mails, voert geen fraudechecks uit en wijst geen licentiesleutels toe. Geen van deze kan voor de import weer worden ingeschakeld — het zijn bewuste harde limieten.
De redenering achter elk is eenvoudig:
- Geen e-mails. Twee jaar aan bestellingen backfillen mag nooit twee jaar aan klanten bestoken met leveringsmeldingen. Niemand krijgt een e-mail; de downloads worden simpelweg beschikbaar voor de volgende keer dat elke klant zijn account bezoekt.
- Geen fraudechecks. Deze bestellingen zijn al lang geleden betaald, uitgevoerd en afgewikkeld. Ze opnieuw door de fraudepijplijn halen zou je wachtrij overspoelen met controles op transacties die al lang verleden tijd zijn.
- Geen licentiesleutels. De import put nooit uit je licentiesleutelvoorraad. Een bulk-backfill die sleutels aan oude bestellingen toewijst, zou stilletjes voorraad kunnen uitputten die je vasthoudt voor live verkopen, dus sleuteltoewijzing wordt volledig overgeslagen.
Het hele punt van de historische import is om toegang stilletjes te herstellen. Het is een reparatie op de achtergrond, geen herlevering. Je klanten krijgen hun downloads terug zonder ook maar één melding, en je licentiesleutelvoorraad en fraudewachtrij blijven onaangeroerd.
Het is idempotent, dus opnieuw uitvoeren is veilig
De historische import is idempotent, wat betekent dat deze twee keer uitvoeren hetzelfde resultaat oplevert als één keer uitvoeren. Dezelfde CSV opnieuw uploaden maakt geen dubbele aankopen aan — Alva herkent registraties die al bestaan en slaat ze over, waarbij alleen de aankopen worden aangemaakt die echt ontbreken.
Dat vangnet is belangrijker dan het klinkt. Als een grote upload wordt onderbroken, kun je deze simpelweg opnieuw uitvoeren. Als je later productkoppelingen toevoegt voor een tweede reeks producten, kun je dezelfde bestelgeschiedenis opnieuw importeren en worden alleen de nieuw koppelbare bestellingen gebackfilld. Er is geen straf voor het meer dan één keer uitvoeren.
Hoe je je historische bestellingen stap voor stap importeert
De import draait vanuit een CSV die je uit Shopify exporteert. Op hoofdlijnen zijn er vier stappen: je producten koppelen, de bestellingen exporteren, het bestand uploaden en importeren. Zorg voordat je begint dat je digitale producten al aan hun bestanden zijn gekoppeld in Alva — de importtool matcht tegen die koppelingen.
1. Koppel eerst je producten aan bestanden
De importtool werkt door de regelitems van elke historische bestelling te matchen tegen je bestaande productkoppelingen. Als een product nog niet aan een bestand, pakket of link in Alva is gekoppeld, hebben zijn oude bestellingen niets om aan te hechten. Stel je koppelingen in voordat je importeert, zodat elke eerdere bestelling zijn match kan vinden.
2. Exporteer historische bestellingen uit Shopify
Open in je Shopify-beheeromgeving Bestellingen, filter op het datumbereik dat je wilt backfillen, en gebruik Exporteren om de bestellingen als CSV te downloaden. Shopify's eigen documentatie over het exporteren van bestellingen loopt de filters en het bestandsformaat door.
3. Upload de CSV in Alva en importeer
Terug in de Alva-beheeromgeving open je de historische bestelimport, upload je je CSV en voer je de import uit. Alva leest elke rij, matcht regelitems tegen je koppelingen en maakt de ontbrekende aankopen aan. Wanneer het klaar is, staan de downloads voor elke gekoppelde bestelling live op de klantaccount- en bestelstatuspagina's.
CSV-imports zijn kieskeurig over kolomnamen en formaten. Voor de exacte kolommen die Alva verwacht en een uitleg per scherm volg je vóór het uploaden het stap-voor-stap-helpartikel over het importeren van historische Shopify-bestellingen.
Migreren van SendOwl, Gumroad of Shopify's native downloads
Van digitale-leveringstool wisselen is het moment waarop deze functie zich terugverdient. Wanneer je naar Alva overstapt vanuit SendOwl, Gumroad of Shopify's native digitale-downloadsproces, gaan alleen nieuwe bestellingen automatisch via Alva lopen. Elke verkoop van vóór de overstap is onzichtbaar voor de nieuwe app totdat je deze backfillt.
De historische import is de stap die je bestaande klanten heel houdt tijdens een migratie. Importeer je eerdere bestellingen en niemand verliest toegang tot wat ze al hebben gekocht — de koper die vorig jaar een presetpakket kocht, kan het nog steeds opnieuw downloaden, ook al vond die verkoop plaats op je oude platform. Als je een overstap overweegt, behandelt ons stuk over hoe overstappen van SendOwl naar Alva er echt uitziet de rest van de overgang.
Waar geïmporteerde downloads voor klanten verschijnen
Eenmaal geïmporteerd gedraagt een historische aankoop zich als elke andere. De download verschijnt op de Shopify-bestelstatuspagina voor die bestelling en in het digitale-downloadsgedeelte van het account van de klant, zodat kopers zichzelf kunnen helpen zonder contact met je op te nemen. Het hergebruikt dezelfde leveringsoppervlakken die elke live Alva-bestelling al oplicht.
Omdat er geen e-mail wordt verzonden, staat de toegang klaar te wachten in plaats van aangekondigd. Dat is meestal precies wat je wilt na een migratie: de volgende keer dat een eerdere klant zijn bestand zoekt, is het er gewoon. Voor een rondleiding langs elke plek waar klanten hun bestanden kunnen bereiken, zie onze gids over de manieren waarop klanten hun digitale downloads op Shopify krijgen.
Wie de historische import kan gebruiken
De historische bestelimport is vandaag algemeen beschikbaar voor elke Alva-winkel, na het afronden van een eerdere bèta. Er is geen wachtlijst en geen speciale vlag om aan te vragen — exporteer je bestellingen, koppel je producten en voer deze uit wanneer je moet backfillen. Bekijk je plan voor opslag- en leveringslimieten en importeer vervolgens zoveel eerdere bestellingen als je geschiedenis bevat.
Veelgestelde vragen
Nee. De historische bestelimport in Alva Digital Downloads verstuurt nul e-mails, van opzet en in code afgedwongen. Het is een stille backfill die de ontbrekende aankoopregistraties aanmaakt zodat downloads in het account en op de bestelstatuspagina van elke klant verschijnen. Geen enkele klant wordt op de hoogte gesteld, dus duizenden oude bestellingen importeren kan je kopers nooit spammen.
Ja. De import is idempotent, dus dezelfde CSV opnieuw uploaden maakt geen dubbele aankopen aan. Als een eerste poging halverwege mislukt of je nieuwe productkoppelingen toevoegt en opnieuw wilt backfillen, kun je deze veilig opnieuw uitvoeren. Bestaande registraties worden herkend en overgeslagen, en alleen echt ontbrekende aankopen worden aangemaakt.
Bestellingen die zijn geplaatst voordat je de app installeerde, zijn nooit door de ORDERS_PAID-webhook gegaan, dus er bestaat geen aankoopregistratie voor. Zonder die registratie hebben de bestelstatuspagina en het klantaccounttabblad niets te tonen. De historische import herstelt de ontbrekende aankopen zodat die downloads met terugwerkende kracht verschijnen.
Nee. De historische import wijst geen licentiesleutels toe en voert geen fraudechecks uit. Beide worden bewust overgeslagen zodat een bulk-backfill van oude bestellingen nooit licentiesleutelvoorraad opbrandt of je fraudewachtrij overspoelt. Het maakt alleen de aankoopregistraties aan die klanten de bestanden laten bereiken die aan hun bestaande productkoppelingen zijn verbonden.
Exporteer je historische bestellingen als CSV uit de Shopify-beheeromgeving, koppel je producten aan bestanden in Alva, upload vervolgens de CSV in Alva en importeer. De tool matcht de regelitems van elke bestelling tegen je koppelingen en maakt de ontbrekende aankopen aan, zodat klanten die via SendOwl, Gumroad of Shopify's native proces kochten, toegang houden tot wat ze al bezitten.