Skip to content
Erich Grundman

Agent

Parcel invoice audit agent

An agent reads a carrier invoice against the shipper's own records and the published rules, disputes the lines that do not hold up, and says what it cannot verify.

How the agent works ↓

The invoice

One week of FedEx Ground and Home Delivery from a single origin. The shipper's facts on the left, the carrier's lines on the right. Eight of the forty packages carry a billing error.

Invoice
FX-260925-01
Period
2026-09-14 to 2026-09-20
Origin
Kansas City, KS (ZIP3 660)
Fuel for the period
16.5%
Packages
40
Invoice total
$1,482.88
Invoice lines by package
TrackingServiceDestZoneAddressDims (in)Actual lbBilled lbChargesTotal
701708901788Ground4565commercial13.09×10.81×6.691.628Transport 7.95, fuel 1.31, Sig. adult 10.0019.26
702506781856Home Delivery0597residential18.04×13×12.2711.7224Transport 15.39, fuel 3.60, Residential 6.4525.44
703478409309Home Delivery7785residential11.72×10.87×6.791.647Transport 7.64, fuel 2.32, Residential 6.4516.41
704023948099Ground7634commercial14.05×15.39×11.838.4721Transport 10.66, fuel 2.82, Residential 6.4519.93
705963818864Home Delivery3874residential27.98×20.48×18.158.3681Transport 22.68, fuel 10.21, Residential 6.45, AHS dim. 32.7572.09
706991388893Ground4985commercial15.28×15.78×12.789.0124Transport 12.72, fuel 2.1014.82
707458669666Home Delivery4204residential18.61×12.48×12.7311.2624Transport 11.44, fuel 2.95, Residential 6.4520.84
708513135406Home Delivery9947residential17.83×13.48×11.728.0722Transport 14.69, fuel 3.57, Residential 6.9525.21
709142298124Home Delivery7234residential11.82×9.94×4.324.745Transport 6.32, fuel 3.56, Residential 6.45, DAS ext. 8.8025.13
710155407582Ground7785commercial11.14×8.24×4.165.036Transport 7.32, fuel 1.21, Sig. direct 7.6016.13
711275589710Home Delivery9917residential22.03×20.31×14.8619.253Transport 25.12, fuel 5.21, Residential 6.45, Sig. direct 7.6044.38
712578716716Ground7433commercial46×14×1012.447Transport 15.28, fuel 7.92, AHS dim. 32.7555.95
713392225005Home Delivery0507residential11.32×8.65×4.271.024Transport 8.06, fuel 2.39, Residential 6.4516.90
714963469980Home Delivery0876residential16.75×14.77×10.994.9421Transport 13.08, fuel 4.67, Residential 6.45, DAS ext. 8.8033.00
715067743418Home Delivery3347residential19.85×13.75×9.125.5621Transport 14.34, fuel 3.43, Residential 6.4524.22
716904962453Home Delivery5162residential52×12×10945Transport 13.13, fuel 8.63, Residential 6.45, AHS dim. 32.7560.96
717839840466Home Delivery6343residential11.69×8.94×5.632.635Transport 5.71, fuel 2.01, Residential 6.45, Sig. direct 7.6021.77
718101271127Home Delivery6374residential17.52×13.43×10.9750.3351Transport 18.14, fuel 13.44, Residential 6.45, DAS 6.60, AHS weight 50.2594.88
719108889594Home Delivery9807residential12.09×8.16×6.25.386Transport 8.85, fuel 2.52, Residential 6.4517.82
720564905121Home Delivery7875residential12×12×12918Transport 10.97, fuel 2.87, Residential 6.4520.29
721642477532Home Delivery7293residential11.91×9×6.042.396Transport 5.96, fuel 2.05, Residential 6.4514.46
722508964189Home Delivery1076residential17.08×15.34×12.486.4827Transport 14.98, fuel 3.54, Residential 6.4524.97
723833568720Home Delivery1625residential28.29×21.62×16.9718.8579Transport 25.28, fuel 11.59, Residential 6.45, AHS dim. 38.5081.82
724827804451Home Delivery9337residential11.84×8.82×4.282.614Transport 8.06, fuel 4.57, Residential 6.45, DAS 6.60, DAS 6.6032.28
725468577224Home Delivery6662residential16.97×13.6×13.467.0124Transport 9.12, fuel 2.57, Residential 6.4518.14
726850537759Home Delivery9837residential11.07×9.81×5.475.456Transport 8.85, fuel 2.52, Residential 6.4517.82
727059903528Ground6364commercial13.89×10.61×4.594.426Transport 6.61, fuel 1.097.70
728021438452Home Delivery7373residential60×18×1622125Transport 20.13, fuel 49.76, Residential 6.45, Oversize 275.00, Sig. direct 7.60358.94
729766543647Home Delivery6134residential10.34×8.19×5.664.885Transport 6.32, fuel 2.11, Residential 6.4514.88
730788259247Ground4165commercial10.77×8.01×5.975.266Transport 7.32, fuel 1.94, DAS 4.4513.71
731031650625Home Delivery1596residential11.39×8.88×6.772.476Transport 8.07, fuel 3.48, Residential 6.45, DAS 6.6024.60
732239346926Home Delivery0726residential14.43×12.1×8.0510.3513Transport 10.47, fuel 3.13, Residential 6.4520.05
733666356553Home Delivery0746residential16.96×12.93×11.056.1420Transport 12.76, fuel 3.17, Residential 6.4522.38
734533919100Home Delivery4055residential13.35×10.5×5.995.017Transport 7.64, fuel 2.32, Residential 6.45, Sig. direct 7.6024.01
735324743066Home Delivery4435residential18.91×15.49×11.369.0627Transport 13.57, fuel 4.39, Residential 6.45, DAS 6.6031.01
736361440136Home Delivery1576residential29.3×16.1×16.3212.963Transport 25.88, fuel 5.33, Residential 6.4537.66
737970239329Home Delivery8346residential26.29×16.55×13.5616.6447Transport 21.12, fuel 4.55, Residential 6.4532.12
738748080059Home Delivery5724residential18.12×14.85×9.447.2321Transport 10.66, fuel 2.82, Residential 6.4519.93
739010139003Home Delivery2286residential10.92×9.59×5.44.15Transport 7.71, fuel 3.43, Residential 6.45, DAS 6.6024.19
740540458101Home Delivery8285residential13.78×10.11×6.443.198Transport 7.95, fuel 2.38, Residential 6.4516.78

