@flowselections/logistiek-engine 1.0.34 → 1.0.89

package/dist-lib/lib/modulePrompts.js

@@ -709,6 +709,76 @@ CONTROLELIJST
 [ ] Bij "indelen op afmetingen" verschijnt de tekening met de posities van de Engine.
 [ ] Omschakelen van methode is na verversen direct zichtbaar.
 [ ] Bij een fout in de RPC blijft het blok verborgen, zonder foutmelding in beeld.`,
+            },
+            {
+                number: 17,
+                title: "Achterstand apart tellen in Verkooporders",
+                date: "2026-09-29",
+                summary: "Orders met status 'Nog te picken' en een verstreken leverdatum apart tonen als 'Te picken (achterstand)', op basis van de Engine-functie.",
+                body: `AANVULLING op de eerdere prompts (die blijven geldig).
+
+AANLEIDING
+De Verkooporders-pagina telt alle orders met status "Nog te picken" als "Te picken".
+Het pickstation toont alleen orders met een leverdatum van vandaag of later. Orders
+met een verstreken leverdatum stonden daardoor wel in Verkoop, maar nergens in het
+pickstation. De Engine heeft nu een aparte categorie "Achterstand".
+
+NIEUWE VERPLICHTING
+1. Lees per order het achterstandkenmerk uit de Engine, nooit zelf berekenen:
+   const { data } = await supabase.rpc("logistics_order_backlog_info", { p_order_id: orderId });
+   data is null  -> geen achterstand
+   data = { achterstand: true, leverdatum, dagen } -> achterstand
+2. Toon orders met achterstand apart: "Te picken (achterstand)", met het aantal
+   dagen. Tel ze niet mee in het gewone "Te picken".
+3. De orderstatus NIET wijzigen. "Nog te picken" blijft de status.
+4. Fail-closed: geeft de functie een fout, toon de order onder "Te picken" met de
+   melding "achterstand onbekend" en schrijf niets.
+
+CONTROLE
+[ ] Een order met status "Nog te picken" en leverdatum gisteren staat onder
+    "Te picken (achterstand)".
+[ ] De orderstatus is ongewijzigd.
+[ ] Geen omgevingswaarden in code of migraties.`,
+            },
+            {
+                number: 16,
+                title: "Buffer alleen lezen; ordergegevens uit de Engine",
+                date: "2026-09-25",
+                summary: "Verkoop stelt de bufferpayload niet meer zelf samen en schrijft nooit meer order_buffers of orders.buffer_id; de Engine is de enige schrijver.",
+                body: `AANVULLING op prompt 3, 4, 10 en 15 (die blijven geldig, behalve waar hieronder iets vervalt).
+
+AANLEIDING
+buildDecisionOrderInput stelt zelf de payload voor logistics_buffer_decision samen,
+zonder floridaySalesOrderRef. De Engine ziet Floriday-orders daardoor als handmatige
+orders en geeft een andere buffersleutel. applyBufferDecisionForOrder schrijft die
+afwijkende buffer daarna weg (order_buffers, orders.buffer_id, cart_replan_queue,
+lege buffers wissen). Gevolg: elke 5 minuten werden alle karren van Floriday-orders
+gewist en opnieuw opgebouwd. De Engine zet zulke schrijfacties inmiddels terug en
+logt ze als "externe_bufferwijziging_teruggezet".
+
+HAAL WEG
+- buildDecisionOrderInput en elke eigen samenstelling van de bufferpayload.
+- Elke schrijfactie op order_buffers (aanmaken, bijwerken, lege buffers wissen).
+- Elke schrijfactie op orders.buffer_id.
+- Het wegschrijven naar cart_replan_queue vanuit het bufferbesluit.
+
+NIEUWE VERPLICHTING
+1. Heb je het bufferbesluit nodig, haal de payload dan uit de Engine:
+   const { data: payload } = await supabaseAdmin.rpc("logistics_buffer_payload", { p_order_id: orderId });
+   const { data: besluit } = await supabaseAdmin.rpc("logistics_buffer_decision", { p_order: payload, p_strategy_id: null });
+   Geef payload ongewijzigd door: niets toevoegen, niets weglaten.
+2. De buffer van een order lees je altijd uit orders.buffer_id. Die zet de Engine.
+   Is die leeg, dan is de order los. Maak nooit zelf een buffer aan.
+3. notifyEngineOrder, order-buffers.functions.ts en logistics-engine.functions.ts
+   roepen applyBufferDecisionForOrder niet meer aan; alleen het event melden.
+4. Fail-closed: geeft logistics_buffer_payload een fout of niets terug, toon
+   "bufferbesluit niet beschikbaar" en schrijf niets.
+
+CONTROLE
+[ ] Floriday-orders met dezelfde koper, afleverlocatie en leverdatum blijven 10
+    minuten lang in dezelfde buffer; geen nieuwe karren.
+[ ] In het Orderlogboek verschijnen geen nieuwe regels "externe_bufferwijziging_teruggezet".
+[ ] Geen omgevingswaarden in code of migraties.`,
             },
             {
                 number: 15,
@@ -2449,6 +2519,731 @@ CONTROLELIJST
 [ ] De losgekoppelde order heeft een eigen regel en eigen pakbonnen.
 [ ] Al geprinte karren houden hetzelfde nummer en dezelfde barcode.`,
             },
