Получение списка GLN номеров, которые связаны с заданной розничной сетью¶
Для работы с этим методом пользователь должен быть `авторизированным <https://wiki.edi-n.com/ru/latest/integration_2_0/API/Authorization.html`__ .
Метод запроса | HTTP GET |
---|---|
Content-Type | application/json (тело запроса/ответа в json формате в теле HTTP запроса |
URL запроса | https://edo-v2.edi-n.com/api/oas/retailer/identificators?retailer_id=11 |
Параметры, передаваемые в URL (вместе с адресом метода) | В строке заголовка (Header) «Set-Cookie» обязательно передается SID - токен полученный при авторизации Обязательные url-параметры: retailer_id - число; идентификатор розничной сети (из предыдущих методов) |
Подсказка
Также возможно выполнить запрос в виде curl-строки:
curl -X GET „/api/oas/retailer/identificators?retailer_id=11“ -b „SID=458a0d38-5b56-4b8e-8998-009a1edd31eb“
Спецификация для расшифровки ключей curl запроса: https://curl.haxx.se/docs/manpage.html
JSON-параметры в теле HTTP запроса/ответа
REQUEST
В этом методе json-тело запроса отсутствует (другие данные передавать не нужно).
RESPONSE
Ответ: массив объектов данных о контрагентах
Таблица 1 - Описание json-параметров, которые могут передаваться в ответ на метод API
Параметр | Формат | Описание |
---|---|---|
Объект Identificator | ||
guid | String | GUID организации |
taxNum | String | Налоговый идентификационный номер; строка 50 символов |
ndsNum | String | № свидетельства НДС; строка 50 символов |
manager | String | ФИО менеджера; строка 100 символов |
accountant | String | ФИО бухгалтера; строка 100 символов |
id | long | ID пользователя |
gln | String | GLN организации, которая связана с авторизированным пользователем? ; строка 13 символов |
companyId | long | id аккаунта; число |
retailerId | long | id сети (ритейлера); число |
name | String | название организации; строка 100 символов |
companyType | String | форма собственности; строка 5 символов; jur - Юридическое лицо, fiz - Физическое лицо |
companyInn | String | код ИНН компании; строка 50 символов |
companyKpp | String | код ЕГРПОУ/КПП; строка 50 символов |
companyOgrn | String | Основной Государственный Регистрационный Номер; строка 15 символов |
companyTaxDepartmentID | String | идентификатор отделения налоговой инспекции |
dirLastName | String | фамилия директора; строка 150 символов |
dirFirstName | String | имя директора; строка 150 символов |
apartment | String | квартира; строка 20 символов |
zip | String | почтовый индекс; строка 20 символов |
city | String | город; строка 50 символов |
street | String | название улицы; строка 100 символов |
regionCode | String | код региона; строка 3 символа |
bankName | String | название банка; строка 100 символов |
bankMfo | String | МФО банка, код-реквизит банка |
phone | String | № телефона; строка 50 символов |
bankAccount | String | расчетный счет банка; строка 50 символов |
otherInfo | String | комментарии |
String | E-mail; строка 255 символов | |
metroCode | String | код точки доставки; строка 20 символов |
Таблица 2 - Описание параметров объекта Account)
Параметр | Формат | Описание |
---|---|---|
Объект Account | ||
platform | enum | признак принадлежности к платформе EVO / FELEX |
id | int | id аккаунта; число 11 символов |
name | String | полное наименование организации или ФИО индивидуального предпринимателя |
ownership | String | форма собственности; строка 5 символов; jur - Юридическое лицо, fiz - Физическое лицо |
inn | String | код ИНН; строка 50 символов |
kpp | String | код ЕГРПОУ/КПП; строка 50 символов |
String | почта | |
phone | String | № телефона; строка 50 символов |
ndsNumber | String | № свидетельства НДС; строка 50 символов |
bankAccount | String | расчетный счет банка; строка 50 символов |
bankName | String | название банка; строка 100 символов |
bankMfo | String | МФО банка, код-реквизит банка |
bankAddress | String | адрес банка; строка 150 символов |
identificators | List<Identificator> | массив объектов; |
companies | List<Company> | массив объектов; |
users | List<User> | массив объектов; |
Таблица 3 - Описание параметров объекта Company)
Объект Company | ||
---|---|---|
id | long | id компании; число |
account | Account | объект; данные аккаунта |
name | String | полное наименование организации или ФИО индивидуального предпринимателя |
ownership | String | форма собственности; строка 5 символов; jur - Юридическое лицо, fiz - Физическое лицо |
edrpou | String | код ЕГРПОУ/КПП; строка 50 символов |
inn | String | код ИНН; строка 50 символов |
String | почта | |
phone | String | № телефона; строка 50 символов |
ndsNumber | String | № свидетельства НДС; строка 50 символов |
bankAccount | String | расчетный счет банка; строка 50 символов |
bankName | String | название банка; строка 100 символов |
bankMfo | String | МФО банка, код-реквизит банка |
bankAddress | String | адрес банка; строка 150 символов |
users | List<User> | массив объектов; |
Таблица 4 - Описание параметров объекта User)
Параметр | Формат | Описание |
---|---|---|
Объект User | ||
id | long | id пользователя; число |
accountId | long | id аккаунта |
login | String | логин пользователя; строка 50 символов |
stringEmails | String | E-mail; строка 255 символов |
emails | List<String> | массив адресов E-mail |
blocked | int | отметка о блокировке; число; 0 - нет, 1 - да |
allowFTP | int | отметка доступа к FTP; число; 0 - нет, 1 - да |
autoSending | boolean | автоотправка; число; 0 - Нет, 1 - Да (документы автоматически отправляются при переносе документа для отправки в папку outbox) |
statusFile | int | создание статус-файлов; число; 0 - Нет, 1 - Да, 2 - Да, о доставке, 3 - Да, о прочтении |
isAdmin | boolean | отметка, является ли пользователь админом в управление пользователями; число; 0 - нет, 1 - да |
Примеры
Запрос не содержит тела (json)
Пример тела ответа (json):
[
{
"guid": {},
"id": 82208,
"gln": "5790000017089",
"companyId": 19,
"retailerId": 16404,
"name": "ECCO - EDITEL",
"companyInn": "№",
"companyKpp": "№",
"city": "№",
"street": "№",
"account": {
"platform": "EVO",
"id": 19,
"name": "eXite-Ukraine",
"ownership": "ФОП",
"inn": "-",
"kpp": "#",
"mail": "DikhtyarZ@exite-edi.com",
"phone": "1111111111",
"ndsNumber": "#",
"bankAccount": "#",
"bankName": "#",
"bankMfo": "#",
"bankAddress": "#",
"identificators": [],
"companies": [],
"users": []
}
},
{
"guid": {},
"manager": "#",
"id": 126701,
"gln": "5790000833054",
"companyId": 19,
"retailerId": 16404,
"name": "ECCO - EDITEL SUPPLIER",
"companyInn": "#",
"companyKpp": "#",
"zip": "#",
"city": "#",
"street": "#",
"phone": "#",
"account": {
"platform": "EVO",
"id": 19,
"name": "eXite-Ukraine",
"ownership": "ФОП",
"inn": "-",
"kpp": "#",
"mail": "DikhtyarZ@exite-edi.com",
"phone": "1111111111",
"ndsNumber": "#",
"bankAccount": "#",
"bankName": "#",
"bankMfo": "#",
"bankAddress": "#",
"identificators": [],
"companies": [],
"users": []
}
}
]