The audit run

The agent starts from the invoice table and a set of tools that answer factual questions. Every call it makes is shown below, with what came back.

Model
claude-opus-5
Tool calls
41
Turns
9
Elapsed
162s
Tokens in / out
170,741 / 14,684
  1. I'll start by pulling the full invoice.
  2. 02 list_packages()
    Invoice FX-260925-01, FedEx, period 2026-09-14 to 2026-09-20, origin Kansas City, KS (ZIP3 660), fuel surcharge for the period 16.5%, 40 packages, invoice total $1482.88.
    
    tracking | service | ship_date | dest_zip3 | zone | address_type | dims_in (LxWxH) | actual_lb | billed_lb | charges (code=amount) | line_total
    701708901788 | FedEx Ground | 2026-09-17 | 456 | 5 | commercial | 13.09x10.81x6.69 | 1.62 | 8 | TRANSPORTATION=7.95 FUEL=1.31 SIGNATURE_ADULT=10.00 | 19.26
    702506781856 | FedEx Home Delivery | 2026-09-19 | 059 | 7 | residential | 18.04x13x12.27 | 11.72 | 24 | TRANSPORTATION=15.39 FUEL=3.60 RESIDENTIAL=6.45 | 25.44
    703478409309 | FedEx Home Delivery | 2026-09-18 | 778 | 5 | residential | 11.72x10.87x6.79 | 1.64 | 7 | TRANSPORTATION=7.64 FUEL=2.32 RESIDENTIAL=6.45 | 16.41
    704023948099 | FedEx Ground | 2026-09-18 | 763 | 4 | commercial | 14.05x15.39x11.83 | 8.47 | 21 | TRANSPORTAT…
    [cut for the log]
  3. Let me pull the key rules and check the suspicious cartons.
  4. 04 get_rule(rule_id: "FUEL")
    Fuel surcharge
    The fuel percentage for the invoice period is stated in the invoice header. Assumption for this audit: the percentage applies to the transportation charge plus the residential, delivery area, additional handling, and oversize surcharges, and not to signature or address correction fees. FedEx publishes the percentage weekly and the applicable base on fedex.com; neither is in the documents this audit holds.
    Source: Stated assumption, not read from a FedEx document (assumption).
  5. 05 get_rule(rule_id: "AHS_DIMENSION")
    Additional Handling Surcharge, Dimension
    Applies to any package that measures greater than 48 inches along its longest side, or greater than 30 inches along its second-longest side, or greater than 105 inches in length and girth (length plus two times the height plus two times the width), or greater than 10,368 cubic inches. Rating is based on the greater of actual rounded weight or dimensional weight, subject to a 40-lb. minimum billable weight. 2026 U.S. amounts by zone: Zone 2 $29.50, Zones 3-4 $32.75, Zones 5-6 $38.50, Zones 7+ $40.75.
    Source: FedEx Service Guide, effective January 5, 2026, updated September 11, 2026, Non-standard shipment fees, Additional Handling Surcharge (document read).
  6. 06 get_rule(rule_id: "OVERSIZE")
    Oversize Charge
    Applies to any package that measures greater than 96 inches along its longest side, or greater than 130 inches in length and girth, or greater than 17,280 cubic inches, or has an actual weight greater than 110 lbs. Rating is based on the greater of actual rounded weight or dimensional weight, subject to a 90-lb. minimum billable weight. When the Oversize Charge applies, the Additional Handling Surcharge does not also apply. 2026 U.S. amounts by zone: Zone 2 $255, Zones 3-4 $275, Zones 5-6 $320, Zones 7+ $330.
    Source: FedEx Service Guide, effective January 5, 2026, updated September 11, 2026, Non-standard shipment fees, Oversize Charge (document read).
  7. 07 get_rule(rule_id: "DAS")
    Delivery Area Surcharge
    Applies per package to ZIP codes FedEx designates as delivery area, extended delivery area, or remote. 2026, U.S. Package Services: Residential $6.60, Extended Residential $8.80, Commercial $4.45, Extended Commercial $5.55, Remote Commercial or Remote Residential $16.75. One surcharge per package. Whether a ZIP is on the list is set by FedEx's published DAS ZIP tables, which this audit does not hold, so eligibility cannot be verified here and only the amount and the count can.
    Source: 2026 changes to FedEx surcharges & fees, fedex.com, Delivery Area Surcharge (document read).
  8. 08 get_rule(rule_id: "RESIDENTIAL")
    Residential Delivery Charge
    Applies to shipments delivered to a home or private residence. 2026: $6.95 per package for U.S. Package Services (Express). $6.45 per package for FedEx Ground, FedEx Home Delivery, and FedEx International Ground shipments. A commercial address does not carry the charge.
    Source: 2026 changes to FedEx surcharges & fees, fedex.com, Residential Delivery Charge (document read).
  9. 09 get_rule(rule_id: "SIGNATURE")
    Delivery Signature Options
    Charged only when the shipper selects the option. 2026 U.S. Package Services: Adult Signature Required $10 per package; Direct Signature Required and Indirect Signature Required $7.60 per package.
    Source: 2026 changes to FedEx surcharges & fees, fedex.com, FedEx Delivery Signature Options (document read).
  10. 10 check_triggers(length_in: 46, width_in: 14, height_in: 10, actual_lb: 12.4)
    Longest side 46 in. Second-longest 14 in. Length plus girth 94 in. Cubic volume (rounded sides) 6440 cubic in. Actual weight 12.4 lb.
    Additional Handling, Dimension: longest > 48 (false), second-longest > 30 (false), length plus girth > 105 (false), cubic > 10368 (false).
    Additional Handling, Weight: actual > 50 lb (false).
    Oversize: longest > 96 (false), length plus girth > 130 (false), cubic > 17280 (false), actual > 110 lb (false).
    Ground Unauthorized: longest > 108 (false), length plus girth > 165 (false), actual > 150 lb (false).
    When Oversize applies, Additional Handling does not also apply.
  11. 11 check_triggers(length_in: 60, width_in: 18, height_in: 16, actual_lb: 22)
    Longest side 60 in. Second-longest 18 in. Length plus girth 128 in. Cubic volume (rounded sides) 17280 cubic in. Actual weight 22 lb.
    Additional Handling, Dimension: longest > 48 (true), second-longest > 30 (false), length plus girth > 105 (true), cubic > 10368 (true).
    Additional Handling, Weight: actual > 50 lb (false).
    Oversize: longest > 96 (false), length plus girth > 130 (false), cubic > 17280 (false), actual > 110 lb (false).
    Ground Unauthorized: longest > 108 (false), length plus girth > 165 (false), actual > 150 lb (false).
    When Oversize applies, Additional Handling does not also apply.
  12. 12 check_triggers(length_in: 52, width_in: 12, height_in: 10, actual_lb: 9)
    Longest side 52 in. Second-longest 12 in. Length plus girth 96 in. Cubic volume (rounded sides) 6240 cubic in. Actual weight 9 lb.
    Additional Handling, Dimension: longest > 48 (true), second-longest > 30 (false), length plus girth > 105 (false), cubic > 10368 (false).
    Additional Handling, Weight: actual > 50 lb (false).
    Oversize: longest > 96 (false), length plus girth > 130 (false), cubic > 17280 (false), actual > 110 lb (false).
    Ground Unauthorized: longest > 108 (false), length plus girth > 165 (false), actual > 150 lb (false).
    When Oversize applies, Additional Handling does not also apply.
  13. 13 check_triggers(length_in: 27.98, width_in: 20.48, height_in: 18.15, actual_lb: 8.36)
    Longest side 27.98 in. Second-longest 20.48 in. Length plus girth 105.24 in. Cubic volume (rounded sides) 11172 cubic in. Actual weight 8.36 lb.
    Additional Handling, Dimension: longest > 48 (false), second-longest > 30 (false), length plus girth > 105 (true), cubic > 10368 (true).
    Additional Handling, Weight: actual > 50 lb (false).
    Oversize: longest > 96 (false), length plus girth > 130 (false), cubic > 17280 (false), actual > 110 lb (false).
    Ground Unauthorized: longest > 108 (false), length plus girth > 165 (false), actual > 150 lb (false).
    When Oversize applies, Additional Handling does not also apply.
  14. 14 check_triggers(length_in: 28.29, width_in: 21.62, height_in: 16.97, actual_lb: 18.85)
    Longest side 28.29 in. Second-longest 21.62 in. Length plus girth 105.47 in. Cubic volume (rounded sides) 10846 cubic in. Actual weight 18.85 lb.
    Additional Handling, Dimension: longest > 48 (false), second-longest > 30 (false), length plus girth > 105 (true), cubic > 10368 (true).
    Additional Handling, Weight: actual > 50 lb (false).
    Oversize: longest > 96 (false), length plus girth > 130 (false), cubic > 17280 (false), actual > 110 lb (false).
    Ground Unauthorized: longest > 108 (false), length plus girth > 165 (false), actual > 150 lb (false).
    When Oversize applies, Additional Handling does not also apply.
  15. 15 check_triggers(length_in: 17.52, width_in: 13.43, height_in: 10.97, actual_lb: 50.33)
    Longest side 17.52 in. Second-longest 13.43 in. Length plus girth 66.32 in. Cubic volume (rounded sides) 2772 cubic in. Actual weight 50.33 lb.
    Additional Handling, Dimension: longest > 48 (false), second-longest > 30 (false), length plus girth > 105 (false), cubic > 10368 (false).
    Additional Handling, Weight: actual > 50 lb (true).
    Oversize: longest > 96 (false), length plus girth > 130 (false), cubic > 17280 (false), actual > 110 lb (false).
    Ground Unauthorized: longest > 108 (false), length plus girth > 165 (false), actual > 150 lb (false).
    When Oversize applies, Additional Handling does not also apply.
  16. 16 surcharge_amount(surcharge: "AHS_WEIGHT", zone: 4)
    AHS_WEIGHT at zone 4 (Zones 3-4): $50.25 per package. Full table: Zone 2 $46, Zones 3-4 $50.25, Zones 5-6 $56.25, Zones 7+ $58.75.
  17. 17 surcharge_amount(surcharge: "AHS_DIMENSION", zone: 2)
    AHS_DIMENSION at zone 2 (Zone 2): $29.50 per package. Full table: Zone 2 $29.5, Zones 3-4 $32.75, Zones 5-6 $38.5, Zones 7+ $40.75.
  18. 18 surcharge_amount(surcharge: "AHS_DIMENSION", zone: 3)
    AHS_DIMENSION at zone 3 (Zones 3-4): $32.75 per package. Full table: Zone 2 $29.5, Zones 3-4 $32.75, Zones 5-6 $38.5, Zones 7+ $40.75.
  19. 19 billable_weight(length_in: 12, width_in: 12, height_in: 12, actual_lb: 9)
    Rounded dims 12x12x12 in = 1728 cubic in. Dimensional weight 1728 / 139 = 12.43, rounds up to 13 lb. Actual 9 lb rounds up to 9 lb. Billable weight 13 lb.
  20. 20 transportation_rate(zone: 5, billable_lb: 13)
    Zone 5, 13 lb: $9.49.
  21. 21 transportation_rate(zone: 5, billable_lb: 18)
    Zone 5, 18 lb: $10.97.
  22. 22 transportation_rate(zone: 3, billable_lb: 125)
    Zone 3, 125 lb: $20.13.
  23. 23 transportation_rate(zone: 3, billable_lb: 47)
    Zone 3, 47 lb: $15.28.
  24. 24 transportation_rate(zone: 6, billable_lb: 13)
    Zone 6, 13 lb: $10.47.
  25. 25 get_package(tracking: "732239346926")
    {
      "tracking": "732239346926",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-18",
      "originZip3": "660",
      "destZip3": "072",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 14.43,
        "w": 12.1,
        "h": 8.05
      },
      "actualLb": 10.35,
      "zone": 6,
      "billedLb": 13,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 6, 13 lb",
          "amount": 10.47
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 3.13
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        }
      ],
      "lineTotal": 20.05
    }
  26. 26 get_package(tracking: "724827804451")
    {
      "tracking": "724827804451",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-15",
      "originZip3": "660",
      "destZip3": "933",
      "destAddressType": "residential",
      "dasTier": "das",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 11.84,
        "w": 8.82,
        "h": 4.28
      },
      "actualLb": 2.61,
      "zone": 7,
      "billedLb": 4,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 7, 4 lb",
          "amount": 8.06
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 4.57
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge, das",
          "amount": 6.6
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge",
          "amount": 6.6
    …
    [cut for the log]
  27. 27 get_package(tracking: "704023948099")
    {
      "tracking": "704023948099",
      "service": "FedEx Ground",
      "shipDate": "2026-09-18",
      "originZip3": "660",
      "destZip3": "763",
      "destAddressType": "commercial",
      "dasTier": "none",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 14.05,
        "w": 15.39,
        "h": 11.83
      },
      "actualLb": 8.47,
      "zone": 4,
      "billedLb": 21,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Ground, zone 4, 21 lb",
          "amount": 10.66
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 2.82
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        }
      ],
      "lineTotal": 19.93
    }
  28. 28 get_package(tracking: "701708901788")
    {
      "tracking": "701708901788",
      "service": "FedEx Ground",
      "shipDate": "2026-09-17",
      "originZip3": "660",
      "destZip3": "456",
      "destAddressType": "commercial",
      "dasTier": "none",
      "signatureRequested": "adult",
      "dimsIn": {
        "l": 13.09,
        "w": 10.81,
        "h": 6.69
      },
      "actualLb": 1.62,
      "zone": 5,
      "billedLb": 8,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Ground, zone 5, 8 lb",
          "amount": 7.95
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 1.31
        },
        {
          "code": "SIGNATURE_ADULT",
          "description": "Adult Signature Required",
          "amount": 10
        }
      ],
      "lineTotal": 19.26
    }
  29. 29 get_package(tracking: "710155407582")
    {
      "tracking": "710155407582",
      "service": "FedEx Ground",
      "shipDate": "2026-09-18",
      "originZip3": "660",
      "destZip3": "778",
      "destAddressType": "commercial",
      "dasTier": "none",
      "signatureRequested": "direct",
      "dimsIn": {
        "l": 11.14,
        "w": 8.24,
        "h": 4.16
      },
      "actualLb": 5.03,
      "zone": 5,
      "billedLb": 6,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Ground, zone 5, 6 lb",
          "amount": 7.32
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 1.21
        },
        {
          "code": "SIGNATURE_DIRECT",
          "description": "Direct Signature Required",
          "amount": 7.6
        }
      ],
      "lineTotal": 16.13
    }
  30. 30 get_package(tracking: "711275589710")
    {
      "tracking": "711275589710",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-17",
      "originZip3": "660",
      "destZip3": "991",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "direct",
      "dimsIn": {
        "l": 22.03,
        "w": 20.31,
        "h": 14.86
      },
      "actualLb": 19.2,
      "zone": 7,
      "billedLb": 53,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 7, 53 lb",
          "amount": 25.12
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 5.21
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "SIGNATURE_DIRECT",
          "description": "Direct Signature Required",
          "amount": 7.6
        }
      ],
      "lineTotal": 44.38
    }
  31. 31 get_package(tracking: "717839840466")
    {
      "tracking": "717839840466",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-14",
      "originZip3": "660",
      "destZip3": "634",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "direct",
      "dimsIn": {
        "l": 11.69,
        "w": 8.94,
        "h": 5.63
      },
      "actualLb": 2.63,
      "zone": 3,
      "billedLb": 5,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 3, 5 lb",
          "amount": 5.71
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 2.01
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "SIGNATURE_DIRECT",
          "description": "Direct Signature Required",
          "amount": 7.6
        }
      ],
      "lineTotal": 21.77
    }
  32. 32 get_package(tracking: "728021438452")
    {
      "tracking": "728021438452",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-15",
      "originZip3": "660",
      "destZip3": "737",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "direct",
      "dimsIn": {
        "l": 60,
        "w": 18,
        "h": 16
      },
      "actualLb": 22,
      "zone": 3,
      "billedLb": 125,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 3, 125 lb",
          "amount": 20.13
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 49.76
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "OVERSIZE",
          "description": "Oversize Charge",
          "amount": 275
        },
        {
          "code": "SIGNATURE_DIRECT",
          "description": "Direct Signature Required",
          "amount…
    [cut for the log]
  33. 33 get_package(tracking: "734533919100")
    {
      "tracking": "734533919100",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-18",
      "originZip3": "660",
      "destZip3": "405",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "direct",
      "dimsIn": {
        "l": 13.35,
        "w": 10.5,
        "h": 5.99
      },
      "actualLb": 5.01,
      "zone": 5,
      "billedLb": 7,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 5, 7 lb",
          "amount": 7.64
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 2.32
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "SIGNATURE_DIRECT",
          "description": "Direct Signature Required",
          "amount": 7.6
        }
      ],
      "lineTotal": 24.01
    }
  34. 34 get_package(tracking: "709142298124")
    {
      "tracking": "709142298124",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-18",
      "originZip3": "660",
      "destZip3": "723",
      "destAddressType": "residential",
      "dasTier": "extended",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 11.82,
        "w": 9.94,
        "h": 4.32
      },
      "actualLb": 4.74,
      "zone": 4,
      "billedLb": 5,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 4, 5 lb",
          "amount": 6.32
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 3.56
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS_EXTENDED",
          "description": "Delivery Area Surcharge, extended",
          "amount": 8.8
        }
      ],
      "lineTotal": 25.13
    }
  35. 35 get_package(tracking: "714963469980")
    {
      "tracking": "714963469980",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-14",
      "originZip3": "660",
      "destZip3": "087",
      "destAddressType": "residential",
      "dasTier": "extended",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 16.75,
        "w": 14.77,
        "h": 10.99
      },
      "actualLb": 4.94,
      "zone": 6,
      "billedLb": 21,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 6, 21 lb",
          "amount": 13.08
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 4.67
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS_EXTENDED",
          "description": "Delivery Area Surcharge, extended",
          "amount": 8.8
        }
      ],
      "lineTotal": 33
    }
  36. 36 get_package(tracking: "718101271127")
    {
      "tracking": "718101271127",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-15",
      "originZip3": "660",
      "destZip3": "637",
      "destAddressType": "residential",
      "dasTier": "das",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 17.52,
        "w": 13.43,
        "h": 10.97
      },
      "actualLb": 50.33,
      "zone": 4,
      "billedLb": 51,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 4, 51 lb",
          "amount": 18.14
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 13.44
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge, das",
          "amount": 6.6
        },
        {
          "code": "AHS_WEIGHT",
          "description": "Additional Handling Surcharge, W…
    [cut for the log]
  37. 37 get_package(tracking: "730788259247")
    {
      "tracking": "730788259247",
      "service": "FedEx Ground",
      "shipDate": "2026-09-17",
      "originZip3": "660",
      "destZip3": "416",
      "destAddressType": "commercial",
      "dasTier": "das",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 10.77,
        "w": 8.01,
        "h": 5.97
      },
      "actualLb": 5.26,
      "zone": 5,
      "billedLb": 6,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Ground, zone 5, 6 lb",
          "amount": 7.32
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 1.94
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge, das",
          "amount": 4.45
        }
      ],
      "lineTotal": 13.71
    }
  38. 38 get_package(tracking: "731031650625")
    {
      "tracking": "731031650625",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-17",
      "originZip3": "660",
      "destZip3": "159",
      "destAddressType": "residential",
      "dasTier": "das",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 11.39,
        "w": 8.88,
        "h": 6.77
      },
      "actualLb": 2.47,
      "zone": 6,
      "billedLb": 6,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 6, 6 lb",
          "amount": 8.07
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 3.48
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge, das",
          "amount": 6.6
        }
      ],
      "lineTotal": 24.6
    }
  39. 39 get_package(tracking: "735324743066")
    {
      "tracking": "735324743066",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-15",
      "originZip3": "660",
      "destZip3": "443",
      "destAddressType": "residential",
      "dasTier": "das",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 18.91,
        "w": 15.49,
        "h": 11.36
      },
      "actualLb": 9.06,
      "zone": 5,
      "billedLb": 27,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 5, 27 lb",
          "amount": 13.57
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 4.39
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge, das",
          "amount": 6.6
        }
      ],
      "lineTotal": 31.01
    }
  40. 40 get_package(tracking: "739010139003")
    {
      "tracking": "739010139003",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-18",
      "originZip3": "660",
      "destZip3": "228",
      "destAddressType": "residential",
      "dasTier": "das",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 10.92,
        "w": 9.59,
        "h": 5.4
      },
      "actualLb": 4.1,
      "zone": 6,
      "billedLb": 5,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 6, 5 lb",
          "amount": 7.71
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 3.43
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        },
        {
          "code": "DAS",
          "description": "Delivery Area Surcharge, das",
          "amount": 6.6
        }
      ],
      "lineTotal": 24.19
    }
  41. 41 get_package(tracking: "708513135406")
    {
      "tracking": "708513135406",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-19",
      "originZip3": "660",
      "destZip3": "994",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 17.83,
        "w": 13.48,
        "h": 11.72
      },
      "actualLb": 8.07,
      "zone": 7,
      "billedLb": 22,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 7, 22 lb",
          "amount": 14.69
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 3.57
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.95
        }
      ],
      "lineTotal": 25.21
    }
  42. 42 get_package(tracking: "720564905121")
    {
      "tracking": "720564905121",
      "service": "FedEx Home Delivery",
      "shipDate": "2026-09-17",
      "originZip3": "660",
      "destZip3": "787",
      "destAddressType": "residential",
      "dasTier": "none",
      "signatureRequested": "none",
      "dimsIn": {
        "l": 12,
        "w": 12,
        "h": 12
      },
      "actualLb": 9,
      "zone": 5,
      "billedLb": 18,
      "charges": [
        {
          "code": "TRANSPORTATION",
          "description": "FedEx Home Delivery, zone 5, 18 lb",
          "amount": 10.97
        },
        {
          "code": "FUEL",
          "description": "Fuel surcharge, 16.5%",
          "amount": 2.87
        },
        {
          "code": "RESIDENTIAL",
          "description": "Residential Delivery Charge",
          "amount": 6.45
        }
      ],
      "lineTotal": 20.29
    }
  43. 43 submit_findings(count: 8)
    Recorded 8 findings.
  44. I disputed eight lines across the 40-package invoice, totaling $342.00 recoverable including fuel. The big one is tracking 728021438452: a $275 Oversize charge on a 60x18x16 carton that clears no Oversize trigger, longest side 60 inches, length plus girth 128 inches, and cubic volume of exactly 17,280 which is not greater than the 17,280 threshold. It does qualify for Additional Handling by dimension, so I claimed the difference net of the $32.75 that is properly due, $282.22 with fuel. Package 712578716716 was charged $32.75 Additional Handling with no trigger at all, and 716904962453 was charged the zone 3-4 rate on a zone 2 movement. Two residential charges were wrong: one on a commercial FedEx Ground delivery, and one billed at the $6.95 Express rate instead of the $6.45 Ground rate. Package 720564905121 was rated at 18 lb when its dimensional weight is 13 lb, 724827804451 carries the delivery area surcharge twice, and 732239346926 has fuel of $3.13 against a base that supports $2.79. What I could not verify is whether the destination ZIPs are actually on FedEx's delivery area lists, since those tables are not in this document set; every DAS amount and tier did match the shipper's own records, so I left them alone apart from the duplicate. Signature fees all matched a shipper request and the published amounts, and the remaining billed weights all reconciled to the dimensional or actual weight.

