Перейти к содержанию

Новая Почта

Города, отделения, регионы, типы груза, виды упаковок — всё это живёт не у вас, а в Новой Почте. Эта служба ходит к ней за свежими данными и наполняет ими справочники модуля. Пока она не отработала, в полях карточки кабинета и в документах не будет из чего выбирать.

Где искать: Модули → Новая Почта → Обслуживание → Новая Почта

Меню: Модули → Новая Почта → Обслуживание → Новая Почта.

Разбор на примере

Окно службы загрузки данных

Одиннадцать флажков «Загрузить только …» — это фильтр объёма работы. Правило простое: если не поставлен ни один, грузится всё — регионы, города, отделения, типы отделений, типы груза, упаковки, паллеты, типы плательщиков, типы груза обратной доставки, виды плательщиков обратной доставки и контрагенты. Поставили один — служба сделает только его.

Это не прихоть интерфейса, а способ не ждать час впустую. Отделений у Новой Почты десятки тысяч, и они приезжают страницами; городов — больше десяти тысяч. Остальные справочники — это несколько строк, которые загружаются мгновенно. Поэтому обычный рабочий сценарий такой: первый раз запустить полностью, а потом обновлять точечно — отдельно города, отдельно отделения.

Внизу две кнопки: Выполнить — запустить сейчас, По расписанию — поручить планировщику заданий. Обычно службу ставят на ночной запуск раз в сутки: адреса Новой Почты меняются медленно, но меняются.

Откуда берутся данные

  • Ключ служба берёт из реестра Новая Почта — из первой записи. Если в первой записи ключа нет, работа прекращается сообщением, что ключ надо указать, — даже когда ключ есть в других.
  • Контрагенты — исключение: их служба собирает по всем карточкам кабинетов, где указан ключ, потому что у каждого кабинета своя адресная книга. Карточку без ключа служба пропускает.
  • Справочник заменяется, только когда Новая Почта отдала его целиком: перед записью он очищается в пределах вашей компании — и тут же наполняется заново. Данные других компаний служба не трогает. Если Новая Почта отказала, не ответила или вернула меньше складов, чем сама назвала, справочник остаётся таким, каким был.
  • Упаковки — исключение: служба заменяет только те, что пришли от Новой Почты (по коду). Добавленные вручную остаются — и те, что Новая Почта уже убрала, тоже: лишние удалите сами.
  • Справочники наполняются теми названиями, которые отдаёт Новая Почта: украинскими. Поэтому и в интерфейсе на русском или английском города и отделения будут на украинском — это не ошибка перевода, а содержимое справочника.

Что попадает в справочники

Справочник Что привозит
НП Регионы Области Украины
НП Города Населённые пункты с привязкой к области
НП Отделения Отделения и почтоматы с номерами, адресами и ограничениями веса
НП Типы отделения Почтовое отделение, грузовое, почтомат
НП Типы груза Посылка, груз, документы, паллеты, шины-диски
НП Виды упаковок Коробки и пакеты с размерами
НП Виды паллет Типоразмеры паллет
НП Виды плательщиков Отправитель, получатель, третье лицо
НП Типы груза обратной доставки Денежный перевод, документы
НП Виды плательщиков обратной доставки Кто платит за обратную доставку
НП Контрагенты Получатели и третьи лица из вашего кабинета

Типичные ситуации

  • «Данные Новой Почты не обновлены, ранее загруженные записи сохранены: …» — Новая Почта отказала или не ответила. После двоеточия названо, какие справочники остались без изменений и почему: текст отказа Новой Почты или ошибка соединения, у контрагентов — ещё и кабинет. Ключ просрочен или отозван — создайте новый в Бизнес-кабинете Новой Почты и замените его в карточке кабинета. Оборвалась связь — просто запустите ещё раз.
  • «Недействительный ключ API!» — это ответ при сохранении карточки кабинета: Новая Почта не приняла набранный ключ. Проверьте, скопирован ли он полностью.
  • Служба долго не завершается. Скорее всего, грузятся отделения: их десятки тысяч и идут они страницами. Если нужны только города — поставьте галочку «Загрузить только города».
  • Во второй компании справочники пусты. Каждая компания держит собственную копию справочников, и служба работает в той компании, в которой вы сейчас. Переключитесь в нужную компанию и запустите службу там.
  • Служба отвечает «Регистр «…» общий с другой компанией: эту службу запускает только она». Выбранный справочник НП в этой компании общий с другой: его записи принадлежат главной компании, поэтому обновляет их служба, запущенная там. Служба отказывает ещё до первого запроса к Новой Почте и ничего не меняет.

Рядом