Justin API support
207 subscribers
1 photo
1 file
23 links
В цьому каналі публікуються термінові повідомлення та актуальні новини щодо роботи API та Особистого кабінету від Justin.

Технічна підтримка API:
APIsupport@justin.ua
Download Telegram
Forwarded from Justin
Ми запустили особистий кабінет!

Тепер користуватися Justin ще зручніше.

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

🔥 Щоб перейти в особистий кабінет, тисни "Реєстрація"
📎Увага!
Документацію API Justin оновлено, а саме додано:
1) розділ 11.6 Експрес-накладна С2С;
2) опис процесу створення замолень С2С з ключем відправника;
3) опис процесу створення замолень С2С з ключем агента
з навединими прикладами.

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v14.0.1.pdf
📎Увага! Оновлено документацію API Justin!

Прохання звернути увагу, що в документацію додано:
1) розділ 26 - новый запит на отримання інформації про зміну номеру ЕН після проведення повернення чи переадресації відправлення;
2) описи нових полів, що тепер будуть повертатися у відповідь на запит створення ЕН (розділ 11.3):
🔥 delivery_date - планова дата доставки;
sender_address - адреса "звідки";
reciver_address - адреса "куди";
reciver_city - місто відділення доставки;
reciver_warehouse - розподільчий центр (далі - РЦ), який закріплений за відділенням доставки;
sort_id - номер сортування по місту для РЦ доставки;
cod_amount - вартість післяплати, у разі відсутності порожній рядок;
delivery_amount - вартість доставки. Заповнюється при оплаті одержувачем, у всіх інших випадках - порожній рядок;
branch_number - номер відділення доставки. При адресній доставці має префікс "А";
type - розрахований типорозмір відправлення.
Зверніть уагу, що дану інформацію, при необхідності, можна використовувати для формування стікеру на стороні клієнта!
3) опис нового параметру cargo_place для друку стікера окремого вантажного місця (розділ 19.1.)
4) описи нових полів для створення ЕН з адресною доставкою та інше (розділ 11.1):
cod_branch - номер відділення для повернення післяплати;
delivery_is_required - ідентифікатор, що визначає наявність адресної доставки відправлення;
receiver_delivery_address - адреса отримувача (обов’язково до заповнення, якщо delivery_is_required = true);
delivery_interval - інтервали адресної доставки.

5) зміни в опис поля order_amount так як відтепер:
🔥Метод створення ЕН не буде повертати помилку "Order_amount сума is not integer", що не дозволяло створити відправлення з сумою післяплати вказану з копійками;
🔥 Метод створення ЕН буде повертати помилку "Order_amount сума shall be rounded to one decimal place", не дозволяючи створювати відправлення з сумою післяплати з неприпустимими номіналами 1,2 і 5 копійок.
Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v14.0.2.pdf
🔥 Шановні Партнери! Важливо!
Метод getOrderStatusesHistory (розділ 15) - застарілий і буде відключений 01.05.2020 у зв'язку з його неправильною роботою і навантаженням на систему,
У зв'язку з цим, прохання змінити реалізацію трекінгу на новий метод getOrderStatusesHistoryF (розділ 16).
Для Агентів (Маркетплейс) приклад використання методу:
{
"keyAccount": "{{Login}}",
"sign": "{{signVar}}",
"request": "getData",
"type": "request",
"name": "getOrderStatusesHistoryF",
"filter": [
{
"name": "senderId",
"comparison": "not",
"leftvalue": "{{api_key}}"

},
{
"name": "orderNumber",
"comparison": "equal",
"leftvalue": "408554727"
}
]
}
📎 Шановні партнери!
Прохання звернути увагу, на оновлення документації:
розділ 27 – новий запит на отримання інформації про склад відправника. Для партнерів з декількома адресами складів;
розділ 28 та 29 - нові методи, що відповідають за сервіс зміни даних в ЕН:
🔥 Методи можна використовувати (необмежену кількість разів) для зміни даних в ЕН;
🔥 Метод перевірки доступних даних в ЕН для зміни - сервіс зміни даних в ЕН. Перевірка доступності (розділ 28);
🔥 Метод заміни значень доступних до зміни даних в ЕН - сервіс зміни даних в ЕН. Заміна даних (розділ 29).
❗️Обмеження сервісу:
1) заборонено додавати дані, які були відсутні в момент створення ЕН (наприклад: суму післяплати, якщо ця послуга не була замовлена Відправником під час оформлення відправлення);
2) змінювати будь-які дані закритої ЕН (наприклад: вже після вручення відправлення в системі).

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v14.0.4.pdf
📎 Шановні партнери!
Відбулися зміни в Justin API, а саме:
1. Додано нові методи:
розділ 30 та 31 - послуга повернення відправлень:
🔥 метод для перевірки можливості створити заявку на повернення;
🔥 метод для створення заявки на повернення;
❗️Обмеження сервісу:
1) створити заявку на повернення можна тільки раз;
2) створити заявку на повернення можна тільки для ЕН, що знаходиться на відділенні одержувача (кінцеве відділення доставки);
3) створити заявку на повернення неможливо для закритої ЕН (наприклад: вже після вручення відправлення в системі).

