Отримання інформації по внутрішньому документу¶
Для роботи з цим методом користувач повинен бути авторизованим .
Метод запиту |
HTTP GET |
---|---|
Content-Type |
application/json (тіло запиту/відповіді в json форматі в тілі HTTP запиту) |
URL запиту |
https://doc.edi-n.com/bdoc/store/internal-document/info |
Параметри, що передаються в URL (разом з адресою методу) |
В рядку заголовка (Header) «Set-Cookie» обов’язково передається SID - токен, отриманий при авторизації Обов’язкові url-параметри: document_id - ID документу |
JSON-параметри в тілі HTTP запиту/відповіді¶
REQUEST
В цьому методі json-тіло запиту відсутнє (інші дані передавати не потрібно).
RESPONSE
Опис json-параметрів відповіді методу API (об’єкт DocumentStore).
Таблиця 1 - Опис параметрів об’єкта DocumentStore
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт DocumentStore |
||
documentId |
long |
id документа |
packageId |
long |
id комплекта |
senderCompanyId |
long |
id організації відправника |
senderCompany |
об’єкт; дані компанії відправника |
|
documentType |
об’єкт; опис типу документу |
|
documentTypeId |
Long |
id типу документу |
number |
String |
номер документу |
date |
long |
дата документу |
dateSent |
long |
дата відправки |
clientSignsCount |
int |
кількість підписів клієнта |
ownerSignsCount |
int |
кількість підписів власника |
status |
int |
статус документа; 2 - відправлений; 3 - прийнятий; 4 - відхилений |
comment |
String |
коментар |
versionStructure |
long |
версія структури структурованого документу |
extraFields |
List<ExtraField> |
масив об’єктів; прив’язка додаткових полів до документа |
bodies |
List<DocumentBody> |
масив об’єктів; тіла документів |
structure |
List<DocStructValue> |
масив об’єктів; опис структури зі значеннями |
agreementLogs |
List<AgreementLogs> |
масив об’єктів; історія / логи узгоджень |
isReadFromApi |
int |
ознака прочитання по API |
documentUuid |
UUID |
унікальний ідентифікатор документа |
agreementProcId |
long |
ID процесу узгодження |
agreementStatus |
int |
статус узгодження |
dictionaryValue |
об’єкт; значення довідника |
Таблиця 2 - Опис параметрів об’єкта Company
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт Company |
||
companyId |
long |
ID компанії |
accountId |
long |
ID аккаунта |
type |
int |
тип компанії (1 - юр. особа; 2 - фіз. особа) |
name |
String |
назва компанії |
legalName |
String |
юридична назва |
inn |
String |
ідентифікаційний номер платника податків |
code |
String |
свідоцтво платника ПДВ |
phone |
String |
телефон |
info |
String |
додаткова інформація |
isApproved |
int |
ознака створення компанії з ЕЦП; можливі значення: 0 - створена звичайним способом; 1 - створена з ЕЦП |
isSignedOffer |
int |
ознака підписана чи оферта; значення за замовчуванням = 0; коментар: 0 - Ні; 1 - Так |
isActive |
int |
статус компанії: активна / деактивовано; значення за замовчуванням = 1; коментар: 0 - Ні; 1 - Так |
ownershipType |
String |
форма власності |
atCode |
String |
код КОАТУУ (Класифікатор об’єктів адміністративно-територіального устрою України) |
certNum |
String |
свідоцтво платника ПДВ |
uuID |
String |
унікальний ідентифікатор компанії |
bankAcc |
об’єкт; банківські реквізити |
|
legalAddress |
об’єкт; юридична адреса |
|
actualAddress |
об’єкт; фактична адреса |
|
fizName |
об’єкт; ПІБ фіз. особи компанії |
|
certificates |
List<Certificate_> |
масив об’єктів; сертифікати |
dictionaries |
List<Dictionary_> |
масив об’єктів; довідники |
notifySettings |
List<EmailNotifySettings_> |
масив об’єктів; налаштування відправки повідомлень на пошту |
Таблиця 3 - Опис параметрів об’єкта Document
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт Document |
||
documentId |
long |
id документа |
companyId |
long |
id компанії |
company |
об’єкт; інформація про компанію |
|
name |
String |
назва документа |
type |
int |
тип; «1 - Файл; 2 - Структура; 3 - Динамічна структура; 4 - Таблиця» |
code |
String |
код документа |
agreementProcId |
long |
id процесу узгодження |
isActive |
int |
статус; «1 - Активний; 0 - Заблокований» |
extraFields |
List<ExtraField> |
масив об’єктів; додаткові поля документа |
dictionary |
об’єкт; дані довідника |
|
structures |
List<DocumentStructure_> |
масив об’єктів; дані структурованого документа |
Таблиця 4 - Опис параметрів об’єкта DocumentBody
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт DocumentBody |
||
bodyId |
long |
id тіла документа |
documentId |
long |
id документа |
fileName |
String |
найменування файлу |
body |
byte[] |
тіло документа |
signBodies |
List<SignBody_> |
масив об’єктів; тіла підписів на документі |
Таблиця 5 - Опис параметрів об’єкта ExtraField
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт ExtraField |
||
fieldId |
long |
id поля |
companyId |
long |
id компанії |
name |
String |
назва поля |
description |
String |
опис поля |
dataType |
int |
формат поля; 1 - текст; 2 - число; 3 - дата; 4 - цифра |
status |
int |
статус; 1 - Активно, 0 - Неактивно (Заблокировано) |
value |
String |
значення поля |
Таблиця 6 - Опис параметрів об’єкта DocStructValue
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт DocStructValue |
||
id |
String |
ID тега відповідно до опису структури |
value |
String |
значення тега |
index |
int |
номер рядка для масивів, починається з «0» |
structure |
List<List<DocStructValue>> |
масив масивів об’єктів; опис структури зі значеннями |
errors |
List<String> |
масив об’єктів; помилки |
Таблиця 7 - Опис параметрів об’єкта AgreementLogs
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт AgreementLogs |
||
agreementLogId |
long |
ID логу узгодження |
taskId |
long |
ID завдання |
actionType |
int |
тип дії |
dateCreated |
long |
дата створення завдання |
comment |
String |
комментарий |
user |
об’єкт; дані користувача |
Таблиця 8 - Опис параметрів об’єкта DictionaryValue
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт DictionaryValue |
||
valueId |
long |
id значення довідника |
dictionaryId |
long |
id довідника |
name |
String |
назва значення довідника |
code |
String |
код значення довідника |
parentCode |
String |
код «батьківського» значення довідника |
isActive |
int |
статус значення довідника; 1 - активний, 0 - заблокований |
Приклади¶
При використанні методу json-тіло запиту відсутнє (дані передавати не потрібно)
Приклад тіла відповіді в json форматі
{
"agreementLogs": [
{
"actionType": 4,
"agreementLogId": 1279,
"comment": "авы",
"dateCreated": 1562230627,
"taskId": 5035,
"user": {
"accountId": 0,
"companies": [],
"email": "sashabelovv@meta.ua",
"fio": "Ляшенко евгений",
"isOwner": 0,
"lastLoginDate": 0,
"passPolicyId": 0,
"passSecureType": 0,
"roles": [],
"routes": [],
"status": 0,
"tel": "34324322",
"uiTypes": [],
"userAccess": {},
"userId": 0
}
}
],
"agreementProcId": 0,
"agreementStatus": 0,
"bodies": [
{
"bodyId": 6257,
"documentId": 6383,
"fileName": "1562240257_1562240257_6383.xml",
"signBodies": [
{
"bodyId": 6257,
"companyId": 4,
"info": {
"certSerial": "33B6CB7BF721B9CE040000000CAB250045995A00",
"isTimeStamp": true,
"issuerCN": "Акредитований центр сертифікації ключів ІДД ДФС",
"subjCN": "Мирний Олександр Максимович (Тест)",
"subjCode": "1010101017",
"subjFullName": "Мирний Олександр Максимович (Тест)",
"subjInn": "1010101017",
"subjOrg": "Мирний Олександр Максимович (Тест)",
"subject": "CN=Мирний Олександр Максимович (Тест);SN=Мирний;GivenName=Олександр Максимович (Тест);Serial=2468620;C=UA;L=Київ",
"timeStamp": 1562312853
},
"signId": 1967
},
{
"bodyId": 6257,
"companyId": 4,
"info": {
"certSerial": "33B6CB7BF721B9CE040000000CAB250045995A00",
"isTimeStamp": true,
"issuerCN": "Акредитований центр сертифікації ключів ІДД ДФС",
"subjCN": "Мирний Олександр Максимович (Тест)",
"subjCode": "1010101017",
"subjFullName": "Мирний Олександр Максимович (Тест)",
"subjInn": "1010101017",
"subjOrg": "Мирний Олександр Максимович (Тест)",
"subject": "CN=Мирний Олександр Максимович (Тест);SN=Мирний;GivenName=Олександр Максимович (Тест);Serial=2468620;C=UA;L=Київ",
"timeStamp": 1562312873
},
"signId": 1969
}
]
}
],
"clientSignsCount": 0,
"comment": "121212",
"date": 1562054351,
"dateSent": 1562229582,
"documentId": 6270,
"documentType": {
"agreementProcId": 0,
"code": "0cfa1f6f52884f6c8a4d1f1e51b7b07d",
"companyId": 4,
"documentId": 2677,
"extraFields": [],
"isActive": 1,
"isProviderAccess": 0,
"name": "Внутренний2",
"type": 2,
"useType": 2
},
"documentUuid": "dd5f6a59-2cf2-4bf3-b70e-26cf5e11266e",
"extraFields": [],
"isReadFromApi": 0,
"number": "1562054351",
"ownerSignsCount": 0,
"packageId": 0,
"senderCompanyId": 4,
"status": 5,
"versionStructure": 2
}