Интеграция предназначена для версии API v4 и выше. Распределение по версиям происходит автоматически. Вам не нужно устанавливать используемую версию API вручную.
Использование версии API v5
Скидки
Из-за того, что по отношению к предыдущей версии API изменилось получение скидок из системы, изменение заказа в двух системах приведет к переводу из общей скидки в скидки на каждую позицию.
При передаче скидок из InSales в систему, возможна и передача скидок на весь заказ, но при обратной синхронизации (Система > InSales) скидки будут приведены к формату «скидка на каждый товар в заказе».
Оплаты
Так как в версии API v5 появилась работа с мультиоплатами, а в InSales всего одна оплата в заказе, то синхронизация оплат в заказе происходит следующим образом.
Если заказ создан в InSales, то при создании заказа в системе будет присвоена одна оплата и ей же будет присвоен внешний ID оплаты, идентичный внешнему ID заказа. В синхронизации заказов будет участвовать та оплата, которая привязана к заказу внешним ID. Если же заказ был создан в системе или связанная оплата была удалена, то при первом изменении оплат в заказе системы, первая из списка оплата заменит оплату в InSales.
Синхронизация статусов оплаты происходит по одному из сценариев описанных ниже:
- Синхронизация по 100% оплате заказа (по дате полной оплаты заказа)
Статус полной оплаты из системы в InSales передается только тогда, когда будет выставлена дата полной оплаты в заказе. То есть, когда все оплаты в заказе будут с пометкой «Оплачен». За исключением статуса оплаты системы, который связан с дополнительным статусом «Бесплатная оплата заказа». В случае, если в системе будет выставлен подобный статус, то в InSales будет передан статус «Оплачен».
- Синхронизация по одной оплате
Синхронизация статусов будет производиться только по одной оплате из системы, которая связана с оплатой в заказе InSales внешним ID. То есть, все остальные оплаты в заказе системы не будут принимать участие в синхронизации статусов оплаты.
Один из перечисленных сценариев можно указать во вкладке «Система», в настройках интеграции. Опция «Синхронизация по 100% оплате заказа (по дате полной оплаты заказа)» является механикой по умолчанию для синхронизации статусов оплат.