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

Voorbeeld van een verkooporder CSV-import met meerdere bestanden 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. Je gebruikt deze importdefinitie om verkooporders te importeren uit twee CSV-bestanden:

  • Eén CSV-bestand met orderkoppen
  • Eén CSV-bestand met orderregels

Je configureert de import op twee plekken:

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

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

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

Tijdens de import gebruikt ReflexBlue zoekfuncties om deze gegevens aan de verkooporder te koppelen.

CSV-bestanden voor verkooporderimport

In dit voorbeeld gebruik je twee CSV-bestanden. De bestanden hebben geen kopregel. De waarden zijn omgeven door dubbele aanhalingstekens (") en zijn gescheiden met een puntkomma (;).

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

CSV-bestand met orderkoppen

Elke regel bevat één orderkop.

"1002";"2";"30"
"1003";"2";"30"

Het CSV-bestand bevat de volgende kolommen.

Kolompositie Gegeven
0 of A Externe ordercode
1 of B Relatiecode
2 of C Betaalconditiecode

CSV-bestand met orderregels

Elke regel bevat één orderregel.

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

Het CSV-bestand bevat de volgende kolommen.

Kolompositie Gegeven
0 of A Externe ordercode
1 of B Externe orderregelcode
2 of C Artikelcode
3 of D Portiegewicht
4 of E Bestelde hoeveelheid
5 of F Besteld gewicht

Belangrijk: Het CSV-bestand met orderregels bevat in kolom A ook de externe ordercode. ReflexBlue gebruikt deze waarde om de orderregels aan de juiste orderkop te koppelen.

Kolom B maakt de orderregel uniek binnen de order.

Importdefinitie configureren in ReflexBlue

Open de importdefinitie eerst in de ReflexBlue Desktop Client. De instellingen staan op het Algemeen tabblad van het Import/Export definities detailscherm.

Importdefinitie toevoegen

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-bestanden opgeven

Ga op het Algemeen tabblad naar het CSV Ontvangen subtabblad.

Verwijder de bestaande regels. Voeg daarna twee regels toe met Nieuw.

Regel voor het orderkoppenbestand

Vul de volgende gegevens in.

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

Regel voor het orderregelsbestand

Vul de volgende gegevens in.

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

Regels koppelen

Ga naar het Regels koppelen subtabblad.

Verwijder de 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;B

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

Hierbij geldt:

  • Ouder positie A verwijst naar kolom A in het orderkoppenbestand. Deze kolom bevat de externe ordercode.
  • Kind positie A;B verwijst naar kolom A en B in het orderregelsbestand.
  • Kolom A in het orderregelsbestand bevat dezelfde externe ordercode als de orderkop.
  • Kolom B in het orderregelsbestand maakt de orderregel uniek binnen de order.

Voorbeeld:

Orderkop Orderregel Sleutel van de orderregel
1002 1000 1002;1000
1002 1001 1002;1001
1003 1003 1003;1003

De koppeling tussen orderkop en orderregel gebeurt dus via kolom A. De combinatie A;B voorkomt dat meerdere orderregels binnen dezelfde order dezelfde sleutel krijgen.

Verkooporderkopvelden koppelen

Ga naar het Velden koppelen subtabblad.

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

Ga naar het Order subtabblad. Verwijder de 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 orderkoppenbestand.

Orderregelvelden koppelen

Voeg onder Velden koppelen ook de entiteit Orderregel toe.

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

Sleutel Positie Standaard waarde Overschrijven
ORDERARTICLELINE_EXTERNALCODE 1-B ✓
ORDERARTICLELINE_ARTICLE 2-C ✓
ORDERARTICLELINE_PORTIONWEIGHT 3-D ✓
ORDERARTICLELINE_ORDEREDQUANTITY 4-E ✓
ORDERARTICLELINE_ORDEREDWEIGHT 5-F ✓

Controleer daarna of de posities overeenkomen met de kolommen in het orderregelsbestand.

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.

De zoekfuncties koppelen waarden uit de CSV-bestanden aan bestaande gegevens in ReflexBlue.

In dit voorbeeld gebruikt ReflexBlue:

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

Je mag maximaal één zoekfunctie opgeven per veldsleutel.

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 in de importdefinitie twee CSV-bestanden hebt ingesteld, zie je in de ReflexBlue Import/Export Service twee velden voor een file mask.

Vul de volgende regex file masks in.

Entiteit File mask
entity://orders.order orders-(\d+)\.csv
entity://orders.orderline order-lines-(\d+)\.csv

In dit voorbeeld importeer je twee CSV-bestanden die bij elkaar horen. De regex-groep (\d+) legt het nummer in de bestandsnaam vast.

De ReflexBlue Import/Export Service gebruikt deze groep om bestanden met hetzelfde nummer samen te importeren.

Voorbeelden:

  • orders-1.csv hoort bij order-lines-1.csv
  • orders-2.csv hoort bij order-lines-2.csv

Zo blijven orderkoppen en orderregels per importgroep bij elkaar.

Voor meer informatie, zie Het gebruik van Regular Expressions voor het importeren van CSV-bestanden.

Orders importeren

Nadat je de synchronisatie hebt toegevoegd en opgeslagen, plaats je de CSV-bestanden in de ingestelde Import Directory.

Gebruik voor dit voorbeeld de volgende bestandsnamen:

  • orders-1.csv voor de orderkoppen
  • order-lines-1.csv voor de orderregels

Deze namen voldoen aan de geconfigureerde regex file masks.

Als de configuratie correct is, haalt de ReflexBlue Import/Export Service de bestanden 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.