Upload 2 files

README.md

@@ -1,112 +1,112 @@
----
-title: HTS Review Tool
-sdk: streamlit
-emoji: 👀
-colorFrom: blue
-colorTo: green
----
-# HTS Checker - Tariff Audit Tool
-
-A Streamlit application for auditing HTS (Harmonized Tariff Schedule) codes, validating primary HTS against additional tariffs and description keywords.
-
-## Features
-
-- **Auto-validation**: Validation runs automatically when file is uploaded
-- **14+ Scenarios**: Validates Steel, Aluminum, Copper tariff classifications
-- **Unique Combinations View**: De-duplicates entries by HTS+Description for efficient review
-- **Interactive Filters**: Filter by HTS, description, status, scenario
-- **Bulk Export**: Add filtered results to cache and export to Excel
-- **HTS Reference**: View all Steel/Aluminum/Copper HTS lists with overlap analysis
-- **Editable Keywords**: Customize metal, aluminum, copper, zinc, plastics keyword lists
-
-## Validation Scenarios
-
-| ID | Description |
-|----|-------------|
-| S1 | Steel HTS + 232 tariff applied - verify 99030133 present, no 99030125 |
-| S2 | Metal keyword but NOT steel HTS - should apply 99030125, no 232 tariffs |
-| S3 | Steel HTS but NO metal keyword - description mismatch, should apply 99030125 |
-| S4 | Aluminum HTS + 232 tariff applied - verify 99030133 present |
-| S5 | Aluminum keyword but NOT aluminum HTS - should apply 99030125, no 232 tariffs |
-| S6 | Aluminum HTS but NO aluminum keyword - description mismatch |
-| S7 | Dual Steel+Aluminum HTS - matches keyword, apply corresponding 232 |
-| S7a | Dual Steel+Aluminum HTS + BOTH keywords - flag for manual review |
-| S8 | Dual Steel+Aluminum HTS + NO keywords - should apply 99030125 |
-| S9 | Copper keyword but NOT copper HTS - potential misclassification |
-| S10 | Copper HTS but NO copper keyword - description mismatch |
-| S11 | Dual Aluminum+Copper HTS + copper keyword - apply 99030133 + copper tariffs |
-| S12 | Dual Aluminum+Copper HTS + aluminum keyword - apply 99030133 + aluminum 232 |
-| S13 | Zinc keyword - should ONLY apply 99030125, no 232 tariffs allowed |
-| S14 | Plastics keyword + metal HTS - override, should ONLY apply 99030125 |
-
-## Key Additional HTS Codes
-
-| Code | Type |
-|------|------|
-| 99038190, 99038191 | Steel Section 232 |
-| 99038507, 99038508 | Aluminum Section 232 |
-| 99037801, 99037802 | Copper tariffs |
-| 99030133 | General 301 (accompanies 232) |
-| 99030125 | Mismatch/Override code |
-
-## Input File Format
-
-Upload Excel file with these columns:
-- **Column E (Description)**: Product description for keyword matching
-- **Column F (Tariff)**: 10-digit Primary HTS code
-- **Columns I-N (Primary 1-6)**: Additional HTS codes applied
-
-## Default Keywords
-
-**Metal**: steel, stainless steel, carbon steel, iron, metal
-
-**Aluminum**: aluminum, aluminium
-
-**Copper**: copper
-
-**Zinc**: zinc
-
-**Plastics**: plastic, abs, pu, pvc, polyester, nylon
-
-## Tabs
-
-1. **Upload & Filter**: Upload Excel file, apply initial filters
-2. **Validation Results**: View all results with interactive filters, add to export cache
-3. **Unique Combinations**: De-duplicated view by HTS+Description with occurrence count
-4. **Keyword Management**: Edit keyword lists used for validation
-5. **Export Selection**: Manage export cache and download Excel reports
-6. **HTS Reference**: View Steel/Aluminum/Copper HTS lists and overlaps
-
-## Local Development
-
-```bash
-cd HTS_Checker
-pip install -r requirements.txt
-streamlit run app.py
-```
-
-## Hugging Face Deployment
-
-1. Create a new Space on [Hugging Face](https://huggingface.co/spaces)
-2. Select **Streamlit** as the SDK
-3. Upload these files:
-   - `app.py`
-   - `hts_validator.py`
-   - `HTS_list.py`
-   - `requirements.txt`
-4. The app will auto-deploy
-
-## Files
-
-| File | Description |
-|------|-------------|
-| `app.py` | Streamlit UI application |
-| `hts_validator.py` | Core validation logic |
-| `HTS_list.py` | Steel, Aluminum, Copper HTS code lists |
-| `requirements.txt` | Python dependencies |
-
-## Requirements
-
-- streamlit
-- pandas
-- openpyxl
+---
+title: HTS Review Tool
+sdk: streamlit
+emoji: 👀
+colorFrom: blue
+colorTo: green
+---
+# HTS Checker - Tariff Audit Tool
+
+A Streamlit application for auditing HTS (Harmonized Tariff Schedule) codes, validating primary HTS against additional tariffs and description keywords.
+
+## Features
+
+- **Auto-validation**: Validation runs automatically when file is uploaded
+- **17 Scenarios**: Validates Steel, Aluminum, Copper tariff classifications
+- **Unique Combinations View**: De-duplicates entries by HTS+Description for efficient review
+- **Interactive Filters**: Filter by HTS, description, status, scenario
+- **Bulk Export**: Add filtered results to cache and export to Excel
+- **HTS Reference**: View all Steel/Aluminum/Copper HTS lists with overlap analysis
+- **Editable Keywords**: Customize metal, aluminum, copper, zinc, plastics keyword lists
+
+## Validation Scenarios
+
+| ID | Description |
+|----|-------------|
+| S1 | Steel HTS + 232 tariff applied - verify 99030133 present, no 99030125 |
+| S2 | Metal keyword but NOT steel HTS - should apply 99030125, no 232 tariffs |
+| S4 | Aluminum HTS + 232 tariff applied - verify 99030133 present, no 99030125 |
+| S5 | Aluminum keyword but NOT aluminum HTS - should apply 99030125, no 232 tariffs |
+| S7 | Dual Steel+Aluminum HTS - matches keyword, apply corresponding 232, no 99030125 |
+| S7a | Dual Steel+Aluminum HTS + BOTH keywords - flag for manual review |
+| S8 | Dual Steel+Aluminum HTS + NO keywords - flag for manual review |
+| S9 | Copper keyword but NOT copper HTS - should apply 99030125, no 232 tariffs |
+| S11 | Dual Aluminum+Copper HTS + copper keyword - apply 99030133 + copper tariffs, no 99030125 |
+| S12 | Dual Aluminum+Copper HTS + aluminum keyword - apply 99030133 + aluminum 232, no 99030125 |
+| S13 | Zinc keyword - should ONLY apply 99030125, no 232 tariffs allowed |
+| S14 | Plastics keyword + metal HTS - override, should ONLY apply 99030125 |
+| S15 | Steel HTS + aluminum keyword - should apply 99030125, no 99030133 or 232 tariffs |
+| S16 | Aluminum HTS + steel keyword - should apply 99030125, no 99030133 or 232 tariffs |
+| S17 | Copper HTS but NO copper keyword - should apply copper tariffs + 99030125, no 99030133 |
+
+## Key Additional HTS Codes
+
+| Code | Type |
+|------|------|
+| 99038190, 99038191 | Steel Section 232 |
+| 99038507, 99038508 | Aluminum Section 232 |
+| 99037801, 99037802 | Copper tariffs |
+| 99030133 | General 301 (accompanies 232) |
+| 99030125 | Mismatch/Override code |
+
+## Input File Format
+
+Upload Excel file with these columns:
+- **Column E (Description)**: Product description for keyword matching
+- **Column F (Tariff)**: 10-digit Primary HTS code
+- **Columns I-N (Primary 1-6)**: Additional HTS codes applied
+
+## Default Keywords
+
+**Metal**: steel, stainless steel, carbon steel, iron, metal
+
+**Aluminum**: aluminum, aluminium
+
+**Copper**: copper
+
+**Zinc**: zinc
+
+**Plastics**: plastic, abs, pu, pvc, polyester, nylon
+
+## Tabs
+
+1. **Upload & Filter**: Upload Excel file, apply initial filters
+2. **Validation Results**: View all results with interactive filters, add to export cache
+3. **Unique Combinations**: De-duplicated view by HTS+Description with occurrence count
+4. **Keyword Management**: Edit keyword lists used for validation
+5. **Export Selection**: Manage export cache and download Excel reports
+6. **HTS Reference**: View Steel/Aluminum/Copper HTS lists and overlaps
+
+## Local Development
+
+```bash
+cd HTS_Checker
+pip install -r requirements.txt
+streamlit run app.py
+```
+
+## Hugging Face Deployment
+
+1. Create a new Space on [Hugging Face](https://huggingface.co/spaces)
+2. Select **Streamlit** as the SDK
+3. Upload these files:
+   - `app.py`
+   - `hts_validator.py`
+   - `HTS_list.py`
+   - `requirements.txt`
+4. The app will auto-deploy
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `app.py` | Streamlit UI application |
+| `hts_validator.py` | Core validation logic |
+| `HTS_list.py` | Steel, Aluminum, Copper HTS code lists |
+| `requirements.txt` | Python dependencies |
+
+## Requirements
+
+- streamlit
+- pandas
+- openpyxl

hts_validator.py

@@ -32,6 +32,7 @@ SCENARIO_SUMMARIES = {
     "S14": "Plastics keyword + metal HTS - override, should ONLY apply 99030125",
     "S15": "Steel HTS + aluminum keyword - should apply 99030125, no 99030133 or 232 tariffs",
     "S16": "Aluminum HTS + steel keyword - should apply 99030125, no 99030133 or 232 tariffs",
+    "S17": "Copper HTS but NO copper keyword - should apply copper tariffs + 99030125, no 99030133",
     "COPPER_OK": "Copper HTS + copper keyword - verify copper tariffs applied",
     "NONE": "No applicable scenario - entry does not match any validation rules",
 }
@@ -611,7 +612,7 @@ class HTSValidator:
                 issue="; ".join(issues) if issues else "Correct - aluminum keyword with non-aluminum HTS"
             )
 
-        # Copper scenarios (COPPER_OK)
+        # Copper scenarios (COPPER_OK, S17)
         if in_copper and not in_steel and not in_aluminum:
             if has_copper_kw:
                 # COPPER_OK: Copper HTS + copper keyword
@@ -635,6 +636,32 @@ class HTSValidator:
                     unexpected_hts=[],
                     issue="; ".join(issues) if issues else "Correct - copper HTS + keyword"
                 )
