Процесс синхронизации данных интернет-магазина с программой учета

Данный порядок необходим для предотвращения возможных ошибок при загрузке данных, и рисков, связанных с ними.

1. Запросить дату актуальности последней синхронизации запросом к syncInfo
2. Сформировать xml с даты последней синхронизации по текущую
3. Загрузить xml файл по FTP. Имя файла должно быть уникальным. Заменять уже загруженные файлы запрещено. Просьба добавить префикс типа файkа к Имени файлу для удобства анализа, например v8_detail_A8E9_28e.xml
4. Поставить xml файл в очередь на синхронизацию запросом к syncAdd

Параметры передаются в виде POST или GET запроса.

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

имя сайта/?option=com_wmartalpha&task=system.syncInfo

Получает информацию о текущей очереди. Результат возвращается в формате JSON.

https://sitename.ru?option=com_wmartalpha&task=system.syncInfo&type=product

имя сайта/?option=com_wmartalpha&task=system.syncAdd

Добавляет файл в очередь синхронизации. Результат возвращается в формате JSON.

https://sitename.ru?option=com_wmartalpha&task=system.syncAdd&type=catalog&filename=_Items678246.xml&date_start=23.07.2019%2022:58&date_end=24.07.2019%2020:22:58

Любой отличный от 1 код ответа следует рассматривать как ошибку запроса.

Накопительная выгрузка изменений товаров за период

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <categories>
    <category aid="10" aparent_id="0">Товары</category>
    <category aid="11" aparent_id="0">Услуги</category>
    <category aid="12" remove="1">Удаляемая категория</category>
  </categories>
  <products>
    <product 
      aid="376647" aparent_id="126" vendor="278" 
      country="000000021" packing="23" fgroup="0000001021,0000001022" 
      prescript="1" veterinary="1" substance="aid" trade-name="aid">
      <title>5-НОК табл по 50 мг №50 Сандоз</title>
     <substance>Нитроксолин</substance>
      <barcode>7613421035662</barcode>
      <vat>VAT_10</vat>
      <imshop_sort>10</imshop_sort>
      <flags>
        <flag>Акция</flag>
        <flag>Новинка</flag>
      </flags>
    </product>
    <product aid="376699" remove="1">
      <title>Удаляемый товар</title>
    </product> 
  </products>
 
</data>

Накопительная выгрузка описания товаров за период

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <products>
    <product aid="376647" diseases="aid,aid">
      <diseases>
        <disease>ОРЗ</disease>
        <disease>Грипп</disease>
      </diseases>
      <syns>
        <syn>Синоним 1</syn>
        <syn>Синоним 2</syn>
      </syns>
      <analogs>
        <analog>Аналог 1</analog>
        <analog>Аналог 2</analog>
      </analogs>
      <relatives>
        <relative>37664732</relative>
      </relatives>
      <desc>
        lt;h2&gt;Наименование&lt;/h2&gt;
        Аквалор Беби средство д/промывания полости носа капли 15 мл Аурена Лабораторис Эйби
        &lt;h2&gt;Производитель / Страна&lt;/h2&gt;
        Аурена Лабораторис Эй Би / Швеция...
      </desc>
      <promo-desc>Промоописание товара длинное может быть</promo-desc>
      <trade-name>Озопринозин</trade-name>
      <prescribe>
        Показания к применению
      </prescribe>
      <dosing>
       Способ применения
      </dosing>
      <precaution>
       Противопоказания 
      </precaution>
      <storeCnd>
       Условия хранения
      </storeCnd>
    </product>
  </products>
  <images>
    <image type="product" aid="376647">
      <filename>AP-0000-3766647.jpg</filename>
      <filename>AP-0000-3766647-1.jpg</filename>
      <filename>AP-0000-3766647-2.jpg</filename>
    </image>
    <image type="category" aid="376648">
      <filename>AP-0000-3766648-1.jpg</filename>
      <filename>AP-0000-3766648-2.jpg</filename>
      <filename>AP-0000-3766648-3.jpg</filename>
    </image>
  </images>
</data>

Накопительная выгрузка изменений цен и остатков за период

<?xml version='1.0' encoding="UTF-8"?>
<data>
  <lots>
    <lot aid="1234565435" aproduct_id="865" expire="2023-09-30T00:00:00" short="1" price="720" price_staff="602.81" price_reg="720" price_opt="">
      <stock aid="834">9</stock> 
      <stock aid="835">8</stock> 
      <stock aid="836">0</stock> 
    </lot>
  </lots>
</data>

Данные пользователей

<?xml version="1.0" encoding="UTF-8"?>
<data>
 <users>
  <user phone="79081234567" aid="guid" card="0122222" card_type="guid">
    <profile>
      <firstname>Кирилл</firstname>
      <lastname>Сорокин</lastname>
    </profile>
    <organizations> 
      <organization inn="52600000">ООО ТОНУС</organization> 
    </organizations> 
    <bonuses sum="100">
      <bonus sum="1000" date="2023-05-22T10:00:00" aid="aa12dswd">Стартовые бонусы</bonus>
      <bonus sum="-900" date="2023-05-22T14:00:00" aid="aa212dw">Матрац аскорбинки</bonus>
    </bonuses>
  </user>
 </users>
