# Parcel Charge Audit

> Parcel Charge 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-09-14).

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.

## Facts

- Endpoint: POST https://rooke-token-risk-pilot.rookepoole.workers.dev/v1/x402/parcel-charge-audit
- Price: $9/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/parcel-charge-audit-abd34064
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5EG1Bi6qPdQW0976dbhHD

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 parcel-charge-audit-abd34064 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/parcel-charge-audit-abd34064/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)
