- Home
- QuickBooks automation
- QuickBooks purchase orders
QuickBooks purchase orders: link them from the bill, and never retry blind
A QuickBooks Online purchase order tells a vendor what you plan to buy. The vendor's bill comes after delivery and links back to it. In Intuit's API, that link is made from the bill, which can carry several purchase orders. On the purchase order itself the link is read-only. By our reading of Intuit's guide, stock moves when the bill is recorded, not when the order is sent.
A purchase order starts the cycle, and the bill closes it
In QuickBooks Online, the purchase order comes first. Intuit’s guide says the billing process usually starts when a business sends a purchase order to a vendor. The vendor delivers, then sends a bill. The business enters the bill and pays it with a bill payment.
Each step is its own record in the API:
Scroll the table sideways to see every column.
| Step | QuickBooks record | What Intuit’s guide says about it |
|---|---|---|
| Order goods | PurchaseOrder | Created and sent to the vendor from QuickBooks |
| Goods arrive, vendor bills | Bill | May be associated with an existing purchase order |
| Pay the vendor | BillPayment | Applied to the bill to settle it |
| Returns or overpayment | VendorCredit | Records what the vendor owes back |
Purchase orders, bills and expenses look much like invoice forms on screen. Intuit’s billing sample builds the same chain. It creates a vendor and a bill, pays the bill, then adds the vendor credit.
The link between a bill and its orders is set from the bill
This rule is easy to get wrong. Intuit’s linked transactions guide says the bill-to-order link is made through the Bill object. One bill can link to several purchase orders, and create, read and update all work there.
On the purchase order, the same link is read-only. Intuit’s table says to set it from the bill side, or in the QuickBooks screen. So an app that receives a vendor bill should:
- Find the open purchase orders for that vendor.
- Create the bill with each line pointing at its order line.
Line.LinkedTxn.TxnLineIdis mandatory for that link. - Leave out
Line.IdandLine.LineNumwhen creating the bill. Intuit says they should not be present. - Follow the link to read the order. A linked transaction gives only its type and ID.
Stock moves when the bill is recorded, by our reading
For stock items, the bill looks like the step that counts. Intuit’s inventory guide says QuickBooks updates quantity on hand once goods arrive and the purchase is recorded as a bill or an expense. Intuit’s API docs say item bundles are not supported on purchase transactions.
That leaves a gap. A three-way check matches order and receipt to bill, yet the receipt step has no record of its own in the guide we read. That is our reading, not Intuit’s words. Our QuickBooks inventory page covers what QuickBooks Online stock does and does not track.
Sales orders can link straight to purchase orders
Some firms buy only against a customer’s order. Intuit’s Sales Order API lists the purchase order as the purchase transaction that can link to a sales order. The sales order itself lives in a GraphQL API. The linked purchase order is read through the REST API, under the accounting scope.
Access is narrow. The Sales Order API opens only to apps on the Gold and Platinum tiers of Intuit’s app program. Intuit also marks it for restricted use for now.
Two IDs stop a retry from creating a second order
Intuit’s field guide shows how a dropped connection can create a duplicate: the app resends, and QuickBooks saves a second record. It gives two defences:
- A request ID. Intuit strongly recommends one on every request that writes, changes or deletes data. It can be up to 50 characters, except in batch calls. Sent again with the same ID, the request can get the first reply back.
- Your own DocNumber. It is the order number people see, up to 21 characters. Left out, QuickBooks assigns the next number when Automatic Transaction Numbers is on, the default for most companies. With Custom Transaction Numbers on, it stays empty.
DocNumber alone does not stop duplicates. Intuit says it does not return an existing record if you send the same value again. Its advice: before retrying a failed create, query for the record first.
An app can hear about purchase order changes
A linked system does not have to poll. Intuit’s webhooks table lists PurchaseOrder among the entities that send change notices. For US companies, purchase orders also carry sales tax codes. Intuit’s guide lists them with invoices and sales receipts as transactions that use TaxCode objects.
Where an AI agent fits in purchasing
An agent can draft purchase orders through Intuit’s API. Intuit’s open-source MCP server, which lets an AI app call QuickBooks, lists create_purchase_order and search_purchase_orders tools. Intuit’s Developer MCP is limited to developer setup and does not touch your books. Intuit’s own AI pages that we read did not cover purchase orders either. Those were the Intuit Intelligence and Accounting AI help articles, captured on 15 November 2026, and the July 2025 AI agents press release.
The jobs a custom agent can take on:
- Request to draft order. Read an emailed request or a reorder alert and draft a purchase order for a person to approve.
- Bill to order match. Match an arriving vendor bill to its open orders and flag any bill with no order.
- Supplier quotes. Send requests for quotes to suppliers and read their replies.
Our team built one multi-agent system for customer quotes and supplier RFQs, and all of its agents run in ERPNext and Frappe CRM. Separate agents handle intake, item matching, pricing, supplier RFQs and reading supplier replies. A person approves every quote before it goes out to a customer. See RFQ and RFP automation and the case study.
Our team has run bookkeeping, inventory sync, order sync and invoicing in QuickBooks. For other jobs, see QuickBooks AI agents.
Questions
How do I add a PO to QuickBooks?
In the QuickBooks screen, you create and send it to the vendor. We could not read Intuit's help steps, because quickbooks.intuit.com refuses our fetch tool. Through the API, an app sends a POST to the PurchaseOrder entity for your company. Give it your own DocNumber of up to 21 characters and a request ID, so a retry after a dropped connection does not create a second order.
Which comes first, PO or invoice?
The purchase order comes before the vendor's invoice, which QuickBooks calls a bill. Intuit's guide says the billing cycle usually starts when a business sends a purchase order to a vendor. The vendor delivers, then sends a bill, which is the vendor's invoice to you. In QuickBooks, that bill is entered and can be linked to the purchase order. A bill payment then pays the bill.
Can you issue an invoice without a purchase order?
In QuickBooks, yes. Intuit's guide says bills may be associated with an existing purchase order, so the link is optional. A vendor can bill you with no order on file, and you can still enter and pay it. Whether your own rules allow that is a policy question. An agent can flag any bill that arrives with no matching order.
Can QuickBooks Online handle inventory on purchase orders?
Yes, with limits. Intuit's guide says stock goes up once goods are received and the purchase is recorded as a bill or an expense. Intuit's API docs say item bundles are not supported on purchase transactions. Our QuickBooks inventory page covers the rest, including what QuickBooks Online does not track, such as serial numbers and separate stock locations.
Can an AI agent create purchase orders in QuickBooks?
Yes, through the API. Intuit's open-source MCP server has tools to create and search purchase orders. Intuit's Developer MCP does not touch your books. We checked Intuit's Intelligence and Accounting AI help articles, captured on 15 November 2026, and its July 2025 AI agents press release, and found no Intuit AI feature that drafts purchase orders. A custom agent can read a request, draft the order and wait for a person to approve it.
Does sending a purchase order change our stock count?
Not by itself, on our reading of Intuit's guide. It says QuickBooks updates quantity on hand once the goods arrive and the purchase is recorded as a bill or an expense. So the bill is the step that moves stock. Check this in a sandbox company with your own settings before you rely on it.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- Intuit Developer, bill payment in QuickBooks OnlineRead 18 Nov 2026
- Intuit Developer, manage linked transactionsRead 18 Nov 2026
- Intuit Developer, implement billing featuresRead 18 Nov 2026
- Intuit Developer, manage sales ordersRead 18 Nov 2026
- Intuit Developer, get started with the Sales Order APIRead 18 Nov 2026
- Intuit Developer, basic ID and field definitionsRead 18 Nov 2026
- Intuit Developer, configure webhooksRead 18 Nov 2026
- Intuit Developer, automated sales tax for US localesRead 18 Nov 2026
- Intuit Developer, items and inventory in QuickBooks OnlineRead 18 Nov 2026
- Intuit Developer, item bundles using groupsRead 18 Nov 2026
- Intuit on GitHub, QuickBooks Online MCP Server READMERead 18 Nov 2026
- Intuit, introducing Intuit Intelligence (help article)Read 15 Nov 2026
- Intuit, Accounting AI features (help article)Read 15 Nov 2026
- Intuit, AI agents press release, 1 July 2025Read 18 Nov 2026
- Intuit Developer, what Developer MCP can help you doRead 18 Nov 2026
Talk through your purchase order flow in QuickBooks
Bring a few recent purchase orders and bills, your QuickBooks Online plan, and where supplier requests arrive today. On the first call we go through which steps an agent could draft and where a person signs off. The first call is free.