Findings

I audited all 40 packages against the shipper's carton and address records and the 2026 FedEx rules, and found eight billing errors worth $342.00 including fuel. The largest is a $275 Oversize charge on tracking 728021438452, a 60x18x16 in carton that meets no Oversize trigger (exactly 17,280 cubic inches, 128 in length plus girth) and should have carried only the $32.75 Additional Handling charge. Delivery area surcharge eligibility itself cannot be checked from the invoice because the FedEx DAS ZIP tables are not in hand, but every DAS amount and tier matched the shipper's own records, so none are disputed other than the duplicate on 724827804451.

Lines disputed
8
Recoverable
$342.00
Of invoice total
23.1%
Flagged, cannot verify
0
Audit findings
TrackingChargeIssueBilledExpectedRecoverRuleConfidence
704023948099ResidentialNot applicable6.450.007.51Residential Delivery Chargehigh
The Residential Delivery Charge applies only to deliveries to a home or private residence; the shipper's order record shows this FedEx Ground shipment to ZIP3 763 as a commercial address. The $6.45 charge should be removed along with the 16.5% fuel billed on it ($1.06), for $7.51 total.
708513135406ResidentialWrong amount6.956.450.58Residential Delivery Chargehigh
The 2026 Residential Delivery Charge is $6.95 only for U.S. Package Services (Express); FedEx Ground and FedEx Home Delivery are $6.45. This package moved on FedEx Home Delivery, so it was billed at the wrong service tier: $0.50 plus $0.08 fuel.
712578716716AHS dim.Not applicable32.750.0038.15Additional Handling Surcharge, Dimensionhigh
The 46x14x10 in carton meets no Additional Handling dimension trigger: longest side 46 in (not >48), second-longest 14 in (not >30), length plus girth 94 in (not >105), cubic volume 6,440 in3 (not >10,368). The $32.75 surcharge and the $5.40 fuel charged on it should be credited.
716904962453AHS dim.Wrong amount32.7529.503.79Additional Handling Surcharge, Dimensionhigh
Additional Handling does apply (longest side 52 in exceeds 48 in), but this is a zone 2 movement and the 2026 published zone 2 amount is $29.50, not the $32.75 zone 3-4 amount billed. Credit $3.25 plus $0.54 fuel.
720564905121TransportWeight overstated10.979.491.72Dimensional weighthigh
The 12x12x12 in carton is 1,728 cubic in / 139 = 12.43, rounding up to a 13 lb dimensional weight, against a 9 lb actual weight, so billable weight is 13 lb, not the 18 lb billed. Zone 5 at 13 lb rates $9.49 rather than $10.97; credit $1.48 plus $0.24 of fuel.
724827804451DASDuplicate13.206.607.69Delivery Area Surchargehigh
The Delivery Area Surcharge is one per package, and this package carries two $6.60 residential DAS lines. The shipper record shows a single 'das' tier destination, so the second line is a duplicate: credit $6.60 plus $1.09 fuel.
728021438452OversizeNot applicable275.000.00282.22Oversize Chargehigh
The 60x18x16 in carton meets no Oversize trigger: longest side 60 in (not >96), length plus girth 128 in (not >130), cubic volume exactly 17,280 in3 (not greater than 17,280), actual weight 22 lb (not >110). It does qualify for Additional Handling-Dimension, which at zone 3 is $32.75, so the correct claim is $275.00 less $32.75 rebilled, plus the 16.5% fuel overbilled on that difference: $282.22 net. Billable weight of 125 lb is unaffected.
732239346926FuelFuel miscalculated3.132.790.34Fuel surchargehigh
At the header rate of 16.5% on transportation plus residential ($10.47 + $6.45 = $16.92), fuel should be $2.79; $3.13 implies a base of $18.97 that does not correspond to any charge on this package. Every other line on the invoice computes fuel on this same base, so this one line is miscalculated by $0.34.

