Перейти до змісту

Нова Пошта

Міста, відділення, регіони, типи вантажу, види упаковок — усе це живе не у вас, а в Нової Пошти. Ця служба ходить до неї по свіжі дані й наповнює ними довідники модуля. Поки вона не відпрацювала, у полях картки кабінету і в документах не буде з чого вибирати.

Де шукати: Модулі → Нова Пошта → Служби → Нова Пошта

Меню: Модулі → Нова Пошта → Служби → Нова Пошта.

Розбір на прикладі

Вікно служби завантаження даних

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

Це не примха інтерфейсу, а спосіб не чекати годину даремно. Відділень у Нової Пошти десятки тисяч, і вони приїжджають сторінками; міст — понад десять тисяч. Решта довідників — це кілька рядків, які завантажуються миттєво. Тому звичайний робочий сценарій такий: перший раз запустити повністю, а потім оновлювати точково — окремо міста, окремо відділення.

Унизу дві кнопки: Виконати — запустити зараз, За розкладом — доручити планувальнику завдань. Зазвичай службу ставлять на нічний запуск раз на добу: адреси Нової Пошти змінюються повільно, але змінюються.

Звідки беруться дані

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

Що потрапляє в довідники

Довідник Що привозить
НП Регіони Області України
НП Міста Населені пункти з прив'язкою до області
НП Відділення Відділення й поштомати з номерами, адресами й обмеженнями ваги
НП Типи відділення Поштове відділення, вантажне, поштомат
НП Типи вантажу Посилка, вантаж, документи, палети, шини-диски
НП Види упаковок Коробки й пакети з розмірами
НП Види палет Типорозміри палет
НП Види платників Відправник, одержувач, третя особа
НП Типи вантажу зворотної доставки Грошовий переказ, документи
НП Види платників зворотної доставки Хто платить за зворотну доставку
НП Контрагенти Одержувачі й треті особи з вашого кабінету

Типові ситуації

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

Поруч