розділ 31 та 32 - послуга переадресації відправлень:
🔥 метод для перевірки можливості створити заявку на переадресацію;
🔥 метод для створення заявки на переадресацію;
❗️Обмеження сервісу:
1) створити заявку на переадресацію можна тільки раз;
2) створити заявку на переадресацію можна тільки для ЕН, що знаходиться на відділенні одержувача (кінцеве відділення доставки);
3) створити заявку на переадресацію неможливо для закритої ЕН (наприклад: вже після вручення відправлення в системі).

розділ 23.4 - метод пакетного друку стікерів ВМ за реєстром:
🔥 метод значно спрощує процес друку стікерів, при умові формування реєстра відправлень

2. Оновлено:
розділ 19 - друк стікерів вантажного місця. Додано опис відправлення на стікер у поле №10

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v15.0.0.pdf
📎 Шановні партнери!
Зверніть увагу, що в Justin API додано наступні методи:
розділ 34 - ВСТАНОВЛЕННЯ МІТКИ АГЕНТА В ЕКСПРЕС-НАКЛАДНІЙ
❗️Метод необхідний переважно для співпраці з маркетплейсами (агентами). Встановлення мітки агенту в ЕН допоможе визначити тариф, у випадку коли відправлення оформлене через особистий кабінет або з допомогою власної інтеграції продавця
розділ 11 - ЗАПИТ НА СТВОРЕННЯ ЕКСПРЕС-НАКЛАДНОЇ
🔥 при створенні ЕН додано поле "safe_deal" ("Безпечна угода") - не обов'язкове для заповнення
🔥 в момент передачі (приймання) такого відправлення (з ознакою "Безпечна угода") на відділенні, можливості вказати (змінити) суму післяплати не буде
❗️ Встановлення ознаки "Безпечна угода" необхідно лише при наявності вибору форми розрахунку по безпечній угоді (назва форми розрахунку, на стороні маркетплейсу, може відрізнятись)

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.2.pdf
📎 Шановні партнери!
Прохання звернути увагу на наступні методи в Justin API. В методах допрацьвано:
розділ 9 - ЗАПИТ НА ДАНІ ПРО ВІДДІЛЕННЯ (НОВИЙ)
❗️Додано параметр StatusDepart, якій показує статус роботи відділення
Заплановано до відкриття – 0;
Активно – 1;
Зупинене – 2;
Закрите – 3;
Заплановано до закриття – 4.
🔥 Якщо відділення має статус роботи – 4 (заплановано до закриття) прохання не виводити його для вибору клієнтам!
🔥 Важливо! У випадку, якщо замовлення вже скомплектоване (вибір відділення відбувся в момент, коли відділення працювало в нормальному режимі по статусу 1), то на таке відділення можна створюввати відправлення.

