一个专业的报关单制作系统支持预报单和最终报关单的制作具有Excel文件上传、自动匹配HS CODE、自动计算关税等功能。功能特性核心功能- **报关单制作**支持预报单和最终报关单两种类型- **Excel文件上传**- 发票Excel表格自动匹配HS CODE、数量、单价、总金额、关税金额- 装箱单Excel表格自动匹配数量、件数、重量、体积- **HS CODE管理**支持Excel导入HS CODE数据库自动匹配关税税率- **自动计算**根据HS CODE自动计算关税金额- **日期处理**自动生成公历日期和伊斯兰历日期- **数据存储**SQLite数据库存储支持数据持久化技术架构- **后端**Python FastAPI SQLAlchemy- **前端**Vue 3 Element Plus- **数据库**SQLite支持MySQL/PostgreSQL- **文件处理**pandas openpyxl安装部署后端部署1. **克隆项目**bashgit clone 项目地址cd customs_declaration/backend2. **安装依赖**bashpip install -r requirements.txt3. **启动服务**bashuvicorn app.main:app --host 0.0.0.0 --port 8000 --reload前端部署1. **安装依赖**bashcd ../frontendnpm install2. **启动开发服务器**bashnpm run dev3. **构建生产版本**bashnpm run build使用指南1. 导入HS CODE数据库- 准备包含以下列的Excel文件- codeHS CODE编码- description商品描述- arabic_description阿拉伯语描述可选- duty_rate关税税率小数形式如0.1表示10%- 在系统中点击HS CODE管理 - 导入HS CODE2. 创建报关单- 进入创建报关单页面- 填写报关单基本信息类型、提单号、发票号、收货人、发货人- 上传发票Excel文件包含hs_code、description、quantity、unit、unit_price列- 上传装箱单Excel文件包含hs_code、quantity、package_count、weight、volume列- 系统会自动匹配HS CODE、计算关税金额- 点击提交按钮创建报关单3. 管理报关单- 在报关单列表页面查看所有报关单- 点击查看按钮查看报关单详情API文档后端API文档可通过访问 http://localhost:8000/docs 查看。主要API端点- **报关单API**/api/customs/declarations/*- **文件上传API**/api/customs/upload/*- **HS CODE API**/api/customs/hscode/*注意事项1. **Excel文件格式**- 发票Excel必须包含hs_code、description、quantity、unit、unit_price列- 装箱单Excel必须包含hs_code、quantity、package_count、weight、volume列- HS CODE Excel必须包含code、description、duty_rate列2. **HS CODE匹配**- 系统会根据Excel中的hs_code字段自动匹配数据库中的HS CODE- 如未找到匹配的HS CODE关税税率默认为03. **日期处理**- 系统自动生成公历日期和伊斯兰历日期- 伊斯兰历日期为简化计算实际项目中可使用更精确的转换库4. **数据安全**- 建议在生产环境中使用MySQL或PostgreSQL数据库- 建议配置适当的访问控制故障排查1. **文件上传失败**- 检查文件格式是否正确- 检查文件大小是否超过10MB2. **HS CODE匹配失败**- 检查Excel中的hs_code格式是否正确- 检查HS CODE数据库是否已导入3. **系统错误**- 查看服务器日志获取详细错误信息- 检查数据库连接是否正常