Skip to main content
📢 Looking to add e-invoicing support for France? We've partnered with Ecosio to extend coverage there. This is an upgrade to your current e-invoicing subscription — contact your Account Manager to get started.

3-Way Matching not working as expected in ZoneCapture

Issue

You configured and enabled 3-Way Matching in ZoneCapture. However, a Vendor Bill does not match, flags a variance, or behaves differently than you expect. This article covers the most common scenarios, grouped by what you see.

Solution

Most 3-Way Matching differences trace back to the configuration level that applies to the affected item or vendor, or to the NetSuite preferences that control billing and receiving. Start with the configuration hierarchy, then find the scenario below that matches what you see.

Check the configuration hierarchy first

ZoneCapture reads 3-Way Matching settings from several configuration levels. For settings that support overrides, ZoneCapture checks the levels in this order:

Item > Vendor > Subsidiary Setup > Main Configuration

The most specific applicable configuration takes precedence. The Main Configuration acts as the fallback when no more specific value exists.

Check the hierarchy first when you troubleshoot tolerances or any setting you can configure at multiple levels. A value set for a specific item or vendor produces a different result than the default in Subsidiary Setup or Main Configuration.

3-Way Matching does not run

Verify that Enable 3-Way Matching is selected in the applicable configuration.

If 3-Way Matching is enabled but does not run for a specific Vendor Bill, confirm that the related Purchase Order (PO) and Vendor Bill meet the requirements for 3-Way Matching.

Vendor Bill cannot be processed because the PO is not ready

The Block Processing PO Not Ready setting prevents processing when the PO has not reached a status that allows billing.

  1. Open the PO and check its status.
  2. Resolve the PO status or the receiving requirements.
  3. Process the Vendor Bill again.

Vendor Bill does not save and asks for an acceptance reason

If Enforce 3-Way Matching on Save is enabled, ZoneCapture requires an acceptance reason when it detects a variance outside the configured tolerance. Without a reason, you cannot save the Vendor Bill.

If the notification asks for an acceptance reason but the Vendor Bill has no field to enter it, the Acceptance Reason (ZC 3-way match) field is hidden on the Vendor Bill form. To show the field:

  1. Go to Customization > Forms > Transaction Forms.
  2. Edit the Vendor Bill form you use.
  3. Under Screen Fields, locate the ZoneCapture: 3 Way Matching section.
  4. Set Acceptance Reason (ZC 3-way match) to Show.
  5. Click Save.

You can now enter the acceptance reason directly on the Vendor Bill when a variance requires approval.

The 3-Way Matching popup is read-only or unavailable

After a Vendor Bill is approved or posted, some 3-Way Matching actions become unavailable. The popup can be read-only, or 3-Way Matching can be unavailable for the transaction.

  1. Check the Vendor Bill status.
  2. If the status is Approved or Posted, determine whether NetSuite still allows you to edit the transaction.
  3. If you need to change the matching result, return the bill to an editable status according to your NetSuite approval and accounting workflow.

Notification "There are changes made in 3-way match that will be discarded"

This warning appears when you close or cancel the 3-Way Matching popup after making changes you have not yet submitted to the Vendor Bill. Changes include:

  • Connecting or disconnecting lines,
  • Editing a quantity or rate,
  • Adding or removing a line,
  • Changing an item or account, and
  • Changing a grouped line.
  • To keep the changes, click Return to 3-way match, and then click Submit.
  • To discard the changes, click Proceed and discard changes.

A bill line is not matched to a PO line

An invoice line stays unmatched when ZoneCapture cannot confidently connect it to a PO line. Common reasons include:

  • The invoice line does not correspond to a PO line,
  • The invoice and the PO use different item or description information,
  • The invoice contains multiple lines that represent 1 PO line,
  • The invoice relates to multiple POs,
  • The captured PDF line structure differs from the PO structure, or
  • ZoneCapture automatically grouped the line and you need to split it again.
  1. Compare the PO lines and the bill lines side by side in the popup.
  2. Click Hide Matched Lines to focus on unresolved lines.
  3. If the correct relationship is clear, drag and drop to connect the lines manually.

You can also click Bill All Unmatched Lines to add all currently unmatched PO lines to the Vendor Bill automatically.

