Інтеграція SalesDrive → Діловод

У SalesDrive підключено 4 сайти. Для кожного сайту в Діловоді створено окремого контрагента. Усі резервування та списання товарів у Діловоді виконуються з основного складу.

1. Передача замовлень

Первинна передача замовлення в Діловод виконується один раз при переході замовлення у статус «Роздруковано». Автоматично створюється документ «Замовлення покупця» та встановлюється резерв на товар.

При зміні статусу цього ж замовлення на «Відправлено» вебхук оновлює дані документа «Замовлення покупця» та ініціює створення документа «Видаткова накладна» на його основі. Під час проведення «Видаткової накладної» здійснюється фактичне списання товару, а резерв автоматично знімається.

Якщо документ «Замовлення покупця» вже існує, при повторному отриманні вебхука новий документ створювати не потрібно. Необхідно оновити існуючий документ за ID замовлення SalesDrive.

2. Контрагенти та дані клієнта

Під час передачі замовлення система автоматично визначає контрагента залежно від сайту, з якого надійшло замовлення.

• Сайт 1 → Контрагент 1

• Сайт 2 → Контрагент 2

• Сайт 3 → Контрагент 3

• Сайт 4 → Контрагент 4

• Якщо замовлення створене вручну в SalesDrive — використовується окремий контрагент «Ручні замовлення».

Додатково передавати:

• ПІБ покупця;

• телефон;

• номер ТТН (за наявності).

Ці дані повинні автоматично записуватися в поле «Коментар» документів «Замовлення покупця» та «Видаткової накладної».

3. Номенклатура

Співставлення товарів між SalesDrive та Діловодом виконується виключно за артикулом (SKU).

Якщо товар із відповідним SKU не знайдений у Діловоді:

• нову картку товару не створювати;

• документ не створювати;

• зафіксувати інформацію про помилку будь-яким зручним способом.

4. Таблична частина

До документа необхідно передавати:

• товар (за SKU);

• кількість;

• ціну за одиницю;

• суму;

• знижку (за наявності).

5. Знижки із SalesDrive

Знижка із SalesDrive повинна автоматично розподілятися пропорційно між усіма товарами замовлення шляхом коригування ціни кожної позиції.

Підсумкова сума документа в Діловоді повинна повністю відповідати сумі замовлення в SalesDrive (копійка в копійку).

6. Скасування або видалення замовлення

Якщо замовлення скасовано або видалено в SalesDrive до створення документа «Видаткова накладна»:

• зняти резерв у Діловоді;

• якщо «Видаткова накладна» ще не створена або не проведена — скасувати документ «Замовлення покупця»;

• якщо «Видаткова накладна» вже проведена — жодних змін у Діловоді не виконувати.

7. Фіксація помилок

У разі виникнення будь-якої помилки (товар із таким SKU не знайдений, контрагент не знайдений, помилка API тощо):

• не створювати новий товар;

• не створювати документ;

• зафіксувати інформацію про помилку будь-яким зручним способом.

Інформація про помилку повинна містити:

• номер (ID) замовлення SalesDrive;

• дату;

• час;

• текст помилки.

8. Ідентифікація замовлення

Для зв'язку документів у Діловоді із замовленнями SalesDrive використовувати унікальний ID замовлення SalesDrive.

Саме за цим ID повинні виконуватися:

• пошук існуючого документа;

• оновлення документа;

• захист від дублювання.

9. Контроль передачі та відображення помилок

У разі виникнення помилки під час передачі замовлення з SalesDrive до Діловода необхідно реалізувати будь-який зручний спосіб відображення інформації про замовлення, які не були передані.

Для кожного такого замовлення повинна бути доступна така інформація:

• номер (ID) замовлення SalesDrive;

• причина помилки;

• дата та час виникнення помилки.

Користувач повинен мати можливість швидко визначити, які замовлення не були передані до Діловода через помилку.