Модуль интеграции дропшиппинга Rozetka с BAS / 1С через API-эндпоинты
Если вы являетесь поставщиком Rozetka, этот модуль автоматизирует весь цикл дропшип-заказов в вашей учетной системе. Заказы поступают самостоятельно, документы формируются автоматически, возвраты обрабатываются без вашего участия.
Примерная стоимость: По запросу
Что автоматизирует модуль
Новые дропшип-заказы с Rozetka загружаются в BAS/1С через API автоматически - со всеми реквизитами: ассортимент товаров, количество, закупочная цена, контактные данные клиента и пункт доставки. Никакого ручного копирования из личного кабинета поставщика.
Ежедневно система автоматически формирует счет-фактуру и накладную по всем отгрузкам дня и передает их поставщику через EDI. Документы о продаже для клиента также формируются автоматически после получения серийных номеров товара.
Модуль отслеживает статус накладных по каждой отправке. Если клиент не забрал товар, система автоматически запускает процесс возврата и формирует все необходимые документы между Rozetka и поставщиком. Вам не нужно ничего делать вручную.
Как выглядит полный цикл дропшиппинга
Схема взаимодействия между Rozetka и поставщиком. Весь процесс, который вы видите на диаграмме, автоматизируется модулем на стороне вашей учетной системы BAS / 1С.
Rozetka получает заказ от клиента и принимает оплату - только предоплата (банковская карта, кредит ОЧ, карта Rozetka). После этого через API поставщику отправляется товарная накладная заказа, контактные данные клиента и адрес доставки. Поставщик подтверждает наличие товара - также через API. После подтверждения заказ блокируется для редактирования клиентом.
Поставщик комплектует заказ на складе и передает серийные номера товаров и накладную через API. На основе этих данных Rozetka формирует документы о продаже и отправляет их поставщику - они вкладываются в посылку для клиента. Параллельно товар размещается на виртуальном складе Rozetka, а документы о закупке формируются и передаются через EDI.
Если клиент не забрал посылку, автоматически создается документ о возврате товара от клиента на виртуальный склад дропшиппинга. Затем формируется документ о возврате товара поставщику (РОБ). Физически товар из «Новой почты» возвращается напрямую на склад поставщика. Для завершения процесса поставщик подписывает документ РОБ.
Как подключить модуль
Определяем, какие товары будут поставляться по схеме дропшиппинга (весь ассортимент или его часть). Подписываем договор с Rozetka на дропшиппинг. Для действующего поставщика - создаем дубликат контрагента с пометкой _Dropshipping. Для нового - создаем нового контрагента сразу с правильным названием.
Настраиваем структуру в учетной системе: отдельное SLA для поставщика (маска Dropshipping_*номер поставщика*), отдельная папка товаров в каталоге, прайс в ССЦ Tools привязан к контрагенту _Dropshipping. После этого новые товары автоматически попадают в нужные группы.
Подключаем модуль к API Rozetka. Проверяем работу всех конечных точек: создание заказа, подтверждение, редактирование, отслеживание, передача документов, отмена и возврат. Только после полного тестирования - запуск.
После запуска мы обеспечиваем сопровождение интеграции - помогаем при изменениях в 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 | Удаление файла |
Создание заказа
Заказ поступает от 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
}
]
}
{
«guid»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «pending»
}
{
«error»: «Недійсні дані замовлення»
}
Отмена заказа
guid — уникальный идентификатор заказа.
{
«partnerOrderId»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «canceled»
}
{
«error»: «Замовлення не знайдено»
}
Редактирование заказа
При обновлении передается полный товарный состав заказа.
{
«deliveryAddresType»: «DropShipping»,
«cashOnDelivery»: 0,
«deliveryCompanyName»: «Нова Пошта»,
«CustomerName»: «Іван Петренко»,
«deliveryCity»: «Київ»,
«deliveryPhone»: «+380501234567»,
«deliveryStreet»: «вул. Хрещатик, 1»,
«products»: [
{
«supplier_code»: «SUP12345»,
«RZ_code»: 11254855,
«price»: 100.50,
«quantity»: 2
}
]
}
{
«partnerOrderId»: «123e4567-e89b-12d3-a456-426614174000»,
«status»: «pending»
}
Проверка статуса заказа
{
«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 — Отправлен, имеется номер накладной
Загрузка файлов
Передача PDF-документов (накладные, чеки) в виде двоичных данных.
POST /order/123e4567-e89b-12d3-a456-426614174000/upload
Content-Type: application/octet-stream
[binary PDF data]
{
«success»: true,
«file_guid»: «abc12345-e89b-12d3-a456-426614174001»,
«message»: «Файл успішно завантажено»
}
Обработка ошибок:
401 — Неверный или отсутствующий API-ключ
400 — Неверный формат запроса или отсутствующие параметры
404 — Ресурс не найден
500 — Общая ошибка сервера
Удаление файла
Передача PDF-документов (накладные, чеки) в виде двоичных данных.
DELETE /file/abc12345-e89b-12d3-a456-426614174001/delete
{
«success»: true,
«message»: «Файл успішно видалено»
}
Доступные инструменты для дропшип-заказов
Оплата (поддерживается модулем):
Доставка
Дропшиппинг 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 по другой схеме — подключим модуль без остановки работы. Если только начинаете — проконсультируем и пройдем весь путь от договора до первого заказа.