розділ 11 - ЗАПИТ НА СТВОРЕННЯ ЕКСПРЕС-НАКЛАДНОЇ
🔥 при створенні ЕН додано поле "dimensional_weight" ("Об'емна вага") - поле не обов'язкове для заповнення
🔥 при створенні ЕН додано поле "type_size" ("Типорозмір відправлення") – поле не обов'язкове для заповнення
❗️ Дуже важливо переглянути значення, яке передается в поле "volume" (Об'єм в метрах кубічних). При не коректному введенні значення об'єму в метрах кубічних може виконуватись конвертація в об'ємну вагу, в результаті чого може вплинути на вартість доставки!
❗️1 м3 = 250 кг. Якщо ви не володієте інформацією про об'єм відправлення, прохання передавати значення "volume" (об'єму в метрах кубічних): null або досить мале число, щоб не впливати на вартість доставки, наприклад: 0.001

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.3.pdf
📎 Шановні партнери!
Прохання звернути увагу на новий метод Justin API для друку стікерів:
розділ 19.4 Пакетний друк стікерів вантажного місця за масивом номерів ЕН
🔥 Новий метод надає можливість отримати стікери за номери ЕН Justin (на відміну від метода № 19.1. щодо отримання стікерів по клієнському номеру);
🔥 Новий метод приймає массив номерів ЕН, у випадку потреби в масовому друку стікерів
❗️ Зверніть увагу! У відповідь на POST запит метод повертає бінарний файл, що гарантує безпеку збереження ключа від передачі третім особам

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.4.pdf
📎 Шановні партнери!
Звернуть увагу, на оновлення документації API Justin
розділ 11.7 Експрес-накладна (далі – ЕН) категорії вантажу:
🔥 Метод створення ЕН допрацьований в частині можливості створення відправлення з різними категоріями (посилки, вантажі, палети, шини/диски);
🔥 Метод приймає нові параметри «категорію», та перелік типів вантажу для категорії "шини\диски".
❗️ Зверніть увагу! Кожна категорія має свої відмінності щодо набору обов'язкових полів.

