036 535 80 70 helpdesk@reflex-systems.nl
Documentatie

Voorbeeld van een verkooporder CSV-import in ReflexBlue

2026-06-02 10:17 UTC
Importeren met CSV bestanden

In dit voorbeeld configureer je in ReflexBlue een importdefinitie van het type CSV verkooporder import. Met deze importdefinitie importeer je verkooporders uit één CSV-bestand. Elke regel in het CSV-bestand bevat één orderregel.

Je configureert de import op twee plekken:

  • In de ReflexBlue Desktop Client, waar je de importdefinitie instelt.
  • In de ReflexBlue Import/Export Service, waar je instelt uit welke map de CSV-bestanden worden opgehaald.

Let op: Dit voorbeeld gaat ervan uit dat in je ReflexBlue-administratie al deze gegevens bestaan:

  • Een relatie met code 2
  • Een betaalconditie met code 30
  • Verkoopartikelen met code 2, 3 en 4

Tijdens de import koppelt ReflexBlue deze gegevens aan de verkooporder met zoekfuncties.

CSV-bestand voor verkooporderimport

In dit voorbeeld importeer je verkooporders uit één CSV-bestand. Elke regel bevat één orderregel. De waarden zijn omgeven door dubbele aanhalingstekens (") en gescheiden met een puntkomma (;).

"1000";"2";"30";"1000";"2";"1.0";"2";"2"
"1000";"2";"30";"1001";"3";"0.5";"4";"2"
"1000";"2";"30";"1002";"4";"1.5";"2";"3"
"1001";"2";"30";"1003";"2";"2.0";"1";"2"
"1001";"2";"30";"1004";"3";"0.75";"4";"3"

Het CSV-bestand bevat de volgende kolommen.

Kolompositie Gegeven
0 of A Order externe code
1 of B Relatiecode
2 of C Betaalconditiecode
3 of D Orderregel externe code
4 of E Artikelcode
5 of F Portie gewicht
6 of G Bestelde hoeveelheid
7 of H Besteld gewicht

Bij CSV-importdefinities kan je kolomposities opgeven als getal of als letter. De eerste kolom is 0 of A.

Stap 1: Importdefinitie toevoegen in ReflexBlue

Open in de ReflexBlue Desktop Client het Import/Export definities overzichtsscherm.

Voeg een nieuwe importdefinitie toe van het type CSV verkooporder import.

Houd de toegevoegde importdefinitie open. Je configureert de importdefinitie verder in het Import/Export definities detailscherm.

CSV-bestand opgeven

Ga in het Import/Export definities detailscherm naar het CSV Ontvangen subtabblad.

Verwijder alle bestaande regels. Voeg daarna één regel toe met Nieuw.

Vul de volgende gegevens in.

Naam Waarde
Type naam entity://orders.order;entity://orders.orderline
Heeft kopregel Uitgevinkt
Scheidingsteken AUTO
Aanhalingsteken "
Aanhalingsteken gebruik Waar nodig
Bestandscodering UTF-8

In dit voorbeeld voeg je één regel toe, omdat je één CSV-bestand importeert.

Bij Type naam geef je twee entiteiten op:

  • entity://orders.order
  • entity://orders.orderline

Beide entiteiten staan op elke regel in het CSV-bestand.

Regels koppelen

Ga naar het Regels koppelen subtabblad.

Verwijder alle bestaande relaties. Voeg daarna één relatie toe met Nieuw.

Vul de volgende gegevens in.

Naam Waarde
Oudertype entity://orders.order
Ouder positie A
Kindtype entity://orders.orderline
Kind positie A;D

Met deze relatie geef je aan hoe ReflexBlue een orderregel aan een verkooporder koppelt.

Bij Ouder positie geef je de kolom(men) op die een entiteit van het type Oudertype uniek identificeren. In dit voorbeeld is dat kolom A, waarin de verkooporder externe code staat.

Bij Kind positie geef je de kolom(men) op die worden gebruikt om een entiteit van het type Kindtype aan zijn ouder te koppelen. Omdat een orderregel hier gekoppeld wordt aan een verkooporder, bevat in dit voorbeeld de Kind positie de waarde A;D omdat die kolommen samen de verkooporder uniek identificeren.

Hiermee kan ReflexBlue de juiste ouder-kindrelatie opbouwen en de entiteiten in dezelfde dataset onderbrengen.

Verkoopordervelden koppelen

Ga naar het Velden koppelen subtabblad.

Verwijder eerst alle bestaande subtabbladen voor entiteiten. Voeg daarna onder Velden koppelen de entiteit Order toe.

Ga naar het Order subtabblad. Verwijder alle bestaande veldposities en voeg de volgende veldposities toe.

Sleutel Positie Standaard waarde Overschrijven
ORDER_EXTERNALCODE 0-A ✓
ORDER_RELATION 1-B ✓
ORDER_PAYMENTTERM 2-C ✓

Controleer daarna of de posities overeenkomen met de kolommen in het CSV-bestand.

Orderregelvelden koppelen

Voeg onder Velden koppelen ook de entiteit Orderregel toe.

Ga naar het Orderregel subtabblad. Verwijder alle bestaande veldposities en voeg de volgende veldposities toe.

Sleutel Positie Standaard waarde Overschrijven
ORDERARTICLELINE_EXTERNALCODE 3-D ✓
ORDERARTICLELINE_ARTICLE 4-E ✓
ORDERARTICLELINE_PORTIONWEIGHT 5-F ✓
ORDERARTICLELINE_ORDEREDQUANTITY 6-G ✓
ORDERARTICLELINE_ORDEREDWEIGHT 7-H ✓

Controleer daarna of de posities overeenkomen met de kolommen in het CSV-bestand.

Importinstellingen instellen

Ga naar het Orders importeren subtabblad.

Vul de volgende instellingen in.

Instelling Waarde
Nieuwe order standaard type Standaard order
Voorraadtekort oplossing Maak accordeer order
Order import strategie Aanmaken en updaten
Orderregel update strategie Regels met overeenkomend artikel bijwerken

Zoekfuncties toevoegen

Blijf op het Orders importeren subtabblad.

Controleer of de volgende zoekfuncties aanwezig zijn.

Sleutel Type
ORDER_RELATION RelationIdByCodeLookup
ORDER_PAYMENTTERM PaymentTermIdByCodeLookup
ORDERARTICLELINE_ARTICLE ArticleIdByCodeLookup

Ontbreekt een zoekfunctie? Voeg deze dan toe.

Deze zoekfuncties zorgen ervoor dat ReflexBlue de waarden uit het CSV-bestand gebruikt om bestaande gegevens op te zoeken.

In dit voorbeeld gebruikt ReflexBlue:

  • Kolom B om de relatie met code 2 op te zoeken
  • Kolom C om de betaalconditie met code 30 op te zoeken
  • Kolom E om de verkoopartikelen met code 2, 3 en 4 op te zoeken

Stap 2: Synchronisatie toevoegen in de ReflexBlue Import/Export Service

Nadat je de importdefinitie in ReflexBlue hebt geconfigureerd, voeg je deze toe aan de ReflexBlue Import/Export Service.

De service haalt CSV-bestanden op uit de ingestelde Import Directory en stuurt ze naar ReflexBlue voor import.

Open in de ReflexBlue Import/Export Service het Synchronisations-scherm en voeg een ReflexBlue Import synchronisatie toe.

Selecteer bij het toevoegen van de synchronisatie de importdefinitie die je eerder hebt aangemaakt.

Omdat je op het CSV Ontvangen subtabblad één bestand hebt opgegeven met twee entiteiten, zie je in de ReflexBlue Import/Export Service één veld voor een file mask bij entity://orders.order;entity://orders.orderline.

Voer als regex voor de file mask de volgende waarde in: orders\.csv.

Stap 3: Orders importeren

Nadat je de synchronisatie hebt toegevoegd en opgeslagen in de ReflexBlue Import/Export Service, plaats je het CSV-bestand in de ingestelde Import Directory.

Gebruik voor dit voorbeeld de volgende bestandsnaam: orders.csv.

Deze bestandsnaam voldoet aan de regex file mask orders\.csv.

Wanneer de configuratie klopt, haalt de ReflexBlue Import/Export Service het bestand op uit de importmap. Bestanden die zijn geüpload, worden verplaatst naar een archiefmap.

Je kan de voortgang van de import volgen in de ReflexBlue Desktop Client via het Imports/Exports overzichtsscherm.

Navigatie

Zoeken

Geen resultaten.