Велике доопрацювання. Інтеграція API Seller-Online

Є завдання настроїти інтеграцію API Seller-Online. Seller-Online – це підрядник по роботі із замовленнями із закордонних маркетплейсів. API v1.0 (Використовуємо для інтеграції замовлень та фінансів): https://app.swaggerhub.com/apis/seller-online/seller-online-user/1.0.1#/ API v2.0 (Використовується для створення відправок посилок з “Надсилання Seller-Online”). https://api.seller-online.com/swagger-ui/ Хочу розділити доробки на блоки та розуміти скільки буде вартість всіх доробок та скільки вартість кожного блоку. (Якщо бюджет не дозволить впровадити все, можливо впровадимо частину) Блоки доробок: 1. Імпорт фінансів Seller-Online 2. Імпорт замовлень, що зайшли на Seller-Online 3. Формування відправки посилок з “Надсилання Seller-Online” 4. Формування відправки посилок із Seller-Online (УкрПошта) 5. Доопрацювання інтеграції “Служба доставки Укрпошта”, щоб можна було надсилати посилки через Укрпошту за кордон. За пунктом 4 чи 5 ТЗ сформуємо днями. Дописуємо. Кожен із блоків перевів у підзавдання, щоб зручніше комунікувати. Інфо для себе: Трек-номер (США) з'являється коли у посилки статус “У транзиті до розподільчого центру” На складі Seller-Online визначають посилку за номером посилки. В ідеалі, якщо буде штрих-кодом. Доробка в OneBox market "Інтеграція з Seller-Online" У OneBox market створюємо "Інтеграція з Seller-Online" У ній можливість створювати інтеграції як у Prom https://prnt.sc/vmd3fc Буде кілька інтеграцій, до різних кабінетів Seller-Online, під кожен свій API ключ та дані доступу. Одну з інтеграцій робимо "Стандартна для відправки" Далі у всіх авт. Діях вибиратимемо в налаштуваннях яку використовувати інтеграції. (Виберіть інтеграцію) 1. Прорахунок доопрацювання Імпорт фінансів Seller-Online. https://app.swaggerhub.com/apis/seller-online/seller-online-user/1.0.1#/ Потрібно API тягнути всі фінансові операції в OneBox. Для цього створено гаманець, до якого потрібно імпортувати операції. Імпортуємо такі дані (https://prnt.sc/vm822f): дата і час Призначення (імпортуємо до коментаря) Сума Номер замовлення Seller-Online (Звіряємо з “Зовнішній ID”, і якщо вони збігаються кріпимо платіж до цього замовлення) Імпортуємо за допомогою “Автоматичні дії раз на хвилину” В авт. дії налаштовуємо такі пункти: Частота запуску (у хв.): вказується цифрою. - Пишемо цифру, яка означає за скільки хвилин запустити авт. дія. Користувач від якого будуть створюватися платежі: список зі співробітниками, що випадає. Акаунт на який будуть зараховані платежі: список, що випадає, з платіжними акаунтами. Виберіть інтеграцію: Вибираємо інтеграцію (з якого кабінету Seller-Online тягнути дані). 2. Прорахунок доопрацювання Імпорт замовлень із Seller-Online. https://app.swaggerhub.com/apis/seller-online/seller-online-user/1.0.1#/ Потрібно по API тягнути замовлення, що надійшли до Seller-Online. Ми виготовляємо замовлення дропшиперів, а також замовлення зі своїх магазинів. Ці замовлення потрапляють до кабінетів Seller-Online. Кожен має свій кабінет, в один кабінет можуть падати замовлення з декількох магазинів. Ми поділяємо 3 особи в одному процесі: Відповідальний (менеджер) Клієнт Одержувач Якщо замовлення від дропшипера, він є клієнтом. Наш менеджер, який обробляє замовлення відповідальним, а людина, що замовила у дропшипера, отримувач. У такому випадку з Seller-Online ми витягуємо дані отримувача. Якщо замовлення з наших магазинів, тоді відповідальний наш менеджер, а клієнтом та одержувачем є та сама людина, чиї дані ми витягуємо з Seller-Online. Тому робимо 2 типи імпорту замовлень: Раз на n хв. імпортуємо ВСІ замовлення, що надійшли в Seller-Online. Створюємо вручну процес, перекладаємо етап із авт. дією, OneBox витягує дані з Seller-Online, згідно "Зовнішній ID". Раз на n хв. імпортуємо ВСІ замовлення, що надійшли до Seller-Online. Імпортуємо за допомогою “Автоматичні дії раз на хвилину” ВСІ замовлення з Seller-Online. В авт. дії налаштовуємо такі пункти: Частота запуску (у хв.): вказується цифрою. - Пишемо цифру, яка означає за скільки хвилин запустити авт. дія. Виберіть інтеграцію - Вибираємо інтеграцію (з якого кабінету Seller-Online тягнути дані). Бізнес-процес - До якої БП потрапляє замовлення. Список, що випадає з БП. Статус – Який статус замовлення. Список, що випадає, з етапами обраного БП Джерело процесу - Випадаючий список із джерелами процесу. Налаштовуємо відповідальний процес щодо магазину. https://prnt.sc/vmbiz0 * Якщо відповідального немає у списку, то закріплюється менеджер клієнта. (У ситуації з дропшипінгом) Створюємо вручну процес, перекладаємо етап із авт. дією, OneBox витягує дані з Seller-Online, згідно "Зовнішній ID". Так як не всі дропшипери бажають, щоб ми імпортували всі замовлення з Seller-Online, для них буде цей варіант імпорту. У картці клієнта (дропшипера), вказуємо інтеграцію, (з якого кабінету Seller-Online тягнути дані). Робимо авт. вплив на етапі. При переході на нього, OneBox дивиться на "Зовнішній ID" процесу (який вставить дропшиппер у створене замовлення), і відповідно до нього підтягує дані з Seller-Online. Імпортуємо такі дані: Назва: вносимо у коментар процесу. Артикул товару: вносимо у коментар процесу. (Артикули по API передаються через кому) Номер замовлення: Це номер замовлення Seller-Online. (В OneBox: "Зовнішній ID") Номер у місці купівлі (продажу): Це номер замовлення в маркетплейсі, який переносить замовлення у Seller-Online. (В OneBox: Створимо "додаткове поле замовлення") Назва магазину, на який зайшло замовлення. Дані, що нижче, слід імпортувати як дані одержувача. (НЕ клієнта, а отримувача). Якщо якихось змінних немає, створимо як Доп. поля процесу”. Ці ж дані будуть використані при створенні ТТН по УкрПошті та відправці Seller-Online (ще одне доопрацювання нижче) Ім'я (В OneBox: "Ім'я одержувача") Прізвище (В OneBox: "Прізвище отримувача") Телефон (В OneBox: "Телефон одержувача") Країна (В OneBox: "Країна одержувача") Місто (В OneBox: "Місто одержувача") Регіон/Штат (В OneBox: “Регіон/Штат отримувача”) Населений пункт (В OneBox: "Населений пункт отримувача") Індекс (В OneBox: "Індекс одержувача") Адреса (В OneBox: "Адреса одержувача") Електронна пошта (В OneBox: "Електронна пошта одержувача") 3. Прорахунок доопрацювання “Формування надсилання посилок через “Надсилання Seller-Online”” Консолідація - це спосіб відправки за кордон, ми відправляємо всі посилки новою поштою або на таксі в Seller-Online, вони упаковують в одну коробку і відправляють на свій склад в Америку, а вже там кожну посилку окремо відправляють клієнтам США. Авт. дія етапу. При переході етап. “Варіанти відправлення “Надсилання Seller-Online”” У кабінеті Seller-Online після внесення даних одержувача, нам надається на вибір варіант відправки (https://prnt.sc/vmrgp3) з різними термінами та цінами. Для того, щоб сформувати посилку, нам потрібно спочатку вибрати який варіант доставки нам потрібен. Це можемо зробити витягнувши варіант через API (/v2/shipping/shipments/get-carriers) варіанти. Я бачу це так: Відповідно до “Зовнішнього ID” процесу/замовлення, через API витягуємо варіанти відправлень із Seller-Online. Передаємо дані одержувача https://prnt.sc/vmemmh з OneBox у Seller-Online. Передаємо дані про посилку (https://prnt.sc/vmf0j8) з OneBox у Seller-Online: Назва товару) Довжина (см) Ширина (см) Висота (см) Вага, кг) Передаємо пункт "особисто в руки" (https://prnt.sc/vmf6y7) в OneBox зробимо дод. поле процесу "Особисто в руки". Передаємо пункт страховка (Це новий пункт, його додадуть днями в API Seller-Online) Seller нам повертає варіанти відправок, з термінами та цінами. Поміщаємо їх в окремий блок у процесі. У блоці в процесі відображається так: https://prnt.sc/vmrtl8 Найменування доставки Ціна ☐ Терміни Тоді ми вибираємо тип доставки, та перекладаємо на слід. етап. Де за допомогою сліду. авт. дії, відправка створиться. * за стандартом має бути обрана найдешевша доставка, з тих, що повернув Seller. Потрібно зробити шаблони за габаритами, які будуть у картці товару. Вони за стандартом виводитимуться у процес, коли ми додаємо товар. При потребі ми їх змінюватимемо (перед переходом на етап) https://prnt.sc/vmf9cd - приклад. Авт. дія етапу. При переході етап. “Створити відправку через “Надсилання Seller-Online”” У попередньому. авт. дії ми витягнули варіанти доставки та ціни, а при переході на цей етап, створюємо відправлення, обраним способом. Повертаємо з Seller-Online у процес OneBox: Вартість доставки, якщо це передбачено у налаштуваннях авт. дійств. Номер посилки (який сформувався https://prnt.sc/vmsj9y) у дод. поле процесу. "Номер посилки Seller" В авт. дії налаштовуємо такі пункти: Інтеграція: Випадаючий список усіх інтеграцій. І пункт "Брати з картки клієнта" (тоді інтеграція береться з картки клієнта/дропшипера) Якщо в картці клієнта не вказано інтеграцію, вибирається “стандартна для відправки”. Якщо оформлення відправки через “стандартне для відправки”, тоді вартість доставки виводимо у процесі. Авт. дія етапу. “Перевести процес у цей етап, якщо статус “Надсилання Seller-Online” змінився” https://prnt.sc/vmftog – приклад. В авт. дії налаштовуємо такі пункти: Інтеграція: Випадаючий список усіх інтеграцій. І пункт "Брати з картки клієнта" (тоді інтеграція береться з картки клієнта/дропшипера) Залежно від обраної інтеграції OneBox перевіряє статус у потрібному кабінеті Seller-Online. Список статусів (https://prnt.sc/vmfs27): customer_created Створена клієнтом customer_sent Надіслана клієнтом in_ua_warehouse Прийнята на склад в Україні transit_ua_buyer У транзиті до покупця in_transit_warehouse В очікуванні відправки покупцю delivered Доставлена покупцю return_processed Повернення оброблене frozen Затримано у Києві leave_usa Залишило межі США transit_ua_usa У транзиті до розподільчого центру transit_usa_buyer Передано до служби доставки з розподільчого центру in_svh Прийнята на склад у розподільчому центрі svh_process В обробці на складі у розподільчому центрі partially_from_np Частково отримано із поштової служби в Україні full_from_np Отримано з поштової служби в Україні customer_sent_back Відправлено назад клієнту customer_returned Доставлено назад клієнту transit_buyer_usa У транзиті від покупця на склад Трек-номери https://prnt.sc/vmgsai - У Seller-Online є 2 змінних з трек номером. Перший трек-номер – ТТН нової пошти, його створюємо ми та вставляємо на замовлення OneBox, коли надсилаємо однією посилкою всі замовлення на склад Seller-Online. Другий трек-номер – створює Seller-Online, на кожну окрему посилку США, його ми повинні витягнути з Seller-Online. Для цього ще 2 авт. дії на етапах: Авт. дія етапу. "Імпорт трек номера з Seller-Online" В авт. дії налаштовуємо такі пункти: Інтеграція: Випадаючий список усіх інтеграцій. І пункт "Брати з картки клієнта" (тоді інтеграція береться з картки клієнта/дропшипера) Якщо в картці клієнта не вказано інтеграцію, вибирається “стандартна для відправки”. При переході на етап, OneBox згідно з номером замовлення, підтягує з Seller-Online трек номер посилки. Авт. дія етапу. "Передати ТТН Нової пошти на Seller-Online"" В авт. дії налаштовуємо такі пункти: Інтеграція: Випадаючий список усіх інтеграцій. І пункт "Брати з картки клієнта" (тоді інтеграція береться з картки клієнта/дропшипера) Якщо в картці клієнта не вказано інтеграцію, вибирається “стандартна для відправки”. На цьому етапі передаємо ТТН Нової Пошти з OneBox (З додаткового поля процесу на Seller-Online).