An item does not match the expected PO item

If a bill line represents the same product or service as a PO line but does not match, compare the item information on both sides. Check whether:

  • The invoice uses a different item identifier or description,
  • The PO contains multiple similar items,
  • The captured invoice line represents several PO lines, and
  • ZoneCapture grouped the line with another captured line.

If you know the correct PO relationship, connect the lines manually in the 3-Way Matching popup.

The unit of measure does not match

If the invoice and the PO refer to the same item but ZoneCapture flags the quantity, check whether they use the same unit of measure. Compare the unit on:

  • The PO line,
  • The Vendor Bill line, and
  • The item record.

A difference in units makes the quantities appear different even when the underlying quantities are equivalent. If the units represent the same quantity, verify the item's unit configuration and the values on the PO and the Vendor Bill.

The quantity looks correct, but ZoneCapture still flags the line

ZoneCapture compares the PO, receipt, and bill quantities according to the configured matching logic, so a quantity that looks correct on the invoice can still produce a difference. Check the following:

  • Purchased quantity,
  • Received quantity,
  • Billed quantity,
  • Remaining billable quantity,
  • The Vendor Bill in Advance of Receipt setting,
  • Any configured maximum billable quantity, and
  • The applicable quantity tolerance.

Hover over the highlighted value in the popup to see the specific difference ZoneCapture detected.

ZoneCapture flags a quantity even though you received the goods

The result depends on how you configured Vendor Bill in Advance of Receipt.

  • When the setting is enabled, the available billable quantity depends on the purchased quantity and the previously billed quantity.
  • When the setting is disabled, the received quantity determines what you can bill.
  1. Go to Setup > Accounting > Accounting Preferences > Order Management > Receiving.
  2. Check Vendor Bill in Advance of Receipt.
  3. Compare the purchased, received, and billed quantities in the 3-Way Matching popup.

A PO line is already billed or has less quantity available than expected

A PO line stays visible even when you have already billed some or all of its quantity. Before you add or match the line, check the PO quantities and the amount already billed. The remaining billable quantity can be lower than the original PO quantity.

If the available quantity is 0, the line is fully billed. Do not bill it again.

If the available quantity is lower than expected, check whether:

  • Another Vendor Bill already used part of the quantity,
  • You partially received the quantity,
  • Vendor Bill in Advance of Receipt is disabled, and
  • A maximum billable quantity is configured.

The invoice contains multiple POs and the lines do not match as expected

When a Vendor Bill connects to multiple POs, check the Purchase Orders section in the 3-Way Matching popup to confirm which POs are connected. If a bill line matches the wrong PO line, or a line stays unmatched:

  1. Review the connected POs and their line items.
  2. Click Hide Matched Lines to focus on the remaining unmatched lines.
  3. Disconnect any incorrect match.
  4. Drag and drop to connect the correct PO and bill lines.

If the invoice structure does not correspond to individual PO lines, consider using Total Header Matching for that vendor or process.

The invoice has several lines, but ZoneCapture groups them into 1 line

ZoneCapture automatically groups equal captured PDF lines into a single line. Grouping helps when a vendor invoices the same PO item on multiple invoice lines, but the grouping does not always match the PO structure. If a grouped line prevents the expected matching:

  1. Open the grouped line using its drill-down option.
  2. Review the individual captured PDF lines in the group.
  3. Click Undo Grouping.
  4. Match each individual line to the appropriate PO line.

Keep grouping only when several invoice lines genuinely represent the same PO line. Otherwise, undo the grouping before you match.

ZoneCapture flags the rate even though the PO and the Vendor Bill show the same rate

The rate in the Purchase Order section follows native NetSuite behavior. By default, NetSuite uses the rate from the Item Receipt instead of the original PO line rate.

  1. Go to Setup > Accounting > Accounting Preferences > Order Management > Receiving.
  2. Select the Use Purchase Order Rate On Bill checkbox.
  3. Click Save.
  4. Check the rate again in the 3-Way Matching popup.

A quantity, rate, or amount is outside the expected tolerance

Identify which value causes the difference: Quantity, Rate, or Amount. Then check the tolerance configuration that applies to that value. ZoneCapture reads tolerances from these levels, and the most specific applicable configuration takes precedence:

