Hugging Face's logo

Spaces:
APEXlogistics
/
HTSReivewTool
Running

App Files Community
joycecast commited on
Commit
46a7bae
·
verified ·
1 Parent(s): 70170d3

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +112 -105
README.md CHANGED
@@ -1,105 +1,112 @@
1
- # HTS Checker - Tariff Audit Tool
2
-
3
- A Streamlit application for auditing HTS (Harmonized Tariff Schedule) codes, validating primary HTS against additional tariffs and description keywords.
4
-
5
- ## Features
6
-
7
- - **Auto-validation**: Validation runs automatically when file is uploaded
8
- - **14+ Scenarios**: Validates Steel, Aluminum, Copper tariff classifications
9
- - **Unique Combinations View**: De-duplicates entries by HTS+Description for efficient review
10
- - **Interactive Filters**: Filter by HTS, description, status, scenario
11
- - **Bulk Export**: Add filtered results to cache and export to Excel
12
- - **HTS Reference**: View all Steel/Aluminum/Copper HTS lists with overlap analysis
13
- - **Editable Keywords**: Customize metal, aluminum, copper, zinc, plastics keyword lists
14
-
15
- ## Validation Scenarios
16
-
17
- | ID | Description |
18
- |----|-------------|
19
- | S1 | Steel HTS + 232 tariff applied - verify 99030133 present, no 99030125 |
20
- | S2 | Metal keyword but NOT steel HTS - should apply 99030125, no 232 tariffs |
21
- | S3 | Steel HTS but NO metal keyword - description mismatch, should apply 99030125 |
22
- | S4 | Aluminum HTS + 232 tariff applied - verify 99030133 present |
23
- | S5 | Aluminum keyword but NOT aluminum HTS - should apply 99030125, no 232 tariffs |
24
- | S6 | Aluminum HTS but NO aluminum keyword - description mismatch |
25
- | S7 | Dual Steel+Aluminum HTS - matches keyword, apply corresponding 232 |
26
- | S7a | Dual Steel+Aluminum HTS + BOTH keywords - flag for manual review |
27
- | S8 | Dual Steel+Aluminum HTS + NO keywords - should apply 99030125 |
28
- | S9 | Copper keyword but NOT copper HTS - potential misclassification |
29
- | S10 | Copper HTS but NO copper keyword - description mismatch |
30
- | S11 | Dual Aluminum+Copper HTS + copper keyword - apply 99030133 + copper tariffs |
31
- | S12 | Dual Aluminum+Copper HTS + aluminum keyword - apply 99030133 + aluminum 232 |
32
- | S13 | Zinc keyword - should ONLY apply 99030125, no 232 tariffs allowed |
33
- | S14 | Plastics keyword + metal HTS - override, should ONLY apply 99030125 |
34
-
35
- ## Key Additional HTS Codes
36
-
37
- | Code | Type |
38
- |------|------|
39
- | 99038190, 99038191 | Steel Section 232 |
40
- | 99038507, 99038508 | Aluminum Section 232 |
41
- | 99037801, 99037802 | Copper tariffs |
42
- | 99030133 | General 301 (accompanies 232) |
43
- | 99030125 | Mismatch/Override code |
44
-
45
- ## Input File Format
46
-
47
- Upload Excel file with these columns:
48
- - **Column E (Description)**: Product description for keyword matching
49
- - **Column F (Tariff)**: 10-digit Primary HTS code
50
- - **Columns I-N (Primary 1-6)**: Additional HTS codes applied
51
-
52
- ## Default Keywords
53
-
54
- **Metal**: steel, stainless steel, carbon steel, iron, metal
55
-
56
- **Aluminum**: aluminum, aluminium
57
-
58
- **Copper**: copper
59
-
60
- **Zinc**: zinc
61
-
62
- **Plastics**: plastic, abs, pu, pvc, polyester, nylon
63
-
64
- ## Tabs
65
-
66
- 1. **Upload & Filter**: Upload Excel file, apply initial filters
67
- 2. **Validation Results**: View all results with interactive filters, add to export cache
68
- 3. **Unique Combinations**: De-duplicated view by HTS+Description with occurrence count
69
- 4. **Keyword Management**: Edit keyword lists used for validation
70
- 5. **Export Selection**: Manage export cache and download Excel reports
71
- 6. **HTS Reference**: View Steel/Aluminum/Copper HTS lists and overlaps
72
-
73
- ## Local Development
74
-
75
- ```bash
76
- cd HTS_Checker
77
- pip install -r requirements.txt
78
- streamlit run app.py
79
- ```
80
-
81
- ## Hugging Face Deployment
82
-
83
- 1. Create a new Space on [Hugging Face](https://huggingface.co/spaces)
84
- 2. Select **Streamlit** as the SDK
85
- 3. Upload these files:
86
- - `app.py`
87
- - `hts_validator.py`
88
- - `HTS_list.py`
89
- - `requirements.txt`
90
- 4. The app will auto-deploy
91
-
92
- ## Files
93
-
94
- | File | Description |
95
- |------|-------------|
96
- | `app.py` | Streamlit UI application |
97
- | `hts_validator.py` | Core validation logic |
98
- | `HTS_list.py` | Steel, Aluminum, Copper HTS code lists |
99
- | `requirements.txt` | Python dependencies |
100
-
101
- ## Requirements
102
-
103
- - streamlit
104
- - pandas
105
- - openpyxl
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: HTS Review Tool
3
+ sdk: streamlit
4
+ emoji: 👀
5
+ colorFrom: blue
6
+ colorTo: green
7
+ ---
8
+ # HTS Checker - Tariff Audit Tool
9
+
10
+ A Streamlit application for auditing HTS (Harmonized Tariff Schedule) codes, validating primary HTS against additional tariffs and description keywords.
11
+
12
+ ## Features
13
+
14
+ - **Auto-validation**: Validation runs automatically when file is uploaded
15
+ - **14+ Scenarios**: Validates Steel, Aluminum, Copper tariff classifications
16
+ - **Unique Combinations View**: De-duplicates entries by HTS+Description for efficient review
17
+ - **Interactive Filters**: Filter by HTS, description, status, scenario
18
+ - **Bulk Export**: Add filtered results to cache and export to Excel
19
+ - **HTS Reference**: View all Steel/Aluminum/Copper HTS lists with overlap analysis
20
+ - **Editable Keywords**: Customize metal, aluminum, copper, zinc, plastics keyword lists
21
+
22
+ ## Validation Scenarios
23
+
24
+ | ID | Description |
25
+ |----|-------------|
26
+ | S1 | Steel HTS + 232 tariff applied - verify 99030133 present, no 99030125 |
27
+ | S2 | Metal keyword but NOT steel HTS - should apply 99030125, no 232 tariffs |
28
+ | S3 | Steel HTS but NO metal keyword - description mismatch, should apply 99030125 |
29
+ | S4 | Aluminum HTS + 232 tariff applied - verify 99030133 present |
30
+ | S5 | Aluminum keyword but NOT aluminum HTS - should apply 99030125, no 232 tariffs |
31
+ | S6 | Aluminum HTS but NO aluminum keyword - description mismatch |
32
+ | S7 | Dual Steel+Aluminum HTS - matches keyword, apply corresponding 232 |
33
+ | S7a | Dual Steel+Aluminum HTS + BOTH keywords - flag for manual review |
34
+ | S8 | Dual Steel+Aluminum HTS + NO keywords - should apply 99030125 |
35
+ | S9 | Copper keyword but NOT copper HTS - potential misclassification |
36
+ | S10 | Copper HTS but NO copper keyword - description mismatch |
37
+ | S11 | Dual Aluminum+Copper HTS + copper keyword - apply 99030133 + copper tariffs |
38
+ | S12 | Dual Aluminum+Copper HTS + aluminum keyword - apply 99030133 + aluminum 232 |
39
+ | S13 | Zinc keyword - should ONLY apply 99030125, no 232 tariffs allowed |
40
+ | S14 | Plastics keyword + metal HTS - override, should ONLY apply 99030125 |
41
+
42
+ ## Key Additional HTS Codes
43
+
44
+ | Code | Type |
45
+ |------|------|
46
+ | 99038190, 99038191 | Steel Section 232 |
47
+ | 99038507, 99038508 | Aluminum Section 232 |
48
+ | 99037801, 99037802 | Copper tariffs |
49
+ | 99030133 | General 301 (accompanies 232) |
50
+ | 99030125 | Mismatch/Override code |
51
+
52
+ ## Input File Format
53
+
54
+ Upload Excel file with these columns:
55
+ - **Column E (Description)**: Product description for keyword matching
56
+ - **Column F (Tariff)**: 10-digit Primary HTS code
57
+ - **Columns I-N (Primary 1-6)**: Additional HTS codes applied
58
+
59
+ ## Default Keywords
60
+
61
+ **Metal**: steel, stainless steel, carbon steel, iron, metal
62
+
63
+ **Aluminum**: aluminum, aluminium
64
+
65
+ **Copper**: copper
66
+
67
+ **Zinc**: zinc
68
+
69
+ **Plastics**: plastic, abs, pu, pvc, polyester, nylon
70
+
71
+ ## Tabs
72
+
73
+ 1. **Upload & Filter**: Upload Excel file, apply initial filters
74
+ 2. **Validation Results**: View all results with interactive filters, add to export cache
75
+ 3. **Unique Combinations**: De-duplicated view by HTS+Description with occurrence count
76
+ 4. **Keyword Management**: Edit keyword lists used for validation
77
+ 5. **Export Selection**: Manage export cache and download Excel reports
78
+ 6. **HTS Reference**: View Steel/Aluminum/Copper HTS lists and overlaps
79
+
80
+ ## Local Development
81
+
82
+ ```bash
83
+ cd HTS_Checker
84
+ pip install -r requirements.txt
85
+ streamlit run app.py
86
+ ```
87
+
88
+ ## Hugging Face Deployment
89
+
90
+ 1. Create a new Space on [Hugging Face](https://huggingface.co/spaces)
91
+ 2. Select **Streamlit** as the SDK
92
+ 3. Upload these files:
93
+ - `app.py`
94
+ - `hts_validator.py`
95
+ - `HTS_list.py`
96
+ - `requirements.txt`
97
+ 4. The app will auto-deploy
98
+
99
+ ## Files
100
+
101
+ | File | Description |
102
+ |------|-------------|
103
+ | `app.py` | Streamlit UI application |
104
+ | `hts_validator.py` | Core validation logic |
105
+ | `HTS_list.py` | Steel, Aluminum, Copper HTS code lists |
106
+ | `requirements.txt` | Python dependencies |
107
+
108
+ ## Requirements
109
+
110
+ - streamlit
111
+ - pandas
112
+ - openpyxl