{"uid":"cap_fqd9TrEzRMwRxAF_notKx","slug":"ardaro-invoice-matching-62b3808a","name":"Ardaro Invoice Matching","description":"Evidence-bounded visibility into publicly discoverable x402 agent services.","url":"https://agents.getardaro.com/v1/invoice-matching/analyze","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"invoice":{"type":"object","allOf":[{"if":{"properties":{"currency":{"const":"JPY"}}},"then":{"properties":{"tax":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?![\\s\\S])","maxLength":26},"total":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?![\\s\\S])","maxLength":26},"subtotal":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?![\\s\\S])","maxLength":26},"line_items":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?![\\s\\S])","maxLength":26}}}}}}}],"required":["currency","line_items","purchase_order_reference","reference","supplier_id"],"properties":{"tax":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?(?![\\s\\S])","maxLength":29},"total":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?(?![\\s\\S])","maxLength":29},"currency":{"enum":["USD","EUR","GBP","CAD","AUD","MXN","JPY"],"type":"string"},"subtotal":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?(?![\\s\\S])","maxLength":29},"reference":{"type":"string","maxLength":80,"minLength":1},"line_items":{"type":"array","items":{"type":"object","required":["description","line_id","quantity","unit","unit_price"],"properties":{"unit":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":32,"minLength":1},"amount":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?(?![\\s\\S])","maxLength":29},"line_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1},"quantity":{"not":{"pattern":"^0(?:\\.0+)?(?![\\s\\S])"},"type":"string","pattern":"^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?(?![\\s\\S])","maxLength":19},"po_line_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1},"unit_price":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?(?![\\s\\S])","maxLength":19},"description":{"type":"string","maxLength":240,"minLength":1},"product_code":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":100,"minItems":1},"supplier_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1},"purchase_order_reference":{"type":"string","maxLength":80,"minLength":1}},"additionalProperties":false},"purchase_order":{"type":"object","allOf":[{"if":{"properties":{"currency":{"const":"JPY"}}},"then":{"properties":{"line_items":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?![\\s\\S])","maxLength":26}}}}}}}],"required":["currency","line_items","reference","supplier_id"],"properties":{"currency":{"enum":["USD","EUR","GBP","CAD","AUD","MXN","JPY"],"type":"string"},"reference":{"type":"string","maxLength":80,"minLength":1},"line_items":{"type":"array","items":{"type":"object","required":["description","line_id","quantity","unit","unit_price"],"properties":{"unit":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":32,"minLength":1},"amount":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?(?![\\s\\S])","maxLength":29},"line_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1},"quantity":{"not":{"pattern":"^0(?:\\.0+)?(?![\\s\\S])"},"type":"string","pattern":"^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?(?![\\s\\S])","maxLength":19},"unit_price":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?(?![\\s\\S])","maxLength":19},"description":{"type":"string","maxLength":240,"minLength":1},"product_code":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":100,"minItems":1},"supplier_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*(?![\\s\\S])","maxLength":80,"minLength":1}},"additionalProperties":false},"contract_version":{"const":"ardaro.agent-invoice-matching.request.v1"}}},"responseSchema":{"type":"json","example":{"result":{"policy":{"stateless":true,"model_calls":0,"matching_rule":"explicit_po_line_id_else_unique_case_sensitive_product_code","decision_scope":"No discrepancies means only that the supported checks found none in supplied data. Human review is always required.","quantity_scope":"Only this invoice is counted; prior invoices and deliveries are not checked. Uninvoiced quantity is not evidence of undelivered goods. Uncertain allocation makes affected PO quantities unavailable.","supplier_scope":"Supplier identifiers are caller-supplied matching identifiers; supplier identity and document authenticity are not verified.","arithmetic_scope":"Supplied line amounts and totals are checked using per-line rounding. Tax applicability, discounts, shipping, and alternate rounding policies are not inferred.","identity_purpose":"deterministic_result_comparison_only","human_review_required":true,"raw_documents_retained":false,"payment_approval_supported":false,"financial_posting_performed":false,"financial_posting_supported":false,"delivery_verification_supported":false},"summary":{"outcome":"no_discrepancies","payment_approved":false,"delivery_verified":false,"discrepancy_count":0,"invoice_line_count":1,"unknown_check_count":0,"human_review_required":true,"purchase_order_line_count":1,"matched_invoice_line_count":1,"unmatched_invoice_line_count":0},"arithmetic":{"invoice_tax":"1.40","invoice_total":"21.40","rounding_mode":"ROUND_HALF_UP","rounding_scope":"each_line_then_sum","invoice_subtotal":"20.00","invoice_total_status":"consistent","computed_invoice_total":"21.40","invoice_currency_scale":2,"invoice_line_amount_sum":"20.00","invoice_subtotal_status":"consistent","purchase_order_currency_scale":2,"invoice_supplied_line_amount_sum":"20.00"},"discrepancies":[],"comparison_rows":[{"outcome":"no_discrepancies","invoice_unit":"each","match_method":"explicit_po_line_id","invoice_amount":"20.00","invoice_source":"/invoice/line_items/0","invoice_line_id":"INV-1","invoice_currency":"USD","invoice_quantity":"2","allocation_status":"allocated","discrepancy_codes":[],"invoice_unit_price":"10","purchase_order_unit":"each","purchase_order_source":"/purchase_order/line_items/0","unit_price_difference":"0","line_arithmetic_status":"consistent","purchase_order_line_id":"PO-1","computed_invoice_amount":"20.00","purchase_order_currency":"USD","purchase_order_quantity":"5","purchase_order_unit_price":"10"}],"document_checks":{"currency_matches":true,"supplier_matches":true,"purchase_order_reference_matches":true},"purchase_order_line_summary":[{"unit":"each","status":"partially_invoiced","computed_amount":"50.00","supplied_amount":"50.00","ordered_quantity":"5","allocated_quantity":"2","overbilled_quantity":"0","uninvoiced_quantity":"3","purchase_order_source":"/purchase_order/line_items/0","line_arithmetic_status":"consistent","purchase_order_line_id":"PO-1","allocated_invoice_sources":["/invoice/line_items/0"]}]},"status":"review_required","identities":{"analysis_result_identity":"res_b79ff4e2dbf7e36d1be1c744bbf4678da8068401cb2675857d8e1b41128289fc"},"contract_version":"ardaro.agent-invoice-matching.response.v1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0THGvAvQxbq_GCT21xqUR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares a single invoice against a purchase order line-by-line and returns a structured discrepancy report for human review, without approving payment or posting to financial systems.","exampleAgentPrompt":"Can you check if supplier invoice INV-2024-0891 from supplier S-4421 matches PO PO-2024-3310? The invoice is in USD, has one line item for 10 units of 'Widget A' at $20.00 each (line ID L-001, mapped to PO line PO-L-001), subtotal $200.00, tax $14.00, total $214.00 — flag any discrepancies for my AP team to review.","exampleUseCases":[{"title":"AP discrepancy check before payment","prompt":"Before we send this supplier payment for approval, check if invoice INV-9982 from supplier SUPP-0034 matches PO-7761. The invoice is in EUR, with two line items: line L1 for 5 units of 'Steel Bracket' at €12.50 each (PO line PO-L1), and line L2 for 2 units of 'Bolt Set' at €3.00 each (PO line PO-L2), subtotal €68.50, no tax, total €68.50. Flag anything that doesn't match for my team."},{"title":"Three-way match audit for finance review","prompt":"I need to audit invoice INV-JP-0055 from supplier JP-VENDOR-12 against purchase order PO-JP-2024-009. The invoice is in JPY with one line item: line LN-1 for 100 units of 'Circuit Board' at 500 each, total 50000 yen, no tax. Can you run the invoice-to-PO comparison and give me the discrepancy report?"},{"title":"Automated pre-screening for high-volume AP","prompt":"We just received invoice REF-CA-20240815 from supplier CA-SUPP-77, denominated in CAD. It references PO CA-PO-4401 and has three line items: line A for 8 units of 'Packaging Box' at $4.50 each (PO line PA-01), line B for 12 units of 'Label Sheet' at $1.20 each (PO line PA-02), and line C for 3 units of 'Tape Roll' at $2.00 each (PO line PA-03), subtotal $57.60, tax $4.32, total $61.92. Run the matching analysis so my AP reviewer can decide whether to approve."}],"resultDescription":"Returns a JSON object containing: a policy block (documenting what checks were and were not performed, that human review is always required, and that no payment approval or financial posting occurs), a summary block (overall outcome such as 'no_discrepancies' or 'discrepancies_found', counts of matched/unmatched lines, and unknown checks), an arithmetic block (computed and supplied totals, subtotals, tax, rounding mode), a list of discrepancies (empty if none found), and an array of comparison rows (one per invoice line, showing match method, invoice and PO values, and per-line outcome).","failureModes":["Missing required invoice fields (currency, line_items, reference, supplier_id, purchase_order_reference) returns a validation error","Invalid currency code not in the allowed enum returns a schema error","Line item quantity of zero is rejected by schema validation","Malformed numeric strings (e.g. amounts with more than two decimal places for non-JPY) fail pattern validation","PO line ID references that don't resolve to any PO line result in unmatched invoice lines","Arithmetic inconsistencies between supplied line amounts and totals are surfaced as discrepancies, not errors","Truncated or missing PO data may result in unknown_check outcomes rather than matched/unmatched classification"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, auditable, stateless invoice-to-PO comparison for a single invoice before human AP review — especially when you need documented policy boundaries (no payment approval, no financial posting, no delivery verification) that satisfy compliance requirements. Prefer this over general-purpose LLM analysis when you need reproducible results and explicit discrepancy enumeration. Not suitable for bulk batch processing of many invoices in one call, for payment execution, or for delivery/receipt verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:22.942Z","isFirstParty":false}