Nero Quote Builder
VAT-correct trade quotes with a branded PDF and one-tap customer accept, for UK trades' AI
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"quote-builder": {
"url": "https://quote-builder.nerolabs.workers.dev/mcp"
}
}
}원격 엔드포인트
https://quote-builder.nerolabs.workers.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (11)
🟡setup_trade(trade_key, trades, display_name, company_name, company_number, ...)
Create a business, or update its saved settings (call with trade_key to update). Saves the rates and rules every quote uses: day and hour rates, labourer rate, materials markup, VAT registration and number, CIS, deposit rule, validity, payment terms, standard exclusions, brand colour, logo (https link or base64; PNG or JPEG for the PDF), quote number prefix, price book. On first call returns trade_key ONCE: it is shown only once and every other tool needs it. Also returns nero_trade_ref, the same identity the Nero Work exchange and Spark Pack use. Money in pounds.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "Omit to create a new business. Give it to update an existing one (only the fields you send change)."
},
"trades": {
"type": "array",
"items": {
"type": "string",
"enum": [
"electrician",
"plumber_heating",
"builder",
"roofer",
"decorator"
]
},
"description": "Required on first setup."
},
"display_name": {
"type": "string",
"description": "Business name customers see. Required on first setup."
},
"company_name": {
"type": "string",
"description": "Registered company name if a limited company."
},
"company_number": {
"type": "string"
},
"licence_body": {
"type": "string",
"description": "Scheme or registration body: niceic, napit, elecsa, stroma, gas_safe, oftec, hetas, fensa, certass, trustmark, nfrc, fmb, other."
},
"licence_number": {
"type": "string",
"description": "Registration number with that body (Gas Safe number for gas engineers)."
},
"address": {
"type": "string"
},
"postcode": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"website": {
"type": "string"
},
"vat_registered": {
"type": "boolean",
"description": "Required on first setup. If false, no VAT is ever added."
},
"vat_number": {
"type": "string"
},
"cis_registered": {
"type": "boolean"
},
"day_rate": {
"type": "number",
"description": "The trade's own charge-out rate per day, pounds, before VAT."
},
"hour_rate": {
"type": "number",
"description": "Per hour, pounds. If only one of day_rate and hour_rate is set the other is worked out from hours_per_day."
},
"labourer_day_rate": {
"type": "number",
"description": "Charge-out day rate for a mate, labourer or apprentice."
},
"hours_per_day": {
"type": "number",
"description": "Default 8."
},
"materials_markup_percent": {
"type": "number",
"description": "Added to what materials cost the trade. Default 15."
},
"deposit": {
"type": "object",
"description": "Deposit rule. basis percent (with percent), fixed (with amount in pounds), materials (deposit equals the materials total), or none. no_deposit_under: no deposit on quotes below this total in pounds.",
"properties": {
"basis": {
"type": "string",
"enum": [
"percent",
"fixed",
"materials",
"none"
]
},
"percent": {
"type": "number"
},
"amount": {
"type": "number"
},
"no_deposit_under": {
"type": "number"
}
}
},
"validity_days": {
"type": "number",
"description": "Default 30."
},
"payment_terms": {
"type": "string",
"description": "Shown on every quote, for example \"Deposit to book, balance on completion by bank transfer.\""
},
"standard_exclusions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Things this business never includes unless stated, shown on every quote."
},
"use_suggested_exclusions": {
"type": "boolean",
"description": "Adds a short set of common exclusions for the trade(s), for example plastering after chasing for electricians."
},
"price_display": {
"type": "string",
"enum": [
"itemised",
"sections"
],
"description": "itemised (default) shows quantity and price per line; sections shows one price per section (labour, materials) with the lines listed."
},
"brand_colour": {
"type": "string",
"description": "Hex colour, for example #0B5FFF. If a logo is given and no colour, one is taken from the logo."
},
"accent_colour": {
"type": "string"
},
"logo_url": {
"type": "string",
"description": "https link to the logo (PNG best, JPEG fine, SVG shows on the phone page only). Under 400 KB."
},
"logo_base64": {
"type": "string",
"description": "The logo file as base64, instead of logo_url."
},
"quote_prefix": {
"type": "string",
"description": "Letters before the quote number, for example BLE gives BLE-0001. Default from the business initials."
},
"price_items": {
"type": "array",
"description": "Materials the trade buys often, saved to their price book. Each: code (short id, optional), description, unit, unit_cost (pounds, what they pay), cost_includes_vat, markup_percent (optional, overrides the default).",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
},
"unit": {
"type": "string"
},
"unit_cost": {
"type": "number"
},
"cost_includes_vat": {
"type": "boolean"
},
"markup_percent": {
"type": "number"
}
},
"required": [
"description",
"unit_cost"
]
}
}
}
}🟢get_trade(trade_key)
The trade's saved settings, price book (most used first), quote stats (win rate, value won in the last 12 months) and, for a business that is not VAT registered, a warning when accepted work is nearing the £90,000 VAT registration threshold.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
}
},
"required": [
"trade_key"
]
}🟡save_price_items(trade_key, price_items)
Add or update materials in the trade's price book, so later quotes can use { code, qty } and the cost, unit and markup fill in. Materials used in quotes are also remembered automatically.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"price_items": {
"type": "array",
"description": "Materials the trade buys often, saved to their price book. Each: code (short id, optional), description, unit, unit_cost (pounds, what they pay), cost_includes_vat, markup_percent (optional, overrides the default).",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
},
"unit": {
"type": "string"
},
"unit_cost": {
"type": "number"
},
"cost_includes_vat": {
"type": "boolean"
},
"markup_percent": {
"type": "number"
}
},
"required": [
"description",
"unit_cost"
]
}
}
},
"required": [
"trade_key",
"price_items"
]
}🟡draft_quote(trade_key, trade, title, summary, customer, ...)
Price a job after a site visit. Give the job, customer, labour (time, priced from the saved rate), materials (trade cost, marked up), other costs and optional extras; the server applies VAT correctly (registered or not, 20/5/0%, the construction domestic reverse charge for contractor customers), the deposit rule, validity, exclusions and a running quote number. Returns the totals, the trade-only margin view, warnings, a check_before_sending list of commonly forgotten items for that trade, and the links to the PDF and the customer's phone page (a DRAFT until finalise_quote). from_quote copies a past quote's lines for a new customer. save false returns the numbers without saving.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"trade": {
"type": "string",
"enum": [
"electrician",
"plumber_heating",
"builder",
"roofer",
"decorator"
],
"description": "Which trade this job is, if the business does more than one. Drives the check_before_sending list."
},
"title": {
"type": "string",
"description": "Short job name the customer sees, for example \"Full rewire, 3 bedroom semi\" or \"Replace combi boiler\"."
},
"summary": {
"type": "string",
"description": "Two to four plain sentences describing the work as found on the visit, written for the customer. No jargon they would not understand."
},
"customer": {
"type": "object",
"description": "Who the quote is for. type: homeowner, landlord, tenant, business (buying for itself) or contractor (a builder or main contractor buying your work). For business or contractor customers also give vat_registered, cis_registered and end_user, because they decide whether the construction domestic reverse charge applies.",
"properties": {
"name": {
"type": "string"
},
"company": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"homeowner",
"landlord",
"tenant",
"business",
"contractor"
]
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"address": {
"type": "string"
},
"postcode": {
"type": "string"
},
"vat_registered": {
"type": "boolean"
},
"cis_registered": {
"type": "boolean"
},
"end_user": {
"type": "boolean",
"description": "True if this business customer is the end user of the work (not selling it on)."
}
},
"required": [
"name"
]
},
"site_address": {
"type": "string",
"description": "Job address, if different from the customer's address."
},
"labour": {
"type": "array",
"description": "Labour lines. Give days OR hours (time on the job, per person) and the server prices it from the trade's saved rate; or give a fixed price in pounds. rate: trade (default, the trade's own rate) or labourer (their mate or apprentice rate). people: how many on site for that time. rate_override: a one-off day or hour rate in pounds.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"days": {
"type": "number"
},
"hours": {
"type": "number"
},
"people": {
"type": "number"
},
"rate": {
"type": "string",
"enum": [
"trade",
"labourer"
]
},
"rate_override": {
"type": "number"
},
"price": {
"type": "number"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
},
"required": [
"description"
]
}
},
"materials": {
"type": "array",
"description": "Materials. unit_cost is what the TRADE pays per unit in pounds; the server adds their markup. Set cost_includes_vat true if the price came from a receipt or shelf price including VAT (the server strips it for VAT registered trades). Give a saved code instead of description and unit_cost to use the price book. Prices used here are remembered for next time.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"qty": {
"type": "number"
},
"unit": {
"type": "string",
"description": "each, m, drum, tin, box, lot, m2..."
},
"unit_cost": {
"type": "number"
},
"cost_includes_vat": {
"type": "boolean"
},
"markup_percent": {
"type": "number"
},
"code": {
"type": "string"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
}
}
},
"other": {
"type": "array",
"description": "Other costs charged as a set amount in pounds (ex VAT): skip hire, scaffolding, waste disposal, certification or notification fees, parking. qty multiplies the amount (for example scaffold per week).",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"amount": {
"type": "number"
},
"qty": {
"type": "number"
},
"unit": {
"type": "string"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
},
"required": [
"description",
"amount"
]
}
},
"optional_extras": {
"type": "array",
"description": "Optional upgrades the customer can tick when accepting (for example an EV charger, a smart thermostat, extra sockets). price in pounds before VAT. Up to 6. Not included in the main total.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"price": {
"type": "number"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
},
"required": [
"description",
"price"
]
}
},
"discount": {
"type": "object",
"description": "Optional discount before VAT: percent OR amount (pounds), with a short reason the customer sees.",
"properties": {
"percent": {
"type": "number"
},
"amount": {
"type": "number"
},
"reason": {
"type": "string"
}
}
},
"deposit": {
"type": "object",
"description": "Override the trade's usual deposit rule for this quote only. Deposit rule. basis percent (with percent), fixed (with amount in pounds), materials (deposit equals the materials total), or none. no_deposit_under: no deposit on quotes below this total in pounds.",
"properties": {
"basis": {
"type": "string",
"enum": [
"percent",
"fixed",
"materials",
"none"
]
},
"percent": {
"type": "number"
},
"amount": {
"type": "number"
},
"no_deposit_under": {
"type": "number"
}
}
},
"validity_days": {
"type": "number",
"description": "How many days the prices hold. Defaults to the trade's setting (usually 30)."
},
"exclusions": {
"type": "array",
"items": {
"type": "string"
},
"description": "What is NOT included in this job, one short sentence each. Added to the trade's standard exclusions."
},
"include_standard_exclusions": {
"type": "boolean",
"description": "Default true."
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "What the price assumes, for example \"Clear access to the loft\"."
},
"notes": {
"type": "string",
"description": "Anything else the customer should read."
},
"start": {
"type": "string",
"description": "Likely start, for example \"w/c 7 December\"."
},
"duration": {
"type": "string",
"description": "Time on site, for example \"3 working days\"."
},
"from_quote": {
"type": "string",
"description": "Start from this past quote. Fields you send replace that quote's fields; customer is required."
},
"save": {
"type": "boolean",
"description": "Default true. false = preview the numbers only, nothing saved, no quote number used."
},
"remember_prices": {
"type": "boolean",
"description": "Default true: material prices used here go into the price book."
}
},
"required": [
"trade_key",
"title",
"customer"
]
}🔴revise_quote(trade_key, quote, trade, title, summary, ...)
Change a quote. Send only the fields that change (a list you send, such as materials, replaces that whole list). A draft stays a draft. A quote the customer already has becomes the next revision on the same link, with fresh dates, and any earlier answer is cleared. Accepted quotes cannot change. status "withdrawn" pulls a quote. use_current_settings true re-prices with the trade's latest rates.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"quote": {
"type": "string",
"description": "Quote number, for example BLE-0007."
},
"trade": {
"type": "string",
"enum": [
"electrician",
"plumber_heating",
"builder",
"roofer",
"decorator"
],
"description": "Which trade this job is, if the business does more than one. Drives the check_before_sending list."
},
"title": {
"type": "string",
"description": "Short job name the customer sees, for example \"Full rewire, 3 bedroom semi\" or \"Replace combi boiler\"."
},
"summary": {
"type": "string",
"description": "Two to four plain sentences describing the work as found on the visit, written for the customer. No jargon they would not understand."
},
"customer": {
"type": "object",
"description": "Who the quote is for. type: homeowner, landlord, tenant, business (buying for itself) or contractor (a builder or main contractor buying your work). For business or contractor customers also give vat_registered, cis_registered and end_user, because they decide whether the construction domestic reverse charge applies.",
"properties": {
"name": {
"type": "string"
},
"company": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"homeowner",
"landlord",
"tenant",
"business",
"contractor"
]
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"address": {
"type": "string"
},
"postcode": {
"type": "string"
},
"vat_registered": {
"type": "boolean"
},
"cis_registered": {
"type": "boolean"
},
"end_user": {
"type": "boolean",
"description": "True if this business customer is the end user of the work (not selling it on)."
}
},
"required": [
"name"
]
},
"site_address": {
"type": "string",
"description": "Job address, if different from the customer's address."
},
"labour": {
"type": "array",
"description": "Labour lines. Give days OR hours (time on the job, per person) and the server prices it from the trade's saved rate; or give a fixed price in pounds. rate: trade (default, the trade's own rate) or labourer (their mate or apprentice rate). people: how many on site for that time. rate_override: a one-off day or hour rate in pounds.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"days": {
"type": "number"
},
"hours": {
"type": "number"
},
"people": {
"type": "number"
},
"rate": {
"type": "string",
"enum": [
"trade",
"labourer"
]
},
"rate_override": {
"type": "number"
},
"price": {
"type": "number"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
},
"required": [
"description"
]
}
},
"materials": {
"type": "array",
"description": "Materials. unit_cost is what the TRADE pays per unit in pounds; the server adds their markup. Set cost_includes_vat true if the price came from a receipt or shelf price including VAT (the server strips it for VAT registered trades). Give a saved code instead of description and unit_cost to use the price book. Prices used here are remembered for next time.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"qty": {
"type": "number"
},
"unit": {
"type": "string",
"description": "each, m, drum, tin, box, lot, m2..."
},
"unit_cost": {
"type": "number"
},
"cost_includes_vat": {
"type": "boolean"
},
"markup_percent": {
"type": "number"
},
"code": {
"type": "string"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
}
}
},
"other": {
"type": "array",
"description": "Other costs charged as a set amount in pounds (ex VAT): skip hire, scaffolding, waste disposal, certification or notification fees, parking. qty multiplies the amount (for example scaffold per week).",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"amount": {
"type": "number"
},
"qty": {
"type": "number"
},
"unit": {
"type": "string"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
},
"required": [
"description",
"amount"
]
}
},
"optional_extras": {
"type": "array",
"description": "Optional upgrades the customer can tick when accepting (for example an EV charger, a smart thermostat, extra sockets). price in pounds before VAT. Up to 6. Not included in the main total.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"price": {
"type": "number"
},
"vat_category": {
"type": "string",
"enum": [
"standard",
"reduced_5",
"zero_energy_saving",
"zero_new_build",
"zero_disabled",
"outside_scope"
],
"description": "VAT treatment of this line if the trade is VAT registered. standard = 20% (almost all repair, maintenance and installation work). reduced_5 = 5% (home empty 2+ years, conversion into a different number of homes, grant-funded heating). zero_energy_saving = 0% until 31 March 2027 for installing insulation, heat pumps, solar panels, batteries or heating controls in a home (NOT gas or oil boilers). zero_new_build = building a new home. zero_disabled = adaptations for a disabled person (needs their signed declaration). outside_scope = a fee paid on the customer's behalf at cost. Default standard. Ignored if the trade is not VAT registered."
}
},
"required": [
"description",
"price"
]
}
},
"discount": {
"type": "object",
"description": "Optional discount before VAT: percent OR amount (pounds), with a short reason the customer sees.",
"properties": {
"percent": {
"type": "number"
},
"amount": {
"type": "number"
},
"reason": {
"type": "string"
}
}
},
"deposit": {
"type": "object",
"description": "Override the trade's usual deposit rule for this quote only. Deposit rule. basis percent (with percent), fixed (with amount in pounds), materials (deposit equals the materials total), or none. no_deposit_under: no deposit on quotes below this total in pounds.",
"properties": {
"basis": {
"type": "string",
"enum": [
"percent",
"fixed",
"materials",
"none"
]
},
"percent": {
"type": "number"
},
"amount": {
"type": "number"
},
"no_deposit_under": {
"type": "number"
}
}
},
"validity_days": {
"type": "number",
"description": "How many days the prices hold. Defaults to the trade's setting (usually 30)."
},
"exclusions": {
"type": "array",
"items": {
"type": "string"
},
"description": "What is NOT included in this job, one short sentence each. Added to the trade's standard exclusions."
},
"include_standard_exclusions": {
"type": "boolean",
"description": "Default true."
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "What the price assumes, for example \"Clear access to the loft\"."
},
"notes": {
"type": "string",
"description": "Anything else the customer should read."
},
"start": {
"type": "string",
"description": "Likely start, for example \"w/c 7 December\"."
},
"duration": {
"type": "string",
"description": "Time on site, for example \"3 working days\"."
},
"status": {
"type": "string",
"enum": [
"withdrawn"
]
},
"reason": {
"type": "string"
},
"use_current_settings": {
"type": "boolean"
},
"remember_prices": {
"type": "boolean"
}
},
"required": [
"trade_key",
"quote"
]
}🟡finalise_quote(trade_key, quote)
Lock a draft so the customer can answer it. Sets today's date and the valid-until date, and returns the customer link, the PDF link and a short ready-to-send message. Nothing is sent by this server: the trade sends the link by their own text, WhatsApp or email. Free allowance: 5 finalised quotes per calendar month (UK time) per trade, shown as free_allowance in the answer and in get_trade; past it the quote stays a saved draft and can be finalised from the 1st of next month. Drafts, revisions of quotes already sent, replies and exports never count.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"quote": {
"type": "string",
"description": "Quote number, for example BLE-0007."
}
},
"required": [
"trade_key",
"quote"
]
}⚪quote_activity(trade_key, mark_seen)
What customers have done since the trade last checked: quotes opened, accepted (with the name they signed, extras ticked and final total), questions asked, declined. Marks them as seen unless mark_seen is false. Answers when the trade asks "any news on my quotes?".
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"mark_seen": {
"type": "boolean"
}
},
"required": [
"trade_key"
]
}🟢get_quote(trade_key, quote)
One quote in full: lines, totals, VAT working with HMRC sources, margins (trade only), the customer's answer, history (drafted, sent, opened, accepted) and links.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"quote": {
"type": "string",
"description": "Quote number, for example BLE-0007."
}
},
"required": [
"trade_key",
"quote"
]
}🟢list_quotes(trade_key, status, search, limit)
Recent quotes, newest first, with status (draft, sent, viewed, queried, accepted, declined, expired, withdrawn), total and whether there is news. Filter by status or search customer name, job title or number.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"status": {
"type": "string"
},
"search": {
"type": "string"
},
"limit": {
"type": "number"
}
},
"required": [
"trade_key"
]
}⚪reply_to_customer(trade_key, quote, message)
Answer a customer's question. The answer shows on their quote page under their question. Price or scope changes are made with revise_quote, not here.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"quote": {
"type": "string",
"description": "Quote number, for example BLE-0007."
},
"message": {
"type": "string"
}
},
"required": [
"trade_key",
"quote",
"message"
]
}🟢export_to_nero_work(trade_key, quote)
The quote in the exact argument shape of the Nero Work exchange's submit_quote tool (labour_minor, materials_minor, vat_minor in pence, validity_hours, exclusions, notes), checked with Nero Work's own rules. If the customer accepted with extras, they are included.
입력 스키마
{
"type": "object",
"properties": {
"trade_key": {
"type": "string",
"description": "The trade's secret key from setup_trade (starts qbk_)."
},
"quote": {
"type": "string",
"description": "Quote number, for example BLE-0007."
}
},
"required": [
"trade_key",
"quote"
]
}커뮤니티
증거