Модуль інтеграції дропшипінгу 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 по іншій схемі – підключимо модуль без зупинки роботи. Якщо тільки починаєте – проконсультуємо і пройдемо весь шлях від договору до першого замовлення.