Основные задачи, которые решает интеграция интернет-магазина с информационной системой ShopVoice:


Синхронизация каталога товаров

Для передачи в информационную систему ShopVoice информации о товарах используется документ в формате JSON. Ниже приведен пример, описывающий шину Bridgestone. В примере заполнены все свойства, которые можно передать в ShopVoice.

Поле Тип Обязательное Описание
id Строка Да Уникальный идентификатор товара в интернет-магазине.
vendor Строка Нет Название бренда или производителя товара. Примеры: Samsung, Apple, Lego.
model Строка Да Модель товара или общее наименование. Примеры: iPad, Рубашка, HP1201.
variant Строка Нет Модификация товара. Примеры: "Память 16Gb", "Размер: 128, цвет: синий".
description Строка Нет Подробное описание товара, можно использовать HTML-теги.
sku Строка Нет Артикул товара в интернет-магазине. Может быть неуникальным если, например, несколько модификаций одного товара имеют одинаковый артикул.
price Число Да Текущая цена товара. Значение должно быть больше 0.
oldPrice Число Нет Старая цена товара. Используется для информирования покупателя о размере скидки на товар. Если значение задано, то оно должно быть больше 0.
url Строка Нет Адрес страницы товара на сайте интернет-магазина. Используется в интерфейсе менеджера для быстрого перехода на страницу товара.
images Массив строк Нет Фотографии товара. Желательно указать не менее 2 изображений. Разрешение не проверяется, но желательно чтобы оно было не менее 500px по каждой из сторон.
propertyGroups Массив объектов Нет Структурированное описание свойств товара. См. пример.
dimensions Объект Нет Длина, ширина и высота товара в упаковке (в миллиметрах).
weight Число Нет Вес товара в упаковке (в граммах). Если задан, то значение должно быть больше 0.

Для синхронизации товаров интернет-магазин публикует на своем сайте ресурс, при запросе которого формируется документ с описанной ниже структурой. Доступ к ресурсу можно ограничить с помощью логина и пароля через Basic Authentication или по IP-адресам серверов ShopVoice (91.239.26.252, 91.239.26.102). Адрес опубликованного ресурса, а также логин и пароль нужно сообщить менеджеру ShopVoice, закрепленному за интернет-магазином.

                
{
    "version": 1,
    "products": [
        {
            "id": "100",
            "vendor": "Bridgestone",
            "model": "MY-02 Sporty Style",
            "variant": "205/55 R16 91V",
            "description": "Универсальная спортивная шина с привлекательным внешним видом и спортивным дизайном.",
            "sku": "01-100",
            "price": 3600
        },
        {
            "id": "101",
            "vendor": "Bridgestone",
            "model": "MY-02 Sporty Style",
            "variant": "205/60 R17 91V",
            "description": "Универсальная спортивная шина с привлекательным внешним видом и спортивным дизайном.",
            "sku": "01-101",
            "price": 3700
        }
    ]
}
                
            

Синхронизация заказов

Для передачи в информационную систему ShopVoice информации о заказах используется документ в формате JSON. В примере ниже заполнены все свойства, которые можно передать в ShopVoice.

Contact:

Поле Тип Обязательное Описание
firstName Строка Да Имя контактного лица.
middleName Строка Нет Отчество контактного лица.
lastName Строка Нет Фамилия контактного <лица>.
phones Массив Да

Телефоны для связи. Необходимо передать хотя бы один номер.

Поле Тип Обязательное Описание
number Строка Да Номер
comment Строка Нет Комментарий
email Строка Нет Адрес электронной почты.

Если в интернет-магазине нет отдельных полей для фамилии, имени и отчества, то ФИО можно передавать в поле firstName, которое является обязательным.

Address:

Поле Тип Обязательное Описание
postcode Строка Нет Почтовый индекс
region Строка Нет Регион
district Строка Нет Область
city Строка Нет Город
locality Строка Нет Район города
metro Строка Нет Метро
street Строка Нет Улица
house Строка Нет Дом
building Строка Нет Корпус
structure Строка Нет Строение
entrance Строка Нет Подъезд
floor Строка Нет Этаж
intercom Строка Нет Домофон
flat Строка Нет Квартира
office Строка Нет Офис
longitude Строка Нет Долгота
latitude Строка Нет Широта

