Pro Doen — Documentatie · Gebruik AI-tools

Offerteregels bewerken met MCP

Met de offerte-tools bouwt een AI een offerte regel voor regel op. Een regel is één rij op de offerte; een onderdeel is een geprijsd stuk van een regel. Een regel met onderdelen is alleen de kop: de onderdelen dragen de prijs.

Lees eerst het project met prodoen_company_project_get. Verzin nooit zelf een offerId, lineId of partId.

Een offerte en regels aanmaken

prodoen_company_offer_create geeft het nieuwe offerId terug.
prodoen_company_offer_line_create bewaart alles wat het schema toestaat: title, description, unitType, unitCost, unitQuantity, vatPercentage, optional, tier, selected en choiceGroup. In changes staat alleen wat daadwerkelijk is opgeslagen. Lukt het opslaan van de overige velden niet, dan meldt de tool dat de regel wel is aangemaakt maar de velden niet; gebruik dan prodoen_company_offer_line_update met hetzelfde lineId.
Stuur je een lineId mee dat al bestaat, dan maakt de tool geen tweede regel en wijzigt hij niets. Het antwoord bevat "created": false en geen changes. Wil je die regel aanpassen, gebruik dan de updatetool.
Een nieuwe regel komt onderaan de offerte, een nieuw onderdeel onderaan de regel.

Volgorde wijzigen

prodoen_company_offer_line_reorder (met projectId, bij voorkeur offerId, en lineIds) en prodoen_company_offer_part_reorder (lineId en partIds) werken zo:

Noem je alle regels (of onderdelen), dan is dat de nieuwe volgorde.
Noem je er maar een paar, dan komen die vooraan, in de volgorde die je opgeeft. De rest volgt daarachter in de volgorde die ze al hadden. Zo krijgen regels A, B, C, D met [C, A] de volgorde C, A, B, D.
Alle id's moeten bij dezelfde offerte (regel) horen. Een id van een andere offerte, een onbekend id of een id dat twee keer voorkomt geeft een foutmelding en er verandert niets.
Zonder offerId wordt de offerte van de eerste genoemde regel gebruikt.

Concept-kop en brief vóór het versturen

Zet de offertekop en de brief gewoon klaar met prodoen_company_offer_update (title, description voor de samenvatting en message voor de brief). Dat kan zolang de offerte een concept is. prodoen_company_offer_send gebruikt wat er is opgeslagen; je hoeft vlak voor het versturen dus niets meer aan te roepen. Geef je bij versturen wel een message mee, dan vervangt die de opgeslagen brief.

Nacalculatie en korting

Zet quantityIsEstimate: true samen met unitQuantity op een regel of onderdeel (line_update, part_update, ook bij line_create) als de hoeveelheid een schatting is. Dit is dezelfde "≈ schatting"-schakelaar als in de offerte-editor. Meldgrens, plafond en wijzigingsvoorstellen uit het nacalculatie-voorstel bestaan nog niet.
Korting geef je per regel of onderdeel met discountType (PERCENTAGE of FIXED), discountValue en discountReason. discountType: null haalt de korting weg. Dit zijn geen kortingscodes: de promotiecodes in Pro Doen gelden alleen voor abonnementen en zijn niet via deze tools te beheren.

Foutmeldingen

De tools spreken over projectId, lineIds, partIds, een line en een part. Voorbeelden: lineIds must list at least one id of the offer, lineIds lists d more than once, Line <id> not found, Part <id> not found.