+            {
+                number: 22,
+                title: "Eén printregel per kar/order: verzendbrief gaat mee met de pakbon",
+                date: "2026-09-07",
+                summary: "Geen aparte regel meer voor de verzendbrief; één klik print pakbon én verzendbrief naar hetzelfde pickstation.",
+                body: `AANVULLING op prompt 17 t/m 21 (die blijven geldig).
+
+WAT ER VERANDERT
+Staat de verzendbrief op hetzelfde pickstation als de pakbon, of is gekozen
+voor "Als de pakbon wordt uitgeprint", dan hoort er nog maar één regel in het
+printoverzicht te staan: de pakbonregel van de kar of order.
+
+WAT JIJ BOUWT
+1. Toon per kar/order precies één regel, volgens de groepering (kar of order)
+   die de Engine in de wachtrij zet. Maak zelf nooit een tweede regel voor de
+   verzendbrief; de Engine weigert die regels ook in public.pick_queue.
+2. Eén printactie: roep alleen pick_complete_print(...) aan zoals nu. De Engine
+   maakt daarbij zelf de tweede printopdracht voor de verzendbrief aan, op
+   dezelfde printplek.
+3. Wil je zien of de verzendbrief meegaat, vraag dan
+   public.logistics_shipping_note_follows_slip(). Gebruik dat alleen om het te
+   tonen ("pakbon + verzendbrief"), niet om zelf te printen.
+4. Volg de status van beide printopdrachten via print_jobs; de verzendbriefjob
+   verwijst in payload.packing_slip_job_id naar de pakbonjob.
+
+WAT JE NIET DOET
+- Zelf een verzendbrief-printjob aanmaken of een eigen layout kiezen.
+- Twee regels tonen wanneer de functie hierboven true geeft.
+- Geen URL's, sleutels, project-refs, printernamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Per kar/order staat er één regel in het printoverzicht.
+[ ] Eén klik levert zowel de pakbon als de verzendbrief op dezelfde printer.
+[ ] Bij een aparte verzendbrief-instelling (na scannen of handmatig) blijft de
+    oude werkwijze met een eigen regel bestaan.`,
+            },
+            {
+                number: 23,
+                title: "Karaantallen uit het karplan tonen in de kolom Karren",
+                date: "2026-09-07",
+                summary: "De Engine levert pickMode, totalCarts, fullCarts en partialCarts per eenheid; het scherm rekent niets zelf uit.",
+                body: `AANVULLING op prompt 17 t/m 22 (die blijven geldig).
+
+WAT DE ENGINE MEELEVERT
+In de payload van elke eenheid in public.pick_queue staan nu:
+- pickMode      de gekozen pickwijze (o.a. "smallest")
+- totalCarts    totaal aantal karren voor deze eenheid (heel getal)
+- fullCarts     aantal volle karren
+- partialCarts  aantal deelkarren (0 of meer)
+- crates        aantal fusten (alleen nog als laatste terugval)
+- cartPlanReady / cartPlanReleased / cartPlanReason
+Bij een buffer gelden deze getallen voor de buffer als geheel, passend bij
+unit_ref.
+
+WAT JIJ BOUWT
+1. Kolom "Karren": bij pickMode = smallest toon je fullCarts, met "+D" erachter
+   wanneer partialCarts > 0 (bijv. 10+D). Bij elke andere pickwijze toon je
+   totalCarts.
+2. Ontbreken de karaantallen of is cartPlanReady = false, dan toon je het
+   fustaantal of een streepje plus cartPlanReason. Verzin nooit zelf een
+   karaantal en tel nooit zelf fusten om tot karren te komen.
+3. De getallen komen uit hetzelfde plan als public.logistics_cart_plan_status(ref)
+   (ready = true, released = true). Wil je verifiëren, gebruik dan die functie —
+   niet je eigen telling.
+4. Na "buffer.closed" en "buffer.order_detached" lees je de eenheden opnieuw:
+   de Engine zet de karaantallen dan opnieuw klaar, ook voor een losgekoppelde
+   order die weer een eigen regel krijgt.
+
+WAT JE NIET DOET
+- Karren afleiden uit fusten, lagen of gewicht.
+- Karaantallen bewaren over een herplanning heen.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] De kolom "Karren" toont een karaantal, geen fustaantal.
+[ ] Bij "kleinste telt" verschijnt "+D" zodra er een deelkar is.
+[ ] Zonder karplan staat de letterlijke reden op het scherm.`,
+            },
+            {
+                number: 24,
+                title: "Bij picken per kar toont het scherm karren, geen orders",
+                date: "2026-09-07",
+                summary: "Elke vrijgegeven kar is een eigen regel; volle karren komen eerst, deelkarren pas na het aanmeldmoment.",
+                body: `AANVULLING op prompt 17 t/m 23 (die blijven geldig).
+
+WAT ER VERANDERT
+Staat de pickwijze op "Picken per kar", dan levert de Engine in
+public.pick_queue één regel PER KAR in plaats van één regel per order of buffer.
+De regel heeft reference = het kar-id en in payload:
+- cartRowFor   het leidende ordernummer van de eenheid
+- cartId, cartSeq, cartIndex, cartTotal, cartLabel ("Kar 2 van 5")
+- isFullCart   volle kar (true) of deelkar (false)
+- barcode      de vaste pakbonbarcode van deze kar
+- pickMode     "cart"
+
+VRIJGAVE
+- Volle karren verschijnen zodra het pickvenster van de order begint.
+- Deelkarren verschijnen pas na het aanmeldmoment, zodat de Engine ze eerst
+  binnen de buffer kan samenvoegen tot volle karren. Is dat ingesteld op
+  "ook vóór het aanmeldmoment", dan komen ze direct mee.
+- public.logistics_cart_released(cart_id) en
+  public.logistics_cart_release_reason(cart_id) geven het antwoord en de
+  letterlijke reden. Toon die reden; verzin er geen eigen tekst bij.
+
+WAT JIJ BOUWT
+1. Toon de regels zoals ze binnenkomen: één regel per kar, gesorteerd op
+   cartSeq. Groepeer niet zelf terug naar orders.
+2. Printen doe je op de karregel; dat print precies die ene kar (pakbon en,
+   indien ingesteld, de verzendbrief mee).
+3. Al geprinte of afgemelde karregels blijven staan; die worden nooit
+   samengevoegd of hernummerd.
+4. Bij andere pickwijzen blijft alles zoals in prompt 17 t/m 23.
+
+WAT JE NIET DOET
+- Karren zelf berekenen, nummeren of samenvoegen.
+- Een orderregel tonen naast de karregels van dezelfde eenheid.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Bij "Picken per kar" staan er karregels, geen orderregels.
+[ ] Een order met 4 volle karren en 1 deelkar toont eerst 4 regels.
+[ ] De deelkar verschijnt pas na het aanmeldmoment.
+[ ] Printen op een karregel levert precies één kar.`,
+            },
+            {
+                number: 25,
+                title: "Na een volledige herindeling alle oude pakbongegevens weggooien",
+                date: "2026-09-07",
+                summary: "Vervallen karregels, barcodes en pakbonnen niet meer tonen of scannen; alleen de actuele Engine-gegevens gebruiken.",
+                body: `AANVULLING op prompt 17 t/m 24 (die blijven geldig).
+
+WAT ER VERANDERT
+In de Logistiek Engine bestaat een uitdrukkelijke noodknop "Alle orders opnieuw
+indelen, ook gepickte orders". Daarna zijn ALLE eerdere karren, karnummers,
+pakbonnen en barcodes van openstaande orders vervallen, ook die al geprint of
+gepickt waren. De Engine maakt nieuwe karren met nieuwe barcodes.
+
+HOE JE DAT HERKENT
+- De oude regel in public.pick_queue heeft cancelled_at gevuld en in payload
+  vervallenReden = "volledige_herindeling".
+- De bijbehorende printopdrachten staan op status geannuleerd.
+- public.logistics_cart_plan_status(<ref>) levert de nieuwe karren met nieuwe
+  cartId's en nieuwe barcodes.
+
+WAT JIJ BOUWT
+1. Toon nooit een pickregel met een cancelled_at; verwijder hem direct uit het
+   scherm en uit je eigen tussenopslag (cache/state), ook als hij al geprint was.
+2. Gooi na iedere verversing je lokaal bewaarde barcodes, karnummers en
+   pakbongegevens weg en gebruik uitsluitend wat de Engine nu teruggeeft.
+3. Scan je een oude barcode die niet meer bestaat, toon dan de letterlijke
+   reden van de Engine ("deze pakbon is vervallen; print de nieuwe pakbon").
+4. Blijft een regel "nog niet printklaar", toon dan de reason van
+   logistics_cart_plan_status en stuur het bestaande seintje cartplan.missing.
+
+WAT JE NIET DOET
+- Een vervallen pakbon opnieuw printen of scannen.
+- Zelf karren, nummers of barcodes bewaren tussen twee verversingen.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Na een volledige herindeling verdwijnen alle oude regels uit het scherm.
+[ ] Er staan uitsluitend nieuwe karregels met nieuwe barcodes.
+[ ] Een oude barcode scannen geeft een duidelijke, leesbare melding.`,
+            },
+            {
+                number: 26,
+                title: "Printregels altijd per kar, nooit meer per order",
+                date: "2026-09-08",
+                summary: "Geen eigen printopdrachten op orderniveau; toon de karregels van de Engine met karnummer en barcode.",
+                body: `AANVULLING op prompt 17 t/m 25 (die blijven geldig).
+
+WAT ER VERANDERT
+Een pakbon hoort in de database vanaf nu bij precies EEN kar. Een
+printopdracht van het type pakbon zonder cart_id in de payload wordt door de
+database geweigerd met een leesbare melding. Bestaande pakbonopdrachten zonder
+kar zijn geannuleerd met de reden dat ze bij een order hoorden in plaats van
+bij een kar; die veroorzaakten de eeuwige melding "nog niet printklaar".
+
+WAT JIJ BOUWT
+1. Maak nooit zelf een printopdracht voor een hele order aan. Vraag per kar
+   een pakbon aan via public.pick_enqueue_print_job met de karregel uit
+   public.pick_queue (reference = cart_id).
+2. Toon per kar EEN regel met karnummer, "Kar X van Y", de barcode en of het
+   een volle of deelkar is. Die velden komen uit
+   public.logistics_cart_plan_status(<ref>); reken zelf niets uit.
+3. Toon geen printopdrachten met status geannuleerd en geen pakbonopdracht
+   zonder cart_id; die zijn vervallen.
+4. Verdwijnt de knop "Pakbon ophalen" niet, kijk dan naar ready uit
+   logistics_cart_plan_status: staat die op true, dan is er niets op te halen
+   en hoort de knop weg te zijn.
+
+WAT JE NIET DOET
+- Een pakbon aanvragen zonder kar; die wordt geweigerd.
+- Meerdere karren samenvatten in een regel.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Een order met twee karren toont twee pakbonregels met eigen barcodes.
+[ ] Er staat geen enkele actieve pakbonregel zonder kar meer in het scherm.
+[ ] De melding "nog niet printklaar" verdwijnt zodra de Engine ready meldt.`,
+            },
+            {
+                number: 27,
+                title: "Karaantal en barcode altijd van de karregel lezen",
+                date: "2026-09-08",
+                summary: "Een karregel toont altijd één kar en gebruikt het vaste barcodeveld voor de printgereedheid.",
+                body: `AANVULLING op prompt 17 t/m 26 (die blijven geldig).
+
+OORZAAK VAN DE OUDE WEERGAVE
+De Engine leverde al één public.pick_queue-regel per kar, maar cart_count en
+payload.cartCount bevatten nog het totaal van de order. Daarnaast stond de
+barcode alleen in payload.barcode. Daardoor toonde het scherm op één karregel
+toch twee of drie karren en kon het scherm ten onrechte concluderen dat de
+pakbon niet printklaar was.
+
+WAT DE ENGINE NU GARANDEERT
+Voor iedere actieve regel met payload.cartRowFor:
+- cart_count = 1
+- payload.cartCount = 1
+- reference = payload.cartId
+- barcode = payload.barcode
+- payload.cartPlanReady = true zodra kar-id en barcode aanwezig zijn
+- payload.cartTotal blijft uitsluitend het totaal aantal karren van de order
+
+WAT JIJ BOUWT
+1. Behandel iedere pick_queue-regel met payload.cartRowFor als precies één kar.
+2. Toon in de kolom "Karren" voor die regel altijd 1; tel of groepeer niet op
+   order_number, document_number of payload.totalCarts.
+3. Gebruik barcode als primaire barcode en payload.barcode alleen als
+   gelijkwaardige terugval. Als een van beide gevuld is én cartPlanReady=true,
+   toon dan niet de melding "nog niet printklaar".
+4. Gebruik payload.cartTotal alleen in het label "Kar X van Y".
+5. Eén klik op "Pakbon ophalen" mag uitsluitend de kar uit reference/cartId
+   aanvragen en nooit alle karren van dezelfde order.
+
+WAT JE NIET DOET
+- Meerdere karregels samenvoegen op ordernummer.
+- cartTotal of totalCarts als aantal van één regel tonen.
+- Printgereedheid alleen op een lokaal bewaarde oude barcode baseren.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Een order met drie karren toont drie regels met ieder "Karren: 1".
+[ ] Iedere regel heeft een eigen documentnummer, kar-id en barcode.
+[ ] Een actuele karregel met barcode toont geen melding "nog niet printklaar".`,
+            },
+            {
+                number: 28,
+                title: "Karregels niet samenvoegen en beide totaalvelden accepteren",
+                date: "2026-09-08",
+                summary: "Iedere Engine-karregel blijft zelfstandig zichtbaar en het karplan is met oude en nieuwe veldnamen leesbaar.",
+                body: `AANVULLING op prompt 17 t/m 27 (die blijven geldig).
+
+VASTGESTELDE OORZAAK IN HET PICKSCHERM
+- dedupeByUnit() groepeert karregels zonder unitRef op ordernummer en laat alleen
+  K1 staan.
+- cartColumnInfo() gebruikt het ordertotaal als aantal van de zichtbare regel.
+- parsePickCartPlan() accepteert alleen cartTotal, terwijl eerdere Engine-data
+  bovenaan totalCarts bevat. Een geldig plan wordt daardoor null en de knop
+  "Pakbon ophalen" blijft onterecht staan.
+
+WAT DE ENGINE NU EXTRA LEVERT
+- payload.unitRef = payload.cartId
+- payload.totalCarts = 1 op iedere afzonderlijke karregel
+- payload.cartTotal blijft het werkelijke order- of buffertotaal
+- pick_queue_cart_plan levert bovenaan zowel cartTotal als totalCarts
+
+WAT JIJ BOUWT
+1. Pas unitRefOf() aan: gebruik voor payload.cartRowFor altijd cartId, daarna
+   reference; val alleen bij niet-karregels terug op unitRef of ordernummer.
+2. Pas dedupeByUnit() aan: voeg iedere regel met payload.cartRowFor zelfstandig
+   toe en dedupliceer die nooit op ordernummer.
+3. Pas cartColumnInfo() aan: toon bij payload.cartRowFor altijd "1" in de kolom
+   Karren. Gebruik cartTotal alleen voor een aanvullend label "Kar X van Y".
+4. Pas parsePickCartPlan() aan: accepteer root.cartTotal én root.totalCarts als
+   gelijkwaardige veldnamen.
+5. Als de actuele karregel een cartId, barcode, cartPlanReady=true en
+   cartPlanReleased=true heeft, is uitsluitend die kar printklaar. Vereis dan
+   niet opnieuw dat alle karren van de order dezelfde controle doorstaan.
+6. Vraag status en pakbongegevens voor een karregel op met cartId/reference,
+   niet met het ordernummer.
+
+WAT JE NIET DOET
+- K2/K3 verwijderen omdat K1 hetzelfde ordernummer heeft.
+- cartTotal tonen als het aantal karren van één regel.
+- Zelf kar-identiteiten, nummers of barcodes maken.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Een plan met drie karren toont K1, K2 en K3 als drie regels.
+[ ] Iedere regel toont "Karren: 1" en zijn eigen barcode.
+[ ] Een ready+released karregel toont direct de printactie.
+[ ] parsePickCartPlan accepteert zowel cartTotal als totalCarts.`,
+            },
+            {
+                number: 29,
+                title: "Verzendbrief gaat altijd mee met de pakbon van een kar",
+                date: "2026-09-08",
+                summary: "Eén printactie op een karregel levert de pakbon én de verzendbrief; afmelden gebeurt pas na de controlescan.",
+                body: `AANVULLING op prompt 17 t/m 28 (die blijven geldig).
+
+WAT DE ENGINE NU DOET
+- Bij iedere pakbon die vanaf een pickstation wordt aangemaakt, zet de Engine
+  automatisch de verzendbrief klaar op dezelfde printplek.
+- BVO-order: verzendbrief volgens de eigen layout uit de instelling
+  "Verzendbrief voor BVO orders".
+- FO-order (Floriday): de Engine haalt de verzendbrief bij Floriday op en zet
+  die als tweede printopdracht klaar. Duurt dat even, dan blijft de aanvraag
+  wachten met een leesbare reden; er wordt niets verzonnen.
+- De kar of order wordt hierdoor NIET bevestigd of afgehandeld. Afmelden
+  gebeurt pas na het scannen van de pakbon bij de controle.
+
+WAT JIJ BOUWT
+1. Toon per kar één printregel en één printknop. Vraag nooit zelf een aparte
+   verzendbrief aan.
+2. Maak zelf geen printopdracht voor een verzendbrief, afleverbrief of
+   verzendlabel aan; dat doet de Engine bij de pakbon.
+3. Zet na het printen geen enkele status op afgehandeld of bevestigd.
+
+WAT JE NIET DOET
+- Een tweede regel of knop voor de verzendbrief tonen.
+- Floriday-documenten zelf ophalen.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Eén klik op een karregel levert twee printopdrachten: pakbon en verzendbrief.
+[ ] Bij een FO-order komt de verzendbrief uit Floriday.
+[ ] De order blijft open tot de controlescan.`,
+            },
+            {
+                number: 30,
+                title: "Actuele tick verwerkt Floriday-verzendbrief direct op sales-order",
+                date: "2026-09-08",
+                summary: "De shell gebruikt de actuele Engine-tick en haalt de verzendbrief op zonder te wachten op een Floriday-statuswijziging.",
+                body: `AANVULLING op prompt 29 (die blijft volledig geldig).
+
+VASTGESTELDE OORZAAK
+De pakbonactie maakte de aanvraag voor de Floriday-verzendbrief correct aan,
+maar de actieve shell draaide nog een oudere handleLogisticsTick zonder de
+shippingNotes-verwerker. Daarnaast mag de documentophaling niet wachten op een
+fulfillment_order_id uit de statuswachtrij: die statusroute blijft terecht
+geblokkeerd tot na de controlescan.
+
+WAT JE BOUWT
+1. Gebruik de actuele handleLogisticsTick-export uit
+   @flowselections/logistiek-engine/hooks voor
+   /api/public/hooks/logistics-recalc-tick.
+2. Controleer dat iedere succesvolle tick in zijn antwoord het onderdeel
+   shippingNotes bevat.
+3. Maak geen eigen Floriday-statusactie om een verzendbrief beschikbaar te
+   krijgen. De Engine haalt het document als leesactie op via het bestaande
+   Floriday sales-order-ID.
+4. Toon een concrete wachtreden als Floriday nog geen fulfillment-order of
+   verzendbrief heeft; maak geen leeg of zelfverzonnen document.
+5. Eén verzendbriefjob gebruikt dezelfde printer en cart_id als de pakbon.
+
+WAT JE NIET DOET
+- De order bevestigen, afhandelen of een fulfillment-order versturen tijdens
+  het printen.
+- Een tweede verzendbriefaanvraag vanuit het pickscherm maken.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Het tickantwoord bevat shippingNotes.
+[ ] Een wachtende FO-aanvraag wordt verwerkt zodra Floriday het document heeft.
+[ ] Eén pakbonactie levert maximaal één bijbehorende verzendbriefjob.
+[ ] De order blijft open tot de controlescan.`,
+            },
+            {
+                number: 31,
+                title: "Tick faalt zichtbaar zonder verzendbriefverwerking",
+                date: "2026-09-08",
+                summary: "De geplande taak controleert of de verzendbriefverwerking echt actief is en rapporteert per ronde de tellingen.",
+                body: `AANVULLING op prompt 29 en 30 (die blijven volledig geldig).
+
+VASTGESTELDE OORZAAK
+De geplande taak meldde iedere minuut succes, terwijl de verzendbriefaanvraag
+onaangeroerd bleef staan op wachtend met pogingen 0. "Geen foutmelding" zei dus
+niets over de verzendbrief.
+
+WAT JE BOUWT
+1. Gebruik uitsluitend de actuele handleLogisticsTick-export uit
+   @flowselections/logistiek-engine/hooks.
+2. Behandel een tick zonder werkende verzendbriefverwerking als FOUT: het
+   antwoord heeft dan ok=false en HTTP 500. Meld dat zichtbaar in je monitoring
+   in plaats van het als geslaagde ronde te tellen.
+3. Toon per ronde de tellingen uit shippingNotes: found, printed,
+   waitingForFloriday, retrying, failed en printJobsCreated.
+4. De pakbon is de bron voor printer en kar. Zet zelf nooit een printer op een
+   verzendbriefaanvraag of -job.
+5. Wachten gebeurt met een reden en een oplopende hertijd. Onderscheid:
+   document nog niet beschikbaar, tijdelijke storing, definitieve fout.
+
+WAT JE NIET DOET
+- Een verzendbrief maken zonder officieel Floriday-document.
+- Een tweede verzendbrief maken voor dezelfde pakbon.
+- Statussen wijzigen of afmelden tijdens het printen.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Een oude moduleversie levert een zichtbare fout, geen stille "succes".
+[ ] De tellingen van shippingNotes staan in je log of scherm.
+[ ] Een aanvraag die blijft wachten toont een oplopend aantal pogingen.
+[ ] Eén pakbonactie levert maximaal één verzendbriefjob op dezelfde printer.`,
+            },
+            {
+                number: 32,
+                title: "Knop: het ingestelde aantal karren in één keer uitprinten",
+                date: "2026-09-08",
+                summary: "Het pickscherm print zoveel karren tegelijk als in de Logistiek Engine is ingesteld, en toont deelkarren pas na het aanmeldmoment.",
+                body: `AANVULLING op de eerdere prompts (die blijven volledig geldig).
+
+WAT ER MIS IS
+Het pickscherm kijkt niet naar de instelling "Aantal karren dat je in één keer
+uitprint". Er is alleen een knop per losse kar.
+
+WAT JE BOUWT
+1. Lees de instelling via de bestaande RPC:
+   supabase.rpc('logistics_pick_mode') geeft nu
+   { pickMode, showCartControl, cartsPerPrint }.
+   cartsPerPrint is het ingestelde aantal karren per printactie.
+2. Is cartsPerPrint groter dan 1, toon dan boven de lijst één knop:
+   "Print eerstvolgende <n> karren". n = cartsPerPrint.
+3. Die knop neemt de bovenste n printklare karregels in de bestaande volgorde
+   en voert per kar exact dezelfde printactie uit als de knop op de regel.
+   Volle karren gaan voor deelkarren, precies zoals de lijst al sorteert.
+4. Zijn er minder printklare karren dan n, print dan alleen wat er is en meld
+   dat in de knoptekst of een korte melding.
+5. Niet printklare karren sla je over, met een leesbare melding per kar.
+6. Is cartsPerPrint leeg (geen actieve werkwijze), toon de knop dan NIET en val
+   niet stil terug op een eigen aantal.
+7. Per kar blijft het bij één printactie: pakbon (en de verzendbrief die de
+   Engine er zelf bij zet). Maak nooit een tweede printopdracht per kar.
+
+DEELKARREN
+De Engine bepaalt wanneer een deelkar naar het pickstation mag: pas na het
+aanmeldmoment van de order. Je toont dus alleen de karren die de Engine in de
+wachtrij zet; filter of vervroeg zelf niets.
+
+WAT JE NIET DOET
+- Zelf een aantal karren per print bepalen of onthouden.
+- Karren samenvoegen tot één regel; één kar blijft één regel.
+- Statussen wijzigen of afmelden na het printen; dat gebeurt pas na de
+  controlescan.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Staat de instelling op 5, dan print de knop 5 karren in één klik.
+[ ] Wijzig je de instelling, dan verandert de knop mee zonder aanpassing.
+[ ] Elke kar levert precies één printactie op.
+[ ] Deelkarren verschijnen pas na het aanmeldmoment.`,
+            },
+            {
+                number: 33,
+                title: "Toon de verzendbriefstatus bij de geprinte kar",
+                date: "2026-09-08",
+                summary: "Na een pakbonprint toont het pickscherm of de verzendbrief wordt klaargezet, op Floriday wacht, geprint is of is mislukt.",
+                body: `AANVULLING op prompt 29 t/m 32 (die blijven volledig geldig).
+
+VASTGESTELDE OORZAAK
+De pakbon en verzendbrief worden als één printactie behandeld, maar een officiële
+Floriday-afleverbrief kan nog ontbreken. De Engine blijft dan automatisch
+proberen, terwijl het pickscherm alleen meldt dat de pakbon is verstuurd.
+
+WAT JE BOUWT
+1. Bewaar na iedere geslaagde pakbonprint het teruggegeven print_job-id bij de
+   bijbehorende karregel.
+2. Vraag daarna uitsluitend de status op via:
+   supabase.rpc('logistics_shipping_note_status', {
+     p_slip_job_id: <print_job-id>,
+     p_cart_id: <cart-id>
+   }).
+   Geef bij voorkeur het print_job-id mee; cart-id is alleen de terugval.
+3. Toon direct onder de bestaande printmelding de door de Engine geleverde
+   message. Ondersteun exact deze statussen:
+   - klaar_voor_print: "Verzendbrief wordt klaargezet."
+   - wacht_op_floriday: "Pakbon geprint — wachten op officiële Floriday-afleverbrief."
+   - geprint: "Pakbon en verzendbrief zijn naar de printer gestuurd."
+   - mislukt: toon de veilige message uit de Engine als foutmelding.
+4. Ververs alleen bij klaar_voor_print en wacht_op_floriday, bijvoorbeeld iedere
+   10 seconden, maximaal 15 minuten. Stop bij geprint, mislukt, verlaten van het
+   scherm of verwijderen van de karregel.
+5. Toon bij wachten desgewenst attempts en nextAttemptAt als kleine aanvullende
+   status, maar toon geen eigen technische fouttekst.
+
+BELANGRIJK
+- Status opvragen is alleen-lezen. Maak bij verversen nooit een nieuwe
+  verzendbriefaanvraag of printopdracht aan.
+- Laat de bestaande pakbonknop en de knop voor meerdere karren dezelfde
+  statuscontrole per teruggegeven print_job-id starten.
+- Eén kar blijft één regel. Voeg geen losse verzendbriefregel toe.
+- Wijzig bij printen geen order-, kar- of Floriday-status; afhandeling blijft
+  pas na de controlescan plaatsvinden.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] FO zonder document toont de Floriday-wachtmelding bij dezelfde kar.
+[ ] Zodra Floriday het document levert, verandert de melding naar geprint.
+[ ] BVO toont de status van de eigen verzendbrief zonder Floriday-wachtmelding.
+[ ] Automatisch verversen maakt geen dubbele aanvraag of printopdracht.
+[ ] Zowel enkel printen als meerdere karren printen toont per kar de status.`,
+            },
+            {
+                number: 34,
+                title: "Verzendbrief direct ophalen bij het versturen van de pakbon",
+                date: "2026-09-08",
+                summary: "Zodra een pakbon naar het pickstation gaat, wordt de verzendbrief meteen opgehaald in plaats van pas bij de volgende achtergrondronde.",
+                body: `AANVULLING op prompt 33 (die blijft volledig geldig).
+
+WAAROM
+De verzendbrief werd pas opgehaald bij de volgende achtergrondronde, waardoor
+de status minutenlang op "wordt klaargezet" bleef staan.
+
+WAT ER VERANDERT
+1. Direct na een geslaagde pakbonprint roep je één keer aan:
+   POST /api/public/hooks/logistics-shipping-note-now
+   met de publiceerbare sleutel in de apikey-header en een lege JSON-body.
+2. Vraag daarna meteen de status op met logistics_shipping_note_status, precies
+   zoals in prompt 33.
+3. Ververs bij klaar_voor_print of wacht_op_floriday elke 3 seconden, maximaal
+   15 minuten. Roep het directe eindpunt daarbij niet opnieuw aan.
+4. Print je meerdere karren in één actie, roep het eindpunt dan één keer aan
+   voor de hele actie, niet per kar.
+5. Ontbreekt de sleutel of faalt de aanroep, meld dan niets technisch: de
+   achtergrondverwerking blijft de status vanzelf bijwerken.
+
+DIT GELDT BIJ DE INSTELLING
+Deze werkwijze hoort bij de keuze "Als de pakbon wordt uitgeprint" bij het
+vrijgeven van de verzendbrief. Bij de andere keuzes verandert er niets.
+
+BELANGRIJK
+- Het eindpunt is idempotent en alleen-lezen richting Floriday: het maakt nooit
+  een tweede aanvraag of dubbele printopdracht.
+- Is er nog geen officiële Floriday-afleverbrief, dan blijft de wachtmelding
+  staan; er wordt nooit een leeg of zelfgemaakt document geprint.
+- Printen wijzigt geen enkele status; afhandelen gebeurt pas na de controlescan.
+- Geen URL's van omgevingen, sleutels, project-refs of klantnamen in code; de
+  sleutel komt uit de omgeving van de shell.
+
+CONTROLELIJST
+[ ] Na het printen verschijnt de verzendbriefstatus binnen enkele seconden.
+[ ] Bij een beschikbaar Floriday-document staat de verzendbrief vrijwel direct
+    in de printwachtrij op dezelfde printer.
+[ ] Herhaald printen of verversen levert nooit een tweede verzendbrief op.`,
+            },
+            {
+                number: 35,
+                title: "Laadtoestand en definitieve redenen per eenheid",
+                date: "2026-09-08",
+                summary: "Elke eenheid heeft een vaste toestand (bezig, klaar of geblokkeerd) met voortgang en een leesbare reden, zodat de teksten in de regels niet meer wisselen.",
+                body: `AANVULLING; het gedeelde contract uit koppelprompt 1 blijft geldig.
+
+WAAROM
+Het scherm zag alleen "wel/niet klaar" en wisselde daardoor tussen teksten
+terwijl de Engine nog rekende.
+
+WAT DE ENGINE LEVERT
+1. In public.pick_queue.payload en in logistics_cart_plan_status(ref) staan nu:
+   - planState: precies één van pending, ready of blocked
+   - planStateSince: sinds wanneer die toestand geldt
+   - planProgress: 0-100, of leeg als voortgang niet zinvol is
+   - cartPlanReason: bij pending een wachtreden, bij blocked een concrete
+     oorzaak. Nooit leeg en nooit algemeen.
+2. Nieuwe alleen-lezen functie voor tientallen eenheden in één ronde:
+   logistics_plan_progress(p_refs text[]) geeft per unit_ref:
+   plan_state, plan_progress, plan_state_since, cart_plan_ready,
+   cart_plan_released, cart_plan_reason. Een unit_ref mag een ordernummer,
+   documentnummer of kar-id zijn.
+
+WAT HET PICKSCHERM DOET
+- Toon bij pending één vaste tekst met de voortgangsbalk uit planProgress; wissel
+  niet meer tussen "Pakbon controleren", "Pakbon ophalen" en "Printen".
+- Toon bij blocked de reden uit cartPlanReason en geen printknop.
+- Print alleen bij ready.
+- Ververs de zichtbare eenheden met één aanroep van logistics_plan_progress
+  (alle refs in één array), elke paar seconden. Bereken zelf niets.
+
+BELANGRIJK
+- De functie is alleen-lezen: geen bijwerkingen, geen statuswijzigingen.
+- Kar-id's, karnummers en barcodes blijven eigendom van de Engine.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Elke eenheid heeft altijd een planState.
+[ ] Blocked gaat altijd samen met een concrete oorzaak.
+[ ] Tientallen refs komen in één aanroep terug.`,
+            },
+            {
+                number: 36,
+                title: "Pakbon en verzendbrief in één printactie melden",
+                date: "2026-09-08",
+                summary: "Eén klik op printen stuurt de pakbon en de bijbehorende verzendbrief naar dezelfde printer; ontbreekt de verzendbrief nog, dan is de printactie niet volledig geslaagd.",
+                body: `AANVULLING; het gedeelde contract uit koppelprompt 1 blijft geldig.
+
+WAT DE ENGINE DOET
+- Zodra een pakbon naar het pickstation gaat, zorgt de Engine voor de
+  bijbehorende verzendbrief: bij een Floriday-order wordt die eerst in
+  Floriday aangemaakt en daarna opgehaald, bij een eigen order wordt de
+  eigen layout gebruikt. Beide krijgen dezelfde kar, dezelfde printer en
+  dezelfde print_batch_key (kar-print:<pakbon-id>).
+- Er komt nooit een leeg of zelfgemaakt vervangdocument. Zolang Floriday het
+  officiële document niet teruggeeft, blijft de status "wachten op
+  Floriday-verzendbrief" en wordt er automatisch opnieuw geprobeerd.
+- Printen bevestigt of handelt niets af; dat blijft aan de controlescan.
+
+WAT HET PICKSCHERM DOET
+1. Toon per kar één printregel. Eén klik print de pakbon en de verzendbrief.
+2. Lees de toestand van de verzendbrief met
+   logistics_shipping_note_status(p_slip_job_id, p_cart_id).
+3. Is die toestand wacht_op_floriday, meld de printactie dan NIET als volledig
+   geslaagd. Toon: "Pakbon geprint, verzendbrief wordt nog opgehaald bij
+   Floriday" en houd de regel zichtbaar tot de verzendbrief geprint is.
+4. Klik niet twee keer: de tweede klik mag geen nieuwe verzendbrief aanvragen.
+
+CONTROLELIJST
+[ ] Eén klik levert twee documenten op dezelfde printer.
+[ ] Ontbrekende verzendbrief geeft een wachtmelding, geen "gelukt".
+[ ] Er ontstaat nooit een tweede verzendbrief voor dezelfde pakbon.`,
+            },
+            {
+                number: 37,
+                title: "Knop verzendbrieven ophalen verwerkt alle openstaande pakbonnen",
+                date: "2026-09-08",
+                summary: "Een aanroep van het eindpunt haalt nu de verzendbrieven van alle openstaande pakbonnen op, niet alleen die van de laatst geprinte kar.",
+                body: `AANVULLING; koppelprompt 1 en 30-34 blijven onverkort gelden.
+
+WAT ER VERANDERT
+- POST /api/public/hooks/logistics-shipping-note-now met een lege JSON-body en
+  de apikey-header uit de shell-omgeving pakt zelf alle openstaande
+  verzendbrieven op. Wachttijden worden vrijgegeven, pakbonnen zonder aanvraag
+  krijgen er alsnog een, en de ronden lopen gebundeld door tot alles op is of
+  het tijdbudget vol is.
+- De respons bevat de tellingen van die aanroep: found, printed,
+  waitingForFloriday, retrying, failed, printJobsCreated en rounds.
+- Per pakbon blijven de bestaande regels gelden: idempotent, nooit een tweede
+  Floriday-aanvraag of dubbele printopdracht, nooit een leeg of zelfgemaakt
+  document, printer en kar komen van de pakbon.
+
+WAT HET PICKSCHERM DOET
+- De knop "Verzendbrieven ophalen" roept dit eindpunt aan met een lege body en
+  hoeft niet te wachten tot alles klaar is.
+- Daarna leest het scherm de toestand per kar opnieuw uit met
+  logistics_shipping_note_status, zoals in koppelprompt 33.
+- Herhaald klikken is veilig: er ontstaan geen dubbele aanvragen.
+
+WAT NIET GEBEURT
+- Geen statuswijziging van order, kar of Floriday tijdens het ophalen.
+- Geen vaste URL's, sleutels, project-refs of id's in code.`,
+            },
+            {
+                number: 38,
+                title: "Herkomst van de order bepaalt het type verzendbrief",
+                date: "2026-09-08",
+                summary: "Een Floriday-order krijgt uitsluitend de officiele Floriday-afleverbrief; een eigen order uitsluitend de eigen verzendbrief. Er bestaat geen terugval.",
+                body: `AANVULLING; koppelprompt 1 en 30-37 blijven onverkort gelden.
+
+VASTE REGEL
+- Floriday-order: alleen de officiele Floriday-afleverbrief. Nooit onze eigen
+  verzendbrief, ook niet tijdelijk of als vervanging.
+- Eigen order: alleen onze eigen verzendbrief.
+- Is de herkomst niet met zekerheid vast te stellen, dan wordt er niets
+  aangemaakt en wordt dat gelogd. Geen gok, geen terugval.
+
+WAT DE ENGINE DOET
+- Bij het aanmaken van de verzendbrief en nogmaals vlak voor het printen wordt
+  de herkomst van de order gecontroleerd. Een eigen verzendbrief bij een
+  Floriday-order wordt hard geweigerd met een leesbare foutmelding en een
+  logregel (event shippingnote.blocked).
+- Bestaande foutieve eigen verzendbrieven bij Floriday-orders worden
+  geannuleerd en vervangen door de officiele Floriday-aanvraag; dit gebeurt
+  automatisch bij elke ronde en bij de knop "Verzendbrieven ophalen".
+- Wacht Floriday nog op het document, dan blijft de aanvraag wachten met de
+  reden "wachten op Floriday-verzendbrief".
+
+WAT HET PICKSCHERM DOET
+- Toon bij een Floriday-order nooit een eigen verzendbrief als alternatief.
+- Meld een printactie pas als volledig geslaagd wanneer ook de juiste
+  verzendbrief is geprint; anders de wachtstatus tonen.
+
+CONTROLELIJST
+[ ] Een Floriday-order kan technisch geen eigen verzendbrief krijgen.
+[ ] Een eigen order krijgt nooit een Floriday-document.
+[ ] Foutieve bestaande verzendbrieven worden geannuleerd, niet verborgen.`,
+            },
+            {
+                number: 39,
+                title: "De verzendbrief wordt eerst in Floriday aangevraagd, daarna opgehaald",
+                date: "2026-09-16",
+                summary: "De draaiende omgeving moet de actuele Engine gebruiken die zelf een afleverbrief in Floriday laat aanmaken; passief wachten is geen geldige uitkomst meer.",
+                body: `AANVULLING op prompt 29, 30, 31 en 38 (die blijven volledig geldig).
+
+VASTGESTELDE OORZAAK
+Bij een Floriday-order bleef de verzendbriefaanvraag op wachtend staan met de
+melding dat Floriday nog geen afleverbrief had. In het Floriday-verkeer stond
+echter geen enkele aanvraag om die afleverbrief te laten aanmaken: alleen
+leesacties. De draaiende omgeving gebruikte dus nog een oudere Engine die
+passief afwacht in plaats van zelf de afleveropdracht aan te vragen.
+
+WAT JE BOUWT
+1. Gebruik uitsluitend de actuele verzendbriefverwerking uit de Logistiek
+   Engine. Die doet twee dingen achter elkaar: eerst de afleverbrief in
+   Floriday laten aanmaken, daarna het officiele document ophalen.
+2. Bestaat er al een afleveropdracht voor deze pakbon, dan wordt er geen tweede
+   aangevraagd.
+3. Staat de schakelaar voor het aanmaken van de afleverbrief uit, dan is dat de
+   getoonde wachtreden. Niet stil afwachten.
+4. Blijft een aanvraag wachten, toon dan of er al een aanvraag naar Floriday is
+   gegaan en hoe vaak. Nul aanvragen bij een wachtende Floriday-order is een
+   fout in de omgeving, geen normale toestand.
+5. Aanvragen en ophalen wijzigen geen orderstatus en melden geen kar of order
+   af; dat blijft aan de controlescan.
+
+WAT JE NIET DOET
+- Een verzendbrief maken zonder officieel Floriday-document.
+- Een eigen verzendbrieflayout gebruiken voor een Floriday-order.
+- Een tweede afleveropdracht aanvragen voor dezelfde pakbon.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Bij een wachtende Floriday-order staat het aantal verstuurde aanvragen op
+    minstens 1, of er staat een concrete reden waarom er niets is verstuurd.
+[ ] Een pakbonactie levert maximaal een afleveropdracht en een verzendbriefjob.
+[ ] De verzendbrief gaat naar dezelfde printer als de pakbon.
+[ ] De order blijft open tot de controlescan.`,
+            },
         ],
     },
     scanners: {
@@ -2691,6 +3486,56 @@ CONTROLELIJST
 [ ] Het getoonde nummer is gelijk aan het nummer op de pakbon.
 [ ] cart_index komt nergens in de weergave voor.`,
             },
+            {
+                number: 5,
+                title: "Controlewijze \"scannen voor afmelden\"",
+                date: "2026-09-07",
+                summary: "Nieuwe eis bovenop prompt 1 t/m 4: bij deze werkwijze meldt één pakbonscan de hele kar af, zonder goedkeurstap en zonder printen.",
+                body: `AANVULLING op koppelprompt 1 t/m 4 (die blijven geldig).
+
+WAT ER VERANDERT
+In de Logistiek Engine, stap 6 "Controle", heet de bestaande scancontrole nu
+"Scancontrole met verzendbrief uitprinten". Daarnaast bestaat er een nieuwe
+werkwijze: "Scannen voor afmelden" (control_mode = scan_only).
+
+HOE JE DE WERKWIJZE OPHAALT
+logistics_control_settings() geeft nu:
+- controlMode        : "scanner" | "scan_only" | "paper" | "skip"
+- scannerId          : de scanner van de controlepost
+- printerId          : alleen gevuld bij "scanner"; bij scan_only altijd null
+- completeOnScan     : true bij scan_only
+- printsShippingNote : true bij scanner
+
+Ook de control.execute taak draagt dit: payload.controlMode,
+payload.completeOnScan en payload.printsShippingNote.
+
+GEDRAG BIJ completeOnScan = true
+- De medewerker scant alleen de pakbon. Geen tweede stap, geen apart
+  goedkeurscherm, geen printerkeuze en geen afleverbrief.
+- Roep gewoon logistics_control_scan_approve(p_barcode, p_scanner_id, null) aan.
+  De Engine meldt daarmee de hele kar af en geeft status "afgemeld" terug met
+  cartsCompleted.
+- Toon na een geslaagde scan alleen de bevestiging dat de kar is afgemeld;
+  verwacht geen printJobId.
+- Bij ok = false: toon de tekst van de Engine letterlijk. errorCode
+  "al_gecontroleerd" betekent dat deze kar al is afgemeld.
+
+GEDRAG BIJ completeOnScan = false
+Ongewijzigd: scannen, goedkeuren, de Engine zet de verzendbrief/afleverbrief
+klaar op printerId.
+
+NIET DOEN
+- Zelf beslissen of er geprint moet worden of zelf een kar afmelden buiten de
+  Engine om.
+- De printerkeuze tonen als printerId leeg is.
+- URL's, sleutels, project-refs of klantnamen in code.
+
+CONTROLELIJST
+[ ] De werkwijze komt uit logistics_control_settings(), niet uit eigen instellingen.
+[ ] Bij scan_only is één pakbonscan genoeg en verdwijnt de goedkeur- en printstap.
+[ ] Bij scan_only wordt er nergens een printjob aangemaakt.
+[ ] Foutteksten komen letterlijk van de Engine.`,
+            },
         ],
     },
     voorraad: {
@@ -3275,6 +4120,54 @@ CONTROLELIJST
 [ ] Elke weigering en elke verzending staat in het logboek.
 [ ] Lezen blijft werken.`,
             },
