Дані про сертифікат

JSON:

{
    "certificate":
    {
        "id": 167,
        "uuid": "55ef04b2-281e-4fca-bb67-d48fe88ae74f",
        "number": "Номер сертифіката1",
        "createDate": 1705494187,
        "updateDate": 1705499386,
        "issueDate": 1704060000,
        "type":
        {
            "id": 10,
            "name": "протокол лабораторних досліджень",
            "type": 0
        },
        "view":
        {
            "id": 1,
            "description": "Період дії"
        },
        "access":
        [
            13203393
        ],
        "startDate": 1705442400,
        "endDate": 1705528800,
        "isSigned": false,
        "accessType":
        {
            "code": 2,
            "description": "Закритий (приватний)"
        },
        "creator": 13205923,
        "info": "Коментар",
        "level":
        {
            "code": "A",
            "description": "Непідписаний сертифікат з прив'язкою до товарів"
        },
        "bodies":
        {
            "1":
            []
        },
        "characteristics":
        {
            "Issuer Article": "Артикул виробника",
            "VMD Number": "Номер ВМД",
            "Batch Number": "Номер партії!"
        },
        "parents":
        [],
        "products":
        [
            {
                "id": 203,
                "certificateId": 167,
                "name": "Шоколадка",
                "barcode": "1212121212",
                "article": "Артикул продавця ",
                "buyerCode": "Артикул покупця",
                "uktved": 123456,
                "dkpp": "Код ДКПП"
            }
        ],
        "productsQty": 0,
        "autoArchive": true
    },
    "glns":
    {
        "13203393":
        {
            "id": 13203393,
            "gln": "9864232607052",
            "companyId": 37663,
            "retailerId": 0,
            "isUzdAts": 0,
            "isFinCrypt": 0,
            "countryId": 2,
            "isERNN": 3,
            "name": "TW_Вантажовідправник",
            "companyType": "fiz",
            "companyInn": "111111111111",
            "companyKpp": "11111111",
            "zip": "121212",
            "katottg": "UA05020030010063857",
            "city": "м. Вінниця, Вінницький р-н",
            "street": "Тестова 2",
            "IBAN": "UA111111111111111111111111111",
            "district": "Вінницька",
            "dpiCReg": 0,
            "dpiCRaj": 0,
            "isListex": false,
            "isDeclarDateNumRequired": true,
            "distribexUser": 0,
            "isWithoutTax": true,
            "taxSource": 0,
            "isDriver": false,
            "isSignConfirm": 0,
            "isSpecification": 0,
            "isCompany": 1,
            "isTemporary": 0,
            "parentId": 0,
            "constructorGroupID": 0
        }
    }
}

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

Параметр	Формат	Опис
certificate	XCertificate	об’єкт; дані сертифіката
glns	Map<gln_id, Identificator>	об’єкт; дані власника публічного сертифіката / дані користувачів з правами перегляду

Таблиця 2 - Опис параметрів об’єкта XCertificate

Параметр	Тип 1	Формат	Опис
		Об’єкт XCertificate
id		long	ідентифікатор сертифіката
uuid	-/M	UUID	унікальний ідентифікатор сертифіката (передається при редагуванні сертифіката)
number	M	String	номер сертифіката
createDate		long	дата створення (Unix timestamp)
updateDate		long	дата оновлення (Unix timestamp)
issueDate	M	long	дата видачі (Unix timestamp)
type	M	XCertificateType	об’єкт; тип сертифіката
view	M	XCertificateView	об’єкт; вид сертифіката
access		List<Long>	масив; доступність
startDate	M	long	дата початку дії сертифіката (Unix timestamp)
endDate	O/M	long	дата завершення дії сертифіката (Unix timestamp); параметр обов’язковий при view.id=1
isSigned		boolean	true - підписаний, false - не підписаний
accessType		AccessType	об’єкт; тип доступу до сертифіката
creator		long	ідентифікатор власника/автора сертифіката
info	O	String	коментар (додаткова інформація)
level		Level	об’єкт; рівень сертифіката
bodies		Map<Integer, byte[]>	вкладення
characteristics	O/M	Map<String, String>	характеристики characteristics (обов’язково передається при view.id=2)
parents		List<XCertificate>	масив об’єктів; материнські сертифікати
products		List<XCertificateProduct>	масив об’єктів; товари
productsQty		int	кількість товарів зв’язаних із сертифікатом
autoArchive		boolean	true - автоматично архівувати, false - не архівувати автоматично

Таблиця 3 - Опис параметрів об’єкта XCertificateType

Параметр	Тип 1	Формат	Опис
		Об’єкт XCertificateType
id	M	int	ідентифікатор типу 1 - Cертифікат відповідності/ визнання 2 - Посвідчення/ сертифікат якості 3 - Декларація імпортера 4 - Висновок СЄС 5 - Декларація виробника 6 - Карантинний сертифікат 7 - Акт фітосанітарного контролю 8 - Фітосанітарний сертифікат 9 - Висновок фітосанітарної експертизи 10 - Протокол лабораторних досліджень 11 - Експертний висновок 12 - Сертифікат типу 13 - Сертифікат аналізу 14 - Дозвіл на випуск/ реалізацію 15 - Висновок Держлікслужб 16 - Сертифікат на СУЯ (ISO9001) 17 - Паспорт якості
name		String	назва типу
code		String	код типу
type		int	тип

