Feed Manager: orderfeeds

Een export van je orders maken in plaats van je producten: per order of per orderregel, als CSV, XML of JSON, met regels, mapping en een veilige aflevering.

Updated 6 Oct 2026·Reading time 7 mingevorderdmodule

Een feed hoeft niet over producten te gaan. Kies bij een nieuwe feed voor Orders en Feed Manager maakt een bestand van de orders in de hub, met hun orderregels. Handig voor je boekhouding, een magazijn of fulfilmentpartner, een vervoerder of je eigen rapportages. Regels, mapping, schema, aflevering en de controles werken net als bij een productfeed.

Een orderfeed maken

Open Feed Manager en klik + Nieuw.
Kies bij Maak deze feed uit voor Orders. Dit kun je later niet meer wijzigen; wil je toch producten, maak dan een tweede feed.
Geef de feed een naam, kies het Formaat (CSV, XML of JSON) en klik Feed aanmaken.

De feed krijgt meteen een set startvelden: ordernummer, orderdatum, status, naam en e-mail van de klant, land van aflevering, valuta, totaalbedrag, en per orderregel de SKU, productnaam, aantal, stukprijs en regeltotaal. Verwijder wat je niet nodig hebt en voeg toe wat ontbreekt op het tabblad Mapping.

Een nieuwe orderfeed staat op pauze en de openbare URL staat uit. Er wordt dus niets geschreven of opgehaald voordat jij de mapping hebt bekeken en de feed aanzet.

Wat je instelt

Op het tabblad Instellingen staan bij een orderfeed drie extra instellingen.

Instelling	Wat het doet	Standaard
Regels	Eén regel per order, of Eén regel per orderregel met de velden van de order op elke regel herhaald	Eén regel per order
Welke orders	Orders van de laatste zoveel dagen, geteld op de orderdatum. Een order zonder orderdatum telt op de datum dat hij in de hub kwam.	30 dagen
Openbare URL	Of de feed op zijn link antwoordt	Uit

Alle orders. Wil je echt alle orders die de hub heeft, vink dan Alle orders in de hub (volledige historie) aan én de bevestiging eronder. Dat is een bewuste keuze: elke run zet dan elke order ooit in het bestand. Zonder de bevestiging wordt het niet opgeslagen, en de wijziging staat in het auditlog.

Het tabblad Categorieën en de Verschilbeveiliging zijn er bij een orderfeed niet: een orderfeed gaat naar geen kanaal met een eigen categorieboom, en het aantal orders in het venster verandert elke dag. De categorie van wat er besteld is gebruik je wél, als veld: zie De categorie van het product op de regel.

Velden en regels

Bij een orderfeed bieden de veldlijsten ordervelden aan in plaats van productvelden:

de velden van de order: ordernummer, status, betaalstatus, bedragen, valuta, betaal- en verzendmethode, orderdatum;
klant, aflevering en factuur: customer_*, delivery_* en billing_*;
de regelvelden (Regel — …): SKU, omschrijving, aantal, stukprijs, btw, korting, regeltotaal;
je eigen velden en de velden die een koppeling toevoegt (bijvoorbeeld een openstaand bedrag), net als in de regels van je koppelingen;
Product op de regel: Category (all lines) en Category path (all lines), de categorie van het product op elke orderregel (zie hieronder);
Bronkoppeling (waar de order vandaan kwam) en Aantal regels.

Met regels kies je welke orders meegaan, op dezelfde manier als bij producten. Bijvoorbeeld: sluit orders met status cancelled uit, neem alleen orders van één koppeling, of alleen orders van de laatste 7 dagen. Een voorwaarde op een regelveld (bijvoorbeeld SKU begint met 106-) klopt als één orderregel van de order klopt. Bij elke regel zie je hoeveel orders hij raakt, geteld over de orders binnen het venster.

De categorie van het product op de regel

Een orderregel noemt alleen zijn artikel (SKU of variant), geen categorie. Nexym zoekt bij elke regel het product in je catalogus op en leest daar de categorieën van:

eerst op de variant-referentie van de regel, dan op het product met die referentie, en anders op de SKU;
hoort het product onder een configureerbaar product (een maat of kleur), dan tellen de categorieën van dat hoofdproduct mee — in veel shops staat alleen het hoofdproduct in een categorie;
alle categorieën van het product tellen, niet alleen de hoofdcategorie, en elke categorie telt met de categorieën erboven. Een horloge in Herenhorloges is dus ook een orderregel in Horloges.

