Invoice PDF
The printable invoice. The supplier opens it with Print Invoice (invoice page) or Print (invoice list, order page); the restaurant receives it attached to emails. It's a US Letter page, built fresh from the order each time it's opened, except for the copy Clipp files when the order goes out.
Who uses it
- Supplier staff print it, attach it to deliveries, or send it themselves.
- Restaurants get it with the Ready for Delivery and Delivered emails, overdue reminders, payment receipts and refund emails.
How it works
Opening it
Clicking Print Invoice or Print opens the PDF in a new browser tab. There's no preview dialog and no forced download. If the browser blocks the tab: "Popup Blocked" / "Allow popups for this site to open the invoices." The button reads "Loading.." while it works. If the PDF can't be made: "Print job could not be started".
The same button prints a different document depending on where the order is:
| Order status | Title on the document |
|---|---|
| Placed (or a saved draft) | Pending Order |
| Confirmed (Packing) | Packing Slip (see Packing slip) |
| Ready for Delivery, Delivered, Canceled | Invoice |
Layout, top to bottom
1. Header row
- Supplier logo, name (bold), address, "city, state, zip", phone as (XXX) XXX-XXXX, email.
- A QR code captioned "Scan for Order Detail". It opens the order in Clipp for whoever scans it.
- On the right: the title, the invoice number, Ref. No: {reference} (if any), and the payment status: Paid, Partially Paid, Unpaid, Payment Processing, Void or Canceled. Badges Payment Refunded and Item(s) Returned when they apply. There's no "PAID" stamp, only this text.
2. Ship To · Bill To · details
| Label | Value |
|---|---|
| Ship To | Customer name, address, phone |
| Bill To | Customer name, billing address (or the shipping address if none), phone |
| Terms | COD, Net 7 days … Net 90 days |
| Order Placed | MM/DD/YYYY |
| Invoice Date | YYYY-MM-DD, exactly as stored |
| Due Date | MM/DD/YYYY |
| Sales Rep, Driver | Names, if set |
The customer's details are the copy saved on the order when it went out, so later changes to the customer don't rewrite old invoices.
3. Items
Columns: PRODUCT ID · PRODUCT NAME · QTY · SIZE/UNIT · WEIGHT · PRICE · TOTAL.
- WEIGHT appears only when something on the order is sold by weight.
- PRICE shows 2 to 4 decimals, trailing zeros trimmed; by-weight lines read "$16.299/LB".
- TOTAL is the line rounded to the cent. See Line totals & rounding.
- When boxes on a by-weight line differ, a "WEIGHT (LB):" row lists each box.
- A line note prints as "REMARK: {note}" under its line, and again under the returned row of that line. Print Settings → Hide Remarks on Invoice removes every note. See Line notes.
- Under the table: "Total Items: 3", "Total QTY: 22", "Total Weight: 12.50" (by weight only), Subtotal.
4. RETURNED ITEM(S), if any. Negative quantities and totals, one row per original line (reshelved and discarded returns merged). Goods returned that the order never sold are listed with no value. See Returns & credits.
5. Bottom row
- Note(s), if the order has notes.
- Pay box, when the invoice is unpaid and has gone out: a QR captioned "Scan to Pay" and a purple Pay Invoice button, both opening the pay page.
- Payment Method and Refunded Method lists, e.g. "Check (1042): $200.00", "Other (Venmo): $50.00".
- The amounts box:
| Row | Shown when |
|---|---|
| Subtotal, or Subtotal After Return | Always |
| One row per discount, promotion, loyalty discount or fee, each with its own label | When above $0 |
| Store Credits | Store credit was applied |
| Payment, or Net Payment when Paid | Something has been paid |
| Refunded Amount | Something was refunded |
| Balance Due (bold, shaded) | Always. $0.00 when Void or Canceled. |
| Outstanding Balance (everything this customer owes the supplier) | Not paid, the order has gone out, and the customer record doesn't hide it |
| Available Refund Amount | The customer paid more than the total |
6. Footnote, if the supplier set one in Print Settings → Invoice Footnote (up to 2,000 characters, printed small). With Repeat header on all pages on, every page after the first starts with the customer, invoice number and page number.
7. Page footer on every page: "Powered by" and the Clipp logo; "Order # INV-1001, Page 1 of 2, Printed 10/03/2026 09:15 AM".
The stored copy
Each time an order goes to Ready for Delivery, Clipp also files a PDF of the invoice as it stood then, a moment after the status changes. The Activity Log links to it: View original Invoice on the first dispatch, View invoice on later ones. Payments and edits made later don't change that filed copy; Print always shows the current state.
Calculations
Example amounts box: subtotal $233.62, 10% promotion (max $20) $20.00, one-time discount 2.5% $5.84, Clipp coupon $15.00, 3% fee $7.01, 2% loyalty $4.67, store credit $10.00 applied, paid $100.00.
| Row | Amount |
|---|---|
| Subtotal | $233.62 |
| Promotions | -$20.00 |
| Discount (2.5%) | -$5.84 |
| Clipp Promotion | -$15.00 |
| Fees & Charges (3%) | $7.01 |
| Loyalty Discount | -$4.67 |
| Store Credits | -$10.00 |
| Payment | $100.00 |
| Balance Due | $85.12 |
Each row prints the label the supplier gave it; the labels above are examples. The invoice total is $195.12 (the rows above Store Credits added up). Balance Due is that less $100.00 paid and $10.00 store credit.
Where it shows up
- Print Invoice on the invoice page, Print on the invoice list and the order page, View Invoice on the driver screens (verify).
- Attached to the invoice emails, the Notify to Pay reminder, payment receipts, refund emails and the order-returned email.
Permissions
Anyone with full or read-only invoice access can print. The server only lets supplier staff print their own business's invoices.
Decisions
- The order QR sits in the header. It used to set the height of a whole row; moving it saves paper. (#2336, #2337)
- The pay QR prints once, next to the totals. It used to print twice on orders with no order QR. (#2336)
- The Weight column shows only when something is weighed. A column of dashes wasted space. (#2335)
- Each line is rounded to the cent, then summed. The printed item lines always add up to the item subtotal. (#2160)
- The footnote prints small. It takes fewer lines. (#2336)
Specs
# prefix: OIB
Feature: Order Invoice Billing Address
The order invoice displays the restaurant's billing address in the Bill To section when available,
falling back to the shipping address otherwise. The restaurant's name and phone number are shown
alongside whichever address is displayed.
Background:
Given a supplier generates an invoice for a restaurant's order
Rule: Bill To uses the restaurant's billing address when one is on record
Scenario: OIB-001 invoice shows the restaurant's billing address in Bill To
Given the restaurant has a billing address on record
When the invoice is generated
Then the Bill To section shows the restaurant's billing address
And the Bill To section shows the restaurant's name and phone number
Scenario: OIB-003 invoice shows available billing address fields when partially filled
Given the restaurant has a billing address with only some fields filled
When the invoice is generated
Then the Bill To section shows only the filled billing address fields
And the Bill To section shows the restaurant's name and phone number
Rule: Bill To falls back to the shipping address when no usable billing address exists
Scenario Outline: OIB-002 invoice falls back to shipping address when billing address is <reason>
Given the restaurant's billing address is <state>
When the invoice is generated
Then the Bill To section shows the same address as Ship To
Examples:
| reason | state |
| not on record | not set |
| entirely blank | set but all fields are empty |
Customer names and addresses on the PDF also follow DDIN-001 to DDIN-017 in the Customer info specs (concepts/customer-info/invoices.feature), including DDIN-009: the transaction fee shows only on the restaurant's copy.
Known limitations
- There's no PO-number field; use the order's reference number (Ref. No).
- The filed copy is taken at Ready for Delivery only; a later edit isn't filed until the next dispatch.
- A footnote too long for one page doesn't print at all; the 2,000-character cap is meant to prevent that.
- The pay QR and Pay Invoice button are made each time the PDF is printed, never stored. The PDF filed when the order went out keeps the link it had then, so a link in an old filed copy can go dead once it expires or the invoice is paid. Printing the invoice again makes a new link.
- The restaurant's copy doesn't list the card Transaction Fee the restaurant paid.
- A discount or fee prints with the label the supplier gave it and doesn't add "(3%)" to a percentage fee.
- For a cancelled order the PDF shows Balance Due $0.00, while the invoice page shows the real balance if the order was delivered before it was cancelled.
FAQ
Why does Print give me a Packing Slip? The order is still in Packing (Confirmed). Once it's Ready for Delivery, the same button prints the invoice.
Why is there no Pay Invoice button on this PDF? It's paid, void or canceled, or the order hasn't gone out yet.
Can I add my return policy to the invoice? Yes: Manage Account → Print Settings → Invoice Footnote.