Web-сервіси 1С

 

</div>

Потрібно визначити:

[[Категорія:Запити 1С]]

* SOAP web-сервіси з описом через WSDL;
* HTTP-сервіси, які частіше використовуються для REST-подібних API, JSON або XML-обміну.; | URL, методи, формати, зовнішні системи, токени, права, логи, помилки, дублікати й регламентні задача.; Частина замовлень, цін і залишків живе в старій системі, частина — у новій, а джерело істини зникає.; |-
| Які бувають web-сервіси?;== Web-сервіси і продуктивність ==
 ]

'''Підхід K2 ERP.''' Під час переходу з [[1С]] потрібно знайти всі web-сервіси, описати їхні URL, методи, формати даних, авторизацію, зовнішні системи, токени, бізнес-логіку, логи й помилки, а потім перенести потрібні інтеграції в [[K2 ERP]].; | Для обміну із сайтом, CRM, WMS, мобільними застосунками, банками, сервісами доставки, BI та іншими системами.; Значення
</div>
'''істотно про 1С і BAS.''' [[1С]] та частина продуктів [[BAS]] мають санкційні, юридичні й кібербезпекові ризики в Україні.;

Це особливо небезпечно, якщо передаються: Можливі варіанти авторизації:

"external_id": "WEB-100245",

Вебсервер

Через web-сервіси можна передавати інформаційні дані в BI.;== Web-сервіс для залишків ==

Контроль після перенесення web-сервісів

Зазвичай потрібні:

/api/v2/orders

знайти всі інтеграційні точки;
закрити небезпечні сервіси;
перенести API в K2 ERP;
прибрати токени зі старого коду;
вимкнути старі публікації;
захистити персональні й комерційні інформаційні дані;
не залишати 1С прихованим центром обміну;
зменшити залежність від 1С і BAS.; Погано:

"field": "items [0].article"

Вони зазвичай використовують: Потрібно: Наслідки:

"order_id": "WEB-100245",

Приклад умовного SOAP-запиту: Не завжди потрібно зберігати повний запит і відповідь, особливо якщо там є собою персональні інформаційні дані, паролі, токени або комерційна відомості.; Через web-сервіси можуть передаватися персональні інформаційні дані:

"success": true,

"api_version": "1.0",

У 1С такий запит має змогу створити: Для інтегратора WSDL — це технічна документація, за якою можна підключити зовнішню систему до web-сервісу.;== Web-сервіси і логіювання == 1С → HTTP-запит → Web-сервіс зовнішньої системи

<Name>ТОВ замовник</Name>

Приклад JSON:

}

"customer": {
"phone": "+380501112233",

|- | Що таке web-сервіси 1С?; Середовище

Або навпаки:

"price": 250.00
},

!; * частина замовлень потрапляє в стару систему;

залишки розходяться;
сайт отримує старі ціни;
CRM бачить неактуальні статуси;
користувачі не розуміють, де правильні інформаційні дані.;== HTTPS ==

Вони можуть забезпечувати:

"quantity": 2,

Помилка: дублікати документів

Логіка web-сервісів реалізується в коді.;

}

Або поле у відповіді:
[[Категорія:Веб-клієнт 1С]]
Правильний порядок:

/api/v1/orders

== Web-сервіси і модулі 1С ==

<syntaxhighlight lang="bsl">

* зовнішній ID;
* статус обробки;
* перевірку дублікатів;
* лог повторних спроб;
* таймаути;
* чергу повідомлень;
* повідомлення відповідальному;
* безпечне повторне виконання.;https://1c.company.ua/ws/Exchange
як ілюстрація:

 <Quantity>2</Quantity>

Web-сервіси можуть викликатися автономно.;<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

* шифрування даних;
* захисту логінів і токенів;
* захисту персональних даних;
* захисту комерційної інформації;
* безпечної роботи через інтернет;
* довіри зовнішніх систем.; Краще використовувати бізнес-методи з перевірками.; Web-сервіс має повертати зрозумілі помилки.; Статус сайту
https://1c.company.ua/api/orders
 "price_type": "retail",
!; !;<syntaxhighlight lang="xml">
== Web-сервіси і журнал реєстрації ==
<syntaxhighlight lang="text">
HTTP-сервіси в [[1С]] часто використовують для сучасніших інтеграцій.; Окремі продукти [[1С]] і [[BAS]] внесені до переліків забороненого програмного забезпечення для окремих категорій організацій в Україні.; |-
| Що істотно для безпеки?;</div>

 <EDRPOU>12345678</EDRPOU>
!; Через web-сервіси можуть передаватися:
Під час переходу на [[K2 ERP]] web-сервіси потрібно аналізувати дуже уважно.; Ознака

