Importeer historische Shopify-bestellingen in Alva

Voordat je begint

Koppel elk Shopify-product dat ooit een digitaal bestand heeft verkocht aan een bestand of pakket in Alva voordat je de import draait. Niet-gekoppelde producten worden rij voor rij overgeslagen en in een samenvatting getoond, maar de schoonste aanpak is eerst koppelen en daarna één keer importeren.

• Bestanden gekoppeld aan producten. Open Bestanden in Alva en bevestig dat aan elk digitaal product minimaal één bestand of pakket hangt. Koppelingen op variantniveau werken ook.
• Bepaal het datumbereik. Veelvoorkomende keuzes: de afgelopen 90 dagen voor een actieve winkel, of alles voor een migratie vanaf een andere fulfilment-app.
• Houd een kleine test-CSV klaar. Exporteer eerst één recente week om de koppelingen te valideren, en re-exporteer daarna het volledige bereik wanneer de droogloop er goed uitziet.

Exporteer de bestellingen-CSV vanuit de Shopify-admin

Shopify biedt de bestelexport aan via Bestellingen → Exporteren. De importer verwacht de standaardkolomnamen van de CSV — hernoem geen kolommen en bewerk het bestand niet handmatig.

1. Open Shopify-admin → Bestellingen. Gebruik de filters om in te zoomen op het datumbereik dat je wilt aanvullen.
2. Klik op Exporteren. Kies Plain CSV file (niet For Excel, Numbers, or other spreadsheets) en selecteer Orders, transactions, and refunds.
3. Kies de juiste scope. "Current page", "Selected orders", "All orders" of "Orders matching your search" werken allemaal. De importer handelt alleen op rijen waarvan de financiële status paid is.
4. Download de mail die Shopify stuurt. Voor grote exports mailt Shopify de CSV-link naar het eigenaarsadres van de winkel. Sla het bestand lokaal op — niet uitpakken en opnieuw inpakken.

Draai de importer

De importer staat op Bestellingen → Historische bestellingen importeren in de Alva-admin-zijbalk. Grote CSV's worden automatisch in stukken verwerkt — er is geen rij-aantallimiet waar je je zorgen over hoeft te maken.

1. Open Bestellingen in Alva en klik daarna op de secundaire actie Historische bestellingen importeren in de paginakop.
2. Sleep de CSV op de uploadzone. Alva valideert de kolomkoppen direct en weigert het bestand als een vereiste kolom ontbreekt.
3. Wacht op het voorbeeld. Alva matcht klanten op e-mail, matcht producten eerst op SKU en daarna op titel, en toont aantallen: totaal aantal bestellingen, geldige bestellingen, overgeslagen (geannuleerd / niet betaald / geen e-mail), klanten gevonden vs. ontbrekend, producten gematcht vs. niet gekoppeld, en bestellingen die in een eerdere run al zijn geïmporteerd.
4. Bekijk niet-gekoppelde producten. Als het voorbeeld niet-gekoppelde producttitels laat zien, annuleer de import, koppel ze in Bestanden → Producten en upload dezelfde CSV opnieuw. Al geïmporteerde bestellingen worden automatisch overgeslagen.
5. Bevestigen en starten. Klik op Import starten. De voortgang stroomt in de UI naarmate elk segment klaar is. Het tabblad sluiten breekt de import niet af — hij draait server-side door, en je kunt de pagina later heropenen om het resultaat te zien.

Wat de importer doet (en overslaat)

De importer is bewust minimaal. Hij schrijft de kleinst mogelijke set rijen die nodig is zodat een klant zijn eigen downloadlinks opnieuw kan aanvragen, en slaat elk neveneffect over dat een terugkerende klant zou verrassen.

Onder de motorkap wordt elke geïmporteerde Purchase-rij aangemaakt met fraudCheckEnabled: false, fraudCheckPassed: false en accessEnabled: true. Daardoor toont de klantaccountpagina het bestand meteen, zonder ooit een bezorgmail of licentiecode-toewijzing te triggeren.