{{indexmenu_n>0001}}
====== Основные положения ======

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

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

Помните, что для всех описываемых механизмов действуют [[dev:as:ogranicheniia|ограничения]].

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

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

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

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

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

===== Зависимости сущностей =====
Необходимо соблюдать порядок выполнения запросов к сайту с системы бухгалтерского учета, который выплывает из следующих зависимостей синхронизируемых сущностей:
  * Товары не зависят ни от чего;
  * Покупатели зависят от товаров;
  * Заказы зависят от покупателей и от товаров.
Имеется ввиду, например, что если необходимо загрузить заказы на сайт из системы бухгалтерского учета, то перед этим необходимо загрузить на сайт информацию о покупателях, но перед этим необходимо загрузить информацию на сайт о товарах.

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