Большая доработка. Интеграцию 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.