{"uid":"cap_exGdAGNfR2YNcBTeAMf1q","slug":"vrsai-invoice-match-d6204aba","name":"vrsai Invoice Match","description":"Match a supplier invoice against purchase orders, cumulative receipts, prior invoicing, and tolerance policy before payment approval.","url":"https://api.vrsai.tech/v1/capabilities/invoice_match?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"checks":[{"id":"duplicate_invoice_number","status":"PASS","evidence":{"duplicate_scope":"supplier_id+invoice_number","duplicate_history_supplied":false}},{"id":"prior_invoicing_evidence","status":"PASS"},{"id":"receipt_evidence_snapshot","status":"PASS"},{"id":"invoice_subtotal_arithmetic","status":"PASS","evidence":{"computed_subtotal_minor":"42000","declared_subtotal_minor":"42000"}},{"id":"invoice_total_arithmetic","status":"PASS","evidence":{"computed_total_minor":"42000","declared_total_minor":"42000"}},{"id":"invoice_line_po_resolution","status":"PASS","invoice_line_id":"line_1"},{"id":"currency_match","status":"PASS","purchase_order_id":"PO-1001"},{"id":"supplier_match","status":"PASS","purchase_order_id":"PO-1001"},{"id":"unit_of_measure_match","status":"PASS","evidence":{"po_unit_of_measure":"EA","invoice_unit_of_measure":"EA"},"po_line_id":"10","invoice_line_id":"line_1","purchase_order_id":"PO-1001"},{"id":"price_basis_match","status":"PASS","po_line_id":"10","invoice_line_id":"line_1","purchase_order_id":"PO-1001"},{"id":"cumulative_quantity_vs_ordered","status":"PASS","po_line_id":"10","purchase_order_id":"PO-1001"},{"id":"cumulative_quantity_vs_received","status":"PASS","evidence":{"cumulative_invoiced":"10","cumulative_received":"10"},"po_line_id":"10","purchase_order_id":"PO-1001"},{"id":"unit_price_tolerance","status":"BLOCK","evidence":{"tolerance_bps":200,"po_unit_price_minor":"4000","invoice_unit_price_minor":"4200"},"po_line_id":"10","reason_code":"UNIT_PRICE_OUTSIDE_TOLERANCE","invoice_line_id":"line_1","purchase_order_id":"PO-1001"},{"id":"line_total_arithmetic","status":"PASS","po_line_id":"10","invoice_line_id":"line_1","purchase_order_id":"PO-1001"}],"totals":{"computed_total_minor":"42000","declared_total_minor":"42000","computed_subtotal_minor":"42000","declared_subtotal_minor":"42000"},"invoice":{"id":"inv_internal_883","currency":"EUR","supplier_id":"supplier_123","invoice_number":"INV-883","lines_evaluated":1,"purchase_orders_referenced":["PO-1001"]},"coverage":{"evidence":{"receipts_complete":true,"prior_invoicing_complete":true,"duplicate_history_supplied":false},"match_mode":"three_way","checks_performed":["duplicate_invoice_number","invoice_line_po_resolution","currency_and_supplier_match","unit_of_measure_and_price_basis","cumulative_quantity_vs_ordered","cumulative_quantity_vs_received","unit_price_tolerance","line_total_arithmetic","invoice_subtotal_arithmetic","invoice_total_arithmetic"],"checks_not_performed":["document_authenticity_verification","ocr_or_pdf_extraction","product_description_or_sku_fuzzy_matching","erp_or_wms_retrieval","supplier_identity_verification","tax_determination","fx_conversion","uom_conversion","payment_execution","accounting_posting","invoice_line_multi_po_allocation","credit_note_processing"],"complete_for_declared_scope":true},"decision":"BLOCK","line_results":[{"units":{"po_unit_of_measure":"EA","invoice_unit_of_measure":"EA","po_price_basis_quantity":"1","invoice_price_basis_quantity":"1"},"pricing":{"tolerance_bps":200,"po_unit_price_minor":"4000","absolute_delta_minor":"200","invoice_unit_price_minor":"4200"},"decision":"BLOCK","quantity":{"ordered":"10","current_invoiced":"10","cumulative_invoiced":"10","cumulative_received":"10","previously_invoiced":"0","remaining_order_after_current":"0","remaining_received_after_current":"0"},"po_line_id":"10","reason_codes":["UNIT_PRICE_OUTSIDE_TOLERANCE"],"invoice_line_id":"line_1","purchase_order_id":"PO-1001"}],"reason_codes":["UNIT_PRICE_OUTSIDE_TOLERANCE"],"machine_action":"DO_NOT_APPROVE","ruleset_version":"1.0.0","input_fingerprint":"v1:2c0e0b727e0602244be927bc4215abff15a0323e44cc73ebe781b9860aabf71d"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hQxBo9OUvcIFdU0gt4Bu2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a supplier invoice against purchase orders, cumulative receipts, prior invoicing history, and tolerance policy to determine payment approval readiness.","exampleAgentPrompt":"Before we approve payment on invoice INV-883 from supplier_123 for EUR 420.00, run an invoice match check against PO-1001 — I need to know if the unit prices, quantities, and cumulative receipts all pass, or if anything is blocked by our tolerance policy.","exampleUseCases":[{"title":"Pre-payment invoice approval gate","prompt":"We just received invoice INV-2047 from supplier_456 for $15,000 against PO-5500. Before we release payment, check it against our purchase order, the goods receipts we have on file, and flag anything outside our 2% price tolerance."},{"title":"Duplicate invoice detection","prompt":"Supplier Acme Corp sent us what looks like a second copy of invoice INV-883. Run an invoice match on it to confirm whether it's a duplicate and whether we've already invoiced against those PO lines before."},{"title":"Quantity and price compliance check","prompt":"We received an invoice from our parts supplier — PO line 10 was for 10 units at $40 each but they billed 10 units at $42. Can you run the invoice match to see if that price difference is within our tolerance or if it should be blocked?"}],"resultDescription":"Returns a list of named checks (e.g. duplicate_invoice_number, unit_price_tolerance, cumulative_quantity_vs_received) each with a PASS or BLOCK status, supporting evidence (computed vs declared values, tolerance thresholds, PO and invoice line references), plus a summary of invoice totals and metadata. BLOCK status on any check indicates the invoice should not proceed to payment without review.","failureModes":["Missing required PO data causes resolution failure on invoice_line_po_resolution check","Currency mismatch between invoice and PO triggers currency_match BLOCK","Unit price outside configured tolerance basis points results in UNIT_PRICE_OUTSIDE_TOLERANCE BLOCK","Duplicate invoice number detected within same supplier scope returns duplicate_invoice_number BLOCK","Cumulative invoiced quantity exceeds ordered or received quantity triggers BLOCK on respective checks","Arithmetic errors in submitted invoice subtotal or total result in arithmetic check BLOCK"],"whenToPreferThis":"Use this endpoint when you need automated three-way matching (invoice vs PO vs goods receipt) with configurable price tolerance enforcement before approving supplier payments. Prefer this over manual review when processing high volumes of invoices, when you need a structured audit trail of pass/block decisions per check, or when you want to catch duplicates, quantity overruns, and price discrepancies programmatically in an accounts payable workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T04:06:54.281Z","isFirstParty":false,"canonicalSlug":"vrsai-invoice-match-bac15bb8"}