Item > Vendor > Subsidiary Setup > Main Configuration

Next, check whether you configured the tolerance as a percentage or a fixed amount.

Finally, check which behavior you selected: Threshold Settings Prevail, Purchase Order Data Prevails, or Captured Data Prevails. These settings control how ZoneCapture handles differences. Do not treat them as interchangeable tolerance settings.

💡 Tip: After you save the bill, use the 3-Way Matching Summary to verify which tolerance configuration ZoneCapture applied.

ZoneCapture uses the PO value instead of the captured invoice value, or the reverse

When captured invoice data differs from PO data, the selected setting determines which source ZoneCapture uses. Identify which configuration level applies to the affected line (Item, Vendor, Subsidiary Setup, or Main Configuration), and then check which option you selected:

  • Purchase Order Data Prevails: ZoneCapture uses the PO value.
  • Captured Data Prevails: ZoneCapture uses the captured invoice value.
  • Threshold Settings Prevail: ZoneCapture uses the configured threshold to decide whether the difference is acceptable.

The Tolerance column is blank in the 3-Way Matching Summary

If the 3-Way Matching Summary shows no tolerance type, ZoneCapture found no applicable tolerance configuration for that line. Check the tolerance configuration at each level:

Item > Vendor > Subsidiary Setup > Main Configuration

Configure an applicable quantity, rate, or amount tolerance at the level you intend to act as the fallback.

The invoice total matches, but individual lines do not

By default, 3-Way Matching operates at the line level and compares each invoice line against the corresponding PO line. If the vendor's invoice structure does not match the PO structure, line-level matching produces differences even when the invoice total is correct. For example, the vendor sends 1 summary line while the PO contains several detailed lines.

In this situation, use Total Header Matching. ZoneCapture then compares the invoice total against the PO's total billable amount instead of requiring each invoice line to match the PO line structure.

Lines remain highlighted blue after matching

Blue highlighting marks PO lines that are not currently matched to a Vendor Bill line. This behavior is expected and does not prevent you from saving the Vendor Bill.

If a line needs billing, connect it to the appropriate invoice line or add it to the Vendor Bill. ZoneCapture updates the highlighting once the line matches.

If you do not need blue highlighting, select Disable Coloring of Not Matched Vendor Bill Lines in the 3-Way Matching settings.

The Item Receipt section is missing

ZoneCapture displays the Item Receipt section when the connected PO lines have corresponding Item Receipt data. If the section is missing, check whether any Item Receipts exist for the connected PO lines. Without connected Item Receipts, ZoneCapture has no receipt data to display.

The Receipt Number column is missing

If receipt information is available but the receipt number is not, select Show Item Receipt Number in the relevant 3-Way Matching configuration.

The 3-Way Matching Summary is missing from the Vendor Bill

ZoneCapture does not display the 3-Way Matching Summary on Vendor Bill forms by default. If the feature is enabled but the Summary is missing:

  1. Go to Customization > Forms > Sublists.
  2. Confirm that you added ZC 3-Way Matching Summary Results to the Vendor Bill transaction type.
  3. Open the Vendor Bill form and confirm that it shows the ZoneCapture: 3 Way Matching subtab and the Summary sublist.
  4. Confirm that the user's role has permission to view the 3-Way Matching Summary.

The 3-Way Matching popup is slow on large or multi-PO bills

The popup processes and displays PO lines, receipt information, captured invoice lines, and matching results. Bills with many lines or multiple POs take longer to load and respond. For high-volume processes:

  • Use Total Header Matching when the vendor's invoice structure does not require line-level matching,
  • Disable line coloring if users do not need it,
  • Use Bill All Unmatched Lines instead of connecting many lines one by one, and
  • Review whether the Vendor Bill connects to unnecessary POs or PO lines.

If the popup stays unusually slow on a specific transaction, collect the Vendor Bill number, the number of PO lines, the number of connected POs, and any error message, and then contact Support.

Why this happens

3-Way Matching combines ZoneCapture settings that you can override at 4 levels with native NetSuite receiving and billing preferences. A result that looks wrong usually means a more specific setting overrides the default you expect, or a NetSuite preference changes which quantity or rate ZoneCapture compares.

Related to

Was this article helpful?