{
  "tool": "shipment-fee-exceptions",
  "version": "0.1.1",
  "summary": {
    "currency": "USD",
    "weight_unit": "kg",
    "shipment_rows": 4,
    "tariff_rows": 2,
    "accounted_input_rows": 6,
    "matched_shipments": 3,
    "excluded_or_unmatched_shipments": 1,
    "coverage": "3/4 shipment records",
    "coverage_complete": false,
    "covered_expected_subtotal": "10.75",
    "covered_billed_subtotal": "10.50",
    "covered_difference": "-0.25",
    "expected_total": null,
    "billed_total": null,
    "total_difference": null,
    "overcharge_shipments": 1,
    "undercharge_shipments": 1,
    "matched_equal_shipments": 1,
    "unused_tariff_rows": 0,
    "meaning": "Covered subtotals include only valid uniquely matched shipments. Empty/excluded/unmatched shipments prevent full totals. Sign is arithmetic comparison, not refund entitlement."
  },
  "rows": [
    {
      "source_row": "shipments.csv:2",
      "shipment_id": "0007",
      "zone": "SYN-Z",
      "weight_unit": "kg",
      "weight": "1",
      "units": "3",
      "currency": "USD",
      "billed_fee": "3.50",
      "billed_fee_cents": "3.50",
      "tariff_source_row": "tariff.csv:2",
      "tariff_id": "SYN-T1",
      "extra_units": 1,
      "expected_raw": "3.25",
      "expected_fee": "3.25",
      "difference": "0.25",
      "included_in_totals": true,
      "disposition": "OVERCHARGE",
      "codes": []
    },
    {
      "source_row": "shipments.csv:3",
      "shipment_id": "7",
      "zone": "SYN-Z",
      "weight_unit": "kg",
      "weight": "1.01",
      "units": "2",
      "currency": "USD",
      "billed_fee": "4.00",
      "billed_fee_cents": "4.00",
      "tariff_source_row": "tariff.csv:3",
      "tariff_id": "SYN-T2",
      "extra_units": 1,
      "expected_raw": "4.50",
      "expected_fee": "4.50",
      "difference": "-0.50",
      "included_in_totals": true,
      "disposition": "UNDERCHARGE",
      "codes": []
    },
    {
      "source_row": "shipments.csv:4",
      "shipment_id": "SYN-\"box\",é",
      "zone": "SYN-Z",
      "weight_unit": "kg",
      "weight": "1",
      "units": "2",
      "currency": "USD",
      "billed_fee": "3.00",
      "billed_fee_cents": "3.00",
      "tariff_source_row": "tariff.csv:2",
      "tariff_id": "SYN-T1",
      "extra_units": 0,
      "expected_raw": "3.00",
      "expected_fee": "3.00",
      "difference": "0.00",
      "included_in_totals": true,
      "disposition": "MATCH",
      "codes": []
    },
    {
      "source_row": "shipments.csv:5",
      "shipment_id": "SYN-UNMATCHED",
      "zone": "SYN-Z",
      "weight_unit": "kg",
      "weight": "2.01",
      "units": "1",
      "currency": "USD",
      "billed_fee": "5.00",
      "billed_fee_cents": "5.00",
      "tariff_source_row": null,
      "tariff_id": null,
      "extra_units": null,
      "expected_raw": null,
      "expected_fee": null,
      "difference": null,
      "included_in_totals": false,
      "disposition": "REVIEW_REQUIRED",
      "codes": [
        "UNMATCHED_TARIFF"
      ]
    }
  ],
  "tariff_rows": [
    {
      "source_row": "tariff.csv:2",
      "tariff_id": "SYN-T1",
      "zone": "SYN-Z",
      "weight_unit": "kg",
      "min_weight": "0",
      "max_weight": "1",
      "included_units": "2",
      "base_fee": "3.00",
      "extra_unit_fee": "0.25",
      "currency": "USD",
      "matched_shipment_rows": [
        "shipments.csv:2",
        "shipments.csv:4"
      ],
      "disposition": "USED_RULE",
      "codes": []
    },
    {
      "source_row": "tariff.csv:3",
      "tariff_id": "SYN-T2",
      "zone": "SYN-Z",
      "weight_unit": "kg",
      "min_weight": "1",
      "max_weight": "2",
      "included_units": "1",
      "base_fee": "4.00",
      "extra_unit_fee": "0.50",
      "currency": "USD",
      "matched_shipment_rows": [
        "shipments.csv:3"
      ],
      "disposition": "USED_RULE",
      "codes": []
    }
  ],
  "duplicate_shipment_groups": [],
  "fee_exception_source_rows": [
    "shipments.csv:2",
    "shipments.csv:3",
    "shipments.csv:5"
  ],
  "source_files": {
    "shipments.csv": {
      "sha256": "91d4135a542b4d942387169505fe06c1a888e754d5657cc7c8f555b011d15705",
      "bytes": 199,
      "data_rows": 4
    },
    "tariff.csv": {
      "sha256": "e9aedf6cea13eae3976dea03223a1965cca3e8205ef011c16ac315bdc819088b",
      "bytes": 172,
      "data_rows": 2
    }
  },
  "rules": {
    "precision": 512,
    "band": "(min_weight,max_weight]; touching bands do not overlap; positive-width same-zone overlap rejects job",
    "rounding": "Round billed fee individually HALF_UP cents; expected base+max(0,units-included_units)*extra_unit_fee is rounded once at final extension; sum rounded matched results",
    "identity": "Literal IDs/zone/weight_unit; no trimming or conversion",
    "empty_tariff": "No rules means no matches, no supplied common tariff unit and no full amounts",
    "scope": "Supplied narrow pick/pack model; no real-provider schedule inference, carrier lookup, refund entitlement or live action"
  }
}