Job to paid
| Step | Operation | Who |
|---|---|---|
| Start the job | jobs.create | Agent |
| Add photos | media.requestUpload, then PUT the bytes | Agent |
| The shop's agent drafts the quote lines, including prices | quotes.create | Agent |
| A person whose role may send quotes sends it | quotes.send | Owner 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 signs | quotes.sign | Customer, hosted page |
| Make the invoice | invoices.createFromQuote | Agent |
| Idaho jobs: subcontractor statement | subcontractors.prepare, then the owner signs | Agent, then owner |
| Send the invoice | invoices.send | Same roles, for send_invoices. An agent token cannot send lines an agent drafted. |
| Customer pays by card or bank (ACH) | invoices.pay | Customer, hosted page |
| Or paid by cash or check | invoices.markPaidOutside | Owner or office, own sign-in |
| Customer confirms the work | jobs.requestConfirmation | Agent sends the link |
| Show the signed record | jobs.record | Agent |
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.