DLE/backend/db/data/jurisdiction_codes_analysis.md

Анализ кодов по юрисдикциям для DLE

🌍 ГЛОБАЛЬНЫЕ (МЕЖДУНАРОДНЫЕ) КОДЫ

Используются во ВСЕХ юрисдикциях:

• ISO 3166-1 - Коды стран ✅ (у нас есть)
• ISO 4217 - Коды валют ❌ (нужно создать)
• ISIC Rev.4 - Международная стандартная отраслевая классификация ✅ (у нас есть CSV)
• HS Codes - Гармонизированная система описания и кодирования товаров ❌ (нужно создать)

🇷🇺 РОССИЙСКАЯ ФЕДЕРАЦИЯ

Обязательные для регистрации юридических лиц:

• ОКВЭД - Виды экономической деятельности ✅
• ОКАТО/ОКТМО - Территориальные коды ✅
• КПП - Коды причин постановки на учет ✅

Для налогообложения и отчетности:

• КБК - Коды бюджетной классификации ✅
• ОКПД2 - Продукция по видам деятельности ✅
• ОКУН - Услуги населению ✅
• ТН ВЭД - Товарная номенклатура внешнеэкономической деятельности ✅

Статистические и отчетные:

• Коды операций ✅
• Формы отчетности ✅

🇺🇸 СОЕДИНЕННЫЕ ШТАТЫ АМЕРИКИ

Обязательные для бизнеса:

• NAICS - North American Industry Classification System ❌
• State Codes - Коды штатов ❌
• EIN/SSN - Налоговые идентификаторы (не коды, генерируются)
• SIC Codes - Standard Industrial Classification ❌

Федеральные коды:

• Federal Tax Codes ❌
• DUNS Numbers (не коды, но важно для B2B)

🇪🇺 ЕВРОПЕЙСКИЙ СОЮЗ

Общеевропейские:

• NACE Rev.2 - Статистическая классификация экономических видов деятельности ❌
• VAT Codes - НДС коды по странам ЕС ❌
• IBAN Country Codes - для банковских операций ❌

Германия:

• WZ 2008 - Классификация экономической деятельности ❌
• Bundesland Codes - Коды федеральных земель ❌

Франция:

• NAF - Nomenclature d'Activités Française ❌
• APE Codes - Коды основной деятельности ❌

🇬🇧 ВЕЛИКОБРИТАНИЯ

После Brexit:

• SIC 2007 - Standard Industrial Classification ❌
• UK Region Codes ❌
• Companies House Codes ❌

🇨🇳 КИТАЙ

Для иностранных компаний:

• GB/T 4754 - Отраслевая классификация ❌
• Administrative Division Codes - Коды административных единиц ❌

🇯🇵 ЯПОНИЯ

Коды для бизнеса:

• JSIC - Japan Standard Industrial Classification ❌
• Prefecture Codes - Коды префектур ❌

📊 ПРИОРИТИЗАЦИЯ ДЛЯ DLE

🔴 КРИТИЧНО (нужно создать немедленно):

1. ISO 4217 - Коды валют (для всех стран)
2. NAICS - США (крупнейшая экономика)
3. NACE Rev.2 - ЕС (большой рынок)

🟡 ВАЖНО (следующая очередь):

4. SIC 2007 - Великобритания
5. State Codes - США (штаты)
6. VAT Codes - ЕС

🟢 ЖЕЛАТЕЛЬНО (по запросу):

7. Азиатские юрисдикции (Китай, Япония)
8. Другие развитые страны

🎯 АРХИТЕКТУРНОЕ РЕШЕНИЕ

Структура файлов:

/backend/db/data/
├── global/
│   ├── countries.json ✅
│   ├── currencies.json ❌
│   ├── isic.json ❌ (конвертировать из CSV)
│   └── hs_codes.json ❌
├── jurisdictions/
│   ├── RU/ ✅ (все файлы готовы)
│   ├── US/
│   │   ├── naics.json ❌
│   │   ├── states.json ❌
│   │   └── sic.json ❌
│   ├── EU/
│   │   ├── nace.json ❌
│   │   ├── vat_codes.json ❌
│   │   └── countries/ (DE, FR, IT, etc.)
│   └── GB/
│       ├── sic_2007.json ❌
│       └── regions.json ❌

🚀 ПЛАН РЕАЛИЗАЦИИ

Фаза 1 (немедленно):

• Создать currencies.json (ISO 4217)
• Конвертировать ISIC из CSV в JSON
• Создать базовую структуру папок

Фаза 2 (первый квартал):

• Добавить NAICS (США)
• Добавить NACE Rev.2 (ЕС)
• Добать коды штатов США

Фаза 3 (по требованию):

• Расширение по другим юрисдикциям
• Локализация названий кодов

💡 КЛЮЧЕВЫЕ ПРИНЦИПЫ

1. Модульность - каждая юрисдикция в отдельной папке
2. Стандартизация - единый формат JSON для всех кодов
3. Глобальность - приоритет международным стандартам
4. Практичность - фокус на реально используемых юрисдикциях