{"uid":"cap_5EG1Bi6qPdQW0976dbhHD","slug":"parcel-charge-audit-abd34064","name":"Parcel Charge Audit","description":"Public static preview plus paid token controls, risk consensus, AI security, webhook reliability, developer security, schedule risk, decision analysis, API release compatibility, accounts-payable reconciliation, e-commerce return eligibility, SaaS subscription-proration, sales-commission reconciliation, parcel-charge reconciliation, SLA service-credit reconciliation, advertising spend-and-fee audit, contract-renewal audit, workforce timecard reconciliation, hotel booking-commission reconciliation, and warehouse cycle-count adjustment reconciliation products for autonomous agents.","url":"https://rooke-token-risk-pilot.rookepoole.workers.dev/v1/x402/parcel-charge-audit","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"policy":{"type":"object","required":["policyId","policyVersion","currency","dimensionalDivisorCubicInchesPerPound","rateBands","additionalHandling","oversize","suppressAdditionalHandlingWhenOversize","residentialFeePerPackageMinor","fuelSurchargeBps","fuelBasis"],"properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"oversize":{"type":"object","required":["enabled","feeMinor","longestSideOverInches","secondLongestSideOverInches","lengthPlusGirthOverInches","actualWeightOverPounds","minimumBillableWeightPounds"],"properties":{"enabled":{"type":"boolean"},"feeMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"longestSideOverInches":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]},"actualWeightOverPounds":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]},"lengthPlusGirthOverInches":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]},"minimumBillableWeightPounds":{"type":"integer","maximum":50000,"exclusiveMinimum":0},"secondLongestSideOverInches":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]}},"additionalProperties":false},"policyId":{"type":"string","maxLength":120,"minLength":1},"fuelBasis":{"enum":["BASE_ONLY","BASE_AND_ACCESSORIALS"],"type":"string"},"rateBands":{"type":"array","items":{"type":"object","required":["upToBillableWeightPounds","baseChargeMinor"],"properties":{"baseChargeMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"upToBillableWeightPounds":{"type":"integer","maximum":50000,"exclusiveMinimum":0}},"additionalProperties":false},"maxItems":500,"minItems":1},"policyVersion":{"type":"string","maxLength":120,"minLength":1},"fuelSurchargeBps":{"type":"integer","maximum":10000,"minimum":0},"additionalHandling":{"type":"object","required":["enabled","feeMinor","longestSideOverInches","secondLongestSideOverInches","lengthPlusGirthOverInches","actualWeightOverPounds"],"properties":{"enabled":{"type":"boolean"},"feeMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"longestSideOverInches":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]},"actualWeightOverPounds":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]},"lengthPlusGirthOverInches":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]},"secondLongestSideOverInches":{"anyOf":[{"type":"integer","maximum":50000,"exclusiveMinimum":0},{"type":"null"}]}},"additionalProperties":false},"residentialFeePerPackageMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"dimensionalDivisorCubicInchesPerPound":{"type":"integer","maximum":50000,"exclusiveMinimum":0},"suppressAdditionalHandlingWhenOversize":{"type":"boolean"}},"additionalProperties":false},"invoice":{"type":"object","required":["invoiceId","observedBaseChargeMinor","observedAdditionalHandlingMinor","observedOversizeMinor","observedResidentialMinor","observedFuelMinor","observedTotalMinor"],"properties":{"invoiceId":{"type":"string","maxLength":120,"minLength":1},"observedFuelMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedTotalMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedOversizeMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedBaseChargeMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedResidentialMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedAdditionalHandlingMinor":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false},"shipment":{"type":"object","required":["shipmentId","residential","packages"],"properties":{"packages":{"type":"array","items":{"type":"object","required":["packageId","lengthMilliInches","widthMilliInches","heightMilliInches","actualWeightMilliPounds"],"properties":{"packageId":{"type":"string","maxLength":120,"minLength":1},"widthMilliInches":{"type":"integer","maximum":300000,"exclusiveMinimum":0},"heightMilliInches":{"type":"integer","maximum":300000,"exclusiveMinimum":0},"lengthMilliInches":{"type":"integer","maximum":300000,"exclusiveMinimum":0},"actualWeightMilliPounds":{"type":"integer","maximum":500000,"exclusiveMinimum":0}},"additionalProperties":false},"maxItems":100,"minItems":1},"shipmentId":{"type":"string","maxLength":120,"minLength":1},"residential":{"type":"boolean"}},"additionalProperties":false},"auditPolicy":{"type":"object","required":["toleranceMinor"],"properties":{"toleranceMinor":{"type":"integer","maximum":1000000,"minimum":0}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"policy":{"currency":"USD","policyId":"CARRIER-CONTRACT-42","fuelBasis":"BASE_AND_ACCESSORIALS","policyVersion":"2026-07","fuelSurchargeBps":1000,"dimensionalDivisorCubicInchesPerPound":139},"summary":{"packageCount":1,"toleranceMinor":0,"oversizePackageCount":0,"residentialPackageCount":1,"dimensionalWeightPackageCount":1,"additionalHandlingPackageCount":0},"verdict":"MATCHED_WITHIN_TOLERANCE","expected":{"fuelMinor":360,"totalMinor":3960,"oversizeMinor":0,"baseChargeMinor":3000,"residentialMinor":600,"additionalHandlingMinor":0},"observed":{"fuelMinor":360,"totalMinor":3960,"oversizeMinor":0,"baseChargeMinor":3000,"residentialMinor":600,"additionalHandlingMinor":0},"invoiceId":"INV-42","riskFlags":["DIMENSIONAL_WEIGHT_CONTROLS_BILLABLE_WEIGHT"],"variances":{"fuelMinor":0,"totalMinor":0,"oversizeMinor":0,"baseChargeMinor":0,"residentialMinor":0,"additionalHandlingMinor":0,"observedArithmeticMinor":0},"reportHash":"sha256-hex","shipmentId":"SHIP-42","evidenceGaps":["CALLER_SUPPLIED_POLICY_MEASUREMENTS_AND_INVOICE_FACTS_NOT_AUTHENTICATED"],"claimBoundary":{"fundsMoved":false,"disputeFiled":false,"invoiceApproved":false,"paymentAttempted":false,"carrierOrRateApiCalled":false},"schemaVersion":"PARCEL_CHARGE_AUDIT_V1","packageResults":[],"requestCommitment":"sha256-hex","recommendedDisposition":"MATCHED_NO_ACTION"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"9","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":"$9/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"9","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"9","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hNsUnMeDQZHN9Gz051XwW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"9","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates carrier parcel invoice charges against a caller-supplied rate policy, identifying billing discrepancies, oversize/additional-handling errors, fuel surcharge miscalculations, and dimensional-weight issues across shipment packages.","exampleAgentPrompt":"Audit this carrier invoice INV-42 for shipment SHIP-42 against our contract policy CARRIER-CONTRACT-42 (version 2026-07): USD currency, dimensional divisor 139, fuel surcharge 1000 bps applied to base and accessorials, with residential fee and the rate bands I'll provide — tell me if the charges match, flag any oversize or dimensional-weight issues, and give me a recommended disposition.","exampleUseCases":[{"title":"Pre-payment invoice approval check","prompt":"Before I approve payment on carrier invoice INV-99 for shipment SHIP-99, audit it against our rate policy CONTRACT-FEDEX-2026 version 2026-Q3 — USD, dimensional divisor 139, fuel surcharge 850 bps on base only, and our standard rate bands. Tell me if the billed amount matches what we expect and flag any risk issues."},{"title":"Oversize surcharge dispute investigation","prompt":"Our carrier billed us an oversize fee on invoice INV-7 for shipment SHIP-7 and I think it was wrongly applied. Validate it against policy CARRIER-UPS-STD version 2025-12 with USD currency, dimensional divisor 166, fuel surcharge 950 bps on base and accessorials, and the oversize thresholds in our contract. Tell me if the fee was legitimate and whether I have grounds to dispute."},{"title":"Post-delivery residential surcharge reconciliation","prompt":"Reconcile the residential delivery surcharges on carrier invoice INV-201 for shipment SHIP-201 against our rate policy GROUND-CONTRACT-A version 2026-01 — USD, dimensional divisor 139, fuel surcharge 1100 bps applied to base only, with our residential fee per package. Show me expected vs observed charges and any variances."}],"resultDescription":"Returns a structured audit report including: a MATCHED_WITHIN_TOLERANCE or discrepancy verdict, expected vs observed charge breakdowns (base, fuel, oversize, residential, additional handling), per-field variance amounts, risk flags (e.g. DIMENSIONAL_WEIGHT_CONTROLS_BILLABLE_WEIGHT), evidence gaps, claim boundary status (whether funds have moved or dispute filed), a recommended disposition, and a SHA-256 report hash for audit trail purposes.","failureModes":["Invalid or missing policy fields cause 400 validation errors","Rate bands array empty or malformed causes rejection","Currency code not matching ISO 4217 three-letter format","Oversize or additional handling threshold values out of allowed range","Package dimension or weight data inconsistent with policy rules","Fuel surcharge basis points exceed 10000 cap","Payment of $9 USDC not received results in 402 Payment Required","Caller-supplied policy measurements are not authenticated — flagged as evidence gap"],"whenToPreferThis":"Use this endpoint when you need to programmatically audit a parcel carrier invoice against a known rate contract before approving payment or filing a dispute. It is purpose-built for parcel charge reconciliation with explicit support for dimensional weight, oversize surcharges, additional handling fees, residential fees, and fuel surcharges — making it more precise than a generic computation or document-comparison service. Prefer it when you have structured policy data (rate bands, thresholds, fuel basis) and want a deterministic verdict with variance detail and a claim boundary status.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:00.273Z","isFirstParty":false}