Протокол обміну даними


		Протокол обміну даними

Протокол обміну даними

Обмін даними між сервером Каталогу та клієнтами проходить в форматі XML.
В якості транспортного протоколу використовується HTTP.
Для запитів використовується метод POST.
Content type=text/xml
Схема ідентифікації Basic
URL = http://catalog.ean.ua/interface/call

Запити

Використовуються два запити:
1. GetLC-отримання повної інформації по одному номеру обмеженої циркуляції товарів змінної кількості.

Назва параметра	Опис
number	Номер обмеженої циркуляції товарів змінної кількості. Тільки цифри. Тільки постійна частина номеру.

2. GetList-отримання списку номерів.

Назва параметра	Опис
gln	GLN виробника товару. Обов'язковий параметр.
name	Назва або частина назви товару (не менше 2-х символів). Обов’язковий параметр.
from	Порядковий номер Номеру обмеженої циркуляції товарів змінної кількості, з котрого починати формувати результат ( default 1 ).
maxRows	Максимальна кількість Номерів обмеженої циркуляції товарів змінної кількості котрі пересилаються в списку ( default 20 ). Значення -1 без обмежень.

Схеми запитів приведені в файлі.

Відповіді

Якщо запит успішно виконано, то сервер Каталогу поверне XML документ з результатами.
Схеми результатів запитів приведені: повна інформація по одному номеру обмеженої циркуляції товарів змінної кількості, та список номерів обмеженої циркуляції товарів змінної кількості

Якщо виникла помилка , то Сервер дасть відповідь - XML документ в тілі котрого буде тег помилки з описом: <ERROR>Текст повідомлення про помилку</ERROR>

Список повідомлень про помилку:

Wrong content type <ContentType> (Помилка типу запиту)
No data Found (Дані не знайдені)
Wrong request name. <name> (Помилка назви запиту)
Wrong parameter <name> (Неправильний параметр name)
You must set number parameter (Ви повинні присвоїти параметру number номер)
You must set gln or name parameter (Ви повинні присвоїти значення параметрам gln та name)
org.xml.sax.SAXParserException: <description> (Некоректно оформлений запит, як XML документ)


		GS1 в Україні

Всі права належать Асоціації "ДжіЕс1 Україна"

Розробка компанії Information Technology Services