Простими словами. Web-сервіс 1С — це “вхід” або “вихід” для обміну даними між 1С і зовнішнім світом.;</Response> {{SEO

</syntaxhighlight>

тип ціни;
валюту;
дату актуальності;
ПДВ;
знижки;
акційні ціни;
округлення;
мінімальну ціну.;</syntaxhighlight>

]
"tracking_number": "20450000000000",

Web-сервіси і міграція в K2 ERP

"date": "2026-05-15T14:30:00",

Web-сервіси і BI-аналітика

Web-сервіси не повинні бути відкритими без контролю доступу.; має змогу бути в K2 ERP:

</syntaxhighlight>

"email": "client@example.ua"
}

!; Статус у 1С

сайт надсилає замовлення в 1С;
1С повертає сайту залишки товарів;
CRM запитує заборгованість клієнта;
WMS отримує задача на відвантаження;
мобільний застосунок створює заявку;
банк передає статус платежу;
K2 ERP приймає інформаційні дані зі старої 1С під час міграції.; "error": "Error"

</syntaxhighlight>

які методи існують;
які поля обов’язкові;
хто викликає сервіс;
що означають статуси;
які помилки можливі;
де зберігаються токени;
як тестувати інтеграцію;
що переносити в K2 ERP.; # Перевірити помилки.; як ілюстрація:

як ілюстрація:

"reserved": 20,

Для web-сервісів важлива ідемпотентність.; "article": "USB-C-1M-BLK", </syntaxhighlight>

Web-сервіси і резервна копія

Приклад запиту:

Вони можуть працювати з:

Як правильно працювати з web-сервісами перед міграцією

Приклад створення замовлення: }

"items": [

Воно надає можливість: { Authorization: Bearer token

Висновок

Web-сервіси і XML

Ідемпотентність

<Date>2026-05-15T14:30:00</Date>

</syntaxhighlight>

Вступ

Потрібно передбачити: Для інтеграцій бажано створювати окремих сервісних користувачів.;== Типові проблеми web-сервісів 1С ==

дату і час;
URL;
метод;
напрям обміну;
зовнішню систему;
користувача або сервісний обліковий запис;
зовнішній ID;
код відповіді;
результат;
помилку;
час виконання;
короткий характеристика даних.; Приклад

"paid": true

отримати список товарів;
отримати залишки;
створити замовлення;
змінити статус замовлення;
отримати контрагента;
передати оплату;
повернути помилку.; Приклад API-методів:

Приклад:

Через web-сервіси можуть створюватися або оновлюватися документи: Host: 1c.company.ua

<OrderId>WEB-100245</OrderId>

http://1c.company.ua/api/orders

POST /1c/api/orders

У модулях має змогу бути:

HTTP/HTTPS;
сертифікати;
маршрутизацію;
обмеження доступу;
журнали доступу;
проксі;
балансування;
безпечну публікацію сервісів.; Потрібно переносити бізнес-сценарії, структури даних, правила обміну й вимоги до API.; Цифрова незалежність. Web-сервіси 1С часто є собою невидимими зв’язками старої системи з цифровим середовищем бізнесу.; Відповідь

Приклад заголовку:

<DocumentNumber>ЗМ-000123</DocumentNumber>

Web-сервіси можуть читати або змінювати інформаційні дані регістрів через бізнес-логіку 1С.; URL

Такі інформаційні дані не можна передавати без контролю, логіювати у відкритому вигляді або зберігати в незахищених файлах.;

[[Категорія:Міграція з BAS]]

Обробка має змогу:

* залишки товарів;
* ціни;
* курси валют;
* взаєморозрахунки;
* собівартість;
* резерви;
* статуси обміну.; # Спроєктувати API в [[K2 ERP]].; Через них можуть проходити замовлення, товари, ціни, залишки, контрагенти, документи, статуси, оплати, доставки, складські операції та аналітичні інформаційні дані.; {

<syntaxhighlight lang="json">
[[Категорія:Заміна 1С]]
 <Article>USB-C-1M-BLK</Article>
== Web-сервіси і JSON ==
|-
| Test
| /api-test/orders
| Тестування
|-
| Production
| /api/orders
| Робочий обмін
|}

Через web-сервіси можуть синхронізуватися довідники:

{

* кількість запитів;
* складність запитів;
* запити до регістрів;
* розмір відповіді;
* кешування;
* сервер [[1С]];
* вебсервер;
* СУБД;
* мережа;
* логіювання;
* зовнішні системи.; |-
| Для чого вони використовуються?; користувач системи
[[Категорія:Деколонізація обліку]]
 <Price>250.00</Price>

== Web-сервіси і комерційна відомості ==

Особливо перед:

== Web-сервіси і довідники ==

 <Warehouse>MAIN</Warehouse>

* сайт;
* інтернет-магазин;
* [[CRM]];
* [[WMS]];
* мобільний застосунок;
* банк;
* касова платформа;
* сервіс доставки;
* маркетплейс;
* платіжний сервіс;
* [[BI]];
* платформа документообігу;
* зовнішній API постачальника;
* внутрішні мікросервіси.;<Item>

 "success": true

[[Категорія:Документи 1С]]

* перевіряти нові методи;
* тестувати зміни;
* не псувати робочу базу;
* перевіряти помилки;
* перевіряти авторизацію;
* тестувати міграцію;
* навчати інтеграторів.; Під час переходу істотно перенести ці зв’язки в [[K2 ERP]], а не залишити стару [[1С]] критичним інтеграційним вузлом.; # Описати формати JSON, XML або SOAP.; HTTP-сервіс
[[Категорія:CSV]]
<syntaxhighlight lang="text">
Зовнішня платформа → Web-сервіс 1С → Документ або довідник у 1С

Для web-сервісів бажано використовувати HTTPS.;

== Web-сервіси і обмеження навантаження ==
== Web-сервіс для контрагентів ==
}
 {
|-
| 200
| Успішно
| інформаційні дані отримано
|-
| 201
| Створено
| Замовлення створено
|-
| 400
| Помилка запиту
| Не заповнене обов’язкове поле
|-
| 401
| Не авторизовано
| Немає токена або неправильний токен
|-
| 403
| Заборонено
| Недостатньо прав
|-
| 404
| Не знайдено
| Метод або об’єкт не знайдено
|-
| 500
| Внутрішня помилка
| Помилка сервера або коду
|}

 "name": "ТОВ замовник",

__TOC__

Перед зміною web-сервісів потрібно зробити резервну копію.;== Web-сервіси і цифрова незалежність ==
У практиці переходу з [[1С]] на [[K2 ERP]] web-сервіси мають особливе значення, з цієї причини що саме через них стара платформа часто пов’язана з іншими частинами бізнесу: сайтом, складом, CRM, мобільними застосунками, банком, касами, зовнішніми сервісами й аналітикою.; },
<syntaxhighlight lang="json">
організація повинна:
[[Категорія:Автоматизація бізнесу]]
істотно розрізняти:
 "success": true,
