Supplier Invoice Import & 3-Way Matching
Import supplier invoices from PDF, auto-match against POs, and detect discrepancies.
Import supplier invoices from PDF, automatically match them against purchase orders, detect discrepancies, and update prices — all from one screen.
Overview
Stogly's 3-way matching system helps you:
- Import supplier invoices from PDF files or create them manually
- Automatically match invoice items against purchase orders
- Detect quantity and price discrepancies per item
- Update supplier prices and product cost prices with one click
- Create retroactive purchase orders when orders were placed by phone
Importing a Supplier Invoice from PDF
Step 1: Open the Invoice Import
- Navigate to Procurement > Supplier Invoices
- Click + New Invoice
- Click Import PDF at the top of the modal
Step 2: Upload Your PDF
- Click the upload area or drag-and-drop your supplier's PDF invoice
- The system automatically extracts:
- Supplier name — matched against your supplier database
- Invoice number — from the document header
- Invoice date & due date
- Line items — product names, quantities, unit prices, totals
Step 3: Review Parsed Items
The system uses a smart matching algorithm to link invoice items to your products:
- Exact match via supplier SKU — if the PDF contains a SKU that matches your supplier price list
- Near-exact match via supplier product name — high-confidence fuzzy matching against supplier price list mappings
- Fuzzy match via supplier product name — lower threshold for partial matches
- Fallback to internal product name — matches against your own product catalog
Each matched item shows:
- Your internal product name and SKU in the dropdown
- The supplier's product name and SKU below (in teal text)
- Quantity, unit price, and total
Step 4: Verify and Save
- Review all matched products — correct any mismatches using the dropdown
- Unmatched items appear with an empty dropdown — select the correct product manually
- Click Save Invoice
Matching Invoices Against Purchase Orders
Auto-Match
- From the Supplier Invoices list, find your invoice
- Click the blue Auto Match button (link icon)
- The system searches for purchase orders from the same supplier with status "Received" or "Completed"
- Results appear in the Match Details modal
Understanding Match Results
Each PO match shows a status badge:
| Status | Meaning |
|---|---|
| Full Match | All quantities and prices match exactly |
| Quantity Mismatch | One or more items have different quantities |
| Price Mismatch | One or more items have different prices |
| Qty & Price Mismatch | Both quantity and price differences exist |
Per-Item Variance Breakdown
When a match has discrepancies, click to expand the per-item variance table:
| Column | Description |
|---|---|
| Product | Product name |
| Inv. Qty | Quantity on the invoice |
| PO Qty | Quantity on the purchase order |
| Inv. Price | Unit price on the invoice |
| PO Price | Unit price on the purchase order |
| Status | Per-item match status with color coding |
Color coding:
- Green ✓ — item matches perfectly
- Yellow — quantity or price mismatch (with exact difference shown)
- Blue "Invoice only" — item is on the invoice but not on the PO
- Purple "PO only" — item is on the PO but not on the invoice
Giving a Line Its Product
An invoice line that has no product cannot be matched with a purchase order. In the Match Details modal, under Invoice Items, such a line carries the Needs Mapping badge next to what the supplier wrote. Either:
- click Choose a product and search by name, SKU or barcode, or
- click Create product to add it to your catalogue as a product or an ingredient.
The line is linked, and an invoice that is not yet approved or disputed is matched again by itself (otherwise click Re-match). The supplier's code and name for that product are remembered, so the next invoice and the next price list from that supplier match without you. A paid invoice can no longer be changed.
Update Price Button
When a price mismatch is detected, an "Update Price" button appears next to the item. Clicking it:
- Updates the supplier's base price in the supplier price list with the invoice price (quantity prices stay as they are)
- Updates the product cost price with the new price
- Triggers price change alerts if the change exceeds your threshold
Re-matching
If you've updated a purchase order or received new information:
- Open the Match Details modal
- Click the Re-match button (next to "PO Matches" header)
- The system clears old matches and re-runs the matching algorithm
Items Ordered in Packs
An item ordered from Stogly Marketplace in packs and kept on stock in another unit (4 cartons, 12 pieces each) is compared in the product's own unit, whichever way the invoice is written:
- an invoice for 48 pieces at 200.00 and one for 4 cartons at 2,400.00 both match the order;
- quantities and prices in the row carry the unit (48 pcs, 200.00 per pc), with a note such as "Ordered in packs: 1 carton = 12 pcs" and, when the invoice counts packs, "On the invoice: 4 carton × 2,400.00";
- the button reads Update price per pc to 200.00 and writes the price per piece — the unit the product is costed in.
If the price changed a lot, check the "On the invoice" note to see how the line was read.
Creating a PO from an Invoice
If a purchase order was placed by phone/WhatsApp and not recorded in the system:
- Open the Match Details modal for the invoice
- Click "Create PO from Invoice"
- Select the destination Warehouse or Location
- Review the pre-filled items (from the invoice)
- Assign products to any unmatched items
- Click Create PO
- The system creates the PO, marks it as "Received", and automatically matches it
Approving or Disputing an Invoice
After reviewing matches:
- Approve — confirms the invoice is correct and ready for payment
- Dispute — flags the invoice for review (add notes explaining the issue)
- Mark as Paid — records payment completion
Tips
- Set up supplier price lists first — this dramatically improves PDF parsing accuracy
- Use supplier product names and SKUs — the more mapping data you provide, the better the auto-matching
- Re-match after creating POs — if you create a retroactive PO, re-run the match to link it
- Check the notification bell — price changes from "Update Price" trigger alerts if they're significant
Need help? Contact support at support@stogly.com