Различия

Здесь показаны различия между двумя версиями данной страницы.

--- doc:dev:api:supplier [26.05.2017 15:03]
dchuprunov
+++ doc:dev:api:supplier [02.06.2018 10:42] (текущий)
@@ Строка 6: / Строка 6: @@
 ===== Пример запроса на получение данных =====
-Пример запроса на получение данных об остатках товаров:
+Пример запроса на получение данных о поставщиках:
  http://mycompany.virtpos.ru/api/supplier?apikey=MySecret&format=xml
 ==== Параметры запроса ====
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.
-  * **format** - формат, в котором сервер отдаст данные. Может принимать значения "xml" или "json". Необязательный параметр.
+  * **format** (get only) - формат, в котором сервер отдаст данные. Может принимать значения "xml" или "json". Необязательный параметр.
   * **id** - идентификатор поставщика, для которого надо вернуть данные. Если не указан, то возвращаются данные обо всех поставщиках.
@@ Строка 126: / Строка 126: @@
 </file>
+==== Структура ответа сервера ====
+  * **id** – ID поставщика - //int NOT NULL, первичный ключ//
+  * **name** - Название - //varchar(255) NOT NULL, обязательно//
+  * **legal_name** - Юридическое название - //varchar(255) DEFAULT NULL//
+  * **inn** - ИНН - //varchar(255) DEFAULT NULL//
+  * **kpp** - КПП - //varchar(255) DEFAULT NULL//
+  * **address** - Адрес - //varchar(255) DEFAULT NULL//
+  * **phone** - Телефон - //varchar(255) DEFAULT NULL//
+  * **email** - Адрес электронной почты - //varchar(255) DEFAULT NULL, валидный e-mail адрес//
+  * **www** - WWW - //varchar(255) DEFAULT NULL, валидный URL//
+  * **type_id** - Тип контрагента (1 - Внешний поставщик, 2 - Внутренний поставщик, 3 - Банк) - //int NOT NULL DEFAULT '1'//
+  * **type_name** - наименование типа контрагента - //varchar(255) DEFAULT NULL//
+  * **code** - Код контрагента - //varchar(255) DEFAULT NULL//
+  * **OKPO** - ОКПО - //varchar(30) DEFAULT NULL//
+  * **OKONH** - ОКОНХ - //varchar(255) DEFAULT NULL//
+  * **bank_name** - Наименование банка, обслуживающего организацию - //varchar(255) DEFAULT NULL//
+  * **corraccount** - Номер счета банка, обслуживающего организацию - //varchar(255) DEFAULT NULL//
+  * **bankaccount** - Номер счета организации в банке, обслуживающем организацию - //varchar(255) DEFAULT NULL//
+  * **BIK** - БИК - //char(9) DEFAULT NULL, 9 символов ровно//
+  * **status** - Статус - //varchar(255) DEFAULT NULL//
+  * **delivaddress** - Факт. адрес - //varchar(255) DEFAULT NULL//
+  * **external_id** - Идентификатор во внешней системе - //varchar(255) DEFAULT NULL//
+  * **created_date** - Дата создания - //datetime DEFAULT NULL//
+  * **created_by** - Кем создано - //int DEFAULT NULL//
+  * **last_update_date** - Дата изменения - //datetime DEFAULT NULL//
+  * **last_update_by** - Кем изменено - //int DEFAULT NULL//
 ===== Пример запроса на добавление/изменение данных =====
@@ Строка 134: / Строка 189: @@
 ==== Параметры запроса ====
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.
-  * **format** - формат, в котором сервер отдаст данные. Может принимать значения "xml" или "json". Необязательный параметр.
+  * **format** (get only) - формат, в котором сервер отдаст данные. Может принимать значения "xml" или "json". Необязательный параметр.
-  * **id** - идентификатор поставщика, данные которого надо обновить
+  * **id** (get only) - идентификатор поставщика, данные которого надо обновить
-  * **external_id** - код поставщика во внешней системе учета (например, в 1С), данные которого надо обновить
+  * **external_id** (get only) - код поставщика во внешней системе учета (например, в 1С)
-  * **create_if_not_exist** - Если истина, то при неудачном поиске поставщик будет добавлен в систему.
+  * **create_if_not_exist** (get only) - Если истина, то при неудачном поиске поставщик будет добавлен в систему.
   * Также в качестве параметров могут быть переданы все поля для поставщика (name, address, phone и т.д.)