Если адреса в интернет-магазине хранятся в неструктурированном виде, то адрес можно передавать одной строкой в поле street. В этом случае менеджер вручную разобьет строку на составляющие части.

Delivery:

Поле Тип Обязательное Описание
contact Contact Нет Заполняется в случае, если заказчик и получатель - это разные лица
address Address Да Адрес получателя
method Строка Нет Способ доставки (см. ниже)
date Объект Нет Интервал дат доставки. Формат даты: YYYY-MM-DD.
time Объект Нет Интервал времени доставки. Формат времени: HH:MM.
price Число Нет Стоимость доставки
traceCode Строка Нет Идентификатор отправления Почты России или другой службы доставки

Payment:

Поле Тип Обязательное Описание
method Строка Нет Способ оплаты (см. ниже)
contact Contact Нет Заполняется в случае, если заказчик и плательщик - это разные лица
address Address Нет Адрес плательщика. Заполняется если плательщиком не является заказчик. Используется при заполнении банковских квитанций.
method Строка Нет Способ доставки (см. ниже)
paidAmount Число Нет Уже оплаченная сумма.
prepayDueDate Дата Нет Крайний срок предоплаты. Формат даты: YYYY-MM-DD.

Order:

Поле Тип Обязательное Описание
id Строка Нет Уникальный идентификатор заказа. Если идентификатор не передан, то заказу будет назначен внутренний номер ShopVoice.
contact Contact Да Основное контактное лицо
delivery Delivery Нет Условия доставки
payment Payment Нет Условия оплаты
shopComment Строка Нет Комментарий магазина
customerComment Строка Нет Комментарий покупателя
items Массив Нет Заказанные товары
dateOrdered Дата Да Дата и время поступления заказа в магазин (в формате ISO)
Способы доставки

В таблице ниже указаны стандартные способы доставки, используемые в ShopVoice. Если вы не нашли подходящий, то обратитесь к вашему менеджеру.

Идентификатор Описание
russian_post:parcel Почта России, Посылка. Используйте если посылки отправляете самостоятельно, не через агрегатора.
russian_post:first_class Почта России, Бандероль 1 класса. Используйте если посылки отправляете самостоятельно, не через агрегатора.
axiomus:courier Axiomus / Курьер
axiomus:pickup Axiomus / Самовывоз
axiomus:dpd:classic_parcel Axiomus / DPD / Classic Parcel
axiomus:dpd:consumer Axiomus / DPD / Consumer
axiomus:russian_post:parcel Axiomus / Почта России / Посылка
axiomus:russian_post:first_class Axiomus / Почта России / Бандероль 1 класса
axiomus:topdelivery:courier Axiomus / TopDelivery / Курьер
axiomus:topdelivery:pickup Axiomus / TopDelivery / Самовывоз
axiomus:boxberry Axiomus / BoxBerry
Способы оплаты

В таблице ниже указаны стандартные способы оплаты, используемые в ShopVoice. Если вы не нашли подходящий, то обратитесь к вашему менеджеру.

Идентификатор Описание
cash Наличные
bank_transfer Банковский перевод
bank_card Банковская карта
yandex_money Яндекс.Деньги
qiwi_wallet Qiwi.Кошелек
Статусы заказов

Возможные статусы заказов согласовываются с каждым интернет-магазином индивидуально. Обратитесь к вашему менеджеру.

Для синхронизации заказов интернет-магазин публикует на своем сайте ресурс, при запросе которого формируется документ с описанной ниже структурой. Доступ к ресурсу можно ограничить с помощью логина и пароля через Basic Authentication или по IP-адресам серверов ShopVoice (176.58.120.55, 178.79.147.170). Адрес опубликованного ресурса, а также логин и пароль нужно сообщить менеджеру ShopVoice, закрепленному за интернет-магазином.

                
{
    "version": 1,
    "orders": [
        {
            "id": "100",
            "contact": {},
            ...
        },
        {
            "id": "100",
            "contact": {},
            ...
        },
        ...
    ]
}