...
Серверная архитектура кассовой системы диктует определенные требования к правилам загрузки информации из товаро-учетной системы: если во внешней товаро-учетной сстеме системе изменяется объект (или создается новый / удаляется ранее существовавший), то информация об этом должна быть передана кассовому серверу (API) только один раз. Далее кассовой сервер организует доставку этой информации до касс, к которым относится объект.
...
Надо иметь в виду, что загружаемый объект всегда должен содержать все его атрибуты: имеющаяся запись об атрибутах будет полностью заменена на новое значение. Если какой-то атрибут отсутствует в запросе, то, если он обязателен в соответствии со схемой (помечен значком *), то запрос не будет принят системой (возникнет сообщение об ошибке); если атрибут не обязателен, то его значение будет установлено в значение null. В том числе, это относится к атрибутам, содержащим множество значений. Например, в информации о товаре есть атрибут barcodes. При каждой выгрузке товара в атрибуте barcodes должны быть перечислены все штрихкоды для данного товара и прежний перечень будет полностью заменен на новый, в том числе и на пустой.
...
- Сервер УКМ 5 всегда выступает в роли сервера. Клиентом является товаро-учетная система.
- Авторизация не требуется. IT-службы клиента должны обеспечивать безопасность.
- Загрузка данных всегда производится партиями. Размер партии ограничен выделенным ресурсами. Рекомендуемый размер партии – 1000 записей.
- Рекомендуется загружать данные в один поток. Следующий запрос можно посылать только после получения ответа на предыдущий.
- При импорте проверяется соответствие данных схеме, а также наличие дубликатов.
- Загрузка данных объектов (товары, цены, пик-листы и т.д.) всегда происходит в инкрементальном режиме. Т.е. новые данные дополняют уже имеющиесяданные о новых объектах прибавляются к уже имеющимся. При этом, атрибуты тех объектов, которые уже присутствуют в базе сервера, полностью перезаписываются на новые.
- Для удаления данных используется поле deleted, которое присутствует во всех сущностях.
- Успешный импорт означает, что запрос сконвертирован во внутренний формат УКМ 5 и передан на дальнейшую обработку. Однако, из этого не следует, что он загружен в базу данных и передан на кассы.
...