== Web-сервіси і безпека ==
Приклад:
 "order_id": "WEB-100245",
Приклад URL:
У WSDL описується:
XML часто застосовується в SOAP-сервісах або старих інтеграціях.; "external_id": "WEB-100245"

<syntaxhighlight lang="json">

Для HTTP-сервісів істотно використовувати зрозумілі коди.; Витік web-сервісу має змогу розкрити критичну інформацію бізнесу.; "available": 100,
== Повторні спроби ==
[[Категорія:Web-сервіси 1С]]
як ілюстрація:
{
як ілюстрація, API має змогу мати методи:
https://1c.company.ua/api/orders
Токени й ключі доступу потрібно зберігати безпечно.; {| class="wikitable" style="width:100%;"
 }
[[Категорія:Режим підприємства 1С]]

Потрібно контролювати: POST /api/orders HTTP/1.1

!; Токен = "secret-token-123";

"price": 250.00

Перед міграцією потрібно зрозуміти, яка платформа є собою джерелом істини для кожного довідника.;== Коротко == Приклад HTTP-запиту: </syntaxhighlight>

Сервісні користувачі

}

"edrpou": "12345678"

Приклад таблиці:

</GetStock>

!; # Перевірити вебсервер і публікації.; # Знайти токени й секрети.; "error": {

"edrpou": "12345678"
"quantity": 120,

Помилка: немає документації

Приклад відповіді: |- | /products | Повертає товари | JSON |- | /stock | Повертає залишки | JSON |- | /orders | Приймає замовлення | JSON |- | /prices | Повертає ціни | JSON |- | /status | Оновлює статус документа | JSON |}

як ілюстрація:

Web-сервіс без HTTPS має змогу передавати чутливі інформаційні дані незахищеним каналом.; !; Перед міграцією в K2 ERP потрібно знайти ці модулі й описати бізнес-логіку.; # Зібрати URL-адреси.;

Структура API з часом змінюється.;<syntaxhighlight lang="json">

 "price": 250.00

 "customer": {

{| class="wikitable" style="width:100%;"

Погано:

Інтеграції можуть повторювати запит при помилці.; З урахуванням санкційних, юридичних і кібербезпекових ризиків 1С та BAS, аналіз web-сервісів старої системи має бути частиною ширшої стратегії переходу на українське програмне забезпечення, цифрову незалежність і сучасну ERP-архітектуру.; # Перевірити регламентні задача.; Щоб ці системи обмінювалися даними, використовують інтеграції.; Сервіс

== SOAP web-сервіси 1С ==
|-
| /api/orders
| HTTP JSON
| Замовлення
| Сайт
| Приймати замовлення в K2 ERP
|-
| /api/stock
| HTTP JSON
| Залишки
| Сайт / WMS
| Віддавати залишки з K2 ERP
|-
| ExchangeSOAP
| SOAP XML
| Контрагенти, документи
| CRM
| Замінити сучасним API
|-
| /api/prices
| HTTP JSON
| Ціни
| Інтернет-магазин
| Передавати ціни з K2 ERP
|-
| /api/status
| HTTP JSON
| Статуси
| Доставка
| Синхронізувати статуси в K2 ERP
|}

 <Customer>

}

== Інвентаризація web-сервісів ==

* бізнес-сценарії;
* структури даних;
* зовнішні ID;
* правила зіставлення;
* формати відповідей;
* статуси;
* правила помилок;
* авторизацію;
* логи;
* вимоги безпеки;
* інтеграційні маршрути;
* відповідальних;
* контрольні звірки.;<Article>USB-C-1M-BLK</Article>
 "edrpou": "12345678",

== Web-сервіси і персональні інформаційні дані ==

<syntaxhighlight lang="json">

# Знайти всі SOAP web-сервіси.;<syntaxhighlight lang="text">

 "article": "USB-C-1M-BLK",

{| class="wikitable" style="width:100%;"
Один із варіантів інтеграції — web-сервіси.; # Перевірити логи.; SOAP web-сервіс

 }

* створення замовлень;
* отримання товарів;
* отримання цін;
* отримання залишків;
* синхронізації контрагентів;
* передачі оплат;
* зміни статусів;
* обміну з доставкою;
* обміну з WMS;
* інтеграції з CRM;
* інтеграції з сайтом;
* передачі даних у BI;
* міграції даних у [[K2 ERP]].; Призначення
[[Категорія:Резервна копія 1С]]
!; Бізнес-система рідко функціонує ізольовано.; | Це механізми обміну даними між [[1С]] та зовнішніми системами через мережеві протоколи.; Web-сервіс часто є собою частиною [[API]].; Такі обробки потрібно зібрати перед міграцією.; Погано:
Журнал реєстрації [[1С]] має змогу допомогти знайти події, пов’язані з web-сервісами:
<Order>

== Web-сервіси і токени ==

 </Customer>

Краще:

* [[K2]]
* [[K2 ERP]]
* [[ERP]]
* [[1С]]
* [[BAS]]
* [[API]]
* [[JSON 1С]]
* [[JSON]]
* [[XML]]
* [[CSV]]
* [[Інтеграція через файли]]
* [[Інтеграція через XML]]
* [[Імпорт даних]]
* [[Експорт даних]]
* [[Інтеграція з 1С]]
* [[Інтеграція з BAS]]
* [[Заміна 1С]]
* [[Заміна BAS]]
* [[Міграція з 1С]]
* [[Міграція з BAS]]
* [[Обробки 1С]]
* [[Модуль 1С]]
* [[Запити 1С]]
* [[Веб-клієнт 1С]]
* [[Тонкий клієнт 1С]]
* [[Режим підприємства 1С]]
* [[Журнал реєстрації 1С]]
* [[Резервна копія 1С]]
* [[Довідники 1С]]
* [[Документи 1С]]
* [[Реквізити 1С]]
* [[Номенклатура 1С]]
* [[Ціни номенклатури 1С]]
* [[Серії номенклатури 1С]]
* [[Курси валют 1С]]
* [[Каса 1С]]
* [[Податкова накладна 1С]]
* [[Фізичні особи 1С]]
* [[Табель обліку робочого часу 1С]]
* [[Собівартість 1С]]
* [[BI]]
* [[Права доступу]]
* [[Кібербезпека]]
* [[Українське програмне забезпечення]]
* [[Автоматизація бізнесу]]
* [[Цифрова незалежність]]
* [[Деколонізація обліку]]

 "name": "ТОВ замовник",

* [https://erp.kyiv.ua Сайт K2 ERP]
* [https://wiki.erp.kyiv.ua Wiki K2 ERP]
* [https://cloud.corp2.eu хмарна інфраструктура K2 ERP]
* [https://cip.gov.ua/ua/statics/perelik-zaboronenogo-do-vikoristannya-programnogo-zabezpechennya-ta-komunikaciinogo-merezhevogo-obladnannya Перелік забороненого до використання програмного забезпечення на сайті Держспецзв’язку]
* [https://cip.gov.ua/ua/news/vidpovidi-na-poshireni-zapitannya-shodo-pereliku-zaboronenogo-programnogo-zabezpechennya-ta-obladnannya Роз’яснення Держспецзв’язку щодо переліку забороненого ПЗ]
* [https://www.president.gov.ua/documents/6012024-52009 Указ Президента України №601/2024]
* [https://zakon.rada.gov.ua/go/601/2024 Указ Президента України №601/2024 на сайті Верховної Ради України]
* [https://t.me/+uIdWI1W6vndkMTAy Telegram-канал K2 ERP]
* [https://t.me/+6jFwAZM6TQliNTdi Група обговорення функціоналу та пропозицій]
* [https://www.linkedin.com/company/k2erp/ LinkedIn K2]

Іноді інтеграційні функціональні можливості через web-сервіси реалізована не в конфігурації, а в зовнішній обробці.;<syntaxhighlight lang="json">

 <Items>

* відкривати web-сервіси без авторизації;
* не використовувати HTTPS;
* зберігати токени в коді;
* не мати логів;
* не мати зовнішніх ID;
* не документувати API;
* не тестувати помилки;
* не мати тестового середовища;
* не обмежувати права сервісного користувача;
* не перевіряти навантаження;
* залишити старі web-сервіси [[1С]] активними після запуску [[K2 ERP]];
* ігнорувати санкційні й кібербезпекові ризики старої системи.;<syntaxhighlight lang="text">

{

</Order>

!; як ілюстрація, якщо сайт двічі відправив одне замовлення з ID `WEB-100245`, платформа не повинна створити два замовлення.;<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">

== Web-сервіси і зовнішні обробки ==

 "article": "USB-C-1M-BLK",
<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">
 "payment": {

!; Формат

* заголовок;
* табличні частини;
* статуси;
* правила проведення;
* зовнішні ID;
* контроль дублікатів;
* правила помилок.; # Описати бізнес-сценарії.; {| class="wikitable" style="width:100%;"
Приклад:
[[Категорія:Інтеграція з BAS]]
== Авторизація web-сервісів ==
 "order_id": "WEB-100245",
Потрібно перенести:
<syntaxhighlight lang="text">

як ілюстрація:

* контрагента;
* замовлення покупця;
* рахунок;
* резерв;
* оплату;
* задачу менеджеру;
* запис у журналі інтеграцій.; Через нього можна передати замовлення, отримати залишки, оновити ціни, створити контрагента, передати статус доставки або синхронізувати документи.; !; }
!; "document_id": "1C-000123"
'''Правильний підхід.''' Web-сервіси [[1С]] потрібно розглядати не як окремий технічний код, а як частину інтеграційної архітектури бізнесу: хто з ким обмінюється, які інформаційні дані передає, хто є собою джерелом істини, як захищений доступ і як це має працювати в [[K2 ERP]].;[[Категорія:Експорт даних]]

* номенклатура;
* контрагенти;
* склади;
* валюти;
* види цін;
* одиниці виміру;
* серії;
* характеристики;
* договори;
* працівники;
* підрозділи;
* статті витрат.;

інформаційна база;
вебсервер;
сервер 1С, якщо база серверна;
конфігурація публікації;
URL;
права доступу;
HTTPS;
авторизація;
журналювання;
тестовий контур.; # Перевести зовнішні системи на K2 ERP.; Тіло запиту:

{

Web-сервіси і регламентні задача

!; * список сервісів;

URL;
тип сервісу;
методи;
формати;
авторизацію;
користувачів;
зовнішні системи;
приклади запитів;
приклади відповідей;
логи;
помилки;
регламентні задача;
відповідальних;
бізнес-сценарії.; Статус у K2 ERP

{ { Web-сервіс має змогу: Краще:

</soap:Body>

SOAP web-сервіси — це більш формальний варіант інтеграції.; # Перевірити сервісних користувачів.;</syntaxhighlight>

"items": [

</syntaxhighlight>

"edrpou": "12345678",

 "items": [

авторизацію;
HTTPS;
створення документів;
актуалізація статусів;
передачу залишків;
передачу цін;
дублікати;
помилки;
логи;
продуктивність;
зовнішні ID;
тестові й робочі URL;
права сервісних користувачів;
контрольні звірки.; Щоб зовнішня платформа могла звертатися до web-сервісу 1С, його потрібно опублікувати.; Бажано фіксувати:

!; !; # Перевірити дублікати.; * приймати запити;

повертати відповіді;
створювати документи;
читати довідники;
передавати залишки;
оновлювати ціни;
синхронізувати статуси;
передавати помилки;
виконувати бізнес-логіку;
взаємодіяти з іншими системами.; # Визначити зовнішні системи.;</syntaxhighlight>

"message": "Замовлення створено",

немає документації;
незрозуміло, хто викликає сервіс;
web-сервіс відкритий без належного захисту;
немає HTTPS;
токени збережені в коді;
застосовується адміністраторський користувач системи;
немає логів;
помилки незрозумілі;
дублюються замовлення;
API повертає різні формати;
сервіс повільний;
немає тестового середовища;
зовнішні системи залежать від старої 1С;
після міграції старий сервіс не вимкнули.; GET /api/stock?warehouse=MAIN&article=USB-C-1M-BLK

</syntaxhighlight>

"customer": {

!; |- | Чи потрібно переносити старий код web-сервісів у K2 ERP?;https://1c.company.ua/hs/stock

Вебсервер приймає запити від зовнішніх систем або браузерів.; рішення для бізнесу в K2 ERP

JSON;
XML;
plain text;
файлами;
параметрами URL;
HTTP-заголовками;
токенами;
статусами відповіді.; "vat_number": "123456789012",

як ілюстрація: "warehouse": "MAIN",

сайт відправив замовлення;
не отримав відповідь через таймаут;
відправив ще раз;
у 1С створилося два замовлення.; Права

; * ПІБ; телефон; email; адреса; ІПН; паспортні інформаційні дані; банківські реквізити; зарплатні інформаційні дані; кадрові інформаційні дані.; Призначення POST /k2/api/v1/orders Після переходу потрібно вимкнути або перевести старі сервіси в архівний режим.; } оновленням конфігурації; зміною API; зміною авторизації; зміною структури JSON/XML; масовим завантаженням даних; запуском нової інтеграції; міграцією в K2 ERP.;</Item> Аналіз web-сервісів 1С — це частина підготовки до виходу зі старої ризикової системи.; \| Залишити старі web-сервіси 1С активними після запуску K2 ERP.; Окремі продукти 1С і BAS внесені до відкритих переліків програмного забезпечення, забороненого до використання для окремих категорій організацій.; З web-сервісів 1С не переносять сам старий код механічно.; \| SOAP web-сервіси з WSDL і HTTP-сервіси для JSON, XML або REST-подібного API.;== Що переносити в K2 ERP == Але для BI краще використовувати контрольовану модель даних, а не хаотичні запити до старої 1С.; \| Ні.;<Success>true</Success> Простий приклад: </syntaxhighlight> рішення для бізнесу — зовнішній ID і перевірка повторного запиту.; Якщо немає зовнішнього ID, повторний запит має змогу створити дубль документа.;</syntaxhighlight> Зовнішні посилання замовлення покупця; рахунки; реалізації; надходження; переміщення; списання; інвентаризації; касові документи; банківські документи; заявки; виробничі документи.; Після перенесення інтеграцій у K2 ERP потрібно перевірити: логіни; паролі; токени; персональні інформаційні дані; замовлення; ціни; залишки; фінансова відомості.; Питання Якщо документації немає, складно зрозуміти: { "price": 250.00
new	Нове замовлення	Нове
paid	Оплачено	Оплачено
shipped	Відвантажено	Відвантажено
cancelled	Скасовано	Скасовано

</syntaxhighlight>

}

API — це набір правил, за якими одна платформа має змогу взаємодіяти з іншою.;== Web-сервіс для статусів ==

Будь-який web-сервіс має логіювати важливі події.; Не варто використовувати для інтеграцій обліковий запис адміністратора.; Код </syntaxhighlight>

"status": "shipped",

Web-сервіси і помилки

"items": [

Для інтеграцій потрібне тестове середовище.; },

XML;
SOAP envelope;
WSDL;
строгий характеристика методів;
типи даних;
формалізовані запити й відповіді.; Зовнішня платформа має розуміти, що саме сталося.; {

Web-сервіси і документи

"message": "Товар з артикулом USB-C-1M-BLK не знайдено",

!; "article": "USB-C-1M-BLK", Під час обробки потрібно перевіряти:

"name": "ТОВ замовник", "article": "USB-C-1M-BLK", ]

|-
| ключовий формат
| XML
| JSON, XML або інший формат
|-
| характеристика інтерфейсу
| WSDL
| Документація API
|-
| Гнучкість
| Менша
| Вища
|-
| Типові сценарії
| Корпоративні інтеграції
| Сайти, CRM, мобільні застосунки, сучасні API
|-
| Простота тестування
| Потрібні SOAP-інструменти
| Часто можна тестувати HTTP-клієнтами
|}

[[Категорія:Заміна BAS]]

Authorization: Bearer eyJhbGciOi...; Зовнішня платформа

[[Категорія:Кібербезпека]]

!; # Провести тестову інтеграцію.;[[Категорія:BI]]
== Див.; додатково ==
Порівняння:
}
== Публікація web-сервісу 1С ==
У [[K2 ERP]] web-сервіси можуть бути частиною сучасної інтеграційної архітектури.; "article": "USB-C-1M-BLK",

[[Категорія:Довідники 1С]]
 "price": 250.00
HTTPS потрібен для:

Web-сервіси можуть використовуватися для:

== Web-сервіс для замовлень ==

На продуктивність web-сервісів впливають:

Погані підходи:

 }
|-
| api_site
| Обмін із сайтом
| Товари, ціни, замовлення
|-
| api_wms
| Обмін зі складом
| Складські документи
|-
| api_crm
| Обмін із CRM
| Контрагенти, замовлення, статуси
|}

Web-сервіси можуть використовуватися; додатково реалізовано інтернет-магазинами, [[CRM]], [[ERP]], [[WMS]], мобільними застосунками, банками, сервісами доставки, маркетплейсами, платіжними сервісами, [[BI]]-системами та іншими програмними продуктами.; '''WSDL''' — це характеристика SOAP web-сервісу.;

}

"external_id": "CRM-5001",

Web-сервіси і тестове середовище

; SOAP часто зустрічається в старіших або корпоративних інтеграціях.; # Вимкнути старі web-сервіси 1С після переходу.;

 "customer": "ТОВ замовник",

{

Для web-сервісів критично істотно, щоб вебсервер був налаштований безпечно.; '''[[K2 ERP]]''' у цьому процесі має змогу стати новою платформою для контрольованих API, web-сервісів, JSON/XML-обмінів, інтеграцій, довідників, документів, залишків, цін, статусів, [[BI]]-аналітики, журналювання, прав доступу й подальшого розвитку автоматизації бізнесу без залежності від старої екосистеми [[1С]].; Тип

== Web-сервіси і регістри ==
Перед міграцією журнал реєстрації має змогу допомогти знайти інтеграції, про які забули.;<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">

Content-Type: application/json

* знайти всі SOAP і HTTP-сервіси;
* описати URL і методи;
* зібрати формати JSON, XML і WSDL;
* перевірити авторизацію;
* знайти токени й секрети;
* перевірити права сервісних користувачів;
* перевірити логи й помилки;
* описати зовнішні системи;
* перенести потрібні API-сценарії в [[K2 ERP]];
* вимкнути старі web-сервіси [[1С]] після переходу.; # Зібрати приклади запитів і відповідей.; це механізми платформи [[1С]], які дозволяють зовнішнім системам обмінюватися даними з інформаційною базою через мережеві протоколи виступає ключовою рисою інтеграції [[1С]] із сайтами забезпечується через '''Web-сервіси 1С'''.;[[Категорія:Регістри 1С]]
 "success": false,
 "quantity": 2,
Потрібно мати таблицю відповідності статусів.; Типові проблеми:

 "quantity": 2,
{| class="wikitable" style="width:100%;"
Приклад XML:
<syntaxhighlight lang="xml">
Потрібен зовнішній ID:
[[Категорія:ERP]]

 {

== Помилка: відкритий сервіс без HTTPS ==

[[Категорія:K2 ERP]]

Приклад відповіді:

* HTTPS;
* авторизацію;
* паролі;
* токени;
* IP-обмеження;
* VPN;
* права сервісних користувачів;
* журналювання;
* ліміти запитів;
* захист від дублювання;
* захист від зайвих даних;
* захист персональних даних;
* захист комерційної інформації.; }

== SOAP чи HTTP-сервіс ==

Найпоширеніші:

<syntaxhighlight lang="text">

* щогодинне актуалізація залишків;
* нічне вивантаження цін;
* завантаження замовлень кожні 5 хвилин;
* синхронізація статусів;
* передача даних у BI;
* обмін із WMS.; | HTTPS, авторизація, сервісні користувачі, обмеження прав, логіювання, захист токенів і контроль доступу.; Для кожного документа потрібно описати:

== Як не треба робити ==

 "article": "CHARGER-20W",

* ціни;
* знижки;
* собівартість;
* маржа;
* залишки;
* клієнтська база;
* договори;
* банківські операції;
* податкові документи;
* статуси замовлень.; ],
 <GetStock>
== Web-сервіси і K2 ERP ==
'''Ризик безпеки.''' Web-сервіс [[1С]], відкритий в інтернет без HTTPS, авторизації, журналювання й обмежень доступу, має змогу стати джерелом витоку фінансових, персональних і комерційних даних.; Що робить

 "external_id": "WEB-100245",

'''Найгірший сценарій.''' організація переходить на [[K2 ERP]], але залишає сайт підключеним до старого web-сервісу [[1С]].; інформаційні дані

Приклад відповіді:
== Web-сервіс і API ==
{
== Міграційний приклад API в K2 ERP ==
Web-сервіси [[1С]] можуть працювати з різними форматами.; |}

[[Категорія:1С]]

Потрібно обмежувати навантаження.; |-
| Яка головна помилка?; '''Web-сервіс [[1С]]''' — це програмний інтерфейс, через який зовнішня платформа має змогу звернутися до інформаційної бази [[1С]] через мережу.;== WSDL ==

Потрібно зібрати:

продажі та реалізація;
залишки;
ціни;
замовлення;
статуси;
клієнти;
доставки;
помилки інтеграцій;
активність сервісів.; !; Без версіонування зміни можуть зламати зовнішні системи.;== Помилка: старий сервіс залишили активним ==

</Items>

</syntaxhighlight>

"price": 650.00
"name": "ТОВ замовник",

"currency": "UAH",

зберігати секрети в захищених налаштуваннях;
обмежувати доступ;
періодично змінювати токени;
мати окремий токен для кожної системи;
відкликати токени після міграції;
не писати токени в логи.; {

фактичний залишок;
резерв;
доступний залишок;
залишок по складу;
залишок по характеристиці;
залишок по серії;
залишок на дату.;

Приклад:

Після запуску K2 ERP старий web-сервіс 1С має змогу продовжити приймати запити.; JSON часто застосовують, коли потрібно в HTTP-сервісах.;

Приклад:

Приклад запиту на створення замовлення:

{{DISPLAYTITLE:Web-сервіси 1С}}

* читання JSON;
* читання XML;
* формування відповіді;
* пошук номенклатури;
* створення документа;
* перевірка залишків;
* перевірка прав;
* логіювання;
* обробка помилок;
* виклик зовнішніх API.;<soap:Body>

<syntaxhighlight lang="text">

{| class="wikitable" style="width:100%;"

* API для сайту;
* API для CRM;
* API для WMS;
* API для мобільних застосунків;
* обмін із сервісами доставки;
* обмін із платіжними сервісами;
* передачу даних у BI;
* імпорт довідників;
* імпорт документів;
* експорт залишків;
* експорт цін;
* синхронізацію статусів;
* журналювання інтеграцій.; # Перевірити права доступу.;</soap:Envelope>
 "quantity": 2,
[[Категорія:Безпека]]

 }

 "document_number": "ЗМ-000123"

 "phone": "+380501112233"

* логін і пароль;
* Basic authentication;
* Bearer token;
* API key;
* OAuth;
* IP-фільтрація;
* VPN;
* сертифікати;
* підпис запиту;
* окремий сервісний користувач системи.; !;<div style="border:3px solid #1565c0; background:#e3f2fd; padding:14px; margin:16px 0;">

Приклад URL:

* JSON;
* XML;
* SOAP XML;
* CSV;
* plain text;
* binary files;
* Base64;
* ZIP-архіви.; }
Не варто відкривати зовнішнім системам прямий неконтрольований доступ до регістрів.; Метод

{

* не запитувати всі залишки кожні 10 секунд;
* не передавати весь каталог при кожній зміні;
* не створювати документи без черги;
* не запускати важкі обміни в піковий час;
* використовувати сторінки даних;
* використовувати дату останньої зміни;
* передавати тільки зміни.; | Так.; "code": "PRODUCT_NOT_FOUND",

Приклад запиту:

* приймати інформаційні дані;
* відправляти HTTP-запити;
* формувати JSON;
* формувати XML;
* запускатися за розкладом;
* логіювати помилки;
* створювати документи.; "method": "card",

'''Головне.''' Web-сервіс [[1С]] — це точка обміну даними між 1С та іншою системою.; !;== Формати даних ==

Перед переходом потрібно перевірити всі регламентні задача, пов’язані з web-сервісами.; Було в [[1С]]:
== HTTP-сервіси 1С ==
Content-Type: application/json

[[Категорія:Цифрова незалежність України]]

* дублікати;
* ЄДРПОУ;
* ІПН;
* статус платника ПДВ;
* договори;
* контактні особи;
* адреси;
* зовнішній ID.; |-
| Що перевірити перед міграцією?; Безпека web-сервісів критично важлива.; з цієї причини web-сервіси [[1С]] потрібно розглядати як частину інвентаризації старої інтеграційної архітектури перед переходом на українську [[ERP]]-платформу.;[[Категорія:Модуль 1С]]
[[Категорія:Інтеграція через XML]]
з цієї причини бажано мати версіонування.;== Web-сервіс для цін ==

{
 "updated_at": "2026-05-15T18:10:00"
== Типові сценарії web-сервісів 1С ==

Web-сервіси [[1С]] — це важливий механізм інтеграції старої облікової системи із зовнішніми сервісами.;[[Категорія:SOAP]]
Він має змогу відповідати за:
У [[1С]] під web-сервісами часто мають на увазі два основні підходи:
 ]

== Версіонування web-сервісів ==

 "items": [

Найчастіші проблеми:

* які методи доступні;
* які параметри приймає метод;
* які типи даних використовуються;
* яка структура відповіді;
* де знаходиться сервіс;
* які простори імен використовуються.; # Знайти всі HTTP-сервіси.; {
Навколо [[1С]] часто є собою багато інших систем:
<syntaxhighlight lang="text">
Це означає, що повторний запит не має створювати дублікати.; # Перевірити авторизацію.; |-
| Чи є собою санкційні ризики у [[1С]] і [[BAS]]?;</div>

!; "updated_at": "2026-05-15T18:00:00"
Під час міграції web-сервіси потрібно аналізувати як частину інтеграційної архітектури.;[[Категорія:HTTP]]

}

* помилки авторизації;
* запуск HTTP-сервісів;
* помилки модулів;
* створення документів;
* відмови доступу;
* технічні помилки;
* проблеми з регламентними завданнями.;== HTTP-коди відповіді ==

* повільна відповідь;
* таймаути;
* зависання при великому обсязі;
* блокування документів;
* велика кількість одночасних запитів;
* важкі запити до залишків;
* відсутність кешування.;

},

Що таке Web-сервіс 1С

</syntaxhighlight>

Вебсервер

Контроль після перенесення web-сервісів

Помилка: дублікати документів

Web-сервіси і міграція в K2 ERP

Web-сервіси і BI-аналітика

Web-сервіси і резервна копія

Як правильно працювати з web-сервісами перед міграцією

Висновок

Web-сервіси і XML

Ідемпотентність

Вступ

Сервісні користувачі

Помилка: немає документації

Web-сервіси і регламентні задача

Зовнішні посилання

Web-сервіси і помилки

Web-сервіси і документи

Web-сервіси і тестове середовище

Що таке Web-сервіс 1С