</data>

Накопительная выгрузка изменений по заказам за период

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

Пользователя c флагом registered установленным в 0 считать гостем. Данный пользователь не имеет постоянного идентификатора и не должен быть регистрирован в качестве контрагента.

alot (guid партии) более не передается. Партия выбирается на усмотрение программы учета исходя из передаваемых сайтом пункта выдачи, срока годности и признака short.

<?xml version='1.0' encoding="UTF-8"?>
<data>
  <orders>
    <order aid="263aa" id="2634" number="203" status="1" source="imshop" created="2021-09-30T10:05:00" changed="2021-09-30T10:05:00">
      <user id="12" registered="0" card="76760000000000086" card-type="aa1d17d7-8c63-11eb-879d-00155d016709" aid="950515">
        <firstname>Кирилл</firstname>
        <lastname>Сорокин</lastname>
        <phone>78310000000</phone>
        <email>info@web152.ru</email>
      </user>
      <shipping id="30" aid="834" type="delivery">
        603000 г. Нижний Новгород, Володарского
      </shipping>
      <payment id="1" />
      <price shipping="0" coupon="-12.5" balance="0" hold="1459" total="1459" />
      <items>
        <item aid="3790984" expire="2023-09-30T00:00:00" short="1" price="1459" count="1" />
        <item aid="3790985" expire="2023-09-30T00:00:00" short="1" price="1459" count="1" />
      </items>
      <note>Комментарий</note>
    </order>
  </orders>
</data>

Справочные данные по свойствам и складам. Выгружается всегда полностью.

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <references>
    <reference name="vendor">
      <val aid="7959">Плантэкстракт ГмбХ и Ко.КГ/Мадаус ГмбХ</val>
      <val aid="7960">Рекитт Бенкизер Хелскэар/ЭсЭсЭл Мануфакт</val>
    </reference>
    <reference name="disease">
      <val aid="7959">Грипп</val>
      <val aid="7960">ОРВИ</val>
    </reference>
    <reference name="substance">
      <val aid="7959">Адапален</val>
      <val aid="7960">Азитромицин</val>
    </reference>
    <reference name="trade-name">
      <val aid="7959">АЗИТРОМИЦИН</val>
      <val aid="7960">Тиберал</val>
    </reference>
    <reference name="country">
      <val aid="000000001">Россия</val>
      <val aid="000000002">Италия</val>
    </reference>
    <reference name="packing">
      <val aid="1">Ампулы</val>
      <val aid="2">Аэрозоль</val>
    </reference>	
    <reference name="fgroup">
      <val aid="0000000689">Средства, действующие преимущественно на центральную нервную систему</val>
      <val aid="0000000690">Средства, тормозящие активность центральной нервной системы</val>
    </reference>
    <reference name="ugroup">
      <val aid="0">Розница</val>
      <val aid="0000000xxx">Карта лояльности</val>
      <val aid="0000000xxx">Сотрудники</val>
    </reference>
  </references>
  <cities>
    <city aid="52">
      <title>Нижний Новгород</title>
      <stocks>
        <stock aid="830" lat="56.296348" lon="43.924713" dropshipping="0">
          <title>ЕАптека Московское шоссе ост Березовская</title>
          <address>603079, г.Нижний Новгород, Московское шоссе, 179</address>
          <address-short>Н.Новгород,Московское ш.,179</address-short>
          <phone>+7 (831) 215-51-41</phone>
          <shedule desc="ПН-ПТ 8:00 – 20:00&lt;br&gt;СБ-ВС 9:00 – 20:00">  
          </shedule>
        </stock>
        <stock aid="831" lat="56.296348" lon="43.924713">
          <title>ЕАптека Терешковой</title>
          <address>603081, г.Нижний Новгород, ул. Терешковой, 6а</address>
          <phone>+7 (831) 215-51-40</phone>
          <shedule desc="ПН-ПТ 8:00 – 20:00&lt;br&gt;СБ-ВС 9:00 – 20:00">
            <days>
             <day num="1" purchase_end="18:30" duration="1">
             <day num="2" purchase_end="18:30" duration="1">
             <day num="3" purchase_end="18:30" duration="1">
             <day num="4" purchase_end="18:30" duration="1">
             <day num="5" purchase_end="18:00" duration="1">
             <day num="6"><!-- нельзя заказывать, но можно забрать -->
            </days>
          </shedule>
        </stock>
      </stocks>
    </city>
  </cities>
</data>

Параметры передаются в виде POST или GET запроса.

имя сайта/?option=com_wmartalpha&task=system.orderItems

Получает xml документ с данными заказов измененных начиная с времени date_change

https://sitename.ru?option=com_wmartalpha&task=system.orderItems&date_change=01.01.2020%2023:00