Интеграция 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;

• причина ошибки;

• дата и время возникновения ошибки.

Пользователь должен иметь возможность быстро определить, какие заказы не были переданы в Деловод из-за ошибки.