JSON-данные передаются в теле запроса POST в REST API. Ключевым аспектом является указание заголовка Content-Type: application/json, который сообщает серверу, что данные имеют формат JSON.

В случае успешного выполнения запроса возвращается JSON объект. Убедитесь, что сервер принял данные, в противном случае выполнение запроса необходимо повторить.

Обновление данных является инкрементным и требует соблюдения хронологической последовательности и неразрывности. Порядок действий: - Запросить дату актуальности последней синхронизации API-методом syncInfo - Сформировать json-документ с выборкой по времени объектов, начиная с даты последней синхронизации по текущую - Отправить запрос с сформированный JSON-документа с помощью API-метода

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

Запрос создает access токен, предназначенный для работы с API. Полученный токен необходимо отправлять в заголовке Authorization: token accessToken

{
  username: "super"
  key: "7d61d77d61d77d61d77d61d77d61d7"
}

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

{
  type: "product"
}

Получает json документ с данными заказов. Формат возвращаемых данных см. /api/v2/order.sync

{
  date_change: "2025-09-03T10:25:43+03:00"
}

Получает json документ с данными заказов. Формат возвращаемых данных см. /api/v2/reference.sync

{
  name: "country"
}

Получает json документ с данными заказов. Формат возвращаемых данных см. /api/v2/user.sync

{
  date_change: "2025-09-03T10:25:43+03:00",
}

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

{
 date_start: "2025-09-03T10:25:43+03:00",
 date_end: "2025-09-03T18:25:43+03:00",
 categories: [
  {
   aid: "10",
   aparent_id: "0",
   title: "Товары"
  },
  {
   aid: "11",
   aparent_id: "10",
   title: "Товар 1"
  },
  {
   aid: "12", 
   remove: 1,
   title: "Удаляемая категория"
 }
 ]
}

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

{
 date_start: "2025-09-03T10:25:43+03:00",
 date_end: "2025-09-03T18:25:43+03:00",
 products: [
   {
    aid: "10",
    aparent_id: "126", 
    title: "5-НОК табл по 50 мг №50 Сандоз",
    barcode: "7613421035662",
    vat: "VAT_10",
    vendor_id: "278",
    country_id: "21", 
    packing_id: "23",
    tradename_id: "81",
    substance_id: "78",    
    fgroup_id: ["0000001021","0000001022"],
    flags: ["Акция","Новинка"],
    prescript: 1,
    veterinary: 1
   },
   {
    aid: "376699",
    title: "Удаляемый товар",
    remove: "1"
   }
 ]
}

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

{
  date_start: "2025-09-03T10:25:43+03:00",
  date_end: "2025-09-03T18:25:43+03:00",
  products: [
    {
      aid: "376647",
      diseases:[124,125],
      syns:[512,516],
      analogs:[712,718],
      relatives:[812,818],
      trade_name: "785",
      desc: "<...>Описание<...>",
      prescribe: "<...>Показания к применению<...>",
      dosing: "<...>Способ применения<...>",
      precaution: "<...>Противопоказания<...>",
      storeCnd: "<...>Условия хранения<...>",
      promo_desc: "Промоописание товара длинное может быть",
      images:["AP-0000-3766647.jpg", "AP-0000-3766647-1.jpg"]
    }
  ],
  categories: [
    {
      aid: "37",
      images: ["AP-0000-3766647.jpg", "AP-0000-3766647-1.jpg"]   
    }
  ]
}

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

{
 date_start: "2025-09-03T10:25:43+03:00",
 date_end: "2025-09-03T18:25:43+03:00",
 lots: [
  {
   aid: "572345",
   aparent_id: "865",
   expire: "2023-09-30T00:00:00",
   short: 1,
   prices: [
    {
      aid: 0,
      value: 720,
    },
    {
      aid: 1,
      value: 720,
    },
    {
      aid: 2,
      value: 602.81,
    },
   ]
   stocks: [
    {
      aid: 834,
      qty: 9,
    }, 
    {
      aid: 838,
      qty: 8,
    },   
    {
      aid: 836,
      qty: 0,
    },   
   ]
  },
 ],
}

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

{
  date_start: "2025-09-03T10:25:43+03:00",
  date_end: "2025-09-03T18:25:43+03:00",
  users: [
    aid: "722552",
    email: "customer@gmail.com",
    phone: "79081234567",
    card: "0122222",
    card_type: "1",
    firstname: "Кирилл",
    lastname: "Сорокин",
  ]
}

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

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

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

{
  date_start: "2025-09-03T10:25:43+03:00",
  date_end: "2025-09-03T18:25:43+03:00",
  orders: [
    aid: "722552",
    id: 722,
    number: 206,
    status: 1,
    source: 0,
    created: "2021-09-30T10:05:00+03:00",
    changed: "2021-09-30T10:05:00+03:00",
    user: {
      aid: "435534",
      id: 456,
      registered: 0,
      card: "76760000000000086", 
      card_type: "2"
      firstname: "Кирилл",
      lastname: "Сорокин",
      phone: "79683500000",
      email: "info@web152.ru",
    },
    shipping: {
      stock_aid: "834",
      id: 30,
      type: "delivery",
      address: "603000 г. Нижний Новгород, Володарского"
    }
    payment_id: 1,
    prices: {
      shipping: "0",
      coupon: "-12.5",
      balance: "0",
      total: "257",
    },
    purchases: [
      {
        aid: "3790984",
        expire: "2021-09-30T10:05:00+03:00",
        short: 1,
        price: 1000,
        qty:1
      },
      {
        aid: "3790985",
        expire: "2021-09-30T10:05:00+03:00",
        short: 0,
        price: 459,
        qty:1
      },
    ]
    note: "Комментарий"
  ]
}

Справочные данные

{
  date_start: "2025-09-03T10:25:43+03:00",
  date_end: "2025-09-03T18:25:43+03:00",
  books: [
  {
    name: "vendor",
    references: [
      {
        id: "678",
        aid: "7959",
        value: "Плантэкстракт ГмбХ и Ко.КГ/Мадаус ГмбХ"
      },
      {
        id: "556",
        aid: "7960",
        value: "Рекитт Бенкизер Хелскэар/ЭсЭсЭл Мануфакт"
      }
    ]
  }
}

Справочные данные по складам.

{
  date_start: "2025-09-03T10:25:43+03:00",
  date_end: "2025-09-03T18:25:43+03:00",
  cities: [
  {
   aid: "52",
   title: "Нижний Новгород",
   stocks: [
    {
     aid: "830",
     title: ЕАптека Московское шоссе ост Березовская",
     address: "603079, г.Нижний Новгород, Московское шоссе, 179",
     address_short: "Н.Новгород,Московское ш.,179",
     phone: "78312155141",
     schedule_desc: "ПН-ПТ 8:00 – 20:00; СБ-ВС 9:00 – 20:00",
     lat: "56.296348",
     lon: "43.924713",
    },
    {
     aid: "831",
     title: "ЕАптека Терешковой",
     address: "603081, г.Нижний Новгород, ул. Терешковой, 6а",
     phone: "78312155140",
     lat: "56.296348",
     lon: "43.924713",
     schedule_desc: "ПН-ПТ 8:00 – 20:00; СБ-ВС 9:00 – 20:00",
    }
   ]
  },
 ]
}

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