# Workforce Timecard Audit

> Workforce Timecard Audit is a paid API for AI agents from rooke-token-risk-pilot.rookepoole.workers.dev, paid per call via x402, $9/call, status unknown (last checked 2026-10-13).

Reconciles employee timecard entries against payroll statements using supplied policy rules, returning a verdict on whether pay matches expected amounts within configured tolerances.

## Facts

- Endpoint: POST https://rooke-token-risk-pilot.rookepoole.workers.dev/v1/x402/workforce-timecard-audit?utm_source=zero.xyz
- Price: $9/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/workforce-timecard-audit-43e294ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XEpv97Lkz-vMGpcs1HVly

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability workforce-timecard-audit-43e294ae -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": {
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/workforce-timecard-audit-43e294ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rooke-token-risk-pilot.rookepoole.workers.dev](https://www.zero.xyz/host/rooke-token-risk-pilot.rookepoole.workers.dev/llms.txt)