розділ 35 ЗАПИТ НА ОТРИМАННЯ ДОВІДНИКА ТИПІВ ВАНТАЖУ
🔥 Новий метод для отримання типів вантажу, що необхідні для передачі категорії "шини\диски" та їх кількості при формуванні ЕН.

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.5.pdf
BPMN_схема_статусів_та_їх_взаємозв'язків_v2.pdf
1.2 MB
📎 Шановні партнери!
Незабаром з'являться нові статуси:
[Прийнято відділенням. Невідповідність точки видачі];
[Прийнято відділенням для передачі кур'єру].
Для аналізу процесу зміни статусу ЕН пропонуємо для розгляду BPMN-схема статусів та їх взаємозв'язків
📎 Шановні партнери!
Прохання звернути увагу, що змінилося розміщення тестового середовища.
❗️ Було: https://api.justin.ua/justin_pms_test/..
❗️ Стало: https://api.sandbox.justin.ua/client_api/..
📎 Шановні партнери!
Звернуть увагу, на оновлення документації API Justin
Документ складається з двох розділів відповідно до версій реалізації методів API:
Розділ I версія 1 - 2 містить інформацію по методах, що вже використовуються Вами в роботі;
Розділ II версія 3 – нові методи на отримання населеного пункта, вулиці та номеру будинку для швидкої інтеграції та оптимізації роботи по адресній доставці;
Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.9.pdf
📎 Шановні партнери!
Звернуть увагу, на оновлення документації API Justin в частині методу отримання даних відділень "req_DepartmentsLang"
Наразі Justin розширює мережу та додає відділення, що працюватимуть тільки на видачу безоплатних посилок, прохання враховувати їх при наданні інформації своїм клієнтам для зручної доставки.
За методом API "req_DepartmentsLang" додано можливість відбору потрібного типу відділення, зауважте, що в нас відтепер є різниця відділень за типом видачі. Відділення поділяються на :
Відділення які мають можливість видавати всі посилки з оплатою та без оплати;
Відділення які працюватимуть тільки на видачу відправлень, на них не має можливості розрахуватися за посилку;
Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.10.pdf
📎 Шановні партнери!
Звернуть увагу, на оновлення документації API Justin
розділ 23 ВИДАЛЕННЯ РЕЄСТРУ ВІДПРАВЛЕНЬ ЗА ВЛАСНИМ КЛЮЧЕМ – новий метод працює інакше ніж зазначений в розділі 22 СКАСУВАННЯ РЕЄСТРУ ВІДПРАВЛЕНЬ
🔥 Метод видаляє реєстр з системи повністю з усім списком експрес- накладних зазначених в ньому;
🔥 Метод не може використовуватись для ключів з типом Агент.

Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
Попередня версія документації доступна за посиланням: https://justin.ua/api/api_justin_v16.0.10.pdf
📎 Шановні партнери!
🔥 JUSTIN змінює назву типів відділень для більш зручного сприйняття користувачами послуг, стара назва більше не буде використовуватись.

Було:
Smart, OSR MINI - Стало: Відділення до 15 кг
Було: OSR Стандарт - Стало: Відділення до 30 кг
Було: Cargo - Стало: Вантажне відділення

Типи відділень як і раніше ви можете отримати за методом cat_branchType п. 7 нашої API документації та у відповіді на метод req_DepartmentsLang параметр “branchType” п. 9 API документації вам повертається інформація про тип відділення:
"branchType": {
"uuid": "UUID відділення",
"descr": "Отделение до 15 кг",
"type": "cat_branchType"

Відділення типу MiniOSR більше не використовуються в системі JUSTIN, але у відповідь на метод cat_branchType деякий час ми віддаватимемо вам цей тип відділення.
Дякуємо за увагу! Плануйте надалі свій бізнес з доставкою JUSTIN 📦
📎 Шановні партнери!
❗️ Прохання звернути увагу на те, що ми прибрали з наших стікерів інформацію про вартість доставки і післяплати. Це зроблено для конфіденційності та безпеки інформації щодо ваших відправлень.
Всю інформацію по ЕН ви можете отримати в особистому кабінеті JUSTIN https://biz.justin.ua/login.
📎 Шановні партнери!
Звернуть увагу, на оновлення документації API Justin
розділ 4 пункт 4.5 Запит отримання списку населених пунктів с адресним забором – новий метод потрібно застосовувати, у випадках якщо ви користуєтесь послугою адресного забору JUSTIN. У відповідь на метод «cat_cityAddressFence» можна отримати всі населені пункти в яких передбачено адресний забір.
❗️Для формування послуги адресного забору потрібно:
☑️ Передавати в запиті на створення відправлення розділ 11ЗАПИТ НА СТВОРЕННЯ ЕКСПРЕС-НАКЛАДНОЇ параметр “pick_up_is_required” = true
☑️ Створити реєстр відправлень для виїзду кур’єра - розділ 20 СТВОРЕННЯ РЕЄСТРУ ВІДПРАВЛЕННЯ
Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
📎 Шановні партнери!
Оновлено метод розділу 16 ЗАПИТ НА ІСТОРІЮ СТАТУСІВ ЕКСПРЕС-НАКЛАДНОЇ (НОВИЙ) , а саме, додано інформацію по полях "deliveryDepartment", "addressDepartment" в Таблиці 16.5 – Поля об’єкту «fields» – у відповідь на запит повертаються такі дані:
"deliveryDepartment" –Відділення або розподільчий центр зазначеного відправлення, призначений за маршрутом прямування для відправки, доставки ЕН;
"addressDepartment"- повертає дані по адресі відділення або РЦ призначеного за маршрутом прямування: для відділення повну адресу, по розподільчому центру тільки населений пункт де знаходиться РЦ.
Метод повертає пусті поля для тих статусів в яких не передбачається прийняття доставки на відділення, РЦ.
Детальніше ознайомитися зі змінами в API Justin можна за посиланням: https://justin.ua/api/api_justin_documentation.pdf
‼️ Увага Шановні партнери
Станом на 02.02.2022 с 01:00 до 05:00 з нашого боку будуть проводитись необхідні технічні роботи із серверами. Можливий частковий або повністю відсутній зв'язок із сервером, вибачте за незручності та враховуйте дану інформацію при роботі з нашим API.