Технічна документація
Завантаження модуля
Для роботи з сервісом необхідно завантажити з нашого сайту обробку
“Завантаження 7A”
Вона дозволяє імпортувати електронні накладні за допомогою QR-коду або тимчасового ключа.
Конфігурація з налаштуванням
Створення документа
Рекомендація для системи 1C/BAF: створіть регістр для співставлення
Рекомендуємо додати новий регістр відомостей “Співставлення довідників та посилань імпорту”.
Він потрібен для автоматичного співставлення товарів у випадках, коли:
у товару немає штрихкоду,
постачальник не надає штрихкод у накладній.
Як це працює:
При першому імпорті, якщо система не знайде товар за штрихкодом, ви можете один раз виконати ручне співставлення.
Усі наступні завантаження цей товар буде визначатися автоматично, без повторної ручної роботи.
Для реєстрації у системі постачальник надсилає HTTP-запит методом POST на
адресу: http://api.7a.com.ua:6010/SendDoc
ФОРМАТ ЗАПИТУ:
POST http://api.7a.com.ua:6010/SendDoc?P1=Назва&P2=Код_ЄДРПОУ&P3=Email&P4=ТелефонТіло запиту (формат JSON)
{
"DocArray": [
{
"info": "",
"DocN": "000468",
"DocDate": "20250814",
"Doc_ID": "9d4c272f-7821-11f0-b364-d86126937ec5",
"goods": [
{
"code": "ІФ0011569",
"id": "d437feea-ee03-11eb-80f2-9c8e995544df",
"name": "Горілка Малинівка Святкова 0.1",
"uktzed": "2208601100",
"unit": "2061",
"barcode": [
"4820103409519"
],
"quantity": "10.000",
"summ": "208.00"
},
{
"code": "31282",
"id": "e56aa22a-446e-11ea-914e-645d86b9d79a",
"name": "Горілка Малинівка Святкова 0.25",
"uktzed": "2208601100",
"unit": "2061",
"barcode": [
"4820103407065"
],
"quantity": "10.000",
"summ": "434.00"
},
{
"code": "26154",
"id": "d27dfa2b-446e-11ea-914e-645d86b9d79a",
"name": "Вода Джерело Зарваниці 1.5",
"uktzed": "2201",
"unit": "2061",
"barcode": [
"4820046310019"
],
"quantity": "18.000",
"summ": "187.20"
}
],
"CleaningDate": "20250820"
}
],
"Key1": "0DEAA650D4",
"Hash2": "B57B8CE1D2744D4F3FBD2F18F96BC080"
}ОПИС ПОЛІВ:
info – інформація яка буде відображатися покупцю при завантаженні цього документа
DocN – номер документа (повинен співпадати із номером яки ми друкуємо у QR-коді. У номері дозволено використовувати тільки цифри, та латинськті літери)
DocDate – дата документа (формат yyyyMMdd)
Doc_ID – унікальний ідентифікатор документа (не обов’язково, у разі відсутності вказати пустий ідентифікатор 00000000-0000-0000-0000-000000000000)
CleaningDate – дата до якоъ необхідно зберігати документи у системі 7A
Key1 – публічний ключ наданий системою 7A
Hash2 – значення хешу MD5 (формат: дата вивантаження у систему 7A + закритий ключ2). Наприклад 202508146H30P94PUF2LWJ де 220250814 це дата 14.08.2025, а 6H30P94PUF2LWJ закритий ключ наданий системою 7A. Результат хешування MD5 – B57B8CE1D2744D4F3FBD2F18F96BC080
goods – массив товарів
Code – код товару у постачальника
ID – унікальний ідентифікатор у постачальника
Name – назва товару
Uktzed – код УКТЗЕД товару (може бути відсутній)
Unit – код одиниці вимірювання (згідно класифікатора системи позначень одиниць
вимірювання)
Barcode – масив штрихкодів
Quantity – кількість
Summ – сума
Завантаження модуля
Для роботи з сервісом необхідно завантажити з нашого сайту обробку
“Завантаження 7A”
Вона дозволяє імпортувати електронні накладні за допомогою QR-коду або тимчасового ключа.
Створення документа
Створення документа
Рекомендація для системи 1C/BAF: створіть регістр для співставлення
Рекомендуємо додати новий регістр відомостей “Співставлення довідників та посилань імпорту”.
Він потрібен для автоматичного співставлення товарів у випадках, коли:
у товару немає штрихкоду,
постачальник не надає штрихкод у накладній.
Як це працює:
При першому імпорті, якщо система не знайде товар за штрихкодом, ви можете один раз виконати ручне співставлення.
Усі наступні завантаження цей товар буде визначатися автоматично, без повторної ручної роботи.
Отримання ліцензії у системі 7A
GET /GetInvoice
ПРИКЛАД ЗАПИТУ:
GET http://7a.com.ua:6010/GetInvoice?P=D87FB7FF-FE89-11EE-9C4E60A5E224A2E2&P2=TestПараметридля запиту:
P1 – унікальний ідентифікатор клієнта (генерується системою або вами)*
P2 – код інтегратора, якщо ви працюєте через нього (назва, телефон, або e-mail)
* – дані обов’язкові для заповнення
Під час першої реєстрації клієнт має можливість отримати тестову ліцензію терміном
на 30 днів. Для цього встановити ознаку “FreeLicense”: 1
Якщовибажаєте оформитиповноціннуліцензію, необхідно заповнити всі наступні
поля у форматі JSON:
Тіло запиту (формат JSON)
{
"Name": "ФОП Петренко Микола Олегович",
"Kod": "1111111111",
"months": 1,
"email": "test@gmail.com",
"ID": "d87fb7ff-fe89-11ee-9c4e-60a5e224a2e2",
"integrator": “test",
"License": "HBE1BV047D5FV0",
"FreeLicense": 1
}Name – назва ідприємства або ФОП
Kod– код ЄДРПОУ
Months – кількість місяців, на які оформлюється ліцензія
email – адреса для надсилання рахунку
ID – унікальний ідентифікатор клієнта (генерується системою або вами)
Integrator – код інтегратора, якщо ви працюєте через нього (назва, телефон, або e-mail)
License – номер попередньої/діючої ліцензії, якщо вона вже була
FreeLicense– 1 для тестової ліцензії, 0 для платної
Отримання інформації по QR коду
GET/GetDoc
Для забезпечення повного завантаженняданих з документа, до запиту за QR
кодом необхідно додати два додаткових параметри.
Якщоці параметри не передані, система поверне лише три перші позиції з
накладної.
Переконайтесь, що ваш запит сформовано правильно, щоб уникнути обмеженого
відображення товарів.
Додаткові параметри для запиту:
P6–унікальний ідентифікатор клієнта (генерується системою або вами)
P7–номер поточної ліцензії
ПРИКЛАД ЗАПИТУ:
http://7a.com.ua:6010/Doc?P1=20250901&P2=000100&P3=CFB9F197A3&P4=E514A075E5C804DAC248C1049B858AA8&P5=AF93A567F73FB9A951ABC2C9140FCA37&P6=D87FB7FF-FE89-11EE-9C4E-60A5E224A2E2&P7=HBE1BV047D5FV0
Приклад відповіді, що повертається
{
"key":"B1A935",
"info": "",
“service": "",
"Doc_ID": "9d4c272f-7821-11f0-b364-d86126937ec5",
"goods": [
{
"code": "11569",
"id": "d437feea-ee03-11eb-80f2-9c8e995544df",
"name": "Горілка Малинівка Святкова 0.1",
"uktzed": "2208601100",
"unit": "2061",
"barcode": [
"4820103409519"
],
"quantity": "10.000",
"summ": "250.00"
},
{
"code": "26154",
"id": "d27dfa2b-446e-11ea-914e-645d86b9d79a",
"name": "Вода Джерело Зарваниці 1.5",
"uktzed": "2201",
"unit": "2061",
"barcode": [
"4820046310019"
],
"quantity": "10.000",
"summ": "190.00"
}
]
}Опис параметрів відповідей:
Key – ключ для завантаження документа при скануванні телефоном (дійсний до 1хв)
Info – інформаційне повідомлення надіслане постачальником
Service – сервісне повідомлення надіслане сервісом 7A
Doc_ID– ідентифікатор документа у постачальника (може бути відсутній)
Goods – Масив товарів
Code – код товару у постачальника
ID – унікальний ідентифікатор у постачальника
Name – назва товару
Uktzed– код УКТЗЕД товару (може бути відсутній)
Unit – код одиниці вимірювання (згідно класифікатора системи позначень одиниць
вимірювання)
Barcode – масив штрихкодів
Quantity – кількість
Summ-сума
Отримання документа по ключу отриманого на телефоні
GET/Key
Для забезпечення повного завантаженняданих з документа, до запиту за QR
кодом необхідно додати два додаткових параметри.
Якщоці параметри не передані, система поверне лише три перші позиції з
накладної.
Переконайтесь, що ваш запит сформовано правильно, щоб уникнути
обмеженого відображення товарів.
Додаткові параметри для запиту:
P1 – ключ для завантаження (отриманий на телефоні)
P6–унікальний ідентифікатор клієнта (генерується системою або вами)
P7–номер поточної ліцензії
ПРИКЛАД ЗАПИТУ:
http://7a.com.ua:6010/Key?P1=B1A935&P6=D87FB7FF-FE89-11EE-9C4E60A5E224A2E2&P7=HBE1BV047D5FV0
Приклад відповіді:
{
"key":"B1A935",
"info": "",
“service": "",
"Doc_ID": "9d4c272f-7821-11f0-b364-d86126937ec5",
"goods": [
{
"code": "11569",
"id": "d437feea-ee03-11eb-80f2-9c8e995544df",
"name": "Горілка Малинівка Святкова 0.1",
"uktzed": "2208601100",
"unit": "2061",
"barcode": [
"4820103409519"
],
"quantity": "10.000",
"summ": "250.00"
},
{
"code": "26154",
"id": "d27dfa2b-446e-11ea-914e-645d86b9d79a",
"name": "Вода Джерело Зарваниці 1.5",
"uktzed": "2201",
"unit": "2061",
"barcode": [
"4820046310019"
],
"quantity": "10.000",
"summ": "190.00"
}
]
}Опис параметрів відповідей:
Key – ключ для завантаження документа при скануванні телефоном (дійсний до 1хв)
Info – інформаційне повідомлення надіслане постачальником
Service – сервісне повідомлення надіслане сервісом 7A
Doc_ID– ідентифікатор документа у постачальника (може бути відсутній)
Goods – Масив товарів
Code – код товару у постачальника
ID – унікальний ідентифікатор у постачальника
Name – назва товару
Uktzed – код УКТЗЕД товару (може бути відсутній)
Unit – код одиниці вимірювання (згідно класифікатора системи позначень одиниць
вимірювання)
Barcode – масив штрихкодів
Quantity – кількість
Summ – сума