Получение списка GLN номеров, которые связаны с заданной розничной сетью¶
Для работы с этим методом пользователь должен быть авторизированным .
Метод запроса |
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 |
объект; данные аккаунта |
|
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": []
}
}
]