Job to paid

StepOperationWho
Start the jobjobs.createAgent
Add photosmedia.requestUpload, then PUT the bytesAgent
The shop's agent drafts the quote lines, including pricesquotes.createAgent
A person whose role may send quotes sends itquotes.sendOwner always. Office for any job, a lead for jobs on their crew, field for jobs assigned to them, until the owner turns send_quotes off. An agent token cannot send lines an agent drafted.
Customer signsquotes.signCustomer, hosted page
Make the invoiceinvoices.createFromQuoteAgent
Idaho jobs: subcontractor statementsubcontractors.prepare, then the owner signsAgent, then owner
Send the invoiceinvoices.sendSame roles, for send_invoices. An agent token cannot send lines an agent drafted.
Customer pays by card or bank (ACH)invoices.payCustomer, hosted page
Or paid by cash or checkinvoices.markPaidOutsideOwner or office, own sign-in
Customer confirms the workjobs.requestConfirmationAgent sends the link
Show the signed recordjobs.recordAgent

Quote lines

Each line has a description, a quantity and a unit price in cents (unit_price_minor). An agent you connect can draft these, including prices, from what the shop tells you or its price book. The owner can always send quotes, invoices and visit recaps. Office can send them for any job, a lead for jobs on their crew, and field for jobs assigned to them, until the owner turns that send off for that role. Quote or invoice lines an agent drafted stay unsent until a person whose role may send them sends them. An agent token cannot send those lines. A draft a person wrote follows the same role and job checks, and an agent token can send it when the role allows. Visit recaps follow the recap permission. Read the total back before sending.

Bank payments

A bank (ACH) payment takes a few business days to clear. While it clears, the invoice isn't paid yet, and paying again answers payment_pending. Tell the owner: "The customer paid by bank. It takes a few business days to clear." When it clears you get invoice.paid. If it fails you get invoice.payment_failed, the owner gets an email, and the same pay link works again.

Waiting

Signing and paying happen when the customer gets to it. Subscribe to webhooks such as quote.signed and invoice.paid, or read the records, then tell the owner. A quote is quotes.get and the list is quotes.list. Invoices are invoices.get and invoices.list. Payments are payments.get and payments.list.

Start here, then a checkup

me.start is the first read after you connect: the shops this connection can use, and the next tasks. agent.checkup is a read-only look across the shop (stale quotes, overdue invoices, tomorrow's visits, and the rest). Nothing is sent. agent.snooze hides one suggestion.