Against the answer key

The errors were planted, so the run can be scored. A catch names the right package and the right charge. A false positive is a dispute on a clean line, which is the expensive mistake.

Planted
8
Caught
8
Missed
0
False positives
0
Recoverable, claimed / planted
$342.00 / $342.00
Planted, of invoice
23.1%
Planted errors and whether the agent caught them
Planted errorTrackingRecoverableResult
Residential charge on a commercial addressShipper's order record says commercial. The carrier billed the residential charge, and fuel on top of it.7040239480997.51caught
Residential charge at the Express rateThe $6.95 figure is the Express rate. Ground and Home Delivery carry $6.45.7085131354060.58caught
Additional handling with no trigger metLongest side 46 in, second 14 in, length plus girth 94 in, 6,440 cubic in. None of the four triggers is met.71257871671638.15caught
Additional handling at the wrong zone tierThe surcharge is real; 52 in exceeds the 48 in trigger. The amount is the Zones 3-4 figure on a zone 2 package.7169049624533.79caught
Billed weight above actual and dimensionalActual 9 lb, dimensional 13 lb, billed 18 lb. Nothing in the shipper's record supports the billed weight.7205649051211.72caught
Delivery area surcharge billed twiceTwo DAS lines on one package. The surcharge is per package, once.7248278044517.69caught
Oversize charge where only additional handling appliesLongest side 60 in, length plus girth 128 in, 17,280 cubic in. Oversize needs more than 96, 130, or 17,280. Additional Handling, Dimension, applies instead at $32.75, so the recovery is the difference.728021438452282.22caught
Fuel at the wrong percentageFuel on this line works out to 18.5% of the base. The invoice period states 16.5%.7322393469260.34caught

