Таможенная статистика и открытые данные ФТС России
| Признак | Значение |
|---|---|
| Уровень и охват | Федеральный: агрегированная таможенная статистика внешней торговли и открытые ведомственные реестры ФТС России |
| Тип доступа | HTML-витрина со скачиваемыми XLSX/XLS и каталог открытых данных с CSV и паспортами |
| Основные форматы | CSV, XLSX; в исторических разделах также XLS, DOC и DOCX |
| Оператор | ФТС России |
| Режим доступа | Открытый; раздел stat.customs.gov.ru при проверке перенаправлял в личный кабинет участника ВЭД и не является открытым API |
Коротко: это первичный официальный источник для двух разных задач: агрегированной внешней торговли товарами и справочных реестров таможенной инфраструктуры/участников. На 2026-07-17 подтверждены актуальная пара XLSX за январь–май 2026 и 35 наборов CSV в каталоге открытых данных. Здесь нет построчных таможенных деклараций, выгрузки начисленных или уплаченных таможенных платежей и строк кассового исполнения бюджета.
Качество и верификация
| Измерение | Значение для этой карточки |
|---|---|
Дата проверки (last_verified) | 2026-07-17: открыты HTML-витрина статистики, каталог ОД, паспорта и фактические файлы, перечисленные ниже. |
Полнота (data_completeness) | Частичная для анализа ВЭД: проверенный XLSX содержит только группы стран или товарные группы, а не декларации, страны-партнёры по отдельности либо товары ТН ВЭД на уровне позиции. CSV-каталог покрывает опубликованные ФТС реестры, но не все оперативные ИС службы. |
Машиночитаемость (machine_readability) | Смешанная: CSV с паспортами и версиями удобны для скриптов; актуальная ВЭД — XLSX с многострочной шапкой и без плоской схемы; часть витрины — HTML/DOC(X). Открытого API для этих данных не подтверждено. |
Юридическая значимость (legal_significance) | Официальная первичная публикация ФТС: файлы и паспорта расположены на customs.gov.ru. data.gov.ru — только государственный каталог/зеркало метаданных, а не источник схемы или версии. |
Задержка обновления (update_lag) | Единого лага нет. У проверенной таблицы ВЭД за январь–май 2026 файл изменён 2026-07-13: это 43 календарных дня после конца мая; это наблюдение одного выпуска, а не обещанная периодичность. В CSV-реестрах дата файла — дата среза/выгрузки, но дата фактического события обычно не указана. |
Глубина архива (archive_depth) | Неоднородна. В паспортах проверенных CSV есть версии: перевозчики с 2013-05-27, представители с 2013-05-27, ТРОИС с 2015-04-09, проверки с 2016-10-05; страница текущей ВЭД подтверждает архив выпусков за январь, февраль, март и май 2026. Непрерывность архивов не заявлена. |
Лицензия (license_or_terms) | На странице «Открытые данные» ФТС разрешает свободное, бессрочное и безвозмездное использование CSV-наборов, включая коммерческое, при законном использовании, неискажении данных и указании источника. Отдельные условия для статистических XLSX на проверенной странице не указаны — не переносите эти условия автоматически на XLSX. |
Описание
Портал нужно разделять на три несмешиваемых слоя.
- Таможенная статистика внешней торговли — публикуемые XLSX/XLS и сопроводительные документы. Проверенный текущий выпуск — два небольших XLSX с агрегатами в млрд долларов США.
- Открытые данные ФТС — 35 идентифицированных CSV-наборов и их машиночитаемые паспорта
meta.csv. Это главным образом реестры, справочники, вакансии и ведомственные сведения; не статистика деклараций. - Личный кабинет участника ВЭД — бывший адрес
stat.customs.gov.ruпри проверке перенаправляет вedata.customs.ru/FtsPersonalCabinetWeb/. Он требует входа и в эту карточку как открытый набор или API не включён.
Не относите к этому источнику кассовое исполнение бюджета и не выводите его из внешнеторговых сумм. Таможенные платежи администрируются ФТС, однако кассовые строки бюджета и отчётные формы берут из отчётов Федерального казначейства, а не из представленных здесь таблиц ВЭД.
Оператор
Федеральная таможенная служба — официальный портал и страница организации. ФТС одновременно публикует и эксплуатирует проверенные витрины, поэтому это отражено двумя типизированными связями в frontmatter.
URL и точки доступа
| Тип доступа | URL | Формат и назначение |
|---|---|---|
| Витрина таможенной статистики | https://customs.gov.ru/statistic | HTML; актуальные и исторические ссылки на файлы |
| Витрина «Итоги внешней торговли со всеми странами» | страница набора | HTML; стабильная точка входа и список версий XLSX |
| Каталог открытых данных | https://customs.gov.ru/opendata | HTML; условия использования и ссылки на 35 наборов |
| Машиночитаемый реестр каталога | https://customs.gov.ru/opendata/list.csv | CSV; один ряд описывает один набор/паспорт, а не наблюдение таможенной статистики |
| Паспорт отдельного набора | например, meta.csv реестра представителей | CSV; идентификатор, описание, даты, URL версий данных и схемы |
| Каталог/зеркало метаданных | организация ФТС на data.gov.ru | Дополнительная точка поиска. Сверяйте ссылку на файл и паспорт с customs.gov.ru. |
Карта опубликованных наборов и файлов
| Семейство данных / набор | Что описывает | Единица наблюдения | Период и охват | Формат и точка доступа | Обновление / архив | Пригодность для машинной обработки |
|---|---|---|---|---|---|---|
«Итоги внешней торговли со всеми странами»: страны052026.xlsx и структура052026.xlsx | Соответственно экспорт/импорт по группам стран и по товарным группам | Строка агрегата группы; в обоих файлах есть служебная строка «в том числе:» | Январь–май 2026; Российская Федерация, млрд долл. США | страница выпуска, группы стран, товарная структура | Версионные URL; на странице подтверждены выпуски за январь, февраль, март и май 2026 | Файл с подтверждённой схемой, но это широкая XLSX-таблица, не CSV и не микроданные |
| ВЭД с ЕАЭС, дальним зарубежьем, СНГ и основными странами | Четыре отдельных исторических среза внешней торговли | Не проверялось из фактических файлов этой редакцией | В витрине на дату проверки указано: январь 2022 | витрина статистики; ссылки ведут на четыре XLSX | Периодичность и полнота архива не подтверждены | Машиночитаемые файлы, но схема и актуальность не подтверждены; не проектируйте импорт по одному имени страницы |
| Экспорт и импорт важнейших товаров | Два исторических файла по важнейшим товарам | Не проверялось из фактических файлов этой редакцией | В витрине: январь 2022 | витрина статистики; XLSX | Периодичность и полнота архива не подтверждены | Машиночитаемые файлы, но схема меняется или неполна |
| Товарная структура экспорта и импорта | Два исторических файла товарной структуры и пояснение к ним | Не проверялось из фактических файлов этой редакцией | В витрине: январь 2022 | витрина статистики; XLSX и DOC | Периодичность и полнота архива не подтверждены | XLSX — машиночитаемый файл, но схема не подтверждена; DOC — публикация без подтверждённой построчной структуры |
| Индексы цен внешней торговли | Базисные и цепные индексы, месячные и квартальные | Не проверялось из фактических файлов этой редакцией | В витрине: январь 2022 и IV квартал 2021 | витрина статистики; XLSX | Периодичность и полнота архива не подтверждены | Машиночитаемые файлы, но схема и методика конкретных листов не проверены |
| Внешняя торговля субъектов РФ | Историческая таблица по субъектам Российской Федерации | Не проверялось из фактического файла этой редакцией | В витрине: январь 2022 | витрина статистики; XLSX | Периодичность и полнота архива не подтверждены | Машиночитаемый файл, но схема и актуальность не подтверждены |
| Экспорт субъектов малого и среднего предпринимательства | Три файла: общий экспорт, несырьевой экспорт и несырьевой неэнергетический экспорт | Не проверялось из фактических файлов этой редакцией | В витрине: январь 2022 | витрина статистики; XLSX | Периодичность и полнота архива не подтверждены | Машиночитаемые файлы, но схема и актуальность не подтверждены |
| Гуманитарная и техническая помощь | Сопроводительный ведомственный материал | Построчная структура не подтверждалась | В витрине: декабрь 2021 | витрина статистики; DOCX | Периодичность и полнота архива не подтверждены | Публикация без подтверждённой построчной структуры |
list.csv — реестр наборов открытых данных | Перечень 35 опубликованных наборов ФТС и URL их паспортов | Одна строка — описание одного набора; строка standardversion — служебная мета-запись | Состояние каталога на дату скачивания; федеральный охват | прямой CSV | Не содержит дат версий каждого набора; за ними переходят в meta.csv | Справочник/паспорт, а не набор наблюдений; UTF-8 CSV с запятыми и кавычками |
7730176610-p5statplanprov — проверки | Число плановых и внеплановых проверок ФТС и РТУ | Одна строка — агрегат по названной группе таможенных органов | Период внутри текущего файла не назван; федеральный охват | паспорт, CSV 2026-06-11 | 90 ссылок-версий в проверенном паспорте: 2016-10-05—2026-06-11; нерегулярно | Файл с подтверждённой схемой; малый CSV, но не ряд по датам |
7730176610-reesrtampredst — реестр таможенных представителей | Представители, их реквизиты и обособленные подразделения | Строка представителя либо его подразделения; представитель повторяется для каждого подразделения | Срез на дату файла; федеральный реестр | паспорт, CSV 2026-07-17 | 1 818 ссылок-версий в паспорте: 2013-05-27—2026-07-17 | Файл с подтверждённой схемой; пригоден после сохранения кодов строками и дедупликации по назначению анализа |
7730176610-reestrtamperev — реестр таможенных перевозчиков | Юридические лица из реестра перевозчиков, документы, сроки и реквизиты | Строка записи файла о перевозчике/документе; паспорт не задаёт уникальную гранулярность | Срез на дату файла; страны и таможенные органы из полей записи | паспорт, CSV 2026-07-03 | 513 ссылок-версий: 2013-05-27—2026-07-03 | Файл с подтверждённой схемой, но без документированного уникального ключа |
7730176610-trois — ТРОИС | Объекты интеллектуальной собственности, включённые в таможенный реестр | Техническая строка реестра; регистрационный номер повторяется, поэтому строка не равна одному объекту | Срез на дату файла; федеральный реестр | паспорт, CSV 2026-07-17 | 966 ссылок-версий: 2015-04-09—2026-07-17 | Машиночитаемый набор, но гранулярность неполна: схема есть, первичный ключ не опубликован |
| Остальные 31 CSV из каталога ОД | Места временного хранения, терминалы, владельцы складов и магазинов, вакансии, НПА, услуги, стратегические документы, банки, маски документов и обращения граждан | Зависит от отдельного паспорта | Федеральный; актуальность различается между наборами | Полный точный перечень ниже; каждый идентификатор ведёт к своему meta.csv | Проверять паспорт и файл индивидуально | CSV-наборы, схема не проверялась в этой карточке; не переносите поля из четырёх описанных CSV на них |
Полный перечень других наборов из list.csv
Проверенный реестр наборов на 2026-07-17 содержит, помимо четырёх подробно описанных CSV, следующие точные идентификаторы. URL паспорта каждого строится как https://customs.gov.ru/<идентификатор>/meta.csv; это ссылка на паспорт, а не на данные наблюдений.
- Инфраструктура и владельцы:
7730176610-mestavh,7730176610-tltgranitsa,7730176610-reestrmbt,7730176610-reestrvtamskl,7730176610-revlsvrhr. - Вакансии (20 отдельных наборов, не один общий):
7730176610-p6vakantdlzndvtu,7730176610-p6vakantdlznfts,7730176610-p6vakantdlznjutu,7730176610-p6vakantdlznctu,7730176610-p6vakantdlznutu,7730176610-p6vakantdlznstu,7730176610-p6vakantdlznsztu,7730176610-p6vakantdlznreboti,7730176610-p6vakantdlzndcektu,7730176610-p6vakantdlznsktu,7730176610-p6vakantdlzncet,7730176610-p6vakantdlzncat,7730176610-p6vakantdlzncbt,7730176610-p6vakantdlzncittu,7730176610-p6vakantdlznsht,7730176610-p6vakantdlznvnt,7730176610-p6vakantdlznptu,7730176610-p6vakantdlzndt,7730176610-p6vakantdlzncpt,7730176610-p6vakantdlzncentrt. - Справочные и ведомственные:
7730176610-law,7730176610-pgu,730176610-docgosstrplan,7730176610-rebankincredit,7730176610-mask44,7730176610-grazhdane.
Подробные структуры файлов
«Итоги внешней торговли со всеми странами» — выпуск за январь–май 2026
Назначение и гранулярность. Страница названа «Итоги внешней торговли со всеми странами», однако скачиваемый файл страны052026.xlsx не содержит строк отдельных стран или их кодов. В нём одна содержательная строка — агрегат группы стран: «Весь мир», Европа, Азия, Африка, Америка или Океания. Строка «в том числе:» — заголовок-разделитель без чисел, её нужно исключить из данных. Сопутствующий файл структура052026.xlsx не является описанием схемы: это другая таблица с одной строкой на широкую товарную группу.
Точки доступа и версия. В проверенной статистической витрине опубликена HTML-страница выпуска, а не машиночитаемый паспорт meta.csv; используйте страницу как стабильную точку входа. Проверены две прямые, но версионные, а не «latest», ссылки: группы стран и товарная структура. У обоих файлов Last-Modified: 2026-07-13; HTML-страница показывает период «январь–май 2026».
Техническое представление. Оба файла — настоящие XLSX (OOXML), по одному листу: 1 и структура соответственно. BOM, кодировка и разделитель к XLSX неприменимы; значения сумм и темпов находятся в ячейках как числовые значения, даты внутри листов отсутствуют, формул нет. Шапка занимает строки 1–5, диапазоны A1:F2 (или A1:G2), B4:D4 и E4:G4 объединены. Несмотря на денежный формат ячеек с символом рубля, заголовок листа прямо задаёт единицу: млрд долл. США. Для анализа используйте единицу из заголовка, а не стиль ячейки.
Лист 1 файла страны052026.xlsx
| Поле в файле | Тип данных | Смысл | Допустимые значения / формат | Роль в ключе или связи | Ограничения |
|---|---|---|---|---|---|
A (строки 6–12) | строка | Группа стран | «Весь мир», названия частей света; A7 — служебное «в том числе:» | После нормализации: часть ключа вместе с периодом и направлением | Нет кодов стран или классификатора; не соединять со справочником стран как будто это страны-партнёры |
B | число | Экспорт за январь–май 2025 | млрд долл. США | Мера | Значение не является рублём, хотя отображающий формат ячейки содержит символ ₽ |
C | число | Экспорт за январь–май 2026 | млрд долл. США | Мера | Период зашит в многострочной шапке, а не в отдельном поле |
D | число | Темп роста экспорта | процент | Производная мера | В файле нет формулы; проверяется как C / B × 100 |
E | число | Импорт за январь–май 2025 | млрд долл. США | Мера | Период зашит в шапке |
F | число | Импорт за январь–май 2026 | млрд долл. США | Мера | Период зашит в шапке |
G | число | Темп роста импорта | процент | Производная мера | В файле нет формулы; проверяется как F / E × 100 |
Лист структура файла структура052026.xlsx
Схема B:G та же, что у листа 1; меняется значение колонки A.
| Поле в файле | Тип данных | Смысл | Допустимые значения / формат | Роль в ключе или связи | Ограничения |
|---|---|---|---|---|---|
A (строки 6–15) | строка | «Всего» либо товарная группа | Текст с диапазонами глав ТН ВЭД в начале, например 01-24-..., 68-70, 84-97-... | После нормализации: часть ключа вместе с периодом и направлением | Это не отдельное поле кода ТН ВЭД: диапазоны могут быть составными; не извлекайте их как точный код без собственной документированной процедуры |
B–G | числа | Те же экспортные и импортные суммы за 2025/2026 и темпы роста, что описаны выше | млрд долл. США для B, C, E, F; проценты для D, G | Меры | Стили ячеек не определяют единицу; она указана в заголовке листа |
Ключ и соединения. Первичный ключ не поставляется. После преобразования широкой таблицы в длинную разумный технический идентификатор — (period_start, period_end, dimension, group_label, flow), где flow ∈ {export, import}; это ключ нормализованной копии, а не ключ ФТС. Для первой книги dimension = country_group, для второй — commodity_group. Не существует проверенного поля для соединения с отдельной страной, декларацией, таможенным органом, валютой, КБК или строкой бюджета.
Контрольные соотношения и ошибки. В строке «Весь мир» темпы роста совпадают с отношением сумм текущего и прошлого периодов. В товарной структуре сумма групп практически равна «Всего» (расхождение 0,0001 млрд долл. США в экспорте из-за округления); в группах стран подгруппы не дают общий итог: по экспорту 2026 разница составляет 0,0553 млрд долл. США, по импорту 0,0182 млрд. Не заменяйте итог суммой континентов. Не объединяйте файл групп стран с товарной структурой по позиции строки: их измерения независимы.
Граница применимости. Подходит для быстрой проверки агрегированного товарооборота и сравнения с предыдущим годом. Не подходит для анализа отдельных стран, товарных позиций ТН ВЭД, компаний, таможенных деклараций, уплаченных платежей, валютных курсов или кассовых доходов бюджета.
7730176610-p5statplanprov — статистическая информация о проверках
Назначение и гранулярность. Официальный паспорт описывает набор как количество плановых и внеплановых проверок, проведённых ФТС и региональными таможенными управлениями. В текущем файле две строки: «ФТС России» и «Региональные таможенные управления». Это агрегаты групп органов, не реестр самих проверок.
Точки доступа и версия. HTML-паспорт, машиночитаемый паспорт, файл 2026-06-11, описание структуры. Паспорт содержит 90 ссылок на версии с 2016-10-05 по 2026-06-11; интервал между ними не является регулярным календарём публикаций.
Техническое представление. CSV UTF-8 без BOM, разделитель ;, строки CRLF, заголовок и две записи. Кавычки в текущем файле не используются; пустые значения как отдельный случай не наблюдались. Десятичные чисел нет. Поле периода отсутствует: дата в имени файла — дата версии, а не явно названный отчётный период.
| Поле в файле | Тип данных | Смысл | Допустимые значения / формат | Роль в ключе или связи | Ограничения |
|---|---|---|---|---|---|
№ п/п | целое | Порядковый номер строки | 1, 2 в проверенной версии | Технический порядок, не стабильный ключ | Может измениться при добавлении группы |
Таможенный орган, проводивший проверку | строка | Группа органов, проводивших проверки | В версии 2026-06-11: «ФТС России», «Региональные таможенные управления» | Логическая категория | Нет кода органа и нет разреза по отдельным РТУ |
Количество проверок | целое | Число проверок | Неотрицательное целое в проверенном файле | Аддитивная мера только при одинаковом, подтверждённом периоде | В файле не указан период, вид проверки и объект проверки |
Ключ, контроль и применимость. В конкретной версии уникальны № п/п и название группы, но паспорт не определяет первичный ключ. Для панели сохраняйте file_version_date и название группы. Не суммируйте исторические версии: это срезы, а не помесячные приращения. Набор годится для описания опубликованного агрегата проверок; не годится для подсчёта проверок по регионам, компаниям или датам и не говорит о таможенных платежах.
7730176610-reesrtampredst — реестр таможенных представителей
Назначение и гранулярность. Это перечень таможенных представителей. Одна строка описывает самого представителя либо одно его обособленное подразделение. Поэтому один регистрационный номер встречается во множестве строк: в версии 2026-07-17 1 038 строк и 796 разных регистрационных номеров.
Точки доступа и версия. HTML-паспорт, паспорт meta.csv, CSV 2026-07-17, схема. В паспорте 1 818 ссылок на версии за 2013-05-27—2026-07-17. Сам паспорт и файл обновлены на дату проверки; это не заменяет дату изменения записи представителя.
Техническое представление. CSV UTF-8 без BOM, ; как разделитель, " как ограничитель строк, CRLF. Пустое поле записывается как "". Все даты в данных имеют форму YYYY.MM.DD. Десятичные чисел нет. Схема называет ряд идентификаторов «числовыми», но в аналитической копии их следует хранить строками: РЕГ НОМЕР содержит ведущие нули, ИНН/КПП являются идентификаторами, а не величинами.
| Поле в файле | Тип данных | Смысл | Допустимые значения / формат | Роль в ключе или связи | Ограничения |
|---|---|---|---|---|---|
ST | строка | Страна | В проверенном файле RU | Контекст записи | Паспорт не называет классификатор; не подменяйте описанием страны без отдельной проверки |
РЕГ НОМЕР | строковый код | Регистрационный номер представителя | Четыре цифры, например 0003 | Идентификатор представителя, но не строки | Обязательно сохранять ведущие нули; повторяется для подразделений |
ДАТА ВКЛЮЧЕНИЯ В РЕЕСТР | дата | Дата включения юридического лица | YYYY.MM.DD | Атрибут представителя | Не дата версии выгрузки |
НАИМЕНОВАНИЕ ТАМОЖ. ПРЕД | строка | Наименование таможенного представителя | Свободный текст | Соединение только после нормализации и проверки | Не уникально и не заменяет ИНН |
ADROWN | строка | Юридический адрес | Свободный адрес | — | В заголовке используется техническое имя, а не русское название из паспорта |
TELEFON | строка | Телефон | Текст с разным форматированием | — | Пропуски есть; не числовое поле |
EMAIL | строка | Электронная почта | Текст | — | Пропуски есть; не ключ организации |
INN | строковый код | ИНН представителя | 10 цифр в проверенной версии | Наиболее практичное соединение с российскими реестрами после контроля | Хранить строкой; не все внешние наборы используют тот же идентификатор |
KPP | строковый код | КПП представителя | 9 цифр в проверенной версии | Уточняет российскую организацию | Хранить строкой |
KPP2 | строковый код | Второй КПП при наличии | 9 цифр; обычно пустой | Дополнительный реквизит | Не превращать пустоту в ноль |
НАИМЕНОВАНИЕ ПОДРАЗДЕЛЕНИЙ | строка | Наименование обособленного подразделения | Свободный текст или пусто | Уточняет строку подразделения | Пусто для строки без подразделения |
АДРЕС ПОДРАЗДЕЛЕНИЙ | строка | Адрес подразделения | Свободный адрес или пусто | Уточняет строку подразделения | Не геокодированное поле |
КПП ПОДРАЗДЕЛЕНИЙ | строковый код | КПП подразделения | 9 цифр или пусто | Может различать подразделения | Хранить строкой |
ОГРАНИЧЕНИЯ ПО РЕГИОНУ | строковый код | Код таможенного органа, в регионе которого разрешены операции | 8 цифр в непустых значениях проверенного файла | Возможная связь со справочником таможенных органов только после получения официального справочника | Большинство значений пусты; справочник в этом наборе отсутствует |
ОГРАНИЧЕНИЯ ПО ТН ВЭД (MIN) | строковый код | Начало диапазона ТН ВЭД ЕАЭС | 10 цифр или пусто | Пара с MAX | Сохранять строкой; диапазон не равен одному товару |
ОГРАНИЧЕНИЯ ПО ТН ВЭД (MAX) | строковый код | Конец диапазона ТН ВЭД ЕАЭС | 10 цифр или пусто | Пара с MIN | Не соединять по равенству с товарной группой XLSX |
ОГР ПО ЭКСП БЕСПОШЛ ТОВ | строковый код | Код таможенной процедуры | В непустых значениях 10 | Кодовое ограничение | В паспорте не приведён справочник процедуры |
Ключ и правила соединения. РЕГ НОМЕР не уникален. Комбинация РЕГ НОМЕР + КПП ПОДРАЗДЕЛЕНИЙ + НАИМЕНОВАНИЕ ПОДРАЗДЕЛЕНИЙ + АДРЕС ПОДРАЗДЕЛЕНИЙ почти различает строки текущей версии, но в ней всё равно есть три точных дубля. Для технического слоя сохраняйте URL/дату версии и хеш полной строки; для уровня организации агрегируйте только после явного правила (например, INN + KPP, отдельно документируя судьбу подразделений). Не обрезайте нули у регистрационного номера, ИНН, КПП и кодов ТН ВЭД.
Контроль и применимость. Проверяйте равенство числа колонок 17, валидность дат, длину кодов и дубли на выбранном уровне агрегации. Представитель с несколькими подразделениями не означает несколько разных юридических лиц. Набор подходит для списка представителей и их подразделений; не содержит деклараций, оборота ВЭД, таможенных платежей или статуса на произвольную прошедшую дату без использования архивной версии.
7730176610-reestrtamperev — реестр таможенных перевозчиков
Назначение и гранулярность. Паспорт определяет набор как перечень юридических лиц, включённых в реестр таможенных перевозчиков. Фактический файл имеет 4 506 строк и 27 колонок: номер лицензии/свидетельства повторяется при разных атрибутах документа, периодах или кодах органа. Документированного первичного ключа нет; не делайте вывод, что одна строка равна одной организации или одной действующей лицензии.
Точки доступа и версия. HTML-паспорт, паспорт meta.csv, CSV 2026-07-03, схема. Паспорт содержит 513 ссылок на версии за 2013-05-27—2026-07-03.
Техническое представление. CSV UTF-8 без BOM, ;, двойные кавычки, CRLF; пустота — пустая строка в ячейке. Даты в полях DBEGIN, DEND, DEND_TP имеют вид YYYY.MM.DD. Все коды, номера и реквизиты, включая ST, NLIC, ИНН, КПП, ОГРН, ОКПО и коды органа, храните строками: ведущие нули и буквенные суффиксы значимы. Десятичные чисел нет.
| Поле в файле | Тип данных | Смысл | Допустимые значения / формат | Роль в ключе или связи | Ограничения |
|---|---|---|---|---|---|
ST | строковый код | Буквенный код страны | 2 символа; в файле встречаются BY, RU, KG, KZ, AM | Контекст номера документа | Паспорт не называет конкретный классификатор |
TYP_DOC | строковый код | Тип документа | Односимвольный числовой код или пусто | Часть идентификации документа | Справочника кодов в наборе нет |
NLIC | строковый код | Номер лицензии/свидетельства | Цифры, возможны ведущие нули | Частичный идентификатор документа | Повторяется |
PR_PER | строка | Буква добавления к номеру при перерегистрации | Буква или пусто | Дополняет номер документа | Пустота не равна нулю |
N_BLANK | строковый код | Номер комплекта бланков лицензии/свидетельства | Цифры/пусто | Дополняет документ | Не у всех записей заполнен |
DBEGIN | дата | Дата выдачи лицензии/свидетельства | YYYY.MM.DD | Атрибут периода документа | Не дата появления строки в файле |
DEND | дата | Срок окончания действия | YYYY.MM.DD или пусто | Атрибут периода документа | Значение 2099.12.31 не следует трактовать как фактическое событие без методики |
KODT | строковый код | Код(ы) таможенного органа в регионе деятельности перевозчика | 8 цифр в проверенных непустых значениях | Возможная связь со справочником органов | В одном поле может быть несколько кодов; справочник отсутствует |
IDEL | строковый код | Отметка статуса лицензии/свидетельства | Односимвольный числовой код | Атрибут статуса | Значение кодов не расшифровано в схеме |
OWNER | строка | Наименование перевозчика | Свободный текст | Соединение только после проверки с ИНН/ОГРН | Не гарантированно уникально |
ADRROWN | строка | Местонахождение перевозчика | Свободный адрес | — | Не геокодировано |
ADRPOCHT | строка | Почтовый адрес перевозчика | Свободный адрес | — | В схеме есть опечатка типа, это текст |
TELEFP | строка | Телефон | Свободное форматирование | — | Не число; могут быть несколько номеров |
TELETYPE | строка | Телетайп | Текст/пусто | — | Часто пусто |
TELEFAX | строка | Факс | Текст/пусто | — | Часто пусто |
WEBSITE | строка | Сайт | URL/текст/пусто | — | URL не гарантированно нормализован |
EMAIL | строка | Электронная почта | Текст/пусто | — | Не ключ |
OGRN | строковый код | ОГРН перевозчика | Цифры/пусто | Связь с российской организацией после проверки | Неприменим к части иностранных записей |
INN | строковый код | ИНН перевозчика | Цифры/пусто | Связь с российской организацией после проверки | Хранить строкой; может отсутствовать |
KPP | строковый код | КПП перевозчика | Цифры/пусто | Уточнение российской организации | Хранить строкой |
OKPO | строковый код | ОКПО перевозчика | Цифры/пусто | Дополнительная связь | Хранить строкой |
IAKCIZ | строковый код | Право на доставку подакцизных товаров | Код/пусто | Атрибут разрешения | Справочник значений не опубликован в наборе |
VIDTRANS | строковый код | Код(ы) вида транспорта | Код/пусто | Атрибут перевозчика | Справочник и правило множественности не приложены |
OPF_VL | строковый код | Организационно-правовая форма | Код/пусто | Атрибут перевозчика | Справочник не приложен |
RF_OUTP | строковый код | Вид(ы) обеспечения уплаты таможенных платежей | Код/пусто | Атрибут документа | Не сумма платежей и не кассовый доход |
DOC_TP | строка | Номер, дата выдачи и срок документа об обеспечении уплаты платежей | Свободный текст/пусто | Атрибут документа | Не разбито на отдельные поля |
DEND_TP | дата | Окончание действия документа об обеспечении | YYYY.MM.DD или пусто | Атрибут документа | Не путать с DEND лицензии |
Ключ, контроль и применимость. Даже состав ST, TYP_DOC, NLIC, PR_PER, N_BLANK, DBEGIN, DEND, KODT оставляет повторы в проверенной версии. Используйте хеш полной строки как технический идентификатор с сохранением даты версии; ключ организации строить только отдельным правилом на ИНН/ОГРН и не для иностранных записей. Набор годится для исследования реестра перевозчиков и реквизитов, но не для подсчёта перевозок, грузов, внешнеторговой стоимости или таможенных платежей.
7730176610-trois — Таможенный реестр объектов интеллектуальной собственности
Назначение и гранулярность. Паспорт говорит о сведениях об объектах интеллектуальной собственности (ОИС), включённых в таможенный реестр. В текущем CSV 41 954 строк, но только 7 894 разных REGNOM: номер реестра повторяется. Паспорт не определяет, какая комбинация полей образует строку ОИС; следовательно, строка — техническая запись выгрузки, а не гарантированно один объект, товар или правообладатель.
Точки доступа и версия. HTML-паспорт, паспорт meta.csv, CSV 2026-07-17, схема. В паспорте 966 версий с 2015-04-09 по 2026-07-17.
Техническое представление. CSV UTF-8 без BOM, ;, двойные кавычки. Файл использует CRLF, а в поле COMM встречаются переводы строки внутри кавычек; нельзя разбирать его построчно через split('\n'). Открывайте CSV-парсером с newline=''. Пустые значения — ""; чисел с десятичной частью нет. Реальные даты DPRAVO и DATEEND записаны как YYYY.MM.DD. В паспорте есть противоречия типам фактических значений: REGNOM содержит /, - и кириллицу, DPRAVO является датой, а NAME — текстом; все три храните строками до явного преобразования.
| Поле в файле | Тип данных | Смысл | Допустимые значения / формат | Роль в ключе или связи | Ограничения |
|---|---|---|---|---|---|
REGNOM | строковый код | Регистрационный номер по реестру | Например, 00257/00062-074/ТЗ-221104 | Идентификатор ОИС верхнего уровня | Не уникален на строку; паспорт ошибочно называет формат integer |
G31_12 | строка | ОИС | Наименование/обозначение или пусто | Атрибут записи | Не уникально |
NOTE | строка | Срок принятия мер | Встречаются «Срок истек», «Исключен» и пусто | Атрибут статуса | Не стандартизированный код |
NPRAVO | строковый код | Поле паспорта обозначено только NPRAVO | Цифры или пусто | Возможный реквизит права | Семантика не расшифрована официальной схемой; не придумывайте название |
DPRAVO | строка-дата | Поле паспорта обозначено только DPRAVO | Фактически YYYY.MM.DD или пусто | Атрибут записи | В схеме ошибочно указан integer; предмет даты не раскрыт |
NAME | строка | Поле NAME | Фактически наименования, например юрлица | Атрибут записи | В схеме ошибочно integer и нет русского описания; не утверждайте юридическую роль без отдельной первичной проверки |
INN | строковый код | ИНН | До 12 цифр или пусто | Возможная связь с российским правообладателем после проверки | Хранить строкой; заполнен не у всех |
KPP | строковый код | КПП | 9 цифр или пусто | Уточнение российской организации | Хранить строкой; заполнен не у всех |
NAMEL | строка | Поле NAMEL | Текст/пусто | Атрибут записи | Схема не раскрывает смысл |
ADDRESS | строка | Адрес | Текст/пусто | — | Не геокодирован |
ADDRESSL | строка | Поле ADDRESSL | Текст/пусто | — | Схема не раскрывает тип адреса |
ADDRESSU | строка | Поле ADDRESSU | Текст/пусто | — | Схема не раскрывает тип адреса |
MKTU | строка | Класс МКТУ | Одно или несколько значений в текстовой ячейке, например 30 или 18, 24, 25, 28 | Возможная связь с классификатором МКТУ только после нормализации | Не числовое поле; бывают повторённые/составные текстовые значения |
NAMET | строка | Перечень товаров | Текст/пусто | Атрибут ОИС | Не код ТН ВЭД и не товарная позиция |
NAMETB | строка | Поле NAMETB | Во всей проверенной версии пусто | — | Семантика не раскрыта схемой |
DATEEND | строка-дата | Поле DATEEND | Фактически YYYY.MM.DD или пусто | Атрибут записи | Схема говорит string; предмет даты не раскрыт |
COMM | строка | Комментарий | Многострочный свободный текст/пусто | — | Может содержать CR/LF и длинный текст; не ломайте CSV-парсер |
COMMB | строка | Поле COMMB | Во всей проверенной версии пусто | — | Семантика не раскрыта схемой |
PARTICIPID | строковый код | Поле PARTICIPID | Цифры/пусто | Возможный внешний идентификатор | Официальная схема не объясняет его значение; не используйте как ключ без проверки |
Ключ, классификаторы и контроль. Ни REGNOM, ни комбинации REGNOM + MKTU + NAMET не уникальны в проверенном файле. Рекомендуемый технический идентификатор — хеш полного набора 19 полей вместе с датой версии; это не бизнес-ключ. MKTU храните строкой и не разбивайте на классы, пока не зафиксируете правило для запятых, повторов и пустот. Не путайте МКТУ с ТН ВЭД: источник не содержит поле кода ТН ВЭД для соединения с таблицами внешней торговли.
Граница применимости. Набор пригоден для работы с опубликованными записями ТРОИС, текстовым поиском и проверкой состава текущей выгрузки. Он не подходит для расчёта числа уникальных ОИС простым COUNT(*), для оценки внешней торговли, поставок, нарушений или таможенных поступлений.
Объекты данных и показатели
- В проверенной текущей ВЭД строка — агрегат группы: страны или товарной группы. Суммы указаны в млрд долларов США и не связаны с КБК.
- В реестре представителей строка — представитель или его подразделение; в реестре перевозчиков и ТРОИС опубликованная строка не имеет документированного уникального бизнес-ключа.
- Подтверждённые коды для осторожной работы: ИНН, КПП, ОГРН, ОКПО, регистрационные номера, коды органов, ТН ВЭД-ограничения и МКТУ. Они не образуют общий ключ между всеми файлами и должны сохраняться строками.
- Не подтверждены как публичные CSV/XLSX: записи деклараций, контрагенты/получатели, стоимость поставки на уровне декларации, уплаченные платежи, бюджетные КБК и строки кассового исполнения.
Периодичность обновления
Для агрегированной ВЭД подтверждён выпуск за январь–май 2026, размещённый 2026-07-13; страница одновременно хранит несколько выпусков 2026 года, но не публикует формальное правило периодичности в проверенном материале. В паспортных CSV дата последней версии доступна из meta.csv: представители и ТРОИС — 2026-07-17, перевозчики — 2026-07-03, проверки — 2026-06-11. Планировать регулярный сбор можно только с проверкой свежего meta.csv: дата в имени CSV — версия, а не гарантированный отчётный период.
Ограничения и особенности
- Витрина ВЭД — не данные о таможенных платежах. Не сопоставляйте напрямую экспорт/импорт в долларах с кассовыми строками федерального бюджета, формой 0503117 или налоговой статистикой ФНС.
- Не всё, что выглядит как код, число. Ведущие нули, суффиксы и смешанные символы требуют строкового типа; особенно это относится к
РЕГ НОМЕР,NLIC, ИНН/КПП, ОГРН/ОКПО, кодам ТН ВЭД иREGNOM. - Паспорт, схема и данные — три разных файла.
meta.csvописывает набор и хранит URLs версий;structure-*.csvописывает колонки;data-*.csvсодержит записи. Не считайте строки паспорта наблюдениями. - Версионные URLs не являются stable latest. Для воспроизводимости сохраняйте URL конкретного
data-YYYYMMDD...csv, дату загрузки и хеш файла; для свежей версии сначала перечитывайтеmeta.csv. - Схемы содержат ошибки и неполные описания. В ТРОИС типы нескольких полей не совпадают с фактическими данными, а часть технических имён не расшифрована. Не «исправляйте» смысл догадками.
- Исторические XLSX на стартовой витрине не равны актуальному ряду. У многих файлов на 2026-07-17 отображается период 2021–2022; перед использованием обязательно проверяйте собственный файл, листы и единицы.
Примеры доступа
Скачать проверенный официальный реестр наборов и безопасно прочитать его как UTF-8 CSV:
curl -fL 'https://customs.gov.ru/opendata/list.csv' -o fts-opendata-list.csv
python3 - <<'PY'
import csv
with open('fts-opendata-list.csv', encoding='utf-8', newline='') as source:
for row in csv.DictReader(source):
if row['property'] != 'standardversion':
print(row['property'], row['value']) # ID набора и URL его meta.csv
PY
Скачать зафиксированную версию CSV и разобрать кавычки/переводы строки штатным парсером, а не split(';'):
curl -fL \
'https://customs.gov.ru/storage/opendata/7730176610-trois/data-20260717T0000-structure-20150409T0000.csv' \
-o trois-2026-07-17.csv
python3 - <<'PY'
import csv
with open('trois-2026-07-17.csv', encoding='utf-8', newline='') as source:
rows = csv.DictReader(source, delimiter=';')
first = next(rows)
print(first['REGNOM'], first['MKTU'])
PY
Связанные страницы wiki
- Росстат: статистика внешней торговли — другой официальный слой публикации ВЭД; перед сравнением показателей проверяйте методику, период и разрез.
- Налоговая статистика ФНС — налоги и взносы по НК РФ, а не таможенные реестры или торговые агрегаты.
- Отчёты Федерального казначейства — кассовое исполнение бюджета, с которым нельзя механически отождествлять экспорт/импорт или запись реестра ФТС.
- Налоговая и таможенная статистика (отчётность) — объясняет границу администрирования доходов и казначейской отчётности.
- ФТС России — полномочия службы и остальные официальные публичные входы.
- Открытые данные Минфина России — бюджетные справочники и своды для отдельного, методологически осторожного сопоставления.
Не путать с
- Отчёты Федерального казначейства — это кассовое исполнение бюджетов; здесь нет его построчных записей.
- Налоговая статистика ФНС — это другой администратор и иной предмет учёта.
- Росстат: ЕМИСС и ОД — официальная государственная статистика; она может использовать сведения ФТС, но её ряды и методология не становятся автоматически взаимозаменяемыми с файлом ФТС.
stat.customs.gov.ru— на дату проверки это перенаправление в личный кабинет участника ВЭД, а не открытая выгрузка или подтверждённый API.
Сводка для машинной обработки
Ниже — четыре проверенных машиночитаемых набора и одна агрегированная XLSX-витрина. Поля описывают именно зафиксированные версии; URL «latest» для данных не выдумывается.
datasets:
- dataset_id: "fts-vneshn-torg-country-groups-2026-05"
official_page: "https://customs.gov.ru/statistic/vneshn-torg/vneshn-torg-countries"
file_url: "https://customs.gov.ru/storage/document/document_statistics_file/2026-07/13/yI56/%D1%81%D1%82%D1%80%D0%B0%D0%BD%D1%8B052026.xlsx"
retrieved_at: "2026-07-17"
format: "xlsx"
record_grain: "одна строка агрегата группы стран; служебная строка 'в том числе:' исключается"
period: "2026-01-01/2026-05-31; сравнение с тем же периодом 2025"
primary_key: []
required_fields: ["A", "B", "C", "E", "F"]
measures:
- field: "B,C,E,F"
unit: "млрд долл. США"
aggregation: "не суммировать группы стран до общего итога"
- field: "D,G"
unit: "процент"
aggregation: "не суммировать"
caveats:
- "код страны отсутствует; это не таблица отдельных стран"
- "денежный формат ячеек содержит ₽, но единица задана заголовком как млрд долл. США"
- dataset_id: "7730176610-reesrtampredst"
official_page: "https://customs.gov.ru/opendata/7730176610-reesrtampredst"
file_url: "https://customs.gov.ru/storage/opendata/7730176610-reesrtampredst/data-20260717T0000-structure-20191220T0928.csv"
retrieved_at: "2026-07-17"
format: "csv"
encoding: "utf-8"
bom: false
delimiter: ";"
record_grain: "представитель или одно его обособленное подразделение"
primary_key: []
required_fields: ["РЕГ НОМЕР", "ДАТА ВКЛЮЧЕНИЯ В РЕЕСТР", "НАИМЕНОВАНИЕ ТАМОЖ. ПРЕД"]
code_fields:
- field: "РЕГ НОМЕР"
classifier: "регистрационный номер представителя"
keep_as_string: true
- field: "INN"
classifier: "ИНН"
keep_as_string: true
- field: "KPP"
classifier: "КПП"
keep_as_string: true
caveats:
- "регистрационный номер повторяется для подразделений"
- "даже расширенная комбинация полей имеет точные дубли в проверенной версии"
- dataset_id: "7730176610-p5statplanprov"
official_page: "https://customs.gov.ru/opendata/7730176610-p5statplanprov"
file_url: "https://customs.gov.ru/storage/opendata/7730176610-p5statplanprov/data-20260611T1354-structure-20151201T0000.csv"
retrieved_at: "2026-07-17"
format: "csv"
encoding: "utf-8"
bom: false
delimiter: ";"
record_grain: "агрегат по группе таможенных органов"
primary_key: []
required_fields: ["Таможенный орган, проводивший проверку", "Количество проверок"]
measures:
- field: "Количество проверок"
unit: "проверка"
aggregation: "sum только в одном подтверждённом периоде"
caveats:
- "в файле нет отчётного периода"
- "версии являются срезами, а не помесячными приращениями"
- dataset_id: "7730176610-reestrtamperev"
official_page: "https://customs.gov.ru/opendata/7730176610-reestrtamperev"
file_url: "https://customs.gov.ru/storage/opendata/7730176610-reestrtamperev/data-20260703T0000-structure-20130527T0000.csv"
retrieved_at: "2026-07-17"
format: "csv"
encoding: "utf-8"
bom: false
delimiter: ";"
record_grain: "техническая запись о перевозчике и его документе; не гарантированно одна организация или одна лицензия"
primary_key: []
required_fields: ["ST", "NLIC", "OWNER", "DBEGIN"]
code_fields:
- field: "NLIC"
classifier: "номер лицензии или свидетельства"
keep_as_string: true
- field: "INN"
classifier: "ИНН"
keep_as_string: true
- field: "OGRN"
classifier: "ОГРН"
keep_as_string: true
caveats:
- "даже расширенная комбинация реквизитов документа не уникальна в проверенной версии"
- "справочники значений кодовых полей в наборе не приложены"
- dataset_id: "7730176610-trois"
official_page: "https://customs.gov.ru/opendata/7730176610-trois"
file_url: "https://customs.gov.ru/storage/opendata/7730176610-trois/data-20260717T0000-structure-20150409T0000.csv"
retrieved_at: "2026-07-17"
format: "csv"
encoding: "utf-8"
bom: false
delimiter: ";"
record_grain: "техническая строка ТРОИС; не гарантированно один объект интеллектуальной собственности"
primary_key: []
required_fields: ["REGNOM", "G31_12", "MKTU"]
code_fields:
- field: "REGNOM"
classifier: "регистрационный номер ТРОИС"
keep_as_string: true
- field: "MKTU"
classifier: "класс МКТУ"
keep_as_string: true
caveats:
- "REGNOM повторяется"
- "COMM может содержать переводы строки внутри кавычек"
- "поля ТН ВЭД нет; МКТУ не является ТН ВЭД"
Частые вопросы
В: Где взять детализацию до страны, товара или декларации?
О: Не из двух проверенных XLSX: там только группы стран и широкие товарные группы. В открытых CSV-каталогах ФТС также не найден набор деклараций. Не заменяйте отсутствующие данные догадкой по названию страницы или коммерческими базами.
В: Можно ли сложить экспорт/импорт ФТС и получить таможенные платежи федерального бюджета?
О: Нет. В XLSX отражается стоимость внешней торговли в млрд долларов США, а не начисление, уплата или кассовое зачисление платежа. Для бюджета используйте казначейские отчёты и их методику.
В: Как получать свежую версию CSV-реестра без выдуманного API?
О: Сначала скачайте стабильный паспорт https://customs.gov.ru/<dataset-id>/meta.csv, затем возьмите из него последнюю строку data-... и сохраните этот конкретный URL вместе с хешем файла. Это файловый каталог, а не документированный API.