De bovenste lagen van een Magento-boom (“Root Catalog” en de hoofdcategorie per winkel) laat Nexym weg: die zeggen niets waar je op wilt filteren.

Voorbeeld: alle orders met een horloge. Maak een regel Neem alleen deze op met de voorwaarde Category (all lines) · is één van · Horloges. Een order gaat mee als minstens één orderregel een product uit Horloges (of een categorie daaronder) is. De telling bij de regel zegt hoeveel orders dat zijn, bijvoorbeeld “4.582 van 4.652 orders gaan uit de feed → 70 blijven over”, en Voorbeeld openen laat ze zien.

Andersom werkt ook: is niet Horloges houdt de orders over waarin géén horloge zit, en bevat horloge vindt elke categorie met dat woord in de naam.

In het bestand. Map je Category (all lines) als kolom, dan staat daar de diepste categorie van het product (Herenhorloges, niet ook Horloges); Category path (all lines) geeft het hele pad: Horloges › Herenhorloges. Bij “één regel per order” staan de categorieën van alle orderregels in één veld, elke categorie één keer. Een regel waarvan het product niet (meer) in de hub staat, heeft geen categorie.

Kiezen uit de echte waarden

Bij een voorwaarde hoef je een waarde niet uit je hoofd te typen. Heeft een veld een vaste set waarden, dan opent de waarde een doorzoekbare lijst van wat er in je data staat — bij is én bij is één van:

Veld	De lijst
Category (all lines)	je categorieën, met hun pad: Horloges › Herenhorloges
Brand name (all lines)	de merken in je catalogus
Status, Betaalstatus, Fulfilmentstatus, Betaalmethode, Verzendmethode, Valuta	wat er in je recente orders staat
Land van aflevering / factuur	idem
Bronkoppeling	de koppelingen van je project

Een eigen waarde typen kan altijd nog, bijvoorbeeld bij bevat. Bij een productfeed werkt het net zo: categorieën (met hun pad), merk, status en type, en de opties van een keuze-attribuut.

Wat er in het bestand staat

	Eén regel per order	Eén regel per orderregel
CSV	Eén regel per order. Een regelveld bevat de waarden van alle orderregels, gescheiden door een komma: `A-1, B-2`.	Eén regel per orderregel; de ordervelden staan op elke regel.
XML	`<orders>` met per order een `<order>`, en daarin `<lines>` met per orderregel een `<line>`.	`<orders>` met per orderregel een `<order>`-element.
JSON	Een lijst van orders; elke order heeft een lijst `lines`.	Een platte lijst, één object per orderregel.

Een order zonder orderregels krijgt bij “per orderregel” toch één regel, zodat hij niet stilletjes ontbreekt. De namen van het hoofd- en itemelement in XML kun je aanpassen (standaard orders en order).

Voorbeeld bekijken. Op het tabblad Voorbeeld & export opent Voorbeeld openen de eerste vijf orders zoals de feed ze schrijft. Er wordt niets gepubliceerd, en het openen staat in het auditlog.

Afleveren en ophalen

Een orderfeed lever je bij voorkeur af op de server van de ontvanger, met SFTP of FTP: zie Aflevering en toegang. De openbare URL staat standaard uit; zolang dat zo is, geeft de link “niet gevonden” (een 404), ook met het juiste token.

Zet je de Openbare URL aan, dan kan iedereen met de link de orders downloaden. De lange code in de link (…/feed/fm_ord_…csv) is het wachtwoord. Daarom:

Token vervangen. Op het tabblad Voorbeeld & export maak je met Token vervangen een nieuwe link. De oude werkt direct niet meer.
Extra slot. Een wachtwoord (basic authentication) of een lijst met toegestane IP-adressen werkt ook bij een orderfeed.
Auditlog. Elke download van een orderfeed staat in het auditlog van het project, met het IP-adres en het programma dat hem ophaalde. Ook het maken en wijzigen van de feed, het vervangen van het token en het openen van het voorbeeld staan erin.

Privacy

Orders die een module in testmodus maakte, komen nooit in een orderfeed.
De AI-agent van Nexym ziet van een orderfeed alleen dat hij bestaat, of hij draait en welke velden erin staan: nooit een waarde, en hij kan een orderfeed niet wijzigen.
Het bestand staat op de server van Nexym tot de volgende run het vervangt, of tot je de feed verwijdert.
Alleen gebruikers met de rol Admin of Customer van het project kunnen een orderfeed maken, wijzigen, het voorbeeld openen of het token vervangen.