+            {
+                number: 2,
+                title: "Herkomst en groepssleutel bij elke binnenkomende bestelling",
+                date: "2026-09-09",
+                withSharedContract: false,
+                summary: "Elke order krijgt bij het aanmaken een herkomst en, bij Floriday, een groepssleutel zonder regeltijdstip, zodat de Engine bestelregels tot één bestelling kan bundelen.",
+                body: `WAAROM
+Floriday levert elke bestelregel als een eigen verkooporder. Eén bestelling van
+één klant werd daardoor vijf orders met vijf ordernummers. De Engine bundelt die
+regels voortaan zelf, maar kan dat alleen als bij het aanmaken van de order
+klopt waar hij vandaan komt en bij welke bestelling hij hoort.
+
+WAT JE BOUWT
+Bij elke order die je in public.orders aanmaakt of bijwerkt zet je:
+
+- order_source, met exact één van deze waarden:
+    floriday    - opgehaald uit Floriday
+    mail        - goedgekeurd voorstel uit de mailbox voor bestellingen
+    actiemail   - goedgekeurd voorstel uit de actiemail
+    manual      - met de hand ingevoerd in verkoop
+- floriday_sales_order_id: het id van de Floriday-verkooporder (alleen bij
+  floriday).
+- floriday_order_group_key: de groepssleutel van de bestelling. De delen staan
+  gescheiden door een verticale streep en beschrijven koper, levermoment,
+  afleverlocatie en organisatie. Het laatste deel mag het tijdstip van de losse
+  regel zijn; de Engine laat dat deel bewust weg bij het bundelen.
+
+REGELS
+- Alle regels van dezelfde bestelling krijgen dezelfde delen vóór het tijdstip.
+  Zit daar iets in dat per regel verschilt (artikel, regelnummer, regel-id), dan
+  bundelt de Engine niets meer en ontstaan er weer losse orders.
+- Vul de herkomst altijd; nooit leeg laten en nooit raden. Onbekende herkomst
+  betekent: order niet aanmaken en melden.
+- Werk nooit een order bij die de Engine als samengevoegd heeft gemarkeerd
+  (deleted_at gevuld en een regel in public.logistics_order_merges). Schrijf in
+  dat geval naar de bewaarde bestelling (kept_order_id).
+- Terugkoppeling naar Floriday blijft per verkooporder-id lopen; die id's staan
+  bewaard in logistics_order_merges.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste database-id's in code
+  of migraties.
+
+CONTROLELIJST
+[ ] Elke nieuwe order heeft een gevulde, geldige order_source.
+[ ] Floriday-regels van dezelfde bestelling delen dezelfde groepssleutel op het
+    tijdstip na.
+[ ] Een samengevoegde order wordt nooit opnieuw aangemaakt of bijgewerkt.
+[ ] Elke Floriday-order houdt zijn eigen floriday_sales_order_id.`,
+            },
         ],
     },
 };