Получение списка 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 комментарии
email 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 символов
mail 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 символов
mail 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": []
        }
    }
]