Статьи по: API

Обзор возможностей API

Внимание! Для использования данного вида интеграции необходимо обратиться к своему менеджеру либо в техническую поддержку support@greenwhite.uz для настройки доступа.

Данная документация является официальной документацией по API для Smartup.

Программные интерфейсы Smartup используются для построения интеграционных решений со сторонними ПО.
В документации подробно рассказывается о модели данных, принятой в Smartup для обмена информацией со сторонними ПО, а также о принципах работы API.

Smartup оперирует такими понятиями как:


document_id – это образное обозначение таких объектов/записей как movement_id, stocktaking_id, writeoff_id, return_id, input_id, deal_id.
external_id – это идентификатор объектов/записей, присвоенный сторонним ПО.

В процессе импорта данных в систему возможны следующие сценарии:

Значения document_id и external_id указаны в запросе. В данной ситуации система отдает приоритет внутреннему идентификатору, то есть document_id. В случае успешной верификации внутреннего идентификатора, в качестве дополнительного этапа система также верифицирует идентификатор, присвоенный сторонним ПО, то есть external_id. При несовпадении какого-либо из двух идентификаторов система выдаст сообщение об ошибке.

Значение document_id указано, а external_id не указано в запросе. В данной ситуации сверка происходит по внутреннему идентификатору. При обнаружении документа с заданным значением идентификатора система обновит запись, а при необнаружении — система вернет сообщение об ошибке.

Значение document_id не указано, а external_id указано в запросе. При обнаружении документа с заданным значением идентификатора система обновит запись, а при необнаружении — создаст новую запись.

Помимо вышеописанного, проверку на уникальность можно настроить вручную в самой системе в разделе Settings. При этом возможны три ситуации:

сообщение об ошибке при обнаружении дублирующих данных;
сообщение обновить/переименовать данные;
сообщение пропустить дублирующие данные.

Система проверяет объект/запись на предмет дублирования по значениям document_number и document_date.

Точка подключения: https://smartup.online

Предупреждение!!! Все запросы необходимо выполнять в кодировке UTF-8. Количество запросов не ограничено.


Для того, чтобы ознакомиться со всеми возможностями интеграции с системой Smartup , перейдите по ссылке Документация по интеграции

Обновлено на: 02/08/2023

Была ли эта статья полезна?

Поделитесь своим отзывом

Отменить

Спасибо!