{
  "campaign_id": "bring-five-hard-transactions",
  "version": "1.0.0",
  "executed_at": "2026-10-21T19:34:53.079638+00:00",
  "source_commit": "1338ff80e9245fe60311546a56261ed4d25e0e6e",
  "source_reviewed_on": "2026-10-21",
  "transaction_date": "2026-07-26",
  "environment": "isolated local reference execution; sandbox service environment; no customer or production mutations",
  "config": {
    "address_validation_mode": "fixture",
    "official_rate_provider_enabled": false,
    "automated_product_identity_enabled": false,
    "rate_source": "disclosed rate-snapshot.json",
    "database": "new in-memory SQLite"
  },
  "source_hashes": {
    "app/services/itms_api_service.py": "b7f358f0b4ef717b635d0dae359d76ebf833594941920d943cbb285c037db2db",
    "app/services/marketplace_service.py": "3425bf84a2b39e5eaa6fd58355c43a8922136a3f6dcb07a7aeb235fcfb2b63d0",
    "app/services/rate_content/il_sqlite_index.py": "502722b17889127d37ee7c4ff6cf32d9b520f6f59c4b1b14bce99425cc0ec0c3",
    "app/services/rate_content/il_sqlite_index_builder.py": "72e035e5fdbcf5a628686e02fbcb5615037b59753a5ea76457ad66e66c80afa4",
    "app/services/rate_content/il_rooftop_parser.py": "c72b5695df92f6f8f626b2e46da173acdea847b406367fb8f0542f772a4b3098",
    "app/services/state_packs/va_st1_webupload.py": "cde14bfed5c9a99b50cbb36b3d69a0a3ff447716d4e2b5c025ecf26bb0567bd3",
    "scripts/seo/build_hard_transactions_pack.py": "4be0a87040064ba59c104ee6b52c8ebb819279d0c94574425d87b0491c47f65f"
  },
  "sources": {
    "va_rates": {
      "title": "Virginia Tax: sales tax rates and locality lookup",
      "url": "https://www.tax.virginia.gov/sales-tax-rate-and-locality-code-lookup"
    },
    "va_exemptions": {
      "title": "Virginia Tax: exemption certificates",
      "url": "https://www.tax.virginia.gov/sales-tax-exemptions"
    },
    "va_marketplace": {
      "title": "Virginia Tax: marketplace facilitators and sellers",
      "url": "https://www.tax.virginia.gov/remote-sellers-marketplace-facilitators-economic-nexus"
    },
    "va_layout": {
      "title": "Virginia Tax: ST-1 Web Upload specification",
      "url": "https://www.tax.virginia.gov/sites/default/files/inline-files/specifications-for-web-upload-server-to-server-processing.pdf"
    },
    "il_addresses": {
      "title": "Illinois Department of Revenue: address-specific rate files",
      "url": "https://tax.illinois.gov/research/taxrates.html"
    }
  },
  "cases": [
    {
      "slug": "same-zip-different-jurisdiction",
      "title": "One ZIP. Two jurisdiction results.",
      "question": "Does your evaluation preserve the delivery address and the jurisdiction code?",
      "result": "8.25% and 7.25% in ZIP 60084",
      "summary": "The actual Illinois address-index resolver returned location codes 04900278 and 04950006 for two rows from the July 2026 official-derived sample.",
      "kind": "Component execution",
      "artifact": "address-executions.json",
      "source": "il_addresses",
      "limitation": "Historical destination-rate lookup over a nine-row subset. Live geocoding, full-file coverage and a complete tax determination were not tested.",
      "next": "Bring two delivery addresses near a tax boundary and document the sourcing rule."
    },
    {
      "slug": "missing-product-identity",
      "title": "A missing product should be a question.",
      "question": "What happens when the integration cannot identify the product?",
      "result": "product_identity_required \u00b7 422",
      "summary": "With product_identity_policy=require_known, the calculation service refused the line without a known tax code or SKU. It did not return an invented zero-tax answer.",
      "kind": "Sandbox service execution",
      "artifact": "api-executions.json",
      "source": "va_rates",
      "limitation": "Tests the explicit strict policy. The API also has an allow_generic policy; this does not claim every request refuses missing identity.",
      "next": "Bring a SKU that your current mapping cannot classify."
    },
    {
      "slug": "certificate-effective-date",
      "title": "The certificate must cover the date.",
      "question": "Does exemption evidence match this customer, state and transaction date?",
      "result": "$0.00 with effective evidence \u00b7 expired request refused",
      "summary": "The fixture customer was marked exempt and linked to an active synthetic certificate. The calculation returned .00 on its last effective date. The next-day request returned exemption_certificate_not_found (422).",
      "kind": "Sandbox service execution",
      "artifact": "api-executions.json",
      "source": "va_exemptions",
      "limitation": "The effective-to date is a synthetic record boundary, not a general Virginia certificate expiration rule. Real certificates require authorized review and correct scope.",
      "next": "Bring a certificate with a date or scope question, through the private workflow."
    },
    {
      "slug": "partial-refund",
      "title": "Follow the credit back to the sale.",
      "question": "Does a partial refund reconcile to the committed transaction?",
      "result": "$25.00 refund \u00b7 $1.33 tax reversal",
      "summary": "The service linked a $25 refund to a $100 sale with $5.30 original tax. The positive refund tax magnitude is $1.33; the remaining tax is $3.97 after cent rounding.",
      "kind": "Sandbox service execution",
      "artifact": "api-executions.json",
      "source": "va_rates",
      "limitation": "Uses a disclosed 5.3% general-retail fixture snapshot. This lifecycle example is separate from the ST-1 sample, whose writer excludes negative activity.",
      "next": "Bring one partial credit, its original invoice and your reconciliation rule."
    },
    {
      "slug": "safe-retries",
      "title": "A retry should not become a second sale.",
      "question": "How does the integration distinguish a retry from a changed transaction?",
      "result": "One sale retained \u00b7 conflicting retry refused",
      "summary": "The first create returned idempotent_replay=false. The identical retry returned true. A changed $101 payload using the same Idempotency-Key returned idempotency_conflict (409). The database still held one sale before the separate refund.",
      "kind": "Sandbox service execution",
      "artifact": "api-executions.json",
      "source": "va_rates",
      "limitation": "Sequential retry trace in an isolated SQLite database. It does not measure concurrent hosted throughput or network-failure performance.",
      "next": "Bring a timeout/retry pattern from checkout or billing."
    },
    {
      "slug": "marketplace-and-direct",
      "title": "Tax amount and payment responsibility are different.",
      "question": "Can a period include direct, facilitated and unresolved activity without mixing their liabilities?",
      "result": "$5.30 seller \u00b7 $10.60 facilitator \u00b7 $2.65 unresolved",
      "summary": "The responsibility service kept the direct liability, documented facilitator remittance and unknown responsibility in separate amounts. The unresolved amount blocked the package writer in the exception replay.",
      "kind": "Component execution",
      "artifact": "responsibility-executions.json",
      "source": "va_marketplace",
      "limitation": "Synthetic explicit responsibility facts; no real facilitator account, remittance or registration was verified.",
      "next": "Bring one direct sale and one marketplace statement with responsibility evidence."
    }
  ],
  "reference_addresses": [
    {
      "input": {
        "zip5": "60084",
        "address": "791 RIDGE AVE",
        "on_date": "2026-07-26"
      },
      "reason": "il_sqlite_matched",
      "result": {
        "high": "0.082500",
        "drug": "0.020000",
        "grocery": "0.020000",
        "loc_code": "04900278",
        "district": "R00",
        "precision": "address",
        "source_version": "ea051b06e1bf",
        "effective_start": "2026-07-01",
        "effective_end": "9999-12-31",
        "rate_edition": "",
        "rate_window_start": "",
        "rate_window_end": ""
      }
    },
    {
      "input": {
        "zip5": "60084",
        "address": "26649 N US HIGHWAY 12",
        "on_date": "2026-07-26"
      },
      "reason": "il_sqlite_matched",
      "result": {
        "high": "0.072500",
        "drug": "0.020000",
        "grocery": "0.010000",
        "loc_code": "04950006",
        "district": "R00",
        "precision": "address",
        "source_version": "ea051b06e1bf",
        "effective_start": "2026-07-01",
        "effective_end": "9999-12-31",
        "rate_edition": "",
        "rate_window_start": "",
        "rate_window_end": ""
      }
    }
  ],
  "compliance": {
    "ledger": [
      {
        "row_id": "VA-001",
        "description": "General retail direct sale",
        "source_gross": "100.00",
        "return_gross": "100.00",
        "return_exempt": "0.00",
        "seller_tax": "5.30",
        "facilitator_tax": "0.00",
        "fips": "51660",
        "decision": "Included: direct sale; general_retail identity and locality stipulated"
      },
      {
        "row_id": "VA-002",
        "description": "Documented resale",
        "source_gross": "50.00",
        "return_gross": "50.00",
        "return_exempt": "50.00",
        "seller_tax": "0.00",
        "facilitator_tax": "0.00",
        "fips": "51660",
        "decision": "Included as exempt: synthetic reviewed certificate stipulated"
      },
      {
        "row_id": "VA-003",
        "description": "Facilitated sale",
        "source_gross": "200.00",
        "return_gross": "0.00",
        "return_exempt": "0.00",
        "seller_tax": "0.00",
        "facilitator_tax": "10.60",
        "fips": "51660",
        "decision": "Seller return excludes facilitated sale; retained in channel audit"
      }
    ],
    "fields": [
      {
        "name": "Gross sales",
        "amount": "150.00",
        "field": 5,
        "row_ids": [
          "VA-001",
          "VA-002"
        ]
      },
      {
        "name": "Exemptions and deductions",
        "amount": "50.00",
        "field": 7,
        "row_ids": [
          "VA-002"
        ]
      },
      {
        "name": "General taxable sales",
        "amount": "100.00",
        "field": 14,
        "row_ids": [
          "VA-001"
        ]
      },
      {
        "name": "General sales tax",
        "amount": "5.30",
        "field": 15,
        "row_ids": [
          "VA-001"
        ]
      }
    ],
    "validation": {
      "validator": "va_st1_webupload.validate_st1_file",
      "spec_sha256": "43fe59f39d14fa094b1d700842db873bd73e50287dfff82ee07337556d86850e",
      "spec_revision": "Web Upload Server-to-Server Specifications (ST-1 layout, April 2025+)",
      "returns": 1,
      "schedule_rows": 1,
      "localities": [
        "51660"
      ],
      "result": "conforming"
    },
    "exception": "unresolved marketplace responsibility blocks ST-1",
    "scope_exclusions": [
      "cigarette sales (field 6 zero-filled)",
      "food & personal hygiene reduced-rate sales (fields 11-12 / ST-1A 5-7 zero-filled)",
      "fuel for domestic consumption (fields 17-18 / ST-1A 9 zero-filled)",
      "prepaid wireless E-911 fee (fields 19-20 zero-filled)",
      "disposable plastic bag tax (fields 21-22 / ST-1A 8 zero-filled)",
      "consumer use tax (fields 9/13 zero-filled)",
      "dealer's discount (field 24 zero-filled \u2014 never auto-claimed)",
      "penalty/interest (fields 25-26 zero-filled)",
      "payment/banking (fields 28-30 never carry bank data)"
    ]
  },
  "artifacts": {
    "LICENSE.txt": "967975424ff5fe00029433e6999740a2aab08baceaacee43042b73bd627a4eb9",
    "README.txt": "1141e291c01aeeae84ec793be331f18a84e18238aecf4937155f2842ec604bea",
    "SYNTHETIC-DO-NOT-FILE-ST1.txt": "33121461ada267d201e848a456bab32e36dd4808edc7c24930d2a900eb0c0918",
    "address-executions.json": "bd4c6f5aabe605fea6ca97161dcf153841ffc934a717db1aa2b3030fb7c1031a",
    "api-executions.json": "a34a2b7c52ce22791072595755cefbb3e91e83de7893bac3d54301373ec6e245",
    "evaluation-instructions.txt": "5f4e6df00ff7b125d33fa977ad6fc462c4b6e17c2984428ee4b8dbe9abb00d58",
    "il-addresses.csv": "ea051b06e1bfdeab651413af511e52ba97fc046e14abbc63acbfeaca55411760",
    "package-execution.json": "91696e318bb5ec73d308a5f53df3cb86c4fd83278a0f20531fadcb28b7c4cec6",
    "package-input.json": "86cf1ceaad7b597abc23b68ccf53a7c700b83bd4e4527a0911f2f63572b7a0cb",
    "rate-snapshot.json": "c64634bfabfde6d28387c426b210f980125827d4da8b956bfeeb6cddc49fd3e8",
    "replay.py": "95ca89346eb50439d1a0004a8a7b3e45a6a02ee32f87b10de8040768d66cbac6",
    "reproduce.py": "d16d9e07639191efac80fdf404181da20a2a3f473c9ac1192ce1f671c1f92cd6",
    "responsibility-executions.json": "9a2269d590e7ae456239961df66dcfaa0e0eac6290939a3c638f9379b6297146",
    "sales-ledger.csv": "45f77bd30c26635c05bd39f9abd1a6440bd03f8a2b6f872fc9e15b6294f07ac7",
    "switching-worksheet.csv": "478bb5abab7f1b88033907e1e6ea41eef8db5d4baf00d992fc8c2fd4a5ada067",
    "verify.py": "8e3ccd420131a6cfb6a593f5db38e03557aa8851700318839ff2129da24af7d5"
  }
}