# Documentatie > Hoe Adorea met recepten, grondstoffen en versies werkt, en welke tools Claude kan gebruiken. Adorea bewaart de recepten van een ambachtelijke bakkerij op één plek: voor het kantoor op de computer, voor de bakkers op de iPad, en voor Claude via MCP. - [Grammen en bakkerspercentages](https://docs.adorea.nl/concepten/grammen-en-percentages/): wat er wordt opgeslagen en wat wordt uitgerekend. - [Onderdelen](https://docs.adorea.nl/concepten/onderdelen/): recepten in recepten, zoals een deeg dat in meerdere broden zit. - [Versies](https://docs.adorea.nl/concepten/versies/): elke wijziging wordt bewaard en kan worden teruggezet. - [Importeren](https://docs.adorea.nl/concepten/importeren/): recepten uit Excel-werkboeken overnemen. - [MCP-tools](https://docs.adorea.nl/mcp/tools/): alle tools die Claude kan gebruiken. - [Claude koppelen](https://docs.adorea.nl/mcp/koppelen/): Claude verbinden, en hoe Claude zelf in deze documentatie zoekt. Per scherm: - [Inloggen en de iPad koppelen](https://docs.adorea.nl/app/inloggen/) - [Recepten zoeken en schalen](https://docs.adorea.nl/app/recepten/) - [De werkvloer](https://docs.adorea.nl/app/werkvloer/) - [Importeren in de app](https://docs.adorea.nl/app/importeren/) - [Producten](https://docs.adorea.nl/app/producten/) en [grondstoffen](https://docs.adorea.nl/app/grondstoffen/) - [Versiegeschiedenis](https://docs.adorea.nl/app/versies/) - [Instellingen](https://docs.adorea.nl/app/instellingen/) en [zoeken met ⌘K](https://docs.adorea.nl/app/zoeken/) --- # Recepten bewerken > Een recept aanpassen in de app: een concept, live controle, voorstellen van Adorea en één versie per keer bewaren. Op een computer of laptop (vanaf 1024 pixels breed) staat op elk recept de knop **Bewerken**. Op de iPad en de telefoon blijft een recept alleen te lezen; daar bak je. ## Een concept, dan bewaren Alles wat je verandert, verandert eerst alleen een concept. Er wordt niets bewaard tot je op **Bewaar** klikt. Het concept staat ook op deze computer: ververs je de pagina of valt de verbinding weg, dan vraagt de editor of je verder wilt met het concept of het weggooit. Wat je kunt aanpassen: - grammen, of het **% van meel** (kies bovenaan *gram* of *% van meel*); - of een regel als meel telt (het vakje voor de naam); - regels toevoegen, weghalen en verplaatsen; - groepen, zoals biga, weekmengsel of deel 1, en een notitie per regel; - de werkwijze: stappen toevoegen, aanpassen, weghalen en verplaatsen; - de producten uit dit deeg en hun stukgewicht. Een regel toevoegen gaat met één regel tekst: `lijnzaad`, `3% honing`, `200 g rozijnen` of `Boerenbrood 5 kg`. De naam wordt gezocht zoals bij een import, ook op andere schrijfwijzen. Bestaat hij niet, dan stelt de editor de dichtstbijzijnde naam voor of maakt hij een nieuwe grondstof. Een percentage van een meelregel wijzigen houdt het meel samen op 100%: de andere meelregels schuiven mee. | Toets | Doet | | --- | --- | | Enter in een grammenveld | naar de volgende regel | | ⌘S | bewaren | | ⌘Z, ⌘⇧Z | ongedaan maken, opnieuw | | ⌥↑, ⌥↓ op de greep | regel of groep een plek omhoog of omlaag | | Esc | stoppen met bewerken | ## Controle Rechts staat **Controle**: bij elke wijziging kijkt de editor opnieuw. Een rood punt houdt bewaren tegen, zoals een recept dat zichzelf zou bevatten of een regel zonder grondstof. De rest is advies: - een hoeveelheid die ontbreekt of een grondstof die twee keer in dezelfde groep staat; - een tikfout van ongeveer ×10 of ÷10 ten opzichte van de bewaarde versie; - zout of verse gist buiten wat gebruikelijk is voor brood en viennoiserie; - zaden zonder weekwater (zaden nemen ongeveer hun eigen gewicht aan water op); - hoeveel stuks een batch geeft, en wat er verandert; - recepten die dit deeg gebruiken en meeveranderen; - nieuwe allergenen op de producten; - een grondstof zonder etiketnaam die op een etiket komt; - een stap die een grondstof noemt die niet in het recept staat. Een voorbeeld met Boerenbrood (20.000 g meel, 400 g zout, 950 g en 1.250 g per stuk), waar Pompoenbrood 10.000 g van gebruikt. Zout naar 2,2% en 4% lijnzaad in een weekmengsel: | Controle | Zegt | | --- | --- | | Zaden | Lijnzaad zonder weekwater trekt vocht uit het deeg. | | Per batch | Boerenbrood groot 31 → 32 stuks, Boerenbrood middel 41 → 42. | | Onderdeel | Pompoenbrood gebruikt dit deeg en verandert mee: 199 g lijnzaad per 10 kg. | | Zout | Zout 2,2% past bij brood (1,8 tot 2,4%). | Met 800 g weekwater erbij verdwijnt de eerste melding en wordt de hydratatie 74%. Na het bewaren blijven waarschuwingen zichtbaar op het recept. ## Voorstellen van Adorea Bovenaan kun je typen wat je wilt, bijvoorbeeld *zout naar 2,2% en 4% lijnzaad, geweekt*. Adorea zet het als concept in de tabel, met **Ongedaan maken** ernaast. Vindt de controle iets dat Adorea kan oplossen, zoals zaden zonder weekwater, dan verschijnt er een voorstel met uitleg. Een voorstel verandert niets tot je **Neem over** kiest én bewaart; de versiegeschiedenis noemt welke voorstellen je overnam. Voor een voorstel gaat het concept naar een taalmodel: de regels met namen en grammen, de werkwijze, de producten, de open punten uit de controle en de namen van je grondstoffen. Geen andere recepten, geen prijzen, geen namen van mensen. Het model draait op Cloudflare (Workers AI), waar ook de rest van Adorea draait, en bewaart niets. Elke aanvraag loopt via een AI Gateway met een maximum per maand. Voorstellen zet je uit in **Instellingen**; de controle blijft dan gewoon werken. Zonder voorstellen, of als ze even niet lukken, werkt de editor hetzelfde: alles kan ook met de hand. ## Bewaren **Bewaar** laat zien wat er verandert en wat dat doet: deeg per batch, hydratatie, stuks per product, recepten die meeveranderen en allergenen. Vul in **Waarom** in wat de reden is; dat komt in de [versiegeschiedenis](https://docs.adorea.nl/app/versies/). Eén keer bewaren is één nieuwe versie. Een product waarvan je het stukgewicht veranderde, krijgt ook een eigen versie. Heeft iemand anders (of Claude) het recept intussen veranderd, dan bewaart de editor niets. Je ziet wat er veranderde en kiest **Zet mijn wijzigingen op de nieuwe versie**; daarna kijk je het na en bewaar je opnieuw. Claude past recepten op dezelfde manier aan, met `recipe_check` en `recipe_apply_edit`. Zie [MCP-tools](https://docs.adorea.nl/mcp/tools/). --- # Grondstoffen > Eén naam per grondstof: samenvoegen, etiketnaam, allergenen en verpakkingen. Een grondstof is alles wat in een recept gaat. Het doel is één naam per grondstof, zodat allergenen en straks de kostprijs kloppen. ## De lijst **Grondstoffen** toont alles, gesorteerd op hoe vaak het gebruikt wordt. Met de filters vind je wat nog werk nodig heeft: dubbele namen, een ontbrekende etiketnaam, geen allergenen ingevuld, omrekeningen die je nog moet bevestigen, desem zonder recept, of grondstoffen die nergens in zitten. **Exporteer voor inkoop** geeft een CSV-bestand voor Excel met namen, allergenen en verpakkingen. ## Samenvoegen Namen die op elkaar lijken, zoals "Kristalsuiker" en "Kristalsuikers", staan bij **Dubbele namen**. Kies welke naam blijft en klik op **Samenvoegen**. Adorea laat eerst zien wat er verandert, bijvoorbeeld "Kristalsuikers gaat op in Kristalsuiker; 3 regels in 2 recepten worden aangepast". Pas na bevestigen gebeurt het. De andere naam wordt een ook-naam van de grondstof die blijft. In de recepten blijft de naam staan die de bakker kent. ## Een grondstof Op de pagina van een grondstof pas je aan: - de hoofdnaam en de ook-namen; - de etiketnaam en herkomst; - de allergenen, de 14 uit de EU-verordening; - verpakkingen, zoals "1 blok = 2.500 g", en het gewicht per stuk (één ei); - de soort, die de kleur in de deegbalk bepaalt; vocht telt mee voor de hydratatie; - **neemt water op**, voor zaden, granen en vlokken: de [controle bij het bewerken](https://docs.adorea.nl/app/bewerken/#controle) waarschuwt dan als er geen weekwater bij staat. **Opslaan** maakt één versie met alles wat je hebt veranderd. Vul bij **Waarom** in waarom, dan staat dat in de geschiedenis. --- # Importeren in de app > Werkboeken neerzetten, controleren wat Adorea niet zeker weet, en in één keer opslaan. Hoe Adorea een werkboek leest, staat bij [Importeren](https://docs.adorea.nl/concepten/importeren/). Dit is het scherm. ## Werkboeken neerzetten Ga naar **Import** en sleep je Excel-bestanden in het vak, of kies ze met **Kies bestanden**. Per bestand zie je hoeveel tabbladen er gelezen zijn. De bestanden worden in je browser gelezen en blijven zoals ze zijn; alleen de recepten gaan naar Adorea. Klik op **Tabbladen controleren**. Er is dan nog niets opgeslagen. ## Controleren Bovenaan staat hoeveel recepten klaar zijn, met de aantallen ingrediëntnamen, gekoppelde onderdelen en regels zonder hoeveelheid. Links staan de soorten beslissingen: | Soort | Wat je beslist | | --- | --- | | Ingrediënten samenvoegen | Of namen als "Ei" en "Eieren" één grondstof zijn. | | Onderdelen koppelen | Aan welk recept een regel als "Desembrooddeeg (zie tab Desembrood)" hoort. | | Recepten | Categorie, importeren of overslaan. | | Afwijkingen van de bron | Waarden die afwijken van een oudere bron; alleen ter kennisgeving. | | Ontbrekende onderdelen | Onderdelen zonder eigen recept, zoals desem. | | Grondstoffen | Nieuwe grondstoffen, en of een naam bij een andere hoort. | | Omrekeningen | "1 ei = 50 g" en dergelijke; ze komen onbevestigd bij de grondstof. | Een rood getal is een open vraag. Zolang er open vragen zijn, kan de import niet worden opgeslagen. Wat Adorea zelf voorstelt, kun je laten staan of veranderen. ## Opslaan of weggooien **N recepten opslaan** toont eerst wat er gaat gebeuren, bijvoorbeeld "12 recepten nieuw, 0 bijgewerkt; 8 nieuwe grondstoffen". Pas na **Ja, opslaan** wordt alles in één keer geschreven, met een versie per recept. **Weggooien** gooit de hele import weg. Er was nog niets opgeslagen, dus aan de recepten verandert niets. --- # Inloggen en de iPad koppelen > Inloggen met een link in je mail, en een iPad bij de werkbank koppelen met een code. Adorea heeft geen wachtwoorden. Op de computer log je in met een link in je mail; een iPad op de werkvloer koppel je één keer met een code. ## Inloggen op de computer 1. Ga naar `app.adorea.nl` en vul je e-mailadres in. 2. Klik op **Stuur me een link**. Je krijgt een mail met een link. 3. Open de link in dezelfde browser. Je bent ingelogd en blijft dat 30 dagen. De link werkt 15 minuten, één keer, en alleen in de browser waarin je hem hebt aangevraagd. Wie de mail onderschept, kan er dus niets mee. Na 30 seconden kun je een nieuwe link laten sturen; na drie links in een kwartier moet je even wachten. Op het scherm staat altijd "Check je mail", ook bij een adres dat Adorea niet kent. Zo verraadt de pagina niet wie een account heeft. ## Een iPad koppelen Een iPad bij de werkbank heeft geen eigen account. Hij hoort bij één locatie en kan recepten en producten lezen, schalen en de werkvloer gebruiken. Wijzigen kan hij niet. 1. Ga op de computer naar **Instellingen, Locaties en apparaten** en klik op **iPad koppelen**. Je ziet een code van zes tekens, bijvoorbeeld `K7M-4PX`. 2. Open op de iPad `app.adorea.nl/koppelen` (of kies **iPad koppelen met een code** op de inlogpagina). 3. Typ de code. De iPad toont de bakkerij en de locatie, bijvoorbeeld "Bakkerij Voorbeeld · Winkel Centrum". 4. Klopt dat, tik dan op **Koppelen**. De code werkt 10 minuten en één keer. Hij bevat alleen tekens die je niet kunt verwarren: geen O en 0, geen I en 1. Na tien verkeerde codes vanaf hetzelfde netwerk moet je een kwartier wachten. Een gekoppelde iPad blijft gekoppeld tot je hem ontkoppelt bij **Instellingen**. Hij verliest dan meteen toegang. --- # Instellingen > Je bakkerij, locaties, gekoppelde iPads en Claude. ## Bakkerij Wie er is ingelogd, en **Uitloggen**. ## Locaties en apparaten Elke bakkerij heeft minstens één locatie: een winkel, een productie of een winkel met bakkerij. Met **Locatie toevoegen** maak je er een bij; met **…** wijzig je de naam, de openingsdagen en wanneer de productiedag begint. Recepten, grondstoffen en producten zijn gedeeld tussen locaties. Wat een locatie verkoopt, en straks prijzen en planning, horen per locatie. Zolang er één locatie is, laat Adorea locaties alleen hier zien. Onder **Apparaten** staan de gekoppelde iPads, met hun locatie en wanneer ze voor het laatst gebruikt zijn. **iPad koppelen** maakt een code; zie [Inloggen en de iPad koppelen](https://docs.adorea.nl/app/inloggen/). **Ontkoppel** haalt de toegang van een iPad meteen weg. ## Claude koppelen Hier staat de connector-link voor Claude, met de stappen om te koppelen. Wat Claude mag, kies je bij het koppelen; opnieuw koppelen is hoe je het verandert. Onder **Recent via Claude** staan de laatste wijzigingen die Claude deed. Lezen en schalen veranderen niets en staan hier niet. Zie [Claude koppelen](https://docs.adorea.nl/mcp/koppelen/) voor alles over de koppeling. --- # Producten > Wat er over de toonbank gaat: maten per deeg en hoeveel stuks één deeg oplevert. Een product is een stuk dat je verkoopt, met het deeggewicht per stuk. Uit één recept kunnen meerdere producten komen: Boerenbrood groot (1.250 g) en Boerenbrood middel (950 g) zijn twee maten van hetzelfde deeg. **Producten** toont ze per recept, met hoeveel stuks er uit één deeg komen. Bij Boerenbrood (39.400 g deeg) is dat 31 groot of 41 middel. Prijzen komen in de fase Geld. ## Een maat toevoegen Klik bij een recept op **+ Maat**, geef een naam en het stukgewicht in gram. Met **…** wijzig of archiveer je een product. Elke wijziging komt in de versies. Recepten zonder product staan in de gele balk bovenaan; met **Laat zien** zie je ze en kun je er een maat aan toevoegen. Zonder stukgewicht weet Adorea niet hoeveel stuks er uit een deeg komen en kun je niet op stuks schalen. --- # Recepten zoeken en schalen > De receptenlijst, een recept lezen en schalen naar een deeggewicht, meelgewicht of aantal stuks. ## De lijst **Recepten** toont alle recepten met hun samenstelling als gekleurde balk: meel, vocht, desem en gist, vet, suiker, toevoegingen. Een gestreept stuk is een onderdeel, een ander recept dat in dit deeg zit. Bovenaan staat wat aandacht vraagt: onvolledige recepten en een import die op je wacht. Filter op categorie met de knoppen boven de lijst of in de zijbalk, of zoek op naam. De status naast elk recept: | Status | Betekent | | --- | --- | | Compleet | Klaar voor de werkvloer. | | Onvolledig | Een concept: er ontbreekt een hoeveelheid, stap of stukgewicht. | | Op Boerenbrood | Dit recept is gemaakt op een ander deeg als onderdeel. | | Stukgewicht mist | Er is nog geen product met een stukgewicht. | ## Een recept Een recept toont per regel de bakkerspercentage en de grammen, met daaronder het totaal deeg. Bij Boerenbrood: | Ingrediënt | Bakkers-% | Gram | | --- | ---: | ---: | | Tarwebloem T80 | 90% | 18.000 | | Tarwebloem T65 | 10% | 2.000 | | Water | 70% | 14.000 | | Roggedesem | 25% | 5.000 | | Zout | 2% | 400 | | **Totaal deeg** | 197% | **39.400** | Rechts staan de producten uit dit deeg met hoeveel stuks er uit één deeg komen, en in welke andere recepten dit deeg zit. Zie [Grammen en bakkerspercentages](https://docs.adorea.nl/concepten/grammen-en-percentages/) voor hoe de percentages werken. Op een computer pas je een recept aan met **Bewerken**; zie [Recepten bewerken](https://docs.adorea.nl/app/bewerken/). Een import of Claude kan het ook. Elke wijziging komt in de [versies](https://docs.adorea.nl/app/versies/). ## Schalen Met **Schaal naar** kies je hoeveel je wilt maken: - een meelgewicht, bijvoorbeeld 20 kg meel (bij recepten zonder meel: een deeggewicht); - een aantal stuks van een product, bijvoorbeeld 60 × groot. Met − en + ga je per kilo omhoog of omlaag. De grammen in de tabel en het totaal passen zich aan; 60 × groot Boerenbrood is 75.000 g deeg met 26.650 g water. **Origineel** zet het recept terug zoals het staat. De schaal staat in de adresbalk. Een gedeelde link of **Werkvloer** toont dus dezelfde hoeveelheid. Schalen verandert niets aan het recept. --- # Versiegeschiedenis > Per recept en grondstof zien wat er veranderde, wat dat doet, waarom, en het terugzetten. Open **Geschiedenis** bij een recept of grondstof. Hoe versies werken, staat bij [Versies](https://docs.adorea.nl/concepten/versies/). Links staat de tijdlijn: wanneer, wie en via welke weg (de app, Claude of een import), met wat er veranderde, bijvoorbeeld "Water 14.000 → 15.000 g". Kies een versie om rechts te zien: - **Wat er veranderde**: bij een recept de grammen van elke regel, ervoor en erna, met de gewijzigde regel gemarkeerd; - **Wat dat doet**: hydratatie, deeg per batch en stuks per product, ervoor en erna; - **Waarom**: de reden die bij de wijziging is opgegeven, ook als Claude de wijziging deed. ## Terugzetten **Zet versie van … terug** draait de gekozen wijziging terug. Je kunt een reden opgeven. Terugzetten maakt een nieuwe versie; de versie die je terugdraait blijft bewaard. --- # De werkvloer > Een recept afwegen op de iPad: regels afvinken, door de werkwijze stappen, de hoeveelheid aanpassen. De werkvloer is het recept zoals je het bij de werkbank nodig hebt: grote cijfers, grote knoppen, niets anders. Open hem vanuit een recept met **Werkvloer**. De hoeveelheid die je had geschaald, gaat mee. ## Afwegen Links staat elke regel met zijn grammen. Tik op het rondje voor een regel als je hem hebt afgewogen; hij wordt grijs en onderaan telt Adorea mee, bijvoorbeeld "4 van 5 afgewogen". Bovenaan staat wat je vandaag draait, bijvoorbeeld "60 × groot, 75,0 kg deeg". Met − en + verander je het aantal per stuk, of per kilo als je op gewicht werkt. Tik op de hoeveelheid zelf om een ander getal te typen. ## De werkwijze Rechts staan de stappen. De huidige stap is oranje omlijnd; met de grote knop onderaan vink je hem af en ga je naar de volgende. Tik op een stap om er direct naartoe te gaan. Afvinken en stappen blijven op deze iPad tot je de pagina sluit, per recept en per hoeveelheid. Er wordt niets in het recept opgeslagen. --- # Zoeken en Vraag Adorea > Met ⌘K overal zoeken en springen, en hoe je Claude iets vraagt. ## ⌘K Druk ⌘K (Ctrl+K op Windows) of klik op **Zoek alles…** bovenaan. Typ een deel van een naam: Adorea toont recepten, producten en grondstoffen, en wat je ermee kunt doen: - **Schaal Boerenbrood naar …** opent het recept bij het schalen; - **Versies van Boerenbrood** opent de geschiedenis; - **Open Boerenbrood op de werkvloer**. Kies met ↑ en ↓, open met ↵, sluit met esc. ## Vraag Adorea **Vraag Adorea** en ⌘↵ in het zoekvenster leggen uit hoe je Claude iets vraagt over je recepten. Een ingebouwde chat komt later; tot die tijd werkt Claude met dezelfde regels als de app, zie [Claude koppelen](https://docs.adorea.nl/mcp/koppelen/). --- # Grammen en bakkerspercentages > Adorea slaat alleen grammen op. Percentages, hydratatie en stuks worden uitgerekend. Elke regel in een recept heeft een hoeveelheid in grammen. Dat is het enige getal dat Adorea bewaart. Bakkerspercentages, hydratatie, het totale deeggewicht en het aantal stuks per deeg worden er steeds uit berekend. Zo kunnen ze nooit uit de pas lopen. ## Een voorbeeld Het Boerenbrood van Bakkerij Voorbeeld: | Grondstof | Gram | Bakkers-% | | --- | ---: | ---: | | Tarwebloem T80 | 18.000 | 90% | | Tarwebloem T65 | 2.000 | 10% | | Water | 14.000 | 70% | | Roggedesem | 5.000 | 25% | | Zout | 400 | 2% | - **Meel**: de regels die als meel tellen, samen 20.000 g. Dat is 100%. - **Deeggewicht**: alle regels samen, 39.400 g. - **Hydratatie**: water gedeeld door meel, 70%. Desem telt niet als meel. - **Stuks per deeg**: deeggewicht gedeeld door het stukgewicht, naar beneden afgerond. Met 1.250 g per brood zijn dat 31 broden, met 950 g 41. Welke regels als meel tellen staat per regel. Een nieuwe regel neemt de instelling van de grondstof over: namen met meel, bloem of een T-nummer (T55, T65, T80, T150) tellen standaard als meel. ## Schalen Schalen verandert het recept niet. Je kiest een doel en Adorea rekent elke regel om met dezelfde factor: - een deeggewicht, bijvoorbeeld 20 kg deeg; - een hoeveelheid meel, bijvoorbeeld 5 kg meel; - een aantal stuks van een product, bijvoorbeeld 60 grote broden van 1.250 g, dus 75.000 g deeg. Een recept kan een verliespercentage hebben voor deeg- en bakverlies (standaard 0%). Bij een doel in deeg of stuks maakt Adorea dan zoveel meer deeg dat er na verlies genoeg over is. ## Hoeveelheid ontbreekt Een regel zonder grammen mag. Hij telt niet mee in de totalen en blijft leeg bij het schalen, maar telt wel mee voor allergenen. ## Recepten zonder meel Een room of vulling heeft geen meel. Dan toont Adorea alleen grammen, zonder percentages. --- # Importeren > Hoe recepten uit Excel-werkboeken in Adorea komen, en wat je daarbij beslist. Adorea leest recepten uit Excel-werkboeken met één recept per tabblad. Een import schrijft niets meteen weg: eerst zet Adorea alles klaar als voorstel, jij beslist wat nodig is, en pas na goedkeuren worden de recepten aangemaakt. ## Hoe een tabblad eruitziet | Cel | Inhoud | | --- | --- | | A, B, C | Ingrediënt, percentage, gram. C2 is het echte gewicht van de eerste regel. | | Volgende regels | Ingrediënt en percentage. Adorea rekent de grammen zelf uit: C2 × percentage ÷ B2, afgerond op 0,1 g. | | Totaal deeggewicht | Wordt genegeerd en opnieuw berekend. | | Gewicht per stuk (gram) | Het stukgewicht, als het bekend is. | | E1 | De werkwijze, met notities. | Een tabblad waarvan de naam eindigt op "(onvolledig)" wordt een concept. ### Haakjes in de naam | In het blad | Wordt | | --- | --- | | Chocolade callets (deel 1) | groep "deel 1" | | Wit desem (optioneel) | optionele regel | | Vlaaivulling, optioneel (zie Halffabricaten) | optioneel onderdeel | | Desembrooddeeg (zie tab Desembrood) | onderdeel: het recept Desembrood | | Toerboter (ca. 15 °C) | notitie "ca. 15 °C" | ### Notities in de werkwijze | Regel begint met | Wordt | | --- | --- | | Bron: | bron van het recept | | Omgerekend: | aanname bij de grondstof, om één keer te bevestigen | | Onderdeel: | verwijzing naar een ander recept | | Deeggewicht: | producten, bijvoorbeeld "1.000 g groot, 600 g klein" | | Let op | opmerking bij het recept | Alle andere regels zijn stappen van de werkwijze. ## Wat je beslist Adorea doet voor alles een voorstel. Alleen wat het niet zeker weet, staat open en moet beslist worden voor je kunt goedkeuren. - **Grondstoffen**: elke naam wordt een grondstof, of een bestaande als die al bekend is. Adorea stelt de samenstelling voor (meel, vocht, rijs, vet, suiker, toevoeging of overig) en of hij als meel telt. Namen met meel, bloem of een T-nummer tellen als meel; desem en amandelmeel niet. - **Dubbele namen**: "Ei" en "Eieren" lijken dezelfde grondstof. Kies samenvoegen of apart houden. In de recepten blijft de naam staan die de bakkers kennen. - **Zelfde grondstof**: een naam kan ook "zelfde als" een andere grondstof uit de import worden, bijvoorbeeld "Water 18 °C" als Water. De naam wordt een alias; in het recept blijft "Water 18 °C" staan. - **Onderdelen**: een verwijzing naar een ander tabblad wordt gekoppeld. Staat dat recept niet in deze import maar wel in de werkboeken, kies dan: koppelen aan een bestaand recept, als grondstof houden of de regel weglaten. Bestaat het recept nergens, dan wordt het voorstel een grondstof met "recept ontbreekt". - **Recepten**: een geraden categorie, of een vraag uit het blad (zoals een stukgewicht dat afwijkt van het deeggewicht), moet je bevestigen. - **Desem zonder recept**: blijft een grondstof, gemarkeerd als "recept ontbreekt". - **Onvolledige recepten**: worden een concept. Wat ontbreekt, staat in de opmerking bij het recept. ### Aannames bij grondstoffen Een regel "Omgerekend: 1 ei = 50 g, citroenrasp 3 g per citroen" zegt hoe stuks of lepels naar grammen zijn omgerekend. Adorea zet elk deel bij de grondstof waar het over gaat: "1 ei = 50 g" bij Eieren, "citroenrasp 3 g per citroen" bij Citroenrasp. Een algemene regel als "1 tl = 5 g" gaat naar de regels die in theelepels gemeten zijn ("Bakpoeder (2 tl)"). Wat nergens bij past, blijft bij het recept staan. De aannames staan bij de grondstof als **onbevestigd**, met de recepten die erop rusten. Bevestig ze één keer per grondstof (in Claude: `ingredient_update` met `confirm_assumptions`). `ingredient_list` met `unconfirmed` toont wat nog open staat. ## Goedkeuren Goedkeuren is een voorgestelde wijziging: je ziet eerst wat er wordt aangemaakt of bijgewerkt. Na bevestigen schrijft Adorea in één keer alle grondstoffen, recepten, regels, stappen en producten. Lukt één ding niet, dan verandert er niets. Elke wijziging komt in de [geschiedenis](https://docs.adorea.nl/concepten/versies/) met "via import". Een grondstof die eerder in de plaats van een recept stond (omdat dat recept nog niet geïmporteerd was), wordt gearchiveerd zodra het recept er is en niemand de grondstof nog gebruikt. ## Opnieuw importeren Na goedkeuren schrijft Adorea in elk tabblad de vaste naam van het recept (de slug, zoals `desembrood`) in cel Z1, in een kopie van het werkboek. Kolom Z is verborgen; de rest van het blad blijft zoals het was. Werk voortaan in die kopie. Bij een volgende import herkent Adorea elk recept aan die slug, ook als het tabblad een andere naam heeft gekregen. Zonder slug zoekt Adorea een recept met dezelfde naam. Een gevonden recept wordt bijgewerkt, niet opnieuw aangemaakt: | Uit het werkboek | Blijft zoals het is | | --- | --- | | Regels, werkwijze, bron, opmerkingen, concept of compleet | Naam, categorie, verlies en bakprofiel, tenzij je bij de beslissing iets anders kiest | | Producten: nieuwe maten erbij, stukgewicht bijgewerkt | Producten die niet in het blad staan | Een tabblad dat niet veranderd is, schrijft niets: geen nieuwe versie. Weggooien kan zolang de import niet is goedgekeurd. Er verandert dan niets aan de recepten. --- # Onderdelen > Een recept kan andere recepten gebruiken, zoals een deeg of een vulling. Een recept kan een ander recept als regel hebben. Het Pompoenbrood van Bakkerij Voorbeeld is 10.000 g Boerenbrooddeeg plus 1.000 g geroosterde pompoen. Het Boerenbrood is dan een onderdeel. ## Bakkerspercentages Bij bakkerspercentages is het meel 100%. Heeft een recept zelf geen meel, dan telt standaard het onderdeel als 100%. De pompoen is dan 10% van het deeg. Met de instelling "percentages tegen meel" is in plaats daarvan al het meel 100%, ook het meel in het onderdeel. In 10.000 g Boerenbrooddeeg zit ongeveer 5.076 g meel, dus de pompoen is dan bijna 20%. Hydratatie kijkt altijd door onderdelen heen: water en meel in het deeg tellen mee. ## Uitvouwen Bij het schalen kun je onderdelen laten uitvouwen. Dan zie je per grondstof hoeveel je in totaal nodig hebt, ook wat in het deeg zit. ## Een recept kan zichzelf niet bevatten Als het Boerenbrood het Pompoenbrood als onderdeel zou krijgen, zit het Boerenbrood in zichzelf. Adorea weigert die wijziging en noemt de kring: Boerenbrood, Pompoenbrood, Boerenbrood. ## Waar wordt het gebruikt Bij elk recept staat welke recepten het als onderdeel gebruiken. Een recept dat nog in een actief recept zit, kan niet gearchiveerd worden. --- # Versies > Elke wijziging wordt bewaard, met wie, hoe en waarom. Terugzetten maakt een nieuwe versie. Elke wijziging aan een recept, grondstof, product of locatie maakt een versie. Daarin staat: - hoe het was en hoe het werd; - wie het deed; - via welke weg: de app, Claude of een import; - waarom, als dat is opgegeven. Bij een recept is de versie het hele recept: de gegevens, alle regels en de werkwijze. Bij een receptversie toont Adorea ook het effect: deeggewicht, meel, hydratatie en stuks per deeg, voor en na. ## Terugzetten Je kunt teruggaan naar de stand direct na een wijziging, of een wijziging ongedaan maken (de stand ervoor). Terugzetten overschrijft niets: het maakt een nieuwe versie die verwijst naar de versie waarnaar je teruggaat. De geschiedenis blijft compleet. De naam in de adresbalk (de slug, zoals `boerenbrood`) verandert nooit, ook niet bij een nieuwe naam of bij terugzetten. ## Voorgestelde wijzigingen Sommige wijzigingen raken veel recepten tegelijk, zoals het samenvoegen van twee grondstoffen. Die worden eerst voorgesteld, met een overzicht van wat er verandert. Pas na bevestigen gebeurt het. Een voorstel verloopt na 24 uur. Bij samenvoegen blijft in de recepten de naam staan die de bakkers kennen, en wordt de oude naam een alias van de grondstof die blijft. --- # Claude koppelen > Verbind Claude met je bakkerij. Inloggen met een e-maillink, daarna kies je wat Claude mag en voor welke locatie. Alles wat je in Adorea kunt, kan Claude ook: recepten zoeken, schalen, een hoeveelheid aanpassen of een wijziging terugzetten. Claude werkt met dezelfde regels als jij. Elke wijziging komt in de [versiegeschiedenis](https://docs.adorea.nl/concepten/versies/), met jouw naam erbij en "via Claude". ## Wat je nodig hebt - Een e-mailadres dat als eigenaar bij je bakkerij hoort. - Claude (claude.ai, de Claude-app of Claude Code). - De connector-link: `https://mcp.adorea.nl/mcp` Er is geen wachtwoord en geen sleutel om te kopiëren. Claude vraagt zelf toegang; jij geeft die door in te loggen. ## Koppelen in Claude 1. Open Claude, ga naar **Instellingen**, **Connectors** en kies **Aangepaste connector toevoegen**. 2. Geef hem een naam, bijvoorbeeld "Adorea", en plak de connector-link. 3. Kies **Verbinden**. Er opent een pagina van Adorea. 4. Vul je e-mailadres in en kies **Stuur me een link**. Open de link uit de mail in dezelfde browser. De link werkt 15 minuten en één keer. 5. Kies wat Claude mag (zie hieronder) en, als je meer locaties hebt, de standaardlocatie. Kies **Toegang geven**. Je bent terug in Claude en de tools staan aan. ### Claude Code ```sh claude mcp add --transport http adorea https://mcp.adorea.nl/mcp ``` Start Claude Code, typ `/mcp`, kies `adorea` en **Authenticate**. De browser opent dezelfde inlogpagina. ## Wat Claude mag Bij het koppelen zet je rechten aan of uit. Claude kan alleen de tools gebruiken waar je een recht voor gaf; vraagt hij iets anders, dan krijgt hij `forbidden` en legt hij uit wat er mist. | Recht | Wat Claude daarmee kan | | --- | --- | | Recepten lezen | Recepten, producten, grondstoffen en versies bekijken, recepten schalen. Staat altijd aan. | | Recepten wijzigen | Recepten en producten aanmaken en aanpassen, versies terugzetten. | | Grondstoffen wijzigen | Namen, allergenen en verpakkingen, en grondstoffen samenvoegen. | | Import uitvoeren | Werkboeken klaarzetten, beslissingen nemen, de import goedkeuren. | | Locaties beheren | Locaties aanmaken en wijzigen. Staat standaard uit. | Grote wijzigingen, zoals grondstoffen samenvoegen of een import goedkeuren, worden eerst voorgesteld. Claude laat zien wat er verandert en voert het pas uit als je het bevestigt. Andere rechten nodig? Koppel opnieuw; je kunt dan andere rechten kiezen. ## Standaardlocatie Heeft je bakkerij meer dan één locatie, dan kies je bij het koppelen voor welke locatie Claude standaard werkt. In een gesprek kun je een andere locatie noemen. Met één locatie sla je deze stap over. ## Waarom Bij elke wijziging kan Claude een reden meegeven. Die staat in de versiegeschiedenis als "Waarom". Zeg het er gewoon bij: > Zet het water in het Desembrood op 740 gram, na de proefbak van vanochtend was het deeg te stug. ## Voorbeelden Met Bakkerij Voorbeeld: - "Welke recepten hebben roggedesem?" - "Schaal Boerenbrood naar 60 grote broden." - "Zet het zout in Boerenbrood op 420 gram." - "Laat de geschiedenis van Boerenbrood zien en draai de laatste wijziging terug." Bij schalen verandert er niets aan het recept; Claude rekent alleen. Elke tool staat in de [lijst met MCP-tools](https://docs.adorea.nl/mcp/tools/). ## Claude leest de documentatie Weet Claude niet hoe iets in Adorea werkt, dan zoekt het in deze documentatie met `docs_search` en leest een pagina met `docs_get`. Dat is dezelfde tekst als op deze site. Vraag bijvoorbeeld: "Hoe koppel ik een iPad?" Andere taalmodellen en tools vinden alle pagina's als platte tekst via [llms.txt](https://docs.adorea.nl/llms.txt), of in één bestand via [llms-full.txt](https://docs.adorea.nl/llms-full.txt). Elke pagina heeft ook een tekstversie: zet `.md` achter het adres, zoals [/mcp/koppelen.md](https://docs.adorea.nl/mcp/koppelen.md). ## Ontkoppelen Verwijder de connector in Claude. Een eigenaar die uit de bakkerij wordt gehaald, verliest meteen ook de toegang via Claude. ## Na een update Claude onthoudt de lijst met tools van het moment dat je koppelde. Nieuwe velden in een antwoord zijn geen probleem. Geeft een tool toch een fout na een update van Adorea, verbind dan opnieuw: in Claude Code met `/mcp` en opnieuw verbinden, in de Claude-app door de connector opnieuw te openen. Wijzigingen die een bestaand veld weghalen of hernoemen staan in de changelog. --- # MCP-tools > Alle tools die Claude kan gebruiken, gegenereerd uit de operaties. Elke handeling in de app is ook een tool voor Claude, met dezelfde controles, rechten en versiegeschiedenis. Deze pagina wordt gemaakt uit dezelfde definities als de tools zelf. De beschrijvingen per tool zijn Engels: zo leest Claude ze. Schrijvende tools geven `before`, `after` en `version_id` terug en nemen een optionele `reason` aan, die in de geschiedenis als "Waarom" verschijnt. Fouten hebben een code: `not_found`, `validation`, `cycle`, `forbidden` of `conflict`. Elke tool vraagt een recht (kolom "Recht"); dat geef je bij het [koppelen van Claude](https://docs.adorea.nl/mcp/koppelen/). 43 toolsElke wijziging maakt een versie | Tool | Recht | Wat het doet | | --- | --- | --- | | [`recipe_list`](#recipe_list) | lezen | List and search recipes with dough totals, hydration and composition. | | [`recipe_get`](#recipe_get) | lezen | Get one recipe with lines, baker's percentages, hydration, method, products, allergens and where it is used. | | [`recipe_create`](#recipe_create) | recepten wijzigen | Create a recipe, optionally with its lines and method steps. | | [`recipe_update`](#recipe_update) | recepten wijzigen | Change recipe details: name, category, tags, status, notes, loss. | | [`recipe_set_lines`](#recipe_set_lines) | recepten wijzigen | Replace all lines of a recipe (ingredients or component recipes, in grams). | | [`recipe_set_steps`](#recipe_set_steps) | recepten wijzigen | Replace the method steps of a recipe. | | [`recipe_archive`](#recipe_archive) | recepten wijzigen | Archive a recipe (or bring it back). | | [`recipe_duplicate`](#recipe_duplicate) | recepten wijzigen | Copy a recipe with its lines and method under a new name, as a draft. | | [`recipe_where_used`](#recipe_where_used) | lezen | Recipes that use this recipe as a component: directly, and through other components. | | [`recipe_scale`](#recipe_scale) | lezen | Scale a recipe to a dough weight, flour weight or number of pieces of a product. | | [`recipe_check`](#recipe_check) | lezen | Run the recipe checks: cycles, missing quantities, duplicate lines, salt and yeast ranges, dry seeds, pieces per batch, allergens, label names and recipes that use this one. | | [`recipe_apply_edit`](#recipe_apply_edit) | recepten wijzigen | Change a recipe in one go: lines, method and product sizes, written as one version. | | [`ingredient_list`](#ingredient_list) | lezen | List ingredients with how many recipes use each. | | [`ingredient_get`](#ingredient_get) | lezen | Get one ingredient with the recipes that use it directly. | | [`ingredient_create`](#ingredient_create) | grondstoffen wijzigen | Create an ingredient. | | [`ingredient_update`](#ingredient_update) | grondstoffen wijzigen | Change an ingredient: names, label name, composition, flour flag, allergens, packs, supplier data, "recept ontbreekt". | | [`ingredient_merge`](#ingredient_merge) | grondstoffen wijzigen | Propose merging duplicate ingredients into one. | | [`product_list`](#product_list) | lezen | List products (sellable pieces of a recipe) with pieces per batch. | | [`product_create`](#product_create) | recepten wijzigen | Add a product to a recipe: a sellable piece with its dough weight, e.g. Desembrood 1.250 g and 950 g are two products of one recipe. | | [`product_update`](#product_update) | recepten wijzigen | Change a product: name, piece weight, extras, shop price, traces note. | | [`product_archive`](#product_archive) | recepten wijzigen | Archive a product (or bring it back). | | [`product_set_location`](#product_set_location) | recepten wijzigen | Set whether a product is sold at a location, and its price there. | | [`location_list`](#location_list) | lezen | List the locations (shops, production sites) of the bakery. | | [`location_create`](#location_create) | beheer | Add a location: a shop, a production site or a shop with bakery. | | [`location_update`](#location_update) | beheer | Change a location: name, kind, opening days, day start, primary; or archive it. | | [`import_stage`](#import_stage) | importeren | Stage parsed workbook tabs as one import batch: proposes ingredients, duplicate merges, component links and categories. | | [`import_list`](#import_list) | importeren | List import batches, newest first, with their summary and item counts (open questions per kind). | | [`import_get`](#import_get) | importeren | Get an import batch with its summary and the items to review, optionally filtered by kind or status. | | [`import_resolve`](#import_resolve) | importeren | Decide one item of a staged import. | | [`import_approve`](#import_approve) | importeren | Propose writing a fully decided import batch: ingredients, recipes, lines, method and products. | | [`import_discard`](#import_discard) | importeren | Throw away a staged import. | | [`pending_list`](#pending_list) | lezen | List staged changes waiting for confirmation, such as ingredient merges. | | [`pending_confirm`](#pending_confirm) | lezen | Carry out a staged change. | | [`pending_cancel`](#pending_cancel) | lezen | Cancel a staged change. | | [`version_list`](#version_list) | lezen | List the change history, newest first: who changed what (line by line for recipes), through the app, Claude or an import, and why. | | [`version_get`](#version_get) | lezen | Get one version with the full before and after, and for recipes the effect on dough, hydration and pieces. | | [`version_restore`](#version_restore) | lezen | Put an entity back as it was at a version. | | [`docs_search`](#docs_search) | lezen | Search the documentation for how the app and the tools work. | | [`docs_get`](#docs_get) | lezen | Get one documentation page as Markdown, with the list of all pages. | | [`device_list`](#device_list) | lezen | List the paired devices (bakery iPads), with their location and when they were last used. | | [`device_create_pairing_code`](#device_create_pairing_code) | beheer | Create a one-time code to pair an iPad with a location. | | [`device_revoke`](#device_revoke) | beheer | Unpair a device. | | [`company_settings_update`](#company_settings_update) | beheer | Change company settings, such as whether suggestions of Adorea are on in the recipe editor. | ## Recepten ### `recipe_list` List and search recipes with dough totals, hydration and composition. Filter by text, category, tag, status, ingredient or missing data. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `query` | string | | Matches name, slug and tags | | `category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | | | | `tag` | string | | e.g. "seizoen" | | `status` | `"draft"` \| `"complete"` | | | | `ingredient` | string | | Only recipes containing this ingredient, also through components | | `missing` | `"quantity"` \| `"piece_weight"` | | Only recipes with lines without grams, or without a product piece weight | | `include_archived` | boolean | | Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].slug` | string | ja | | | `items[].name` | string | ja | | | `items[].category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `items[].tags` | string[] | ja | | | `items[].reference_note` | string \| null | ja | | | `items[].status` | `"draft"` \| `"complete"` | ja | | | `items[].can_be_component` | boolean | ja | | | `items[].loss_pct` | number | ja | | | `items[].bake_profile` | record \| null | ja | | | `items[].source_note` | string \| null | ja | | | `items[].archived_at` | string \| null | ja | | | `items[].dough_total_g` | number | ja | | | `items[].flour_total_g` | number | ja | | | `items[].hydration_pct` | number \| null | ja | | | `items[].line_count` | integer | ja | | | `items[].missing_quantity_count` | integer | ja | | | `items[].composition` | record | ja | Grams per composition group, for the dough bar | | `items[].product_count` | integer | ja | | | `items[].has_piece_weight` | boolean | ja | | | `items[].piece_weights_g` | number[] | ja | Piece weights of its active products, largest first | | `items[].components` | object[] | ja | Recipes it uses as a component, in line order | | `items[].components[].id` | string | ja | | | `items[].components[].slug` | string | ja | | | `items[].components[].name` | string | ja | | #### Voorbeeld Every recipe with hazelnuts, also through a filling or dough it uses. ```json { "ingredient": "hazelnoot" } ``` ### `recipe_get` Get one recipe with lines, baker's percentages, hydration, method, products, allergens and where it is used. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `bakers_percentage_base` | `"component"` \| `"flour"` | | What counts as 100% for baker's percentages. "component": the recipe's flour, or its component lines when it has no flour. "flour": all flour, including flour inside components (percentages tegen meel) Standaard `"component"`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | object | ja | | | `recipe.id` | string | ja | | | `recipe.slug` | string | ja | | | `recipe.name` | string | ja | | | `recipe.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `recipe.tags` | string[] | ja | | | `recipe.reference_note` | string \| null | ja | | | `recipe.status` | `"draft"` \| `"complete"` | ja | | | `recipe.can_be_component` | boolean | ja | | | `recipe.loss_pct` | number | ja | | | `recipe.bake_profile` | record \| null | ja | | | `recipe.source_note` | string \| null | ja | | | `recipe.archived_at` | string \| null | ja | | | `lines` | object[] | ja | | | `lines[].id` | string | ja | | | `lines[].position` | integer | ja | | | `lines[].ingredient_id` | string \| null | ja | | | `lines[].component_recipe_id` | string \| null | ja | | | `lines[].grams` | number \| null | ja | | | `lines[].counts_as_flour` | boolean | ja | | | `lines[].group_label` | string \| null | ja | | | `lines[].note` | string \| null | ja | | | `lines[].optional` | boolean | ja | | | `lines[].display_name` | string \| null | ja | | | `lines[].name` | string | ja | Display name: the line display name, else the ingredient or component name | | `lines[].composition` | string \| null | ja | | | `lines[].bakers_pct` | number \| null | ja | Baker's percentage; null without grams or when nothing counts as 100% | | `lines[].component_slug` | string \| null | ja | | | `steps` | object[] | ja | | | `steps[].id` | string | ja | | | `steps[].position` | integer | ja | | | `steps[].text` | string | ja | | | `steps[].duration_min` | number \| null | ja | | | `steps[].temperature_c` | number \| null | ja | | | `products` | object[] | ja | | | `products[].id` | string | ja | | | `products[].name` | string | ja | | | `products[].piece_weight_g` | number \| null | ja | | | `products[].pieces_per_batch` | integer \| null | ja | | | `products[].shop_price_cents` | integer \| null | ja | | | `analysis` | object | ja | | | `analysis.flour_total_g` | number | ja | | | `analysis.dough_total_g` | number | ja | | | `analysis.bakers_percentage_base_g` | number | ja | Grams that count as 100% for the baker's percentages | | `analysis.hydration_pct` | number \| null | ja | | | `analysis.missing_quantity_count` | integer | ja | | | `composition` | record | ja | | | `allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `used_in` | object[] | ja | Recipes that use this one as a component, directly | | `used_in[].id` | string | ja | | | `used_in[].slug` | string | ja | | | `used_in[].name` | string | ja | | | `version_id` | string \| null | ja | Newest version of this recipe or its products; pass it as base_version_id to recipe_apply_edit | #### Voorbeeld ```json { "recipe": "desembrood" } ``` ### `recipe_create` Create a recipe, optionally with its lines and method steps. The slug is made from the name and never changes. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | ja | | | `category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `tags` | string[] | | | | `reference_note` | string \| null | | | | `status` | `"draft"` \| `"complete"` | | | | `can_be_component` | boolean | | Can be used as a component in other recipes | | `loss_pct` | number | | Dough and bake loss in percent, applied when scaling | | `bake_profile` | record \| null | | | | `source_note` | string \| null | | | | `lines` | object[] | | Standaard `[]`. | | `lines[].ingredient` | string | | Ingredient id, name or alias (case-insensitive), e.g. "T65" | | `lines[].recipe` | string | | Component recipe (a sub-recipe such as a dough or cream) | | `lines[].grams` | number \| null | | Null when the quantity is unknown Standaard `null`. | | `lines[].counts_as_flour` | boolean | | Defaults to the ingredient's flour flag; false for components | | `lines[].group_label` | string \| null | | Dough structure, e.g. "biga", "deel 1" | | `lines[].note` | string \| null | | Process detail, e.g. "18 °C" | | `lines[].optional` | boolean | | Standaard `false`. | | `lines[].display_name` | string \| null | | Name shown to bakers when it differs from the ingredient | | `steps` | object[] | | Standaard `[]`. | | `steps[].text` | string | ja | | | `steps[].duration_min` | number \| null | | | | `steps[].temperature_c` | number \| null | | | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `checks` | object[] | ja | Checks on the recipe as written: warnings and notes, see recipe_check | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | ### `recipe_update` Change recipe details: name, category, tags, status, notes, loss. Lines and steps have their own ops. The slug stays. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | | | | `category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | | | | `tags` | string[] | | | | `reference_note` | string \| null | | | | `status` | `"draft"` \| `"complete"` | | | | `can_be_component` | boolean | | Can be used as a component in other recipes | | `loss_pct` | number | | Dough and bake loss in percent, applied when scaling | | `bake_profile` | record \| null | | | | `source_note` | string \| null | | | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `checks` | object[] | ja | Checks on the recipe as written: warnings and notes, see recipe_check | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | ### `recipe_set_lines` Replace all lines of a recipe (ingredients or component recipes, in grams). Send the full list. A recipe cannot contain itself through components. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `lines` | object[] | ja | The complete new list of lines, in order | | `lines[].ingredient` | string | | Ingredient id, name or alias (case-insensitive), e.g. "T65" | | `lines[].recipe` | string | | Component recipe (a sub-recipe such as a dough or cream) | | `lines[].grams` | number \| null | | Null when the quantity is unknown Standaard `null`. | | `lines[].counts_as_flour` | boolean | | Defaults to the ingredient's flour flag; false for components | | `lines[].group_label` | string \| null | | Dough structure, e.g. "biga", "deel 1" | | `lines[].note` | string \| null | | Process detail, e.g. "18 °C" | | `lines[].optional` | boolean | | Standaard `false`. | | `lines[].display_name` | string \| null | | Name shown to bakers when it differs from the ingredient | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `checks` | object[] | ja | Checks on the recipe as written: warnings and notes, see recipe_check | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | #### Voorbeeld ```json { "recipe": "desembrood", "lines": [ { "ingredient": "Tarwebloem T65", "grams": 900 }, { "ingredient": "Volkorenmeel", "grams": 100 }, { "ingredient": "Water", "grams": 720 }, { "recipe": "desem", "grams": 200 }, { "ingredient": "Zout", "grams": 20 } ], "reason": "Iets meer water na proefbak" } ``` ### `recipe_set_steps` Replace the method steps of a recipe. Send the full list. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `steps` | object[] | ja | The complete new method, in order | | `steps[].text` | string | ja | | | `steps[].duration_min` | number \| null | | | | `steps[].temperature_c` | number \| null | | | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `checks` | object[] | ja | Checks on the recipe as written: warnings and notes, see recipe_check | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | ### `recipe_archive` Archive a recipe (or bring it back). A recipe still used as a component by an active recipe cannot be archived. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `archived` | boolean | | false brings it back Standaard `true`. | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `checks` | object[] | ja | Checks on the recipe as written: warnings and notes, see recipe_check | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | ### `recipe_duplicate` Copy a recipe with its lines and method under a new name, as a draft. Products are not copied. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `name` | string | ja | Name of the copy | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `checks` | object[] | ja | Checks on the recipe as written: warnings and notes, see recipe_check | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | ### `recipe_where_used` Recipes that use this recipe as a component: directly, and through other components. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `direct` | object[] | ja | | | `direct[].id` | string | ja | | | `direct[].slug` | string | ja | | | `direct[].name` | string | ja | | | `indirect` | object[] | ja | | | `indirect[].id` | string | ja | | | `indirect[].slug` | string | ja | | | `indirect[].name` | string | ja | | ### `recipe_scale` Scale a recipe to a dough weight, flour weight or number of pieces of a product. Changes nothing. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `target` | object | ja | | | `target` | object, `kind` = `"dough"` | | Variant | | `target.kind` | `"dough"` | ja | | | `target.grams` | number | ja | Total dough to make, in grams | | `target` | object, `kind` = `"flour"` | | Variant | | `target.kind` | `"flour"` | ja | | | `target.grams` | number | ja | Total flour, in grams | | `target` | object, `kind` = `"pieces"` | | Variant | | `target.kind` | `"pieces"` | ja | | | `target.pieces` | integer | ja | | | `target.product` | string | | Product of this recipe whose piece weight to use; defaults to the only one | | `target.piece_weight_g` | number | | Piece weight when there is no product | | `expand` | boolean | | Also list component recipes expanded into their own ingredients Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | object | ja | | | `recipe.id` | string | ja | | | `recipe.slug` | string | ja | | | `recipe.name` | string | ja | | | `factor` | number | ja | | | `loss_pct` | number | ja | | | `dough_total_g` | number | ja | | | `flour_total_g` | number | ja | | | `pieces` | integer \| null | ja | Whole pieces the scaled batch yields, when a piece weight is known | | `piece_weight_g` | number \| null | ja | | | `lines` | object[] | ja | | | `lines[].name` | string | ja | | | `lines[].group_label` | string \| null | ja | | | `lines[].note` | string \| null | ja | | | `lines[].component_recipe_id` | string \| null | ja | | | `lines[].reference_grams` | number \| null | ja | | | `lines[].grams` | number \| null | ja | Unrounded; round for display only | | `expanded_lines` | object[] \| null | ja | | | `extras` | object[] | ja | Per-piece extras (toppings) for the whole batch | | `extras[].name` | string | ja | | | `extras[].grams` | number | ja | | #### Voorbeeld ```json { "recipe": "desembrood", "target": { "kind": "pieces", "pieces": 60, "product": "Desembrood groot" } } ``` ### `recipe_check` Run the recipe checks: cycles, missing quantities, duplicate lines, salt and yeast ranges, dry seeds, pieces per batch, allergens, label names and recipes that use this one. On the saved recipe, or on a changed draft compared with it. Changes nothing. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `draft` | object | | A changed version to check against the saved recipe, as the editor keeps it. Leave out to check the saved recipe as it is | | `draft.lines` | object[] | ja | | | `draft.lines[].key` | string | ja | | | `draft.lines[].ingredient_id` | string \| null | ja | | | `draft.lines[].component_recipe_id` | string \| null | ja | | | `draft.lines[].name` | string | ja | | | `draft.lines[].grams` | number \| null | ja | | | `draft.lines[].counts_as_flour` | boolean | ja | | | `draft.lines[].group_label` | string \| null | ja | | | `draft.lines[].note` | string \| null | ja | | | `draft.lines[].optional` | boolean | ja | | | `draft.lines[].display_name` | string \| null | ja | | | `draft.steps` | object[] | ja | | | `draft.steps[].key` | string | ja | | | `draft.steps[].text` | string | ja | | | `draft.steps[].duration_min` | number \| null | ja | | | `draft.steps[].temperature_c` | number \| null | ja | | | `draft.products` | object[] | ja | | | `draft.products[].key` | string | ja | | | `draft.products[].id` | string \| null | ja | | | `draft.products[].name` | string | ja | | | `draft.products[].piece_weight_g` | number \| null | ja | | | `draft.products[].archived` | boolean | ja | | | `include_context` | boolean | | Also return the data the checks ran on, for an editor that re-runs them itself Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `checks` | object[] | ja | | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | | `context` | any | | With include_context: ingredients, recipes and thresholds the checks used | | `draft` | object | ja | The saved recipe as a draft (lines keyed by line id), the base of an edit | | `draft.lines` | object[] | ja | | | `draft.lines[].key` | string | ja | | | `draft.lines[].ingredient_id` | string \| null | ja | | | `draft.lines[].component_recipe_id` | string \| null | ja | | | `draft.lines[].name` | string | ja | | | `draft.lines[].grams` | number \| null | ja | | | `draft.lines[].counts_as_flour` | boolean | ja | | | `draft.lines[].group_label` | string \| null | ja | | | `draft.lines[].note` | string \| null | ja | | | `draft.lines[].optional` | boolean | ja | | | `draft.lines[].display_name` | string \| null | ja | | | `draft.steps` | object[] | ja | | | `draft.steps[].key` | string | ja | | | `draft.steps[].text` | string | ja | | | `draft.steps[].duration_min` | number \| null | ja | | | `draft.steps[].temperature_c` | number \| null | ja | | | `draft.products` | object[] | ja | | | `draft.products[].key` | string | ja | | | `draft.products[].id` | string \| null | ja | | | `draft.products[].name` | string | ja | | | `draft.products[].piece_weight_g` | number \| null | ja | | | `draft.products[].archived` | boolean | ja | | #### Voorbeeld Warnings and notes on the saved recipe: missing quantities, salt range, label names. ```json { "recipe": "desembrood" } ``` ### `recipe_apply_edit` Change a recipe in one go: lines, method and product sizes, written as one version. Refused with conflict when the recipe changed since base_version_id; read it again and redo the edit. Returns the checks on the result. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `base_version_id` | string \| null | ja | version_id from recipe_get when the edit started. If the recipe or its products changed since, the edit is refused with conflict | | `edit` | object | ja | | | `edit.lines` | object[] | | The complete new list of lines, in order; leave out to keep the lines | | `edit.lines[].ingredient` | string | | Ingredient id, name or alias (case-insensitive), e.g. "T65" | | `edit.lines[].recipe` | string | | Component recipe (a sub-recipe such as a dough or cream) | | `edit.lines[].grams` | number \| null | | Null when the quantity is unknown Standaard `null`. | | `edit.lines[].counts_as_flour` | boolean | | Defaults to the ingredient's flour flag; false for components | | `edit.lines[].group_label` | string \| null | | Dough structure, e.g. "biga", "deel 1" | | `edit.lines[].note` | string \| null | | Process detail, e.g. "18 °C" | | `edit.lines[].optional` | boolean | | Standaard `false`. | | `edit.lines[].display_name` | string \| null | | Name shown to bakers when it differs from the ingredient | | `edit.lines[].id` | string | | Id of an existing line of this recipe, to keep it as the same line (the history pairs it up) | | `edit.steps` | object[] | | The complete new method; leave out to keep it | | `edit.steps[].text` | string | ja | | | `edit.steps[].duration_min` | number \| null | | | | `edit.steps[].temperature_c` | number \| null | | | | `edit.products` | object[] | | Products to add, change or archive (name, piece weight). Products not listed stay as they are | | `edit.products[].id` | string | | Existing product of this recipe; leave out to add a product | | `edit.products[].name` | string | ja | | | `edit.products[].piece_weight_g` | number \| null | ja | | | `edit.products[].archived` | boolean | | true archives the product Standaard `false`. | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | | `suggestions_accepted` | object[] | | Suggestions of Adorea that are part of this edit (app only) Standaard `[]`. | | `suggestions_accepted[].title` | string | ja | | | `suggestions_accepted[].call_id` | string | | The suggestion call it came from | | `suggestions_accepted[].from_command` | boolean | | Carried out from a typed instruction, not taken over from a proposal Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before.id` | string | ja | | | `before.slug` | string | ja | | | `before.name` | string | ja | | | `before.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `before.tags` | string[] | ja | | | `before.reference_note` | string \| null | ja | | | `before.status` | `"draft"` \| `"complete"` | ja | | | `before.can_be_component` | boolean | ja | | | `before.loss_pct` | number | ja | | | `before.bake_profile` | record \| null | ja | | | `before.source_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.lines` | object[] | ja | | | `before.lines[].id` | string | ja | | | `before.lines[].position` | integer | ja | | | `before.lines[].ingredient_id` | string \| null | ja | | | `before.lines[].component_recipe_id` | string \| null | ja | | | `before.lines[].grams` | number \| null | ja | | | `before.lines[].counts_as_flour` | boolean | ja | | | `before.lines[].group_label` | string \| null | ja | | | `before.lines[].note` | string \| null | ja | | | `before.lines[].optional` | boolean | ja | | | `before.lines[].display_name` | string \| null | ja | | | `before.steps` | object[] | ja | | | `before.steps[].id` | string | ja | | | `before.steps[].position` | integer | ja | | | `before.steps[].text` | string | ja | | | `before.steps[].duration_min` | number \| null | ja | | | `before.steps[].temperature_c` | number \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.slug` | string | ja | | | `after.name` | string | ja | | | `after.category` | `"brood"` \| `"viennoiserie"` \| `"cake_taart"` \| `"koek"` \| `"halffabricaat"` | ja | | | `after.tags` | string[] | ja | | | `after.reference_note` | string \| null | ja | | | `after.status` | `"draft"` \| `"complete"` | ja | | | `after.can_be_component` | boolean | ja | | | `after.loss_pct` | number | ja | | | `after.bake_profile` | record \| null | ja | | | `after.source_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.lines` | object[] | ja | | | `after.lines[].id` | string | ja | | | `after.lines[].position` | integer | ja | | | `after.lines[].ingredient_id` | string \| null | ja | | | `after.lines[].component_recipe_id` | string \| null | ja | | | `after.lines[].grams` | number \| null | ja | | | `after.lines[].counts_as_flour` | boolean | ja | | | `after.lines[].group_label` | string \| null | ja | | | `after.lines[].note` | string \| null | ja | | | `after.lines[].optional` | boolean | ja | | | `after.lines[].display_name` | string \| null | ja | | | `after.steps` | object[] | ja | | | `after.steps[].id` | string | ja | | | `after.steps[].position` | integer | ja | | | `after.steps[].text` | string | ja | | | `after.steps[].duration_min` | number \| null | ja | | | `after.steps[].temperature_c` | number \| null | ja | | | `version_id` | string | ja | | | `products` | object[] | ja | Versions written for products changed in the same edit | | `products[].product_id` | string | ja | | | `products[].version_id` | string | ja | | | `checks` | object[] | ja | | | `checks[].id` | `"cycle"` \| `"unmatched_ingredient"` \| `"missing_quantity"` \| `"duplicate_line"` \| `"magnitude_jump"` \| `"salt_range"` \| `"yeast_range"` \| `"no_flour"` \| `"dry_addition"` \| `"hydration_shift"` \| `"piece_remainder"` \| `"pieces_change"` \| `"where_used"` \| `"allergen_change"` \| `"label_name_missing"` \| `"step_mentions_missing"` \| `"source_conflict"` | ja | | | `checks[].severity` | `"error"` \| `"warn"` \| `"info"` \| `"ok"` | ja | | | `checks[].message` | object | ja | | | `checks[].message.nl` | string | ja | | | `checks[].message.en` | string | ja | | | `checks[].line` | string \| null | ja | | | `checks[].step` | integer \| null | ja | | | `checks[].suggestable` | boolean | ja | Adorea may propose a fix | | `checks[].action` | object \| null | ja | | #### Voorbeeld Take base_version_id from recipe_get. One edit is one version. ```json { "recipe": "desembrood", "base_version_id": "01JD3Y8Q2W5V7K9M1N3P5R7T9V", "edit": { "lines": [ { "ingredient": "Tarwebloem T65", "grams": 900 }, { "ingredient": "Volkorenmeel", "grams": 100 }, { "ingredient": "Water", "grams": 720 }, { "recipe": "desem", "grams": 200 }, { "ingredient": "Zout", "grams": 22 } ] }, "reason": "Zout naar 2,2%" } ``` ## Grondstoffen ### `ingredient_list` List ingredients with how many recipes use each. Filter by text, composition, allergen, unconfirmed import assumptions, or "recept ontbreekt". Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `query` | string | | Matches name, label name and aliases | | `composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | | | | `allergen` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"` | | | | `unconfirmed` | boolean | | Only ingredients with conversion assumptions that are not confirmed yet | | `recipe_missing` | boolean | | Only preferments marked "recept ontbreekt" | | `include_archived` | boolean | | Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].name` | string | ja | | | `items[].label_name` | string \| null | ja | | | `items[].aliases` | string[] | ja | | | `items[].composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | ja | | | `items[].is_flour_default` | boolean | ja | | | `items[].g_per_piece` | number \| null | ja | | | `items[].g_per_ml` | number \| null | ja | | | `items[].allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `items[].packs` | object[] | ja | | | `items[].packs[].name` | string | ja | | | `items[].packs[].grams` | number | ja | | | `items[].article_number` | string \| null | ja | | | `items[].supplier` | string \| null | ja | | | `items[].origin` | string \| null | ja | | | `items[].recipe_missing` | boolean | | A preferment such as desem without a recipe of its own ("recept ontbreekt") Standaard `false`. | | `items[].assumptions` | object[] | | Conversions from the import that still need a one-time confirmation Standaard `[]`. | | `items[].assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `items[].assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `items[].assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `items[].absorbs_water` | boolean | | Seeds, grains and flakes: take up water and want soaking water Standaard `false`. | | `items[].merged_into_id` | string \| null | ja | | | `items[].archived_at` | string \| null | ja | | | `items[].recipe_count` | integer | ja | | ### `ingredient_get` Get one ingredient with the recipes that use it directly. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `ingredient` | string | ja | Ingredient id, name or alias (case-insensitive), e.g. "T65" | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `ingredient` | object | ja | | | `ingredient.id` | string | ja | | | `ingredient.name` | string | ja | | | `ingredient.label_name` | string \| null | ja | | | `ingredient.aliases` | string[] | ja | | | `ingredient.composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | ja | | | `ingredient.is_flour_default` | boolean | ja | | | `ingredient.g_per_piece` | number \| null | ja | | | `ingredient.g_per_ml` | number \| null | ja | | | `ingredient.allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `ingredient.packs` | object[] | ja | | | `ingredient.packs[].name` | string | ja | | | `ingredient.packs[].grams` | number | ja | | | `ingredient.article_number` | string \| null | ja | | | `ingredient.supplier` | string \| null | ja | | | `ingredient.origin` | string \| null | ja | | | `ingredient.recipe_missing` | boolean | | A preferment such as desem without a recipe of its own ("recept ontbreekt") Standaard `false`. | | `ingredient.assumptions` | object[] | | Conversions from the import that still need a one-time confirmation Standaard `[]`. | | `ingredient.assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `ingredient.assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `ingredient.assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `ingredient.absorbs_water` | boolean | | Seeds, grains and flakes: take up water and want soaking water Standaard `false`. | | `ingredient.merged_into_id` | string \| null | ja | | | `ingredient.archived_at` | string \| null | ja | | | `used_in` | object[] | ja | | | `used_in[].id` | string | ja | | | `used_in[].slug` | string | ja | | | `used_in[].name` | string | ja | | | `used_in[].grams` | number \| null | ja | | ### `ingredient_create` Create an ingredient. Composition and the flour flag are guessed from the name when left out. Toegang: grondstoffen wijzigen `write:ingredients` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | ja | | | `label_name` | string \| null | | Name on product labels | | `aliases` | string[] | | | | `composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | | Group in the dough bar; vocht counts for hydration | | `is_flour_default` | boolean | | New recipe lines with this ingredient count as flour | | `g_per_piece` | number \| null | | Grams per piece, e.g. one egg | | `g_per_ml` | number \| null | | | | `allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | | | | `packs` | object[] | | | | `packs[].name` | string | ja | | | `packs[].grams` | number | ja | | | `article_number` | string \| null | | | | `supplier` | string \| null | | | | `origin` | string \| null | | | | `recipe_missing` | boolean | | Mark a preferment such as desem as "recept ontbreekt" | | `absorbs_water` | boolean | | Seeds, grains and flakes that take up water; guessed from the name when left out | | `assumptions` | object[] | | Replaces the list of conversion assumptions | | `assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.name` | string | ja | | | `before.label_name` | string \| null | ja | | | `before.aliases` | string[] | ja | | | `before.composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | ja | | | `before.is_flour_default` | boolean | ja | | | `before.g_per_piece` | number \| null | ja | | | `before.g_per_ml` | number \| null | ja | | | `before.allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `before.packs` | object[] | ja | | | `before.packs[].name` | string | ja | | | `before.packs[].grams` | number | ja | | | `before.article_number` | string \| null | ja | | | `before.supplier` | string \| null | ja | | | `before.origin` | string \| null | ja | | | `before.recipe_missing` | boolean | | A preferment such as desem without a recipe of its own ("recept ontbreekt") Standaard `false`. | | `before.assumptions` | object[] | | Conversions from the import that still need a one-time confirmation Standaard `[]`. | | `before.assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `before.assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `before.assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `before.absorbs_water` | boolean | | Seeds, grains and flakes: take up water and want soaking water Standaard `false`. | | `before.merged_into_id` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.name` | string | ja | | | `after.label_name` | string \| null | ja | | | `after.aliases` | string[] | ja | | | `after.composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | ja | | | `after.is_flour_default` | boolean | ja | | | `after.g_per_piece` | number \| null | ja | | | `after.g_per_ml` | number \| null | ja | | | `after.allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `after.packs` | object[] | ja | | | `after.packs[].name` | string | ja | | | `after.packs[].grams` | number | ja | | | `after.article_number` | string \| null | ja | | | `after.supplier` | string \| null | ja | | | `after.origin` | string \| null | ja | | | `after.recipe_missing` | boolean | | A preferment such as desem without a recipe of its own ("recept ontbreekt") Standaard `false`. | | `after.assumptions` | object[] | | Conversions from the import that still need a one-time confirmation Standaard `[]`. | | `after.assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `after.assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `after.assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `after.absorbs_water` | boolean | | Seeds, grains and flakes: take up water and want soaking water Standaard `false`. | | `after.merged_into_id` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `version_id` | string | ja | | ### `ingredient_update` Change an ingredient: names, label name, composition, flour flag, allergens, packs, supplier data, "recept ontbreekt". confirm_assumptions confirms the conversions from the import. Toegang: grondstoffen wijzigen `write:ingredients` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | | | | `label_name` | string \| null | | Name on product labels | | `aliases` | string[] | | | | `composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | | Group in the dough bar; vocht counts for hydration | | `is_flour_default` | boolean | | New recipe lines with this ingredient count as flour | | `g_per_piece` | number \| null | | Grams per piece, e.g. one egg | | `g_per_ml` | number \| null | | | | `allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | | | | `packs` | object[] | | | | `packs[].name` | string | ja | | | `packs[].grams` | number | ja | | | `article_number` | string \| null | | | | `supplier` | string \| null | | | | `origin` | string \| null | | | | `recipe_missing` | boolean | | Mark a preferment such as desem as "recept ontbreekt" | | `absorbs_water` | boolean | | Seeds, grains and flakes that take up water; guessed from the name when left out | | `assumptions` | object[] | | Replaces the list of conversion assumptions | | `assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `ingredient` | string | ja | Ingredient id, name or alias (case-insensitive), e.g. "T65" | | `archived` | boolean | | Archive (true) or bring back (false) | | `confirm_assumptions` | boolean | | Mark every open conversion assumption as confirmed now | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.name` | string | ja | | | `before.label_name` | string \| null | ja | | | `before.aliases` | string[] | ja | | | `before.composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | ja | | | `before.is_flour_default` | boolean | ja | | | `before.g_per_piece` | number \| null | ja | | | `before.g_per_ml` | number \| null | ja | | | `before.allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `before.packs` | object[] | ja | | | `before.packs[].name` | string | ja | | | `before.packs[].grams` | number | ja | | | `before.article_number` | string \| null | ja | | | `before.supplier` | string \| null | ja | | | `before.origin` | string \| null | ja | | | `before.recipe_missing` | boolean | | A preferment such as desem without a recipe of its own ("recept ontbreekt") Standaard `false`. | | `before.assumptions` | object[] | | Conversions from the import that still need a one-time confirmation Standaard `[]`. | | `before.assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `before.assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `before.assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `before.absorbs_water` | boolean | | Seeds, grains and flakes: take up water and want soaking water Standaard `false`. | | `before.merged_into_id` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.name` | string | ja | | | `after.label_name` | string \| null | ja | | | `after.aliases` | string[] | ja | | | `after.composition` | `"meel"` \| `"vocht"` \| `"rijs"` \| `"vet"` \| `"suiker"` \| `"toevoeging"` \| `"overig"` | ja | | | `after.is_flour_default` | boolean | ja | | | `after.g_per_piece` | number \| null | ja | | | `after.g_per_ml` | number \| null | ja | | | `after.allergens` | `"gluten"` \| `"crustaceans"` \| `"eggs"` \| `"fish"` \| `"peanuts"` \| `"soy"` \| `"milk"` \| `"nuts"` \| `"celery"` \| `"mustard"` \| `"sesame"` \| `"sulphites"` \| `"lupin"` \| `"molluscs"`[] | ja | | | `after.packs` | object[] | ja | | | `after.packs[].name` | string | ja | | | `after.packs[].grams` | number | ja | | | `after.article_number` | string \| null | ja | | | `after.supplier` | string \| null | ja | | | `after.origin` | string \| null | ja | | | `after.recipe_missing` | boolean | | A preferment such as desem without a recipe of its own ("recept ontbreekt") Standaard `false`. | | `after.assumptions` | object[] | | Conversions from the import that still need a one-time confirmation Standaard `[]`. | | `after.assumptions[].text` | string | ja | e.g. "1 ei = 50 g", as the workbook states it | | `after.assumptions[].recipes` | string[] | ja | Recipes whose grams rest on it | | `after.assumptions[].confirmed_at` | string \| null | ja | When the owner confirmed it; null while unconfirmed | | `after.absorbs_water` | boolean | | Seeds, grains and flakes: take up water and want soaking water Standaard `false`. | | `after.merged_into_id` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `version_id` | string | ja | | ### `ingredient_merge` Propose merging duplicate ingredients into one. Staged: nothing changes until pending_confirm. Recipes keep showing the name bakers know. Toegang: grondstoffen wijzigen `write:ingredients` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `from` | string[] | ja | Ingredients to merge away | | `into` | string | ja | The ingredient that stays | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `pending` | object | ja | | | `pending.id` | string | ja | | | `pending.op_name` | string | ja | | | `pending.input` | any | ja | | | `pending.preview` | any | ja | | | `pending.created_by` | string | ja | | | `pending.status` | `"pending"` \| `"confirmed"` \| `"cancelled"` \| `"expired"` | ja | | | `pending.expires_at` | string | ja | | | `pending.created_at` | string | ja | | | `preview` | object | ja | | | `preview.into` | object | ja | | | `preview.into.id` | string | ja | | | `preview.into.name` | string | ja | | | `preview.from` | object[] | ja | | | `preview.from[].id` | string | ja | | | `preview.from[].name` | string | ja | | | `preview.aliases_added` | string[] | ja | | | `preview.recipes` | object[] | ja | | | `preview.recipes[].id` | string | ja | | | `preview.recipes[].name` | string | ja | | | `preview.recipes[].lines` | integer | ja | | | `preview.text` | string | ja | | #### Voorbeeld ```json { "from": [ "bloem T65", "Tarwebloem t65" ], "into": "Tarwebloem T65", "reason": "Dubbele namen uit de import" } ``` ## Producten ### `product_list` List products (sellable pieces of a recipe) with pieces per batch. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `recipe` | string | | Recipe id or slug, e.g. "desembrood" | | `query` | string | | | | `include_archived` | boolean | | Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].recipe_id` | string | ja | | | `items[].name` | string | ja | | | `items[].piece_weight_g` | number \| null | ja | | | `items[].extra_per_piece` | object[] | ja | | | `items[].extra_per_piece[].ingredient_id` | string \| null | | | | `items[].extra_per_piece[].recipe_id` | string \| null | | | | `items[].extra_per_piece[].grams` | number | ja | | | `items[].shop_price_cents` | integer \| null | ja | | | `items[].traces_note` | string \| null | ja | | | `items[].archived_at` | string \| null | ja | | | `items[].locations` | object[] | ja | | | `items[].locations[].location_id` | string | ja | | | `items[].locations[].sold_here` | boolean | ja | | | `items[].locations[].shop_price_cents` | integer \| null | ja | | | `items[].recipe_slug` | string | ja | | | `items[].recipe_name` | string | ja | | | `items[].pieces_per_batch` | integer \| null | ja | Whole pieces one batch of the recipe yields | ### `product_create` Add a product to a recipe: a sellable piece with its dough weight, e.g. Desembrood 1.250 g and 950 g are two products of one recipe. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | ja | e.g. "Desembrood groot" | | `piece_weight_g` | number \| null | | Dough weight per piece in grams | | `extra_per_piece` | object[] | | Added per piece after dividing, e.g. seeds on top | | `extra_per_piece[].ingredient` | string | | Ingredient id, name or alias (case-insensitive), e.g. "T65" | | `extra_per_piece[].recipe` | string | | Recipe id or slug, e.g. "desembrood" | | `extra_per_piece[].grams` | number | ja | | | `shop_price_cents` | integer \| null | | | | `traces_note` | string \| null | | | | `recipe` | string | ja | Recipe id or slug, e.g. "desembrood" | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.recipe_id` | string | ja | | | `before.name` | string | ja | | | `before.piece_weight_g` | number \| null | ja | | | `before.extra_per_piece` | object[] | ja | | | `before.extra_per_piece[].ingredient_id` | string \| null | | | | `before.extra_per_piece[].recipe_id` | string \| null | | | | `before.extra_per_piece[].grams` | number | ja | | | `before.shop_price_cents` | integer \| null | ja | | | `before.traces_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.locations` | object[] | ja | | | `before.locations[].location_id` | string | ja | | | `before.locations[].sold_here` | boolean | ja | | | `before.locations[].shop_price_cents` | integer \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.recipe_id` | string | ja | | | `after.name` | string | ja | | | `after.piece_weight_g` | number \| null | ja | | | `after.extra_per_piece` | object[] | ja | | | `after.extra_per_piece[].ingredient_id` | string \| null | | | | `after.extra_per_piece[].recipe_id` | string \| null | | | | `after.extra_per_piece[].grams` | number | ja | | | `after.shop_price_cents` | integer \| null | ja | | | `after.traces_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.locations` | object[] | ja | | | `after.locations[].location_id` | string | ja | | | `after.locations[].sold_here` | boolean | ja | | | `after.locations[].shop_price_cents` | integer \| null | ja | | | `version_id` | string | ja | | ### `product_update` Change a product: name, piece weight, extras, shop price, traces note. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | | e.g. "Desembrood groot" | | `piece_weight_g` | number \| null | | Dough weight per piece in grams | | `extra_per_piece` | object[] | | Added per piece after dividing, e.g. seeds on top | | `extra_per_piece[].ingredient` | string | | Ingredient id, name or alias (case-insensitive), e.g. "T65" | | `extra_per_piece[].recipe` | string | | Recipe id or slug, e.g. "desembrood" | | `extra_per_piece[].grams` | number | ja | | | `shop_price_cents` | integer \| null | | | | `traces_note` | string \| null | | | | `product` | string | ja | Product id, or product name within the recipe | | `recipe` | string | | Move to another recipe | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.recipe_id` | string | ja | | | `before.name` | string | ja | | | `before.piece_weight_g` | number \| null | ja | | | `before.extra_per_piece` | object[] | ja | | | `before.extra_per_piece[].ingredient_id` | string \| null | | | | `before.extra_per_piece[].recipe_id` | string \| null | | | | `before.extra_per_piece[].grams` | number | ja | | | `before.shop_price_cents` | integer \| null | ja | | | `before.traces_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.locations` | object[] | ja | | | `before.locations[].location_id` | string | ja | | | `before.locations[].sold_here` | boolean | ja | | | `before.locations[].shop_price_cents` | integer \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.recipe_id` | string | ja | | | `after.name` | string | ja | | | `after.piece_weight_g` | number \| null | ja | | | `after.extra_per_piece` | object[] | ja | | | `after.extra_per_piece[].ingredient_id` | string \| null | | | | `after.extra_per_piece[].recipe_id` | string \| null | | | | `after.extra_per_piece[].grams` | number | ja | | | `after.shop_price_cents` | integer \| null | ja | | | `after.traces_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.locations` | object[] | ja | | | `after.locations[].location_id` | string | ja | | | `after.locations[].sold_here` | boolean | ja | | | `after.locations[].shop_price_cents` | integer \| null | ja | | | `version_id` | string | ja | | ### `product_archive` Archive a product (or bring it back). Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `product` | string | ja | Product id, or product name within the recipe | | `archived` | boolean | | Standaard `true`. | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.recipe_id` | string | ja | | | `before.name` | string | ja | | | `before.piece_weight_g` | number \| null | ja | | | `before.extra_per_piece` | object[] | ja | | | `before.extra_per_piece[].ingredient_id` | string \| null | | | | `before.extra_per_piece[].recipe_id` | string \| null | | | | `before.extra_per_piece[].grams` | number | ja | | | `before.shop_price_cents` | integer \| null | ja | | | `before.traces_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.locations` | object[] | ja | | | `before.locations[].location_id` | string | ja | | | `before.locations[].sold_here` | boolean | ja | | | `before.locations[].shop_price_cents` | integer \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.recipe_id` | string | ja | | | `after.name` | string | ja | | | `after.piece_weight_g` | number \| null | ja | | | `after.extra_per_piece` | object[] | ja | | | `after.extra_per_piece[].ingredient_id` | string \| null | | | | `after.extra_per_piece[].recipe_id` | string \| null | | | | `after.extra_per_piece[].grams` | number | ja | | | `after.shop_price_cents` | integer \| null | ja | | | `after.traces_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.locations` | object[] | ja | | | `after.locations[].location_id` | string | ja | | | `after.locations[].sold_here` | boolean | ja | | | `after.locations[].shop_price_cents` | integer \| null | ja | | | `version_id` | string | ja | | ### `product_set_location` Set whether a product is sold at a location, and its price there. Toegang: recepten wijzigen `write:recipes` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `product` | string | ja | Product id, or product name within the recipe | | `location` | string | ja | Location id or name | | `sold_here` | boolean | ja | | | `shop_price_cents` | integer \| null | | Price at this location; null uses the product price | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.recipe_id` | string | ja | | | `before.name` | string | ja | | | `before.piece_weight_g` | number \| null | ja | | | `before.extra_per_piece` | object[] | ja | | | `before.extra_per_piece[].ingredient_id` | string \| null | | | | `before.extra_per_piece[].recipe_id` | string \| null | | | | `before.extra_per_piece[].grams` | number | ja | | | `before.shop_price_cents` | integer \| null | ja | | | `before.traces_note` | string \| null | ja | | | `before.archived_at` | string \| null | ja | | | `before.locations` | object[] | ja | | | `before.locations[].location_id` | string | ja | | | `before.locations[].sold_here` | boolean | ja | | | `before.locations[].shop_price_cents` | integer \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.recipe_id` | string | ja | | | `after.name` | string | ja | | | `after.piece_weight_g` | number \| null | ja | | | `after.extra_per_piece` | object[] | ja | | | `after.extra_per_piece[].ingredient_id` | string \| null | | | | `after.extra_per_piece[].recipe_id` | string \| null | | | | `after.extra_per_piece[].grams` | number | ja | | | `after.shop_price_cents` | integer \| null | ja | | | `after.traces_note` | string \| null | ja | | | `after.archived_at` | string \| null | ja | | | `after.locations` | object[] | ja | | | `after.locations[].location_id` | string | ja | | | `after.locations[].sold_here` | boolean | ja | | | `after.locations[].shop_price_cents` | integer \| null | ja | | | `version_id` | string | ja | | ## Locaties ### `location_list` List the locations (shops, production sites) of the bakery. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `include_archived` | boolean | | Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].name` | string | ja | | | `items[].kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | ja | | | `items[].opening_days` | integer[] | ja | | | `items[].day_start` | string \| null | ja | | | `items[].is_primary` | boolean | ja | | | `items[].archived_at` | string \| null | ja | | ### `location_create` Add a location: a shop, a production site or a shop with bakery. Toegang: beheer `admin` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | ja | | | `kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | ja | | | `opening_days` | integer[] | | ISO weekdays, 1 = Monday | | `day_start` | string \| null | | "HH:MM" the production day starts | | `is_primary` | boolean | | | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.name` | string | ja | | | `before.kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | ja | | | `before.opening_days` | integer[] | ja | | | `before.day_start` | string \| null | ja | | | `before.is_primary` | boolean | ja | | | `before.archived_at` | string \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.name` | string | ja | | | `after.kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | ja | | | `after.opening_days` | integer[] | ja | | | `after.day_start` | string \| null | ja | | | `after.is_primary` | boolean | ja | | | `after.archived_at` | string \| null | ja | | | `version_id` | string | ja | | ### `location_update` Change a location: name, kind, opening days, day start, primary; or archive it. Toegang: beheer `admin` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `name` | string | | | | `kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | | | | `opening_days` | integer[] | | ISO weekdays, 1 = Monday | | `day_start` | string \| null | | "HH:MM" the production day starts | | `is_primary` | boolean | | | | `location` | string | ja | Location id or name | | `archived` | boolean | | | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.name` | string | ja | | | `before.kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | ja | | | `before.opening_days` | integer[] | ja | | | `before.day_start` | string \| null | ja | | | `before.is_primary` | boolean | ja | | | `before.archived_at` | string \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.name` | string | ja | | | `after.kind` | `"winkel"` \| `"productie"` \| `"winkel_bakkerij"` | ja | | | `after.opening_days` | integer[] | ja | | | `after.day_start` | string \| null | ja | | | `after.is_primary` | boolean | ja | | | `after.archived_at` | string \| null | ja | | | `version_id` | string | ja | | ## Importeren ### `import_stage` Stage parsed workbook tabs as one import batch: proposes ingredients, duplicate merges, component links and categories. Writes no recipes; review with import_get, decide with import_resolve, then import_approve. Toegang: importeren `import` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `source_files` | string[] | ja | | | `sheets` | object[] | ja | | | `sheets[].file` | string | ja | | | `sheets[].sheet` | string | ja | Tab name as written, including " (onvolledig)" | | `sheets[].workbook_number` | integer \| null | ja | | | `sheets[].name` | string | ja | Tab name without " (onvolledig)" | | `sheets[].incomplete` | boolean | ja | | | `sheets[].slug` | string \| null | ja | | | `sheets[].lines` | object[] | ja | | | `sheets[].lines[].row` | integer | ja | | | `sheets[].lines[].raw` | string | ja | | | `sheets[].lines[].name` | string | ja | | | `sheets[].lines[].percentage` | number \| null | ja | | | `sheets[].lines[].grams` | number \| null | ja | | | `sheets[].lines[].component` | object | ja | | | `sheets[].lines[].component` | object | | Variant | | `sheets[].lines[].component.target` | string | ja | | | `sheets[].lines[].component.hint` | string | ja | | | `sheets[].lines[].group_label` | string \| null | ja | | | `sheets[].lines[].note` | string \| null | ja | | | `sheets[].lines[].optional` | boolean | ja | | | `sheets[].piece_weight_g` | number \| null | ja | | | `sheets[].shop_price_cents` | integer \| null | ja | | | `sheets[].steps` | string[] | ja | | | `sheets[].notes` | object | ja | | | `sheets[].notes.source` | string \| null | ja | | | `sheets[].notes.conversions` | string[] | ja | | | `sheets[].notes.components` | string[] | ja | | | `sheets[].notes.dough_weight` | string \| null | ja | | | `sheets[].notes.warnings` | string[] | ja | | | `sheets[].notes.missing` | string \| null | ja | | | `sheets[].sizes` | object[] | ja | | | `sheets[].sizes[].label` | string \| null | ja | | | `sheets[].sizes[].grams` | number | ja | | | `sheets[].issues` | string[] | ja | | | `available_sheets` | string[] | | Every tab name in the source workbooks, also those not imported now, to tell "not in this batch" from "does not exist" Standaard `[]`. | | `flags` | object[] | | Known questions to keep flagged for the owner, e.g. a value that differs from an older source Standaard `[]`. | | `flags[].sheet` | string | ja | | | `flags[].text` | string | ja | | | `flags[].propose` | object | | Changes the proposed recipe decision, e.g. a rename; stays changeable | | `flags[].propose.name` | string | | | | `flags[].propose.can_be_component` | boolean | | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | object | ja | | | `batch.id` | string | ja | | | `batch.status` | `"staged"` \| `"approved"` \| `"discarded"` | ja | | | `batch.source_files` | string[] | ja | | | `batch.summary` | object | ja | | | `batch.summary.recipes` | integer | ja | | | `batch.summary.incomplete` | integer | ja | | | `batch.summary.with_component_line` | integer | ja | | | `batch.summary.lines_without_quantity` | integer | ja | | | `batch.summary.without_piece_weight` | integer | ja | | | `batch.summary.without_shop_price` | integer | ja | | | `batch.summary.with_conversions` | integer | ja | | | `batch.summary.distinct_ingredient_names` | integer | ja | | | `batch.summary.ingredients_new` | integer | ja | | | `batch.summary.ingredients_existing` | integer | ja | | | `batch.summary.items` | record | ja | Item count per kind and status | | `batch.result` | object | ja | After approval: what was written, per tab | | `batch.result` | object | | Variant | | `batch.result.recipes` | object[] | ja | | | `batch.result.recipes[].file` | string | ja | | | `batch.result.recipes[].sheet` | string | ja | | | `batch.result.recipes[].recipe_id` | string | ja | | | `batch.result.recipes[].slug` | string | ja | | | `batch.result.recipes[].action` | `"created"` \| `"updated"` \| `"unchanged"` | ja | | | `batch.result.statements` | integer | ja | Statements in the one D1 batch that wrote it | | `batch.created_by` | string | ja | | | `batch.created_at` | string | ja | | ### `import_list` List import batches, newest first, with their summary and item counts (open questions per kind). Toegang: importeren `import` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `status` | `"staged"` \| `"approved"` \| `"discarded"` | | | | `limit` | integer | | Standaard `20`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].status` | `"staged"` \| `"approved"` \| `"discarded"` | ja | | | `items[].source_files` | string[] | ja | | | `items[].summary` | object | ja | | | `items[].summary.recipes` | integer | ja | | | `items[].summary.incomplete` | integer | ja | | | `items[].summary.with_component_line` | integer | ja | | | `items[].summary.lines_without_quantity` | integer | ja | | | `items[].summary.without_piece_weight` | integer | ja | | | `items[].summary.without_shop_price` | integer | ja | | | `items[].summary.with_conversions` | integer | ja | | | `items[].summary.distinct_ingredient_names` | integer | ja | | | `items[].summary.ingredients_new` | integer | ja | | | `items[].summary.ingredients_existing` | integer | ja | | | `items[].summary.items` | record | ja | Item count per kind and status | | `items[].result` | object | ja | After approval: what was written, per tab | | `items[].result` | object | | Variant | | `items[].result.recipes` | object[] | ja | | | `items[].result.recipes[].file` | string | ja | | | `items[].result.recipes[].sheet` | string | ja | | | `items[].result.recipes[].recipe_id` | string | ja | | | `items[].result.recipes[].slug` | string | ja | | | `items[].result.recipes[].action` | `"created"` \| `"updated"` \| `"unchanged"` | ja | | | `items[].result.statements` | integer | ja | Statements in the one D1 batch that wrote it | | `items[].created_by` | string | ja | | | `items[].created_at` | string | ja | | ### `import_get` Get an import batch with its summary and the items to review, optionally filtered by kind or status. Toegang: importeren `import` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | string | | Batch id; defaults to the newest batch | | `kind` | `"recipe"` \| `"ingredient"` \| `"ingredient_merge"` \| `"component"` \| `"missing_recipe"` \| `"conversion"` \| `"flag"` | | | | `status` | `"open"` \| `"proposed"` \| `"resolved"` \| `"info"` | | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | object | ja | | | `batch.id` | string | ja | | | `batch.status` | `"staged"` \| `"approved"` \| `"discarded"` | ja | | | `batch.source_files` | string[] | ja | | | `batch.summary` | object | ja | | | `batch.summary.recipes` | integer | ja | | | `batch.summary.incomplete` | integer | ja | | | `batch.summary.with_component_line` | integer | ja | | | `batch.summary.lines_without_quantity` | integer | ja | | | `batch.summary.without_piece_weight` | integer | ja | | | `batch.summary.without_shop_price` | integer | ja | | | `batch.summary.with_conversions` | integer | ja | | | `batch.summary.distinct_ingredient_names` | integer | ja | | | `batch.summary.ingredients_new` | integer | ja | | | `batch.summary.ingredients_existing` | integer | ja | | | `batch.summary.items` | record | ja | Item count per kind and status | | `batch.result` | object | ja | After approval: what was written, per tab | | `batch.result` | object | | Variant | | `batch.result.recipes` | object[] | ja | | | `batch.result.recipes[].file` | string | ja | | | `batch.result.recipes[].sheet` | string | ja | | | `batch.result.recipes[].recipe_id` | string | ja | | | `batch.result.recipes[].slug` | string | ja | | | `batch.result.recipes[].action` | `"created"` \| `"updated"` \| `"unchanged"` | ja | | | `batch.result.statements` | integer | ja | Statements in the one D1 batch that wrote it | | `batch.created_by` | string | ja | | | `batch.created_at` | string | ja | | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].kind` | `"recipe"` \| `"ingredient"` \| `"ingredient_merge"` \| `"component"` \| `"missing_recipe"` \| `"conversion"` \| `"flag"` | ja | | | `items[].status` | `"open"` \| `"proposed"` \| `"resolved"` \| `"info"` | ja | | | `items[].payload` | any | ja | | | `items[].resolution` | any \| null | ja | | ### `import_resolve` Decide one item of a staged import. Changes only the batch; recipes are written when the batch is approved. Toegang: importeren `import` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | string | ja | | | `item` | string | ja | | | `resolution` | record | ja | Depends on the item kind. recipe: {action:"import", name?, category?, can_be_component?} or {action:"skip"}. ingredient: {action:"create", name, composition, is_flour_default, aliases} or {action:"use_existing", ingredient_id}. ingredient_merge: {action:"merge", into:} or {action:"keep_separate"}. component: {action:"link_batch", sheet} \| {action:"link_existing", recipe_id} \| {action:"as_ingredient", name} \| {action:"drop_line"}. conversion, missing_recipe, flag: {action:"acknowledge"}. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `id` | string | ja | | | `kind` | `"recipe"` \| `"ingredient"` \| `"ingredient_merge"` \| `"component"` \| `"missing_recipe"` \| `"conversion"` \| `"flag"` | ja | | | `status` | `"open"` \| `"proposed"` \| `"resolved"` \| `"info"` | ja | | | `payload` | any | ja | | | `resolution` | any \| null | ja | | ### `import_approve` Propose writing a fully decided import batch: ingredients, recipes, lines, method and products. Staged: nothing changes until pending_confirm. Toegang: importeren `import` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | string | ja | | | `reason` | string | | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `pending` | object | ja | | | `pending.id` | string | ja | | | `pending.op_name` | string | ja | | | `pending.input` | any | ja | | | `pending.preview` | any | ja | | | `pending.created_by` | string | ja | | | `pending.status` | `"pending"` \| `"confirmed"` \| `"cancelled"` \| `"expired"` | ja | | | `pending.expires_at` | string | ja | | | `pending.created_at` | string | ja | | | `preview` | any | ja | | ### `import_discard` Throw away a staged import. Nothing was written to recipes, so nothing changes there. Toegang: importeren `import` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | string | ja | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `batch` | object | ja | | | `batch.id` | string | ja | | | `batch.status` | `"staged"` \| `"approved"` \| `"discarded"` | ja | | | `batch.source_files` | string[] | ja | | | `batch.summary` | object | ja | | | `batch.summary.recipes` | integer | ja | | | `batch.summary.incomplete` | integer | ja | | | `batch.summary.with_component_line` | integer | ja | | | `batch.summary.lines_without_quantity` | integer | ja | | | `batch.summary.without_piece_weight` | integer | ja | | | `batch.summary.without_shop_price` | integer | ja | | | `batch.summary.with_conversions` | integer | ja | | | `batch.summary.distinct_ingredient_names` | integer | ja | | | `batch.summary.ingredients_new` | integer | ja | | | `batch.summary.ingredients_existing` | integer | ja | | | `batch.summary.items` | record | ja | Item count per kind and status | | `batch.result` | object | ja | After approval: what was written, per tab | | `batch.result` | object | | Variant | | `batch.result.recipes` | object[] | ja | | | `batch.result.recipes[].file` | string | ja | | | `batch.result.recipes[].sheet` | string | ja | | | `batch.result.recipes[].recipe_id` | string | ja | | | `batch.result.recipes[].slug` | string | ja | | | `batch.result.recipes[].action` | `"created"` \| `"updated"` \| `"unchanged"` | ja | | | `batch.result.statements` | integer | ja | Statements in the one D1 batch that wrote it | | `batch.created_by` | string | ja | | | `batch.created_at` | string | ja | | ## Voorgestelde wijzigingen ### `pending_list` List staged changes waiting for confirmation, such as ingredient merges. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `status` | `"pending"` \| `"confirmed"` \| `"cancelled"` \| `"expired"` | | Standaard `"pending"`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].op_name` | string | ja | | | `items[].input` | any | ja | | | `items[].preview` | any | ja | | | `items[].created_by` | string | ja | | | `items[].status` | `"pending"` \| `"confirmed"` \| `"cancelled"` \| `"expired"` | ja | | | `items[].expires_at` | string | ja | | | `items[].created_at` | string | ja | | ### `pending_confirm` Carry out a staged change. Needs the same permission as the op that staged it. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `id` | string | ja | | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `pending` | object | ja | | | `pending.id` | string | ja | | | `pending.op_name` | string | ja | | | `pending.input` | any | ja | | | `pending.preview` | any | ja | | | `pending.created_by` | string | ja | | | `pending.status` | `"pending"` \| `"confirmed"` \| `"cancelled"` \| `"expired"` | ja | | | `pending.expires_at` | string | ja | | | `pending.created_at` | string | ja | | | `version_ids` | string[] | ja | | ### `pending_cancel` Cancel a staged change. Nothing is written. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `id` | string | ja | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `pending` | object | ja | | | `pending.id` | string | ja | | | `pending.op_name` | string | ja | | | `pending.input` | any | ja | | | `pending.preview` | any | ja | | | `pending.created_by` | string | ja | | | `pending.status` | `"pending"` \| `"confirmed"` \| `"cancelled"` \| `"expired"` | ja | | | `pending.expires_at` | string | ja | | | `pending.created_at` | string | ja | | ## Geschiedenis ### `version_list` List the change history, newest first: who changed what (line by line for recipes), through the app, Claude or an import, and why. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `entity_type` | `"recipe"` \| `"ingredient"` \| `"product"` \| `"location"` \| `"device"` \| `"company"` | | | | `entity` | string | | Entity id; for recipes also the slug | | `via` | `"app"` \| `"mcp"` \| `"import"` | | Only changes made in the app, through Claude (mcp) or by an import | | `limit` | integer | | Standaard `50`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].entity_type` | `"recipe"` \| `"ingredient"` \| `"product"` \| `"location"` \| `"device"` \| `"company"` | ja | | | `items[].entity_id` | string | ja | | | `items[].op_name` | string | ja | | | `items[].actor_type` | string | ja | | | `items[].actor_id` | string | ja | | | `items[].via` | `"app"` \| `"mcp"` \| `"import"` | ja | | | `items[].reason` | string \| null | ja | | | `items[].restored_from_id` | string \| null | ja | | | `items[].meta` | object | | Standaard `null`. | | `items[].meta` | object | | Variant | | `items[].meta.suggestions` | object[] | | Suggestions of Adorea accepted in this edit | | `items[].meta.suggestions[].title` | string | ja | | | `items[].meta.commands` | object[] | | Typed instructions Adorea carried out in this edit | | `items[].meta.commands[].title` | string | ja | | | `items[].meta.recipe_version_id` | string | | On a product changed in a recipe edit: that recipe version | | `items[].created_at` | string | ja | | | `items[].actor_name` | string \| null | ja | Member or device name, when it still exists | | `items[].changes` | object[] | ja | What changed, from the before and after snapshots; empty for a creation | | `items[].changes[].kind` | `"line"` \| `"step"` \| `"field"` | ja | | | `items[].changes[].label` | string | ja | Ingredient or component name, "stap 4", or the field name | | `items[].changes[].change` | `"added"` \| `"removed"` \| `"changed"` | ja | | | `items[].changes[].before` | string \| number \| boolean \| null | ja | | | `items[].changes[].after` | string \| number \| boolean \| null | ja | | ### `version_get` Get one version with the full before and after, and for recipes the effect on dough, hydration and pieces. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `id` | string | ja | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `id` | string | ja | | | `entity_type` | `"recipe"` \| `"ingredient"` \| `"product"` \| `"location"` \| `"device"` \| `"company"` | ja | | | `entity_id` | string | ja | | | `op_name` | string | ja | | | `actor_type` | string | ja | | | `actor_id` | string | ja | | | `via` | `"app"` \| `"mcp"` \| `"import"` | ja | | | `reason` | string \| null | ja | | | `restored_from_id` | string \| null | ja | | | `meta` | object | | Standaard `null`. | | `meta` | object | | Variant | | `meta.suggestions` | object[] | | Suggestions of Adorea accepted in this edit | | `meta.suggestions[].title` | string | ja | | | `meta.commands` | object[] | | Typed instructions Adorea carried out in this edit | | `meta.commands[].title` | string | ja | | | `meta.recipe_version_id` | string | | On a product changed in a recipe edit: that recipe version | | `created_at` | string | ja | | | `actor_name` | string \| null | ja | Member or device name, when it still exists | | `changes` | object[] | ja | What changed, from the before and after snapshots; empty for a creation | | `changes[].kind` | `"line"` \| `"step"` \| `"field"` | ja | | | `changes[].label` | string | ja | Ingredient or component name, "stap 4", or the field name | | `changes[].change` | `"added"` \| `"removed"` \| `"changed"` | ja | | | `changes[].before` | string \| number \| boolean \| null | ja | | | `changes[].after` | string \| number \| boolean \| null | ja | | | `before` | any | ja | | | `after` | any | ja | | | `effect` | object | ja | For recipes: dough, flour, hydration and pieces before and after | | `effect` | object | | Variant | | `effect.before` | object | ja | | | `effect.before` | object | | Variant | | `effect.before.dough_total_g` | number | ja | | | `effect.before.flour_total_g` | number | ja | | | `effect.before.hydration_pct` | number \| null | ja | | | `effect.before.pieces` | object[] | ja | | | `effect.before.pieces[].product_id` | string | ja | | | `effect.before.pieces[].name` | string | ja | | | `effect.before.pieces[].pieces_per_batch` | integer \| null | ja | | | `effect.after` | object | ja | | | `effect.after.dough_total_g` | number | ja | | | `effect.after.flour_total_g` | number | ja | | | `effect.after.hydration_pct` | number \| null | ja | | | `effect.after.pieces` | object[] | ja | | | `effect.after.pieces[].product_id` | string | ja | | | `effect.after.pieces[].name` | string | ja | | | `effect.after.pieces[].pieces_per_batch` | integer \| null | ja | | ### `version_restore` Put an entity back as it was at a version. Writes a new version; history is never overwritten. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `id` | string | ja | Version to go back to | | `state` | `"after"` \| `"before"` | | "after": as it was right after that change. "before": undo that change Standaard `"after"`. | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | any | ja | | | `after` | any | ja | | | `version_id` | string | ja | | #### Voorbeeld "before" undoes that change. ```json { "id": "01JD3Y8Q2W5V7K9M1N3P5R7T9V", "state": "before", "reason": "Wijziging terugdraaien" } ``` ## Documentatie ### `docs_search` Search the documentation for how the app and the tools work. Returns matching sections with a link; read a whole page with docs_get. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `query` | string | ja | Words to look for, Dutch or English (tool names work too) | | `limit` | integer | | Standaard `8`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `results` | object[] | ja | | | `results[].slug` | string | ja | Page to read with docs_get | | `results[].title` | string | ja | | | `results[].heading` | string \| null | ja | Section on the page, or null for its introduction | | `results[].url` | string | ja | | | `results[].snippet` | string | ja | | | `results[].score` | number | ja | | #### Voorbeeld ```json { "query": "schalen naar aantal stuks" } ``` ### `docs_get` Get one documentation page as Markdown, with the list of all pages. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `slug` | string | ja | Page path from docs_search, e.g. "app/recepten"; "" is the home page | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `slug` | string | ja | | | `title` | string | ja | | | `description` | string | ja | | | `url` | string | ja | | | `text_url` | string | ja | The same page as plain text | | `text` | string | ja | The page as Markdown | | `pages` | object[] | ja | Every page, to find the next one to read | | `pages[].slug` | string | ja | | | `pages[].title` | string | ja | | #### Voorbeeld ```json { "slug": "concepten/grammen-en-percentages" } ``` ## Overig ### `device_list` List the paired devices (bakery iPads), with their location and when they were last used. Toegang: lezen `read` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `include_revoked` | boolean | | Standaard `false`. | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `items` | object[] | ja | | | `items[].id` | string | ja | | | `items[].location_id` | string | ja | | | `items[].name` | string | ja | | | `items[].paired_at` | string | ja | | | `items[].last_seen_at` | string \| null | ja | | | `items[].revoked_at` | string \| null | ja | | | `items[].location_name` | string | ja | | ### `device_create_pairing_code` Create a one-time code to pair an iPad with a location. Valid 10 minutes; enter it on the iPad. Short-lived secret, so no version; the device it creates gets one. Toegang: beheer `admin` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `location` | string | | Defaults to the caller's location | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `code` | string | ja | Six characters to type on the iPad at /koppelen | | `expires_at` | string | ja | | | `location` | object | ja | | | `location.id` | string | ja | | | `location.name` | string | ja | | ### `device_revoke` Unpair a device. It loses access on its next request and has to be paired again with a new code. Toegang: beheer `admin` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `device` | string | ja | Device id | | `reason` | string | | Why this change is made; shown as "Waarom" in the version history | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | object | ja | | | `before` | object | | Variant | | `before.id` | string | ja | | | `before.location_id` | string | ja | | | `before.name` | string | ja | | | `before.paired_at` | string | ja | | | `before.last_seen_at` | string \| null | ja | | | `before.revoked_at` | string \| null | ja | | | `after` | object | ja | | | `after.id` | string | ja | | | `after.location_id` | string | ja | | | `after.name` | string | ja | | | `after.paired_at` | string | ja | | | `after.last_seen_at` | string \| null | ja | | | `after.revoked_at` | string \| null | ja | | | `version_id` | string | ja | | ### `company_settings_update` Change company settings, such as whether suggestions of Adorea are on in the recipe editor. Toegang: beheer `admin` #### Invoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `ai_suggestions` | boolean | | "Voorstellen van Adorea" in the recipe editor; off hides the command bar and the suggestions, checks stay | | `suggest_model` | string \| null | | Model for suggestions instead of the default; "@test/fixed" answers the same every time (tests). null goes back to the default | | `reason` | string | | | #### Uitvoer | Veld | Type | Verplicht | Toelichting | | --- | --- | --- | --- | | `before` | record | ja | | | `after` | record | ja | | | `version_id` | string | ja | |