What the agent assumes

  • The shipper's order record is right about address type and the carton is right about dimensions and weight. A real audit would sample those against the warehouse scan before filing.
  • Fuel applies to transportation plus the residential, delivery area, additional handling, and oversize surcharges, at the percentage in the invoice header. FedEx publishes the percentage weekly and this page does not fetch it.
  • Delivery area eligibility and packaging material are not on an invoice. The agent is told so, and the right answer on those lines is a question, not a dispute.
  • Transportation charges come from the site's synthetic rate table at roughly half of list, standing in for a contract. Surcharge amounts are the published 2026 figures with no discount, which is how most contracts leave them.

How it works

Parcel invoices are wrong more often than most shippers know, and the errors are small enough on any one line that nobody chases them. A residential charge on a warehouse address, an additional handling fee on a box that clears every threshold, a billed weight nobody can reproduce from the carton. Audit vendors exist because the arithmetic is tedious and the rules live in a 130-page service guide. They charge a share of what they recover.

The audit is two jobs, and only one of them is arithmetic. Rebuilding what a package should have cost from its dimensions, weight, zone, and address type is a formula. Deciding whether a line is a dispute, a question, or a charge you cannot check from an invoice at all is judgment: a delivery area surcharge at the right amount might be wrong, but proving it takes the carrier's ZIP tables, and a claim you cannot support costs you standing on the next one. The agent above is built around that split. The tools do the arithmetic and quote the rule. The model decides which packages to inspect, which rule governs a line, and what to leave alone.

