{"uid":"cap_EKvrTn6iKZQO-tAd4SCtr","slug":"vrsai-invoice-match-bac15bb8","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/versions/1.0.0/execute","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_0S4LJOjjNQiIZhC14HTRf","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 before approving payment.","exampleAgentPrompt":"Before we approve this supplier invoice for $14,750 from Acme Supplies, run a 3-way match against the related purchase order and goods receipts, and flag any discrepancies or tolerance breaches that would block payment.","exampleUseCases":[{"title":"Block duplicate supplier invoice","prompt":"We received another invoice from GlobalParts Inc. for $8,200 — can you check it against prior invoicing records for the same PO to make sure we haven't already paid this or something very close to it?"},{"title":"Tolerance check before payment run","prompt":"Before we release payment on this $52,000 invoice from TechLogix, validate it against the purchase order and cumulative receipts and tell me whether it's within our 2% tolerance policy or if we need to put it on hold."},{"title":"Three-way match for partial delivery","prompt":"Our warehouse only received part of this order from SteelCo but the invoice is for the full amount — match it against the PO and the partial receipt records and tell me exactly where the discrepancy is."}],"resultDescription":"Returns a match result indicating whether the invoice is approved, rejected, or flagged for review, along with details on any discrepancies found between the invoice, purchase orders, cumulative receipts, and prior invoicing. Includes tolerance policy assessment and specific line-item or amount variances.","failureModes":["Missing or unresolvable PO reference causes match failure","Invoice already fully invoiced — duplicate detected and rejected","Amount exceeds tolerance threshold — returned as flagged rather than approved","Incomplete receipt data prevents cumulative comparison","Malformed invoice body causes validation error","Payment already approved for this invoice — idempotency check triggers warning"],"whenToPreferThis":"Use this endpoint when you need a structured, policy-aware pre-payment validation of supplier invoices that goes beyond simple amount matching — specifically when you need 3-way matching (PO + receipt + invoice), cumulative billing history checks, and tolerance policy enforcement in a single automated step before accounts payable approval.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:29.734Z","isFirstParty":false}