Большая доработка. Интеграцию API Seller-Online Задать свой вопрос

2020-11-20 16:44:29
Есть задача настроить интеграцию 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.

Ответы:

вы с Легезой об одном и том же спрашиваете зачем ?

20.11.2020, пятница, 21:13

Устименко Игорь
OneBox CTO писал/а:
вы с Легезой об одном и том же спрашиваетеg зачем ?

Мною был создан тикет в БП техподдержки, и он попал на Легезу. Тикет был закрыт. Так как у OneBox новые правила и выставлять нужно здесь.
Вот я и выставил, а после Вашего комента увидел что и Легеза выставил. Но в этом тикете описано подробно ТЗ.

20.11.2020, пятница, 22:23

Грабовский Александр
Клиент писал/а:

Устименко Игорь
OneBox CTO писал/а:
вы с Легезой об одном и том же спрашиваетеg зачем ?

Мною был создан тикет в БП техподдержки, и он попал на Легезу. Тикет был закрыт. Так как у OneBox новые правила и выставлять нужно здесь.
Вот я и выставил, а после Вашего комента увидел что и Легеза выставил. Но в этом тикете описано подробно ТЗ.

подобное ТЗ нужно разбирать через интегратора

21.11.2020, суббота, 10:50
Чтобы ответить на вопрос - пожалуйста войдите или зарегистрируйтесь