The invoice is synthetic and the errors are planted, so the run can be scored. That is the point of showing the answer key: an audit that cannot be checked is a vendor pitch. The recorded run is stored with the page, and the live button runs the same agent on a fresh copy of the invoice, with the tool calls shown as they happen.

Data provenance

Invoice
Synthetic invoice generated by a seeded formula in this repository. Forty FedEx Ground and Home Delivery packages from one origin, destinations drawn from public Census ZIP3 geography, zones from ZIP3 distance bands, transportation charges from the site's synthetic rate table at roughly half of list, and surcharge amounts at the published 2026 FedEx figures. Eight billing errors are planted on fixed positions: the answer key the audit is scored against. They are the kinds of error parcel auditors find every week, at amounts a real invoice would carry. Not a real invoice, not a real shipper, and nothing from an employer or a merchant.
Rules
FedEx 2026 U.S. package rules, read from the public FedEx Service Guide (effective January 5, 2026, updated September 11, 2026) and the 2026 surcharge and fee change table on fedex.com, both read on 2026-09-25. Fuel is a stated assumption, and DAS ZIP eligibility and packaging material cannot be checked from an invoice, so the audit says so rather than guessing. No contract terms, no negotiated discounts, and nothing from an employer or a merchant.
Rates
Synthetic. Every figure was generated by formula. rate = 4.00 + 0.31 * (zone - 2)^1.25 + weightLb^0.92 * (0.275 + 0.0425 * (zone - 2)) No carrier rate card, no negotiated agreement, no employer pricing. Replace this file to plug in published list rates with their own provenance.

The rules, the invoice generator, the deterministic checks, and the agent are separate modules. A new rate year is a data change to the rules file, and a real invoice is a parser in front of the same tools. The code is on GitHub.

← Back to portfolio