{"uid":"cap_2_2B6hdOc80TfFsgQ_WEh","slug":"hotel-booking-commission-audit-29cbcff7","name":"Hotel Booking Commission 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/hotel-booking-commission-audit","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"agreement":{"type":"object","required":["agreementId","agreementVersion","bookingSourceRef","currency","calculationMode","rateBps","flatAmountMinor","commissionTaxWithheldBps","canceledReservationCommissionEligible","noShowReservationCommissionEligible"],"properties":{"rateBps":{"type":"integer","maximum":100000,"minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"agreementId":{"type":"string","maxLength":120,"minLength":1},"calculationMode":{"enum":["PERCENT_OF_ELIGIBLE_REVENUE","FLAT_PER_NIGHT","FLAT_PER_STAY"],"type":"string"},"flatAmountMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"agreementVersion":{"type":"string","maxLength":120,"minLength":1},"bookingSourceRef":{"type":"string","maxLength":120,"minLength":1},"commissionTaxWithheldBps":{"type":"integer","maximum":100000,"minimum":0},"noShowReservationCommissionEligible":{"type":"boolean"},"canceledReservationCommissionEligible":{"type":"boolean"}},"additionalProperties":false},"auditPolicy":{"type":"object","required":["amountToleranceMinor"],"properties":{"amountToleranceMinor":{"type":"integer","maximum":1000000,"minimum":0}},"additionalProperties":false},"reservation":{"type":"object","required":["reservationRef","status","arrivalDate","departureDate","nights","revenueLines","prepaidCommissionMinor"],"properties":{"nights":{"type":"integer","maximum":365,"exclusiveMinimum":0},"status":{"enum":["CHECKED_OUT","CANCELED","NO_SHOW"],"type":"string"},"arrivalDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"revenueLines":{"type":"array","items":{"type":"object","required":["lineId","category","amountMinor","commissionEligible"],"properties":{"lineId":{"type":"string","maxLength":120,"minLength":1},"category":{"type":"string","maxLength":120,"minLength":1},"amountMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"commissionEligible":{"type":"boolean"}},"additionalProperties":false},"maxItems":1000},"departureDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"reservationRef":{"type":"string","maxLength":120,"minLength":1},"prepaidCommissionMinor":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false},"commissionStatement":{"type":"object","required":["statementId","observedCommissionableRevenueMinor","observedGrossCommissionMinor","observedCommissionTaxWithheldMinor","observedPrepaidCommissionMinor","observedNetCommissionDueMinor"],"properties":{"statementId":{"type":"string","maxLength":120,"minLength":1},"observedGrossCommissionMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedNetCommissionDueMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedPrepaidCommissionMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedCommissionTaxWithheldMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedCommissionableRevenueMinor":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"verdict":"MATCHED_WITHIN_TOLERANCE","expected":{"expectedGrossCommissionMinor":3500,"expectedNetCommissionDueMinor":2650,"expectedCommissionTaxWithheldMinor":350,"expectedCommissionableRevenueMinor":35000,"expectedPrepaidCommissionAppliedMinor":500},"observed":{"observedGrossCommissionMinor":3500,"observedNetCommissionDueMinor":2650,"observedPrepaidCommissionMinor":500,"observedCommissionTaxWithheldMinor":350,"observedCommissionableRevenueMinor":35000},"variance":{"commissionTaxVarianceMinor":0,"netCommissionVarianceMinor":0,"grossCommissionVarianceMinor":0,"prepaidCommissionVarianceMinor":0,"statementArithmeticVarianceMinor":0,"commissionableRevenueVarianceMinor":0},"agreement":{"rateBps":1000,"currency":"USD","agreementId":"HOTEL-AGREEMENT-42","calculationMode":"PERCENT_OF_ELIGIBLE_REVENUE","flatAmountMinor":0,"agreementVersion":"2026-07","bookingSourceRef":"opaque-source-9","commissionTaxWithheldBps":1000},"riskFlags":["PREPAID_COMMISSION_PRESENT"],"reportHash":"sha256-hex","reservation":{"nights":3,"status":"CHECKED_OUT","arrivalDate":"2026-08-03","departureDate":"2026-08-06","reservationRef":"opaque-reservation-42","statusCommissionEligible":true},"statementId":"COMMISSION-42","evidenceGaps":["CALLER_SUPPLIED_AGREEMENT_RESERVATION_REVENUE_AND_STATEMENT_FACTS_NOT_AUTHENTICATED"],"revenueLines":[],"claimBoundary":{"fundsMoved":false,"paymentAttempted":false,"taxTreatmentOrJurisdictionRuleDetermined":false,"commissionPaymentApprovedHeldVoidedOrReleased":false,"propertyBookingSourceOrPaymentSystemConnected":false,"commissionEligibilityOrLegalEntitlementDetermined":false},"schemaVersion":"HOTEL_BOOKING_COMMISSION_AUDIT_V1","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_l3bcZShPOe09DjpWdnoAA","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":"Audits hotel booking commission statements by computing expected commission amounts against observed statement values and flagging discrepancies, risk factors, and eligibility issues.","exampleAgentPrompt":"Audit the commission statement COMMISSION-42 for reservation RES-99 (CHECKED_OUT, 3 nights, arrival 2026-08-03, departure 2026-08-06) under agreement HOTEL-AGREEMENT-42 version 2026-07 with booking source OTA-DIRECT, calculated as PERCENT_OF_ELIGIBLE_REVENUE at 1000 bps with 1000 bps tax withheld — revenue lines include a $350 room charge (commission-eligible) and a $50 F&B charge (not eligible), prepaid commission of $5.00 already applied, and observed net commission of $26.50; use a tolerance of 100 minor units and tell me whether the statement matches, what the variance is, and any risk flags.","exampleUseCases":[{"title":"OTA commission overbilling detection","prompt":"We received a commission invoice from our OTA for reservation BOOK-7781, which checked out on 2026-07-15 (2 nights, arrival 2026-07-13, departure 2026-07-15). Our agreement AGR-55 version 2026-Q3 uses PERCENT_OF_ELIGIBLE_REVENUE at 1200 bps with 800 bps tax withheld. Revenue lines are a $200 room rate (eligible) and $30 parking (not eligible). No prepaid commission. The OTA billed us $29.00 gross. Can you audit this against our agreement with a 50-unit tolerance and tell me if they overbilled us and by how much?"},{"title":"Flat-per-night commission reconciliation","prompt":"Please audit commission statement STMT-2209 for reservation RES-442 under agreement CORP-HOTEL-7 version 2025-12 with booking source CORPTRAVEL. The agreement is FLAT_PER_NIGHT at 1500 minor units per night, 0 bps tax withheld. The guest stayed 4 nights (arrival 2026-09-01, departure 2026-09-05, status CHECKED_OUT), with revenue lines for room only ($600 total, eligible). No prepaid commission. Statement shows $60.00 net commission due. Use a 100-unit tolerance and flag any discrepancy."},{"title":"Canceled reservation commission eligibility check","prompt":"Our agreement AGMT-330 version 2026-01 with source LEISURE-OTA says canceled reservations ARE commission-eligible at 500 bps, 0 tax withheld, PERCENT_OF_ELIGIBLE_REVENUE. Reservation RES-998 was CANCELED — it had 1 night booked (arrival 2026-10-10, departure 2026-10-11) with a $120 room charge (eligible). The statement STMT-998 shows $6.00 commission billed. Audit this with 25-unit tolerance and confirm whether the commission is legitimate and matches our agreement."}],"resultDescription":"Returns a JSON object with: a verdict (e.g. MATCHED_WITHIN_TOLERANCE, VARIANCE_DETECTED), expected and observed commission breakdowns (gross, net, tax withheld, commissionable revenue, prepaid applied) in minor currency units, per-line variance figures, a list of risk flags (e.g. PREPAID_COMMISSION_PRESENT), a recommended disposition (e.g. MATCHED_NO_ACTION, ESCALATE_FOR_REVIEW), evidence gap warnings, a claim boundary summary indicating what financial actions have or have not been authorized, and a SHA-256 report hash for audit trail integrity.","failureModes":["Invalid or missing required agreement fields returns 400 validation error","rateBps or commissionTaxWithheldBps out of range (>100000) causes schema rejection","Revenue line amountMinor exceeds safe integer maximum","Reservation status not in allowed enum (CHECKED_OUT, CANCELED, NO_SHOW) causes rejection","arrivalDate/departureDate not in YYYY-MM-DD format causes pattern validation failure","nights value inconsistent with arrival/departure dates may produce unexpected variance","Payment failure (x402) if USDC balance insufficient for $9 fee","Timeout or 5xx from Cloudflare Worker under load"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, auditable computation of whether a hotel booking commission statement matches a contractual agreement — particularly when you have structured revenue line data, a known agreement rate or flat amount, and a recorded observed statement value. It is preferable over manual reconciliation or generic LLM-based analysis because it returns cryptographically hashed audit reports, explicit risk flags, claim boundary metadata, and a machine-readable verdict suitable for straight-through processing or escalation workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:31:55.625Z","isFirstParty":false}