Основные положения

Под понятием сайт в настоящей документации понимается в целом проект аккаунта на платформе komiz.io, а не какая-то его определенная часть (он состоит из нескольких сайтов).

Под понятием система бухгалтерского учета в настоящей документации понимается любой программный комплекс, который будет работать по описываемым в этой документации алгоритмам.

Помните, что для всех описываемых механизмов действуют ограничения.

Для всех процессов синхронизации данных между сайтом и системой бухгалтерского учета справедливы следующие тезисы:

  • Все процессы обмена информацией во всех механизмах синхронизации сайта с системой бухгалтерского учета происходят только при обращении системы бухгалтерского учета к серверу сайта. Обратного обращения, т.е. сайта к системе бухгалтерского учета не производится.
  • Все обращения к серверу сайта производятся по протоколу HTTP.
  • В процессе обращения все передаваемые параметры передаются методом POST.
  • В процессе обращения необходимо передавать HTTP заголовок Content-Type: multipart/form-data. И формировать содержимое запроса по соответствующей ему схеме. Таким образом вы корректно передадите все данные (в первую очередь это касается файлов).
  • Для всех текстовых данных используется кодировка UTF-8.

ПОМНИТЕ! При формировании XML файлов необходимо придерживаться спецификации. В частности, это касается специальных символов, которые необходимо заменить на их альтернативы: 

" (двойная кавычка) - "
' (одинарная кавычка) - '
& (амперсанд) - &
< (знак меньше) - &lt;
> (знак больше) - &gt;

Валюта

Все суммы денег (Цена, старая цена и прочее) должны передаваться в валюте по умолчанию. Необходимо определиться в начале жизненного цикла проекта с валютой по умолчанию, установив ее в панели управления сайта. В дальнейшем изменение валюты по умолчанию не рекомендуется.

Зависимости сущностей

Необходимо соблюдать порядок выполнения запросов к сайту с системы бухгалтерского учета, который выплывает из следующих зависимостей синхронизируемых сущностей:

  • Товары не зависят ни от чего;
  • Покупатели зависят от товаров;
  • Заказы зависят от покупателей и от товаров.

Имеется ввиду, например, что если необходимо загрузить заказы на сайт из системы бухгалтерского учета, то перед этим необходимо загрузить на сайт информацию о покупателях, но перед этим необходимо загрузить информацию на сайт о товарах.

Загрузка заказов без предварительной загрузки информации о товарах или покупателях конечно возможна, но только в том случае, если в заказах не менялась информация относящаяся к товарам или покупателям, информация о которых ранее не загружена на сайт.