...
Совместимость версий API гарантируется в пределах мажорной версии. Т.е. версии 1.0, 1.1, 1.2 и т.д. совместимы, но версии 1.1 и 2.3, например, нет.
Импорт торговых данных
...
Архитектурные требования
Серверная архитектура кассовой системы диктует определенные требования к правилам загрузки информации из товаро-учетной системы: если во внешней товаро-учетной сстеме изменяется объект (или создается новый / удаляется ранее существовавший), то информация об этом должна быть передана кассовому серверу (API) только один раз. Далее кассовой сервер организует доставку этой информации до касс, к которым относится объект.
Объекты, которые выгружает торгово-учетная система, могут быть двух типов:
- объекты, общие для всех касс торговой сети;
- объекты, предназначенные для касс конкретного магазина.
Объекты, общие для всех касс:
- справочник налогов (/api/v1/import/taxes и /api/v1/import/taxGroups);
- группы товаров (товарная иерархия) (/api/v1/import/groupItems);
- товары (включая шрихкоды) (/api/v1/import/items);
- дополнительные параметры товаров (/api/v1/import/itemProperties);
- пик-листы (/api/v1/import/picklists);
- поставщики/продавцы (/api/v1/import/legalEntities);
- товары поставщиков/продавцов (/api/v1/import/legalEntityItemContractors и /api/v1/import/legalEntityItemVendors, соответственно).
Объекты, общие для касс магазина:
- цены на товары (/api/v1/import/store/{id}/itemPrices);
- дополнительные цены на товары (/api/v1/import/store/{id}/AlternativeItemPrices);
- цены на штрихкоды (/api/v1/import/store/{id}/barcodePrices);
- кассиры (/api/v1/import/store/{id}/AlternativeItemPrices);
- продавцы-консультанты (/api/v1/import/store/{id}/sellers).
Технические особенности
- Сервер УКМ 5 всегда выступает в роли сервера. Клиентом является товаро-учетная система.
- Авторизация не требуется. IT-службы клиента должны обеспечивать безопасность.
- Загрузка данных всегда производится партиями. Размер партии ограничен выделенным ресурсами. Рекомендуемый размер партии – 1000 записей.
- Рекомендуется загружать данные в один поток. Следующий запрос можно посылать только после получения ответа на предыдущий.
- При импорте проверяется соответствие данных схеме, а также наличие дубликатов.
- Загрузка данных всегда происходит в инкрементальном режиме. Т.е. новые данные дополняют уже имеющиеся.
- Для удаления данных используется поле deleted, которое присутствует во всех сущностях.
- Успешный импорт означает, что запрос сконвертирован во внутренний формат УКМ 5 и передан на дальнейшую обработку. Однако, из этого не следует, что он загружен в базу данных и передан на кассы.
...
Якорь | ||||
---|---|---|---|---|
|
Особенности
Экспорт продаж может происходить двумя способами:
...