Efficient IT Solutions for Business Automation Systems

Модуль интеграции дропшиппинга Rozetka с BAS / 1С через API-эндпоинты

Если вы являетесь поставщиком Rozetka, этот модуль автоматизирует весь цикл дропшип-заказов в вашей учетной системе. Заказы поступают самостоятельно, документы формируются автоматически, возвраты обрабатываются без вашего участия.

Title: Інтеграція дропшипінгу Rozetka через API (ендпоінти)

Примерная стоимость: По запросу

Что автоматизирует модуль

Прием заказов

Новые дропшип-заказы с Rozetka загружаются в BAS/1С через API автоматически - со всеми реквизитами: ассортимент товаров, количество, закупочная цена, контактные данные клиента и пункт доставки. Никакого ручного копирования из личного кабинета поставщика.

Документооборот

Ежедневно система автоматически формирует счет-фактуру и накладную по всем отгрузкам дня и передает их поставщику через EDI. Документы о продаже для клиента также формируются автоматически после получения серийных номеров товара.

Отслеживание и возврат

Модуль отслеживает статус накладных по каждой отправке. Если клиент не забрал товар, система автоматически запускает процесс возврата и формирует все необходимые документы между Rozetka и поставщиком. Вам не нужно ничего делать вручную.

Как выглядит полный цикл дропшиппинга

Схема взаимодействия между Rozetka и поставщиком. Весь процесс, который вы видите на диаграмме, автоматизируется модулем на стороне вашей учетной системы BAS / 1С.

Прием и передача заказа

Rozetka получает заказ от клиента и принимает оплату - только предоплата (банковская карта, кредит ОЧ, карта Rozetka). После этого через API поставщику отправляется товарная накладная заказа, контактные данные клиента и адрес доставки. Поставщик подтверждает наличие товара - также через API. После подтверждения заказ блокируется для редактирования клиентом.

Подготовка и отгрузка

Поставщик комплектует заказ на складе и передает серийные номера товаров и накладную через API. На основе этих данных Rozetka формирует документы о продаже и отправляет их поставщику - они вкладываются в посылку для клиента. Параллельно товар размещается на виртуальном складе Rozetka, а документы о закупке формируются и передаются через EDI.

Отказ и возврат

Если клиент не забрал посылку, автоматически создается документ о возврате товара от клиента на виртуальный склад дропшиппинга. Затем формируется документ о возврате товара поставщику (РОБ). Физически товар из «Новой почты» возвращается напрямую на склад поставщика. Для завершения процесса поставщик подписывает документ РОБ.

Как подключить модуль

Шаг 1

Определяем, какие товары будут поставляться по схеме дропшиппинга (весь ассортимент или его часть). Подписываем договор с Rozetka на дропшиппинг. Для действующего поставщика - создаем дубликат контрагента с пометкой _Dropshipping. Для нового - создаем нового контрагента сразу с правильным названием.

Шаг 2

Настраиваем структуру в учетной системе: отдельное SLA для поставщика (маска Dropshipping_*номер поставщика*), отдельная папка товаров в каталоге, прайс в ССЦ Tools привязан к контрагенту _Dropshipping. После этого новые товары автоматически попадают в нужные группы.

Шаг 3

Подключаем модуль к API Rozetka. Проверяем работу всех конечных точек: создание заказа, подтверждение, редактирование, отслеживание, передача документов, отмена и возврат. Только после полного тестирования - запуск.

Шаг 4

После запуска мы обеспечиваем сопровождение интеграции - помогаем при изменениях в API Rozetka, обновлениях BAS/1С или нестандартных ситуациях в процессе работы.

API-конечные точки - что обрабатывает модуль

Модуль реализован на основе спецификации REST API, предоставляемой Rozetka поставщикам. Все запросы и ответы представлены в формате JSON. Ниже приведен полный список эндопоинтов с примерами.

МетодЕндпоинтНазначение
POST/order/createСоздание нового заказа
PUT/order/edit/{guid}Редактирование существующего заказа
DELETE/order/cancel/{guid}Отмена заказа
GET/order/status/{guid}Проверка статуса + ТТН
POST/order/{guid}/uploadПередача файлов (PDF-документы)
DELETE/file/{file_guid}/deleteУдаление файла

Создание заказа

POST /order/create

Заказ поступает от Rozetka с полным списком товаров, данными клиента и пунктом доставки.

Тело запроса:

{
«header»: {
«partnerOrderId»: «123e4567-e89b-12d3-a456-426614174000»,
«comment»: «Коментар клієнта з сайту»,
«deliveryAddresType»: «DropShipping»,
«cashOnDelivery»: 0,
«deliveryCompanyName»: «Нова Пошта»,
«deliveryAddressId»: «NP_BRANCH_001»,
«CustomerName»: «Іван Петренко»,
«deliveryCity»: «Київ»,
«deliveryPhone»: «+380501234567»,
«deliveryStreet»: «вул. Хрещатик, 1»
},
«products»: [
{
«supplier_code»: «SUP12345»,
«RZ_code»: 11254855,
«quantity»: 2,
«price»: 100.50
},
{
«supplier_code»: «SUP12346»,
«RZ_code»: 11254800,
«quantity»: 1,
«price»: 250.00
}
]
}

Ответ 250 Pending:

{
«guid»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «pending»
}

Ответ 400 Bad Request:

{
«error»: «Недійсні дані замовлення»
}

Отмена заказа

DELETE /order/cancel/{guid}

guid — уникальный идентификатор заказа.

Ответ 200 OK:

{
«partnerOrderId»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «canceled»
}

Ответ 400 Not Found:

{
«error»: «Замовлення не знайдено»
}

Редактирование заказа

PUT /order/edit/{guid}

При обновлении передается полный товарный состав заказа.

Тело запроса:

{
«deliveryAddresType»: «DropShipping»,
«cashOnDelivery»: 0,
«deliveryCompanyName»: «Нова Пошта»,
«CustomerName»: «Іван Петренко»,
«deliveryCity»: «Київ»,
«deliveryPhone»: «+380501234567»,
«deliveryStreet»: «вул. Хрещатик, 1»,
«products»: [
{
«supplier_code»: «SUP12345»,
«RZ_code»: 11254855,
«price»: 100.50,
«quantity»: 2
}
]
}

Ответ 250 OK

{
«partnerOrderId»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «pending»
}

Проверка статуса заказа

GET /order/status/{guid}
Ответ 250 OK

{
«guid»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «shipped»,
«tracking_number»: «track-12345»,
«products»: [
{
«supplier_code»: «SUP12345»,
«RZ_code»: 11254855,
«quantity»: 2,
«reservedQuantity»: 2,
«SerialNumber»: [«SDSS2122221212», «SDSA11221122233»]
}
]
}

Возможные статусы:

created — Заказ принят к обработке
updated — Заказ отредактирован
shipped — Отправлен, имеется номер накладной

Загрузка файлов

POST /order/{guid}/upload

Передача PDF-документов (накладные, чеки) в виде двоичных данных.

Пример запроса:

POST /order/123e4567-e89b-12d3-a456-426614174000/upload
Content-Type: application/octet-stream

[binary PDF data]

Ответ 200 OK:

{
«success»: true,
«file_guid»: «abc12345-e89b-12d3-a456-426614174001»,
«message»: «Файл успішно завантажено»
}

Обработка ошибок:

401 — Неверный или отсутствующий API-ключ

400 — Неверный формат запроса или отсутствующие параметры

404 — Ресурс не найден

500 — Общая ошибка сервера

Удаление файла

DELETE /file/{file_guid}/delete

Передача PDF-документов (накладные, чеки) в виде двоичных данных.

Пример запроса:

DELETE /file/abc12345-e89b-12d3-a456-426614174001/delete

Ответ 200 OK:

{
«success»: true,
«message»: «Файл успішно видалено»
}

Доступные инструменты для дропшип-заказов

Оплата (поддерживается модулем):

Картой на сайте Rozetka
Оплата в рассрочку
RED / SMART (для товаров весом до 30 кг)

Доставка

