Проверка РНПТ через API ФНС
Менеджер получает УПД с регистрационным номером партии товара и перед проведением должен сверить его с сервисом ФНС. Проверка РНПТ через API переносит ответ прямо в документ: система отправляет запрос, дожидается результата и показывает его сотруднику. Авторизацию и очередь размещаем в защищённом серверном модуле.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Сотрудник открывает сервис ФНС для каждого РНПТ и вручную переносит код товара, страну, количество и дату обновления.
- Ошибка формата или чужая партия обнаруживается уже при финальной проверке счёта-фактуры, УПД или отгрузочного документа.
- B2B-кабинету требуется проверить номер поставщика до подтверждения приёмки или заказа и сохранить доказательство запроса.
- Компания хочет автоматизировать точечный контроль РНПТ, сохранив текущую 1С или ERP и привычный порядок работы бухгалтера.
Что именно мы сделаем
Определяем форму, документ и момент проверки, собираем примеры РНПТ, ожидаемые действия и статические адреса интеграционного сервера.
Получаем или проверяем мастер-токен ФНС, реализуем временную авторизацию, SendMessage, GetMessage и устойчивую очередь запросов.
Показываем сведения о товаре и количестве, сохраняем дату и MessageId, добавляем понятные ошибки и повторную проверку.
Проводим контрольные номера и пакет, передаём журнал, инструкцию поддержки и поясняем, когда достаточно проверки РНПТ, а когда нужен полный учёт партий.
Что входит в стоимость
69 900 ₽ за всю работу
Подключаем один рабочий сценарий проверки РНПТ: помогаем подготовить заявку на мастер-токен, настраиваем SOAP-аутентификацию и обновление временного токена, SendMessage и GetMessage, проверку формата, очередь, журнал, кэш и понятные статусы. Встраиваем результат в форму или документ, проверяем корректный номер, ошибку, длительную обработку и временную паузу API.
Что будет готово
Передадим вам
- Рабочая проверка РНПТ в выбранной системе с форматным контролем, асинхронной очередью, результатом ФНС и связью с документом.
- Защищённый модуль мастер- и временного токена, SOAP-запросов SendMessage/GetMessage, повторов, кэша и ролевого журнала.
- Протокол контрольных номеров и инструкция сотруднику: результат, пауза сервиса, спорное количество и переход к полному учёту.
Перед сдачей проверим
- Корректный РНПТ проходит SendMessage и GetMessage, сохраняет MessageId и показывает поля RESULT из официального ответа ФНС.
- Форматная ошибка, Fault, PROCESSING и истёкший временный токен получают разные понятные статусы и предусмотренный маршрут обработки.
- Результат связан с нужной партией или документом, содержит дату проверки, а повтор одного запроса сохраняет единую историю без дублей.
Как это выглядит на практике
Дистрибьютор проверяет РНПТ поставщика перед приёмкой
- 01
Менеджер загружает входящий УПД, система извлекает РНПТ и сразу отмечает номер с ошибочной длиной до обращения к ФНС.
- 02
Остальные номера попадают в очередь, SendMessage возвращает MessageId, а GetMessage переводит ответы из PROCESSING в COMPLETED.
- 03
Для одной партии API показывает другое находящееся в обороте количество и дату обновления, поэтому документ получает статус проверки бухгалтером.
- 04
После подтверждения поставщика результат и решение сохраняются рядом с УПД, а дальнейшее распределение партий остаётся в действующем учёте.
Что понадобится для работы
От вас
- Доступ к 1С, ERP, B2B-кабинету или сервису, где вводится РНПТ, тестовая база, журналы и возможность разместить серверный модуль.
- Мастер-токен либо сведения для заявки ФНС, FNS-OpenApi-UserToken, список статических IP и ответственный сотрудник организации.
- Примеры корректных, ошибочных и спорных РНПТ, связанные документы, ожидаемые поля и внутреннее правило проведения при паузе API.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 66 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Какие сведения возвращает API проверки РНПТ?
Опубликованная схема содержит ТН ВЭД, название и страну товара, дату выпуска или регистрации, единицу измерения, ввезённое, выбывшее и находящееся в обороте количество, а также дату обновления.
Как получить мастер-токен открытого API ФНС?
Уполномоченный сотрудник направляет ФНС сведения об организации, ИНН, сайте, ответственном лице, почте, сервисах и статических IP. Актуальная страница ФНС указывает адрес fnstokenpros@tax.gov.ru.
Почему ответ проверки приходит асинхронно?
SendMessage регистрирует XML-запрос и возвращает MessageId, затем GetMessage сообщает PROCESSING или COMPLETED. Очередь сама ждёт результат и показывает пользователю текущее состояние.
Можно добавить проверку РНПТ прямо в 1С?
Да. Размещаем её в форме партии, входящем УПД, реализации или отдельной обработке. Тот же серверный модуль можно использовать для B2B-кабинета и ERP.
Что произойдёт во время паузы API ФНС?
Документ сохранится как черновик либо получит предусмотренный внутренним правилом статус. Очередь повторит технический запрос, а сотрудник увидит время, причину и дату последней успешной проверки.
Проверка через API ведёт полный учёт партий РНПТ?
Она подтверждает конкретный номер и возвращает сведения ФНС. Движения партий, распределение количества, возвраты, УПД, ЭДО и отчётность охватывает отдельная услуга «Полный учёт РНПТ в 1С, ERP и ЭДО».
Как защищаются токены и журнал запросов?
Мастер-токен хранится в серверной конфигурации с ограниченными правами, временный обновляется автоматически, а журнал скрывает секреты и доступен только назначенным ролям.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Проверка РНПТ через API ФНС
Автоматически проверить конкретный РНПТ
- 02Полный учёт РНПТ в 1С, ERP и ЭДО
Построить полный учёт партий в 1С и ЭДО
- 03Сверка входящих УПД Диадока с заказами
Сверять входящие УПД с учётными документами