+            else:
+                # S17: Copper HTS but NO copper keyword - apply copper tariffs + 99030125, no 99030133
+                expected = list(COPPER_CODES) + [MISMATCH_CODE]
+                issues = []
+
+                if not has_copper_tariff:
+                    issues.append("Missing copper tariff (99037801/02)")
+                if not has_mismatch:
+                    issues.append("Missing 99030125 - copper HTS without copper keyword")
+                if has_301:
+                    issues.append("Should NOT have 99030133 - no copper keyword in description")
+
+                status = "PASS" if not issues else "FAIL"
+                return ValidationResult(
+                    entry_number=entry_number,
+                    description=description,
+                    primary_hts=primary_hts,
+                    additional_hts=additional_hts,
+                    scenario_id="S17",
+                    scenario_summary=SCENARIO_SUMMARIES["S17"],
+                    status=status,
+                    expected_hts=expected,
+                    missing_hts=(list(COPPER_CODES) if not has_copper_tariff else []) + ([MISMATCH_CODE] if not has_mismatch else []),
+                    unexpected_hts=[GENERAL_301_CODE] if has_301 else [],
+                    issue="; ".join(issues) if issues else "Correct - copper HTS without keyword, has copper tariffs + 99030125"
+                )
 
         # S9: Copper keyword but NOT in copper list
         if has_copper_kw and not in_copper: