Технічна документація
Завантаження модуля
Для роботи з сервісом необхідно завантажити з нашого сайту обробку
“Завантаження 7A”
Вона дозволяє імпортувати електронні накладні за допомогою QR-коду або тимчасового ключа.
Створення документа
Створення документа
Рекомендація для системи 1C/BAF: створіть регістр для співставлення
Рекомендуємо додати новий регістр відомостей “Співставлення довідників та посилань імпорту”.
Він потрібен для автоматичного співставлення товарів у випадках, коли:
у товару немає штрихкоду,
постачальник не надає штрихкод у накладній.
Як це працює:
При першому імпорті, якщо система не знайде товар за штрихкодом, ви можете один раз виконати ручне співставлення.
Усі наступні завантаження цей товар буде визначатися автоматично, без повторної ручної роботи.
Для реєстрації у системі постачальник надсилає HTTP-запит методом POST на
адресу: http://7a.com.ua:6010/Registration
ФОРМАТ ЗАПИТУ:
POST http://7a.com.ua:6010/Registration?P1=Назва&P2=Код_ЄДРПОУ&P3=Email&P4=ТелефонПРИКЛАД ЗАПИТУ:
POST http://7a.com.ua:6010/Registration?P1=ФОП Петренко М.О.&P2=1234567890&P3=test@gmail.com&P4=0505555555ФОРМАТ ЗАПИТУ:
P1 – Назва підприємства або ФОП*
P2 – Код ЄДРПОУ*
P3–e-mail підприємства (куди будуть надіслані ключі)*
P4 – контактний номер (не обов’язково)
* – дані обов’язкові для заповнення
Завантаження модуля
Для роботи з сервісом необхідно завантажити з нашого сайту обробку
“Завантаження 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 – сума