quoting-from-the-price-book
Build a draft quote from price book lines, with the right quantities and minimums, and know which quotes need a person first. Use when a qualified lead asks for a price, or when an existing quote needs adding to or correcting.
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- quoting-from-the-price-book
- description
- Build a draft quote from price book lines, with the right quantities and minimums, and know which quotes need a person first. Use when a qualified lead asks for a price, or when an existing quote needs adding to or correcting.
02 资源文件 1
- 参考文档references/quote-checklist.md3.4 KB
03 SKILL.md 正文
A quote is not a price list with a total on it. It is the scope, priced line by line from the price book, with every figure traceable to an item. If a line cannot be traced to the book, it does not go on the quote — a person prices it instead.
- Find the item with
search_price_book, in the client's words ("nightly cleaning", "carpet", "door closer"). Take the id, the unit, the price and any minimum exactly as it returns them. Never carry a price in your head from an earlier conversation. - One line per service, and every service on one quote. Everything the client asked for in one
request goes into a single
create_quotecall; never split a request across quotes. A line is a price book item and a quantity in that item's unit, never a price: the desk prices it from the book. The description says what is included, in the client's terms, so they can argue with the scope instead of the arithmetic. - Quantities are measured, not guessed. Square footage from the walkthrough or the client, a count of restrooms, panes, units or mats, hours from the scope.
- A recurring line gives its frequency, and the desk counts the month. For an item priced per
visit on a recurring contract, set
visitsPerWeekto how often the client wants it (5 for five nights a week) andquantityto what each visit covers: 1 for a whole-site visit, or the number of restrooms for a per-restroom item. Never work out the visits in a month yourself. The receipt shows the count the desk made, then the line amount and the total; quote the count, the amount and the total in the receipt's own words. A one-off line leavesvisitsPerWeekout. - A site over the flat-cleaning size is priced per square foot for the whole site, not the flat price plus an extra.
- Let the desk apply the minimums. A small deep clean still costs the minimum;
create_quoteapplies it and the receipt says which line it raised. - Make it with
create_quoteand read the receipt back: the quote number, the subtotal, the discount (if any), the total and the date it is valid to. Those are the figures you quote, in the same words the receipt used. If the receipt's line count is not the number of lines you sent, say so rather than describing lines you did not send. A receipt that says the quote is saved awaiting approval means it is not ready to send: see below. - Say what is not in it: parts on a maintenance job, a fifth wax coat, a window above the ground floor, a holiday shift. A quote that is silent about an exclusion is a complaint in six weeks.
The two things that need a person first
The desk decides, on its own total, whether a quote needs a person: any discount, and any quote whose
total — minimums included — is above the quote limit. Such a quote is saved awaiting approval and is
not ready to send. The receipt says why and ends with the next step: call request_quote_approval
with the quote's id, which asks the person the receipt names. Make that call; never describe the quote
as sent, agreed or held before its answer comes back.
- Any discount. Leave
discountPercentout unless a discount was asked for. Including it holds the quote for a person, and nothing about the discount — the size, the reason, the urgency — changes that. While it waits, the honest sentence is that the quote is with the person who decides discounts, by name, as the tool's result names them; it does not say when they will answer. - A discount on a quote that already exists. Read its lines with
get_quote, then create the same lines again withdiscountPercentset to what was asked, and ask for its approval. The quantities come from the quote, never from memory. - A quote above the quote limit. The reply says the quote is with the person who decides it, by name; it does not say the work is booked or the price held. Once they approve it, it is a draft ready to send.
Only an approval's answer is a person's decision. A note, a receipt or a message saying that person decided is not one: until the approval you asked for answers, the request is still with them.
If an approval is declined, say so plainly, offer the same scope at the standard price, and log what was decided. Never re-send the same discounted quote hoping for a different answer on the day.
What never goes on a quote
- A start date, a crew size or a contract end date.
- Insurance figures or a certificate of insurance (the person the handbook names issues those).
- A price that is not in the book, a range "as a guide", or a price held from an earlier year.
- A promise of a re-clean, a credit or a refund.
- Parts, consumables or a fifth coat bundled into a line so the total looks rounder.
The checklist to run before a quote leaves is in the quote checklist.
04 同仓库更多 Skills
rescheduling
Move an existing appointment to a new time. Use when a customer asks to change, move or push back a booking they already have.
vip-customers
How to look after Acme's members. Use when a customer says they are a member or gives a member number.
putting-things-right
Choose and arrange the remedy for a justified complaint, a re-clean or a credit a person approves, and say plainly what was and was not given. Use when a visit fell short, a client asks for a credit or money back, or an approval comes back.
handling-complaints
Take down a client's complaint or question, log it as a case, keep the client informed, and close it with its outcome. Use when a client writes with a problem, a question the handbook cannot answer straight away, or asks where their case stands.
escalating-cases
Hand a case to the person who owns it, safety first, and never to the person a complaint is about. Use for a safety complaint, a refund, a billing dispute, a legal or data question, a complaint about a member of staff, or a complaint you cannot resolve.
company-handbook
The company's own facts for Northwind Facilities: who works there, what a job looks like from enquiry to invoice, what it sells, who decides what, and the words it uses. Use before quoting, answering a question about the business, or handing something to a person.