Таблиця 4 - Опис параметрів об’єкта XCertificateView

Параметр	Тип 1	Формат	Опис
		Об’єкт XCertificateView
id	M	int	ідентифікатор виду 1 - Період дії 2 - Номер партії
description		String	опис виду

Таблиця 5 - Опис characteristics

Назва	Тип 1	Формат	Опис
		Характеристики
Batch Number	O/M	String	Номер партії (обов’язково передається при view.id=2)
Issuer Article	O	String	Артикул виробника
VMD Number	O	String	Номер ВМД

Таблиця 6 - Опис параметрів об’єкта Identificator

Параметр	Формат	Опис
	Об’єкт Identificator
guid	String	GUID організації
taxNum	String(50)	Податковий ідентифікаційний номер
ndsNum	String(50)	№ свідоцтва ПДВ
manager	String(100)	ПІБ менеджера
accountant	String(100)	ПІБ бухгалтера
id	long	GLN ID
gln	String(13)	GLN організації
companyId	long	id аккаунта
retailerId	long	id мережі (ритейлера)
isUzdAts	int	ЮЗД від АТС; 0-ні, 1-так
isFinCrypt	int	шифрування FINDOC; 0-ні, 1-так
countryId	int	ідентифікатор країни
isERNN	int	схема обробки DECLAR; 0 - відправка отримувачу тільки після успішної регістрації в реєстрі, 1 - регістрація після перевірки отримувачем, 3 - відправка отримувачу без регістрації
name	String(100)	назва організації
nameEn	String	назва організації латинницею
companyType	String(5)	форма власності: jur - Юридична особа, fiz - Фізична особа
companyInn	String(50)	код ІПН компанії
companyKpp	String(50)	код ЄДРПОУ/КПП
companyOgrn	String(15)	Основний Державний Реєстраційний Номер
companyTaxDepartmentID	String	ідентифікатор відділення податкової інспекції
dirLastName	String(150)	прізвище директора
dirFirstName	String(150)	ім’я директора
director	String(100)	ПІБ директора
apartment	String(20)	квартира
zip	String(20)	поштовий індекс
katottg	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(255)	E-mail
metroCode	String(20)	код точки доставки
IBAN	String	IBAN (англ. International Bank Account Number)
district	String	назва району
dpiCReg	String	регіон/область податкової
dpiCRaj	String	район (по регіону) прив’язки до податкової
account	Account_	id акаунту
isListex	boolean	підключений довідник Listex
isDeclarDateNumRequired	boolean	обов’язковість № і дати ПН в ТН (МЕТРО)
distribexUser	int	користувач сервісу; 1-Виробник; 2-Дистриб’ютор
isWithoutTax	boolean	неплатник ПДВ
additionalInfo	IdentificatorAdditionalInfo_	додаткова інформація
taxSource	int	Код ознаки джерела податкового номера 0 - відсутній 1 - Єдиний державний реєстр підприємств та організацій України (ЄДРПОУ); 2 - Державний реєстр фізичних осіб – платників податків (ДРФО); 3 - реєстраційний (обліковий) номер (для платників податків, які не включені до ЄДРПОУ); 4 - серія та номер паспорта (для фізичних осіб, які через релігійні переконання відмовляються від прийняття реєстраційного номера)
driverLicense	String	номер водійського посвідчення
isDriver	boolean	має роль Водій (робота з ТТН та коригуючими Актами)
isSignConfirm	int	gln підтверджений КЕП (0-ні; 1-так)
isSpecification	int	доступ до сервісу Е-Специфікація (0-ні; 1-так)
isCompany	int	атрибут; Основний GLN компанії (0-ні; 1-так)
parentId	long	значення Основного GLN компанії
parentIdentificator	Identificator	дані Основного GLN (за наявності)

Таблиця 7 - Опис параметрів об’єкта AccessType

Код	Опис
	Об’єкт AccessType
0	Неопубликований (DRAFT)
1	Відкритий для всіх (PUBLIC)
2	Закритий (приватний) (PRIVATE)
3	Доступний за посиланням (URL_ACCESS)»

Таблиця 8 - Опис параметрів об’єкта Level

Рівень	Опис
	Об’єкт Level
A+	Підписаний сертифікат з прив’язкою до товарів
A	Непідписаний сертифікат з прив’язкою до товарів
B+	Підписаний сертифікат без товарів
B	Непідписаний сертифікат без товарів
C	Без файлу сертификата

Таблиця 9 - Опис параметрів об’єкта XCertificateProduct

Параметр	Тип 1	Формат	Опис
		Об’єкт XCertificateProduct
id	O	long	ідентифікатор товару
certificateId		long	ідентифікатор сертифіката
name	M	String	назва товару
barcode	M	String	штрихкод товару
article	M	String	артикул продавця
buyerCode	O	String	код покупця
uktved	O	long	код УКТЗЕД товару
dkpp	O	String	код ДКПП товару
partNumber		String	номер партії

---

1

Під визначенням колонки Тип поля мається на увазі скорочене позначення:

• M (mandatory) — обов’язкові до заповнення поля;

• O (optional) — необов’язкові (опціональні) до заповнення поля.