Новая Почта - отделение
Новая Почта - курьер
Кур'єр постачальника - в розробці (другий етап)
Заказать модуль




    Дропшиппинг Rozetka с автоматизацией в BAS/1С — зачем это нужно

    Дропшиппинг через Rozetka на первый взгляд выглядит просто: маркетплейс принимает заказы и деньги, вы отправляете товар клиенту. Но если заказов десятки или сотни в день — без нормальной интеграции с учетной системой это превращается в хаос. Ручной перенос каждого заказа, ручное формирование документов, постоянный контроль статусов доставки и возвратов — все это отнимает время и приводит к ошибкам.

    Наш модуль полностью решает эту проблему. Он подключается к API Rozetka и берет на себя весь рутинный цикл: заказ загружается в BAS/1С автоматически, подтверждение наличия товара идет через API, документы формируются и передаются через EDI без единого ручного действия. Трекинг ТТН — автоматический. Возвраты — тоже.

    Как организована работа с контрагентами в BAS/1С

    Один из важных моментов, который часто недооценивают — правильная структура контрагентов в учетной системе. Для каждого поставщика, который работает по дропшип-схеме, создается отдельный контрагент с пометкой _Dropshipping в названии — например, НазваниеПоставщика_Dropshipping. Это не формальность, а необходимость: дропшип и обычные закупки у одного и того же поставщика должны четко разграничиваться в учете, чтобы не путаться в документах, прайсах и отчетах.

    Если поставщик уже существует в системе — создается дубль контрагента. Если новый — заводится сразу с правильным названием. Прайс в ССЦ Tools также привязывается отдельно, под дропшип-контрагента. График поставок в карточке контрагента настраивается отделом закупок — либо остается стандартным. Важно: график под прогноз автозакупки для дропшиппинга не настраивается.

    SLA, товарные папки и маппинг — что настраивается в ERP

    Для каждого поставщика-дропшиппера в ERP создается отдельное SLA с маской Dropshipping_номер поставщика из справочника ERP — например, Dropshipping_28790441. Это нужно для того, чтобы новые товары этого поставщика автоматически попадали в корректные группы в ERP и Goods, без ручной сортировки.

    Параллельно в каталоге создается отдельная папка для дропшип-товаров этого поставщика — например, Название категории_Dropshipping. Существующие товары переносятся в эту папку вручную через ССЦ Tools, новые — попадают туда автоматически после настройки маппинга. Merchant также обновляется через Tools: для дропшип-товаров устанавливается Merchant 109 Dropshipping. Если для товаров дропшиппинга нужно подключить кредит — на новую папку настраивается дельта резерва.

    Новая Почта и бизнес-кабинет для дропшиппинга

    Отдельный момент — логистика. Для каждого поставщика-дропшиппера Rozetka создает отдельный бизнес-кабинет Новой Почты с названием контрагента в формате Rozetka_номер поставщика — например, Rozetka_28790441. Через этот кабинет поставщик формирует ТТН для отправки товаров клиентам.

    Сейчас доступны два варианта отгрузки: вызов курьера НП на склад поставщика с формированием реестров ТТН, либо самостоятельная отправка товара из отделения НП. Вариант доставки курьером поставщика сейчас находится в разработке и появится на втором этапе.

    Что происходит с документами при отгрузке

    После того как поставщик передает серийные номера товара через API — Rozetka формирует документы продажи товара клиенту и отправляет их поставщику. Эти документы поставщик вкладывает в посылку. Каждый день в 23:00 автоматически формируется документ закупки товара у поставщика — входящий счет — куда попадают все товары, отгруженные или запланированные к отгрузке за этот день. Этот документ штатно отправляется поставщику через электронный документооборот EDI. Одновременно автоматически формируется приходная накладная, которая также отправляется поставщику на подпись.

    Вся эта цепочка — без единого ручного действия с вашей стороны. Модуль делает это самостоятельно, ежедневно, в одно и то же время.

    Как обрабатываются возвраты

    Возвраты в дропшиппинге — отдельный и довольно нетривиальный процесс. Если клиент не забрал товар в отделении или по адресу — автоматически создается документ возврата товара от клиента на виртуальный склад дропшиппинга. Физически при этом товар из Новой Почты возвращается напрямую на склад поставщика, минуя Rozetka.

    Затем автоматически формируется документ возврата товара поставщику — РОБ. Это особенно важно для тех поставщиков, у которых по договору возвраты товара не предусмотрены — документ фиксирует факт возврата юридически корректно. Для завершения процесса поставщику необходимо подписать документ РОБ. После подписания возврат считается закрытым.

    Что отличает этот модуль от ручной работы

    Главное отличие — не просто «данные попадают в систему», а то, что вся логика процесса реализована внутри модуля. Он знает, что после получения серийных номеров нужно сформировать документы продажи. Знает, что в 23:00 нужно закрыть документы закупки за день. Знает, что если клиент не забрал посылку — нужно запустить процесс возврата и сформировать РОБ. Ни один из этих шагов не требует вашего участия.

    Для кого подходит модуль

    Модуль разработан для поставщиков Rozetka, которые ведут учет в BAS или 1С и хотят автоматизировать дропшип-схему без найма дополнительного персонала для ручного ввода данных. Подходит как для новых поставщиков, которые только подписывают договор на дропшиппинг, так и для действующих — с минимальными изменениями в существующей структуре ERP. Если у вас уже настроен обмен с Rozetka по другой схеме — подключим модуль без остановки работы. Если только начинаете — проконсультируем и пройдем весь путь от договора до первого заказа.