{"uid":"cap_XEpv97Lkz-vMGpcs1HVly","slug":"workforce-timecard-audit-43e294ae","name":"Workforce Timecard 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/workforce-timecard-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"worker":{"type":"object","required":["workerRef","recordVersion","currency","payPeriodStartDate","payPeriodEndDate","workweekStartsOn","regularRateMinor"],"properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"workerRef":{"type":"string","maxLength":120,"minLength":1},"recordVersion":{"type":"string","maxLength":120,"minLength":1},"payPeriodEndDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"regularRateMinor":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"workweekStartsOn":{"enum":["SUNDAY","MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY"],"type":"string"},"payPeriodStartDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false},"timecard":{"type":"object","required":["timecardId","entries"],"properties":{"entries":{"type":"array","items":{"type":"object","required":["date","paidMinutes","source"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"source":{"enum":["CLOCK","MANUAL","IMPORT"],"type":"string"},"paidMinutes":{"type":"integer","maximum":1440,"minimum":0}},"additionalProperties":false},"maxItems":366,"minItems":1},"timecardId":{"type":"string","maxLength":120,"minLength":1}},"additionalProperties":false},"suppliedPolicy":{"type":"object","required":["regularMinutesPerWorkweek","overtimeMultiplierBps","amountToleranceMinor","minuteTolerance"],"properties":{"minuteTolerance":{"type":"integer","maximum":1440,"minimum":0},"amountToleranceMinor":{"type":"integer","maximum":1000000,"minimum":0},"overtimeMultiplierBps":{"type":"integer","maximum":100000,"minimum":10000},"regularMinutesPerWorkweek":{"type":"integer","maximum":10080,"exclusiveMinimum":0}},"additionalProperties":false},"payrollStatement":{"type":"object","required":["statementId","observedRegularMinutes","observedOvertimeMinutes","observedRegularPayMinor","observedOvertimePayMinor","observedGrossPayMinor"],"properties":{"statementId":{"type":"string","maxLength":120,"minLength":1},"observedGrossPayMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedRegularMinutes":{"type":"integer","maximum":1000000,"minimum":0},"observedOvertimeMinutes":{"type":"integer","maximum":1000000,"minimum":0},"observedRegularPayMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"observedOvertimePayMinor":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"worker":{"currency":"USD","workerRef":"opaque-worker-42","recordVersion":"payroll-import-7","payPeriodEndDate":"2026-08-16","regularRateMinor":2000,"workweekStartsOn":"MONDAY","payPeriodStartDate":"2026-08-03"},"verdict":"MATCHED_WITHIN_TOLERANCE","expected":{"expectedGrossPayMinor":159000,"expectedRegularMinutes":4680,"expectedOvertimeMinutes":60,"expectedRegularPayMinor":156000,"expectedOvertimePayMinor":3000},"observed":{"observedGrossPayMinor":159000,"observedRegularMinutes":4680,"observedOvertimeMinutes":60,"observedRegularPayMinor":156000,"observedOvertimePayMinor":3000,"observedComponentTotalMinor":159000},"variance":{"grossPayVarianceMinor":0,"regularMinuteVariance":0,"overtimeMinuteVariance":0,"regularPayVarianceMinor":0,"overtimePayVarianceMinor":0,"statementArithmeticVarianceMinor":0},"riskFlags":["MANUAL_TIMECARD_ENTRY_PRESENT","SUPPLIED_POLICY_OVERTIME_PRESENT"],"reportHash":"sha256-hex","timecardId":"TC-42","statementId":"PAY-42","evidenceGaps":["CALLER_SUPPLIED_WORKER_POLICY_TIMECARD_AND_PAYROLL_FACTS_NOT_AUTHENTICATED"],"claimBoundary":{"fundsMoved":false,"paymentAttempted":false,"legalAdviceProvided":false,"payrollModifiedOrFinalized":false,"payrollOrTimekeepingSystemConnected":false,"workerClassificationOrOvertimeEligibilityDetermined":false},"schemaVersion":"WORKFORCE_TIMECARD_AUDIT_V1","weeklyResults":[],"suppliedPolicy":{"minuteTolerance":0,"amountToleranceMinor":0,"overtimeMultiplierBps":15000,"regularMinutesPerWorkweek":2400},"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_zgSEMix3ULVBck5B69XQk","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":"Reconciles employee timecard entries against payroll statements using supplied policy rules, returning a verdict on whether pay matches expected amounts within configured tolerances.","exampleAgentPrompt":"Audit worker opaque-worker-42's timecard TC-42 against payroll statement PAY-42 for the pay period 2026-08-03 to 2026-08-16 — their regular rate is $20.00/hr, workweek starts Monday, policy is 2400 regular minutes per workweek with a 1.5x overtime multiplier, and the payroll shows 4680 regular minutes and 60 overtime minutes totaling $1,590.00 gross; flag any variance outside a zero-minute and zero-cent tolerance.","exampleUseCases":[{"title":"Weekly payroll discrepancy detection","prompt":"Check whether timecard TC-99 for worker EMP-205 matches their payroll statement PAY-99 for the period 2026-09-01 to 2026-09-14 — they earn $18.50/hr, workweek starts Sunday, policy allows 2400 regular minutes per week with a 1.5x overtime multiplier, and the statement shows 4800 regular minutes and 0 overtime totaling $1,480.00 gross; flag anything outside a 5-minute or $1.00 tolerance."},{"title":"Overtime pay compliance audit","prompt":"Audit worker OPS-771's timecard for the 2026-07-14 to 2026-07-27 pay period — their regular rate is $25.00/hr, workweek starts Monday, policy is 2400 regular minutes per week at 1.5x overtime, and their payroll statement claims 4320 regular minutes and 480 overtime minutes with a gross pay of $2,700.00; I want to know if the overtime multiplier was applied correctly with zero tolerance."},{"title":"Manual entry risk flag review","prompt":"Reconcile timecard TC-55 against payroll statement PAY-55 for worker CONTRACTOR-12 covering 2026-06-02 to 2026-06-15 — hourly rate is $30.00, workweek starts Monday, standard policy is 2400 regular minutes with a 1.5x overtime multiplier, and the statement reports 3600 regular minutes and 0 overtime at $1,800.00 gross; alert me to any manual timecard entries and tell me if the figures match within a 10-minute or $5.00 tolerance."}],"resultDescription":"A structured JSON report containing a verdict label (e.g. MATCHED_WITHIN_TOLERANCE), expected vs. observed breakdowns of regular minutes, overtime minutes, regular pay, overtime pay, and gross pay (all in minor currency units), variance figures for each dimension, a list of risk flags (e.g. MANUAL_TIMECARD_ENTRY_PRESENT), evidence gaps, a recommended disposition, weekly drill-down results, a SHA-256 report hash, and a claim boundary block confirming no payroll system was modified.","failureModes":["Missing required worker, timecard, suppliedPolicy, or payrollStatement fields returns a validation error","Invalid date formats or out-of-range values (e.g. paidMinutes > 1440) cause schema rejection","Payment of $9 USDC via x402 protocol required; missing or failed payment returns 402","Unauthenticated caller-supplied facts noted in evidenceGaps but do not block processing","Timecard with zero entries fails minItems:1 constraint"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically verify whether a specific employee's payroll statement is arithmetically consistent with their timecard entries and a caller-supplied policy, and receive a machine-readable verdict with variance details and risk flags — particularly when manual timecard entries or overtime calculations need auditability. Prefer over manual payroll review when you need a structured, hashable audit record per pay period.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:46:31.440Z","isFirstParty":false,"canonicalSlug":"workforce-timecard-audit-43e294ae"}