Масово завантажити сертифікати

Для роботи з цим методом користувач повинен бути авторизованим.

Примітка

Максимальний розмір файлу для завантаження - 7,5 МБ

URL
Метод запиту	POST
URL запиту	/api/ecs/certificates?gln=9864232613879
URL параметри	gln (обов’язково) String - GLN власної Компанії
Headers
Authorization	SID - токен, отриманий при авторизації
Content-Type	multipart/form-data
REQUEST
JSON Body	В тілі запиту передається zip-файл, що містить файли-вкладення (в форматі PDF, JPG, JPEG, PNG, TIFF) та заповнений xls/xlsx шаблон з зазначеними назвами файлів-вкладень.

Приклад передаваємого zip

RESPONSE

В тілі відповіді передаються дані завантажених сертифікатів (масив об’єктів XCertificate).

Примітка

Якщо в сертифікатах, що передаються буде допущена помилка, то Ви отримаєте відповідь про помилку в файлі, наприклад:

{
    "certificatesErrors":
    {
        "2":
        [
            {
                "errorType": 1,
                "columnName": "Тип сертификату"
            },
            {
                "errorType": 2,
                "columnName": "Тип сертификату"
            },
            {
                "errorType": 1,
                "columnName": "Номер сертифікату"
            },
            {
                "errorType": 1,
                "columnName": "Дата видачі"
            },
            {
                "errorType": 1,
                "columnName": "Вид сертифікату"
            },
            {
                "errorType": 2,
                "columnName": "Вид сертифікату"
            },
            {
                "errorType": 1,
                "columnName": "Дата закінчення дії",
                "cause": "Вид сертифікату = 1"
            },
            {
                "errorType": 1,
                "columnName": "Номер партії",
                "cause": "Вид сертифікату = 2"
            },
            {
                "errorType": 1,
                "columnName": "Дата початку дії"
            },
            {
                "errorType": 1,
                "columnName": "Назва файлу"
            },
            {
                "errorType": 2,
                "columnName": "Назва файлу",
                "allowedValues": "[pdf, jpg, jpeg, png, tiff]",
                "fileName": "filename.txt"
            },
            {
                "errorType": 3,
                "columnName": "Назва файлу",
                "fileName": "filename.pdf"
            },
            {
                "errorType": 4,
                "columnName": "Назва файлу",
                "fileName": "filename.pdf"
            }
        ]
    },
    "productsErrors":
    {
        "2":
        [
            {
                "errorType": 1,
                "columnName": "Номер сертифікату"
            }
        ]
    },
    "createdCertificates":
    [],
    "existedCertificates":
    [],
    "certsCount": 0,
    "productsCount": 0
}

Таблиця 1 - Опис параметрів помилки

Поле	Опис
certificatesErrors/productsErrors	об’єкт; починається з номера рядка сертифіката / рядка тварної позиції (відповідно), де була допущена помилка. Містить параметри: errorType - тип помилки: 1 - Незаповнене обов’язкове поле, для цього значення помилка може містити поле cause (причина чому воно має бути обов’язкове, як у випадку з Дата закінчення дії або Номер партії; 2 - Некоректне значення поля, для цього поля також є поле allowedValues, це для помилки з Ім’ям файлу; для цього значення помилка може містити поле fileName; 3 - Файл з іменем файла вказаним в колонці Імя файлу не знайдено в zip-архіві; для цього значення помилка може містити поле fileName; 4 - Файл з іменем файла вказаним в колонці Імя файлу занадто великий; для цього значення помилка може містити поле fileName. columnName - назва колонки;
createdCertificates	масив; номера створених сертифікатів
existedCertificates	масив; номера існуючих сертифікатів
certsCount - кількість сертифікатів (рядків на 1-му листі xls/xlsx-файлу)
productsCount - кількість товарних позицій (рядків на 2-му листі xls/xlsx-файлу)