Перейти до вмісту

JSON 1С

Матеріал з K2 ERP Wiki

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

Погано, якщо API повертає без зусиль:

Приклад:

Данные = Новый Структура;

У JSON виступає як два базові типи структур.</syntaxhighlight>

Після завантаження JSON у K2 ERP потрібно звірити:

"article": "USB-C-1M-BLK",
"name": "?????? }

У практиці переходу з на K2 ERP JSON має особливе значення, тому що багато сучасних інтеграцій старої системи вже можуть бути побудовані не через XML або файли CSV, а через JSON і HTTP-запити. CSV

  • вивантаження товарів на сайт;
  • імпорту номенклатури в K2 ERP;
  • синхронізації з CRM;
  • передачі в мобільний каталог;
  • обміну з маркетплейсом. |-

| Чим JSON відрізняється від XML?</syntaxhighlight>

</syntaxhighlight>

]
  • код ;
  • артикул;
  • GUID;
  • штрихкод;
  • зовнішній ID;
  • SKU;
  • комбінація артикул + характеристика;
  • код у сайті;
  • код у K2 ERP.== Контроль після міграції JSON-даних ==

Але для BI краще мати контрольовану модель даних, а не аналізувати хаотичні JSON-файли без валідації. Підхід K2 ERP. Під час переходу з потрібно описати всі JSON-обміни: які системи підключені, які URL використовуються, які структури передаються, які токени застосовуються, які інформаційні дані виступає як джерелом істини та як ці інтеграції мають працювати в K2 ERP. | Мати JSON-обмін без документації, логів, контролю дублікатів і безпечного зберігання токенів. | JSON легший і частіше застосовується для в сучасних API, а XML частіше зустрічається в старих обмінах і формальних документах. "price": 250.50

Для серійного обліку JSON має містити серію або партію. * українські літери відображаються неправильно;

  • замість тексту видно символи `????`;
  • сайт не приймає файл;
  • API повертає помилку;
  • втрачаються лапки або спецсимволи;
  • неправильно обробляються emoji або символи валюти. | Для імпорту, експорту, замовлень, цін, залишків, контрагентів, статусів, оплат, документів і API. USB Type-C"
"currency": "UAH"
"name": "ТОВ клієнт ERP",
== Зовнішні посилання ==
 {
== JSON і CSV ==
Якщо товар має характеристики, їх потрібно передавати явно.

Правильне кодування має бути узгоджене між системами. інформаційні дані </syntaxhighlight>

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

* кома замість крапки;
* число передане як рядок;
* втрата точності;
* різні правила округлення;
* неправильна валюта;
* сума не збігається з рядками.[[Категорія:XML]]

API здатна працювати за схемою:

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

 "warehouse": "Відділення №1"
'''Ризик безпеки.''' Токени, паролі й ключі API не можна зберігати у відкритому коді модулів, у файлах на робочому столі або в незахищених обробках. XML
}
<syntaxhighlight lang="json">
 "unit": "шт",
! JSON часто передається через HTTP.[[Категорія:Запити 1С]]
 "items": [
<syntaxhighlight lang="json">
== JSON і сайт ==
{{DISPLAYTITLE:JSON 1С}}
}
Приклад:
CSV простіший, але менш структурований. ]
Приклад:
Під час міграції потрібно знайти всі JSON-інтеграції старої [[1С]]. ]
Погана практика — зберігати токен прямо в модулі:
{
}

</syntaxhighlight>

Цифрова незалежність. JSON-інтеграції часто з’єднують стару систему з сучасним цифровим середовищем.

Приклад проблеми:
</div>
Приклади:
== JSON і версіонування API ==

== JSON і статуси ==

* тип ціни;
* валюту;
* дату актуальності;
* ПДВ;
* знижки;
* округлення;
* мінімальну ціну;
* акційні ціни. # Перевірити загальні модулі.== Помилка: API повертає не JSON ==

Структура JSON здатна змінюватися. Відповідь

} {

{
"code": "PRODUCT_NOT_FOUND",

</syntaxhighlight> У або K2 ERP потрібно перевірити, чи вже існує документ із таким ID. Аналіз JSON-інтеграцій — це частина підготовки до виходу зі старої ризикової системи. Поле

{

{

JSON і повторні спроби

! K2 ERP у цьому процесі здатна стати новою платформою для контрольованих API, JSON-обмінів, довідників, документів, залишків, цін, статусів, інтеграцій, BI-аналітики, журналювання, прав доступу й подальшого розвитку автоматизації бізнесу без залежності від старої екосистеми . Потрібно визначити:

Зовнішня платформа → HTTP-запит → 1С → JSON-відповідь

  • дату і час;
  • напрям обміну;
  • URL;
  • метод;
  • користувача або сервіс;
  • короткий SEO-опис запиту;
  • код відповіді;
  • результат;
  • помилку;
  • ID документа;
  • зовнішній ID;
  • час виконання.</syntaxhighlight>
  • надходження;
  • переміщення;
  • відвантаження;
  • номенклатуру;
  • штрихкоди;
  • партії;
  • серії;
  • характеристики. інформаційні дані
  1. Знайти всі JSON-інтеграції в . Якщо API тимчасово недоступний, інтеграційні функції ERP здатна повторювати відправку. }

Потрібно мати зовнішній ID: Погані підходи:

Вступ

|- | order_id | Так | Зовнішній номер замовлення |- | date | Так | Дата замовлення |- | customer | Так | інформаційні дані клієнта |- | items | Так | Рядки товарів |- | payment | Ні | здатна прийти пізніше |}

Читання JSON у 1С

Правильний порядок:

"code": "VALIDATION_ERROR",
"external_id": "CRM-5001",
"number": "SO-000123",

}

"quantity": 2,

</syntaxhighlight>

ТекстJSON = ЗаписьJSON.Закрыть();

У модулях можуть використовуватися механізми читання JSON. # Перевірити дублікати. "edrpou": "12345678",

JSON і валюта

{ </syntaxhighlight> { Перед переходом у K2 ERP потрібно перевірити: Сайт здатна передавати в :

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

/api/v2/orders

"active": true

Краще: У довго використовували XML, але JSON став популярним для вебінтеграцій і API.

"paid": true,

Статуси потрібно узгодити між системами. ! "items": [

як приклад, із JSON можна отримати: { Такий JSON здатна використовуватися для:

 },

Мобільний застосунок здатна передавати в [[1С]]:

У JSON числа передаються без лапок:

Для JSON зазвичай потрібно вказувати:

[[Категорія:JSON 1С]]
== JSON і BI-аналітика ==
 "price": 250.00
== Як не треба робити ==
{
 "warehouse": "MAIN",

Бо користувач системи або інтегратор не розуміє, що саме сталося. }
Під час перенесення даних із [[1С]] у [[K2 ERP]] JSON здатна використовуватися як міграційний формат.[[Категорія:Веб-клієнт 1С]]
Токен = "secret-token-123";
{
Данные.Вставить("price", 250);
"document_number": "ЗМ-000123"
"quantity": 1

}

{
"quantity": 120,

}

Приклад JSON для замовлення

JSON здатна використовуватися для:

JSON — це текстовий формат подання структурованих даних. здатна передавати на сайт: У об’єкт JSON часто перетворюється на структуру або відповідність, а масив — на масив або таблицю значень. При інтеграції через JSON потрібно захищатися від дублікатів. # Зібрати зовнішні обробки. # Вимкнути старий JSON-обмін у після переходу. Умовний приклад коду:

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

]

HTTPСоединение = Новый HTTPСоединение("api.example.ua", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL);

Запис JSON у 1С

</syntaxhighlight>

* [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]

 {
 }
 "vat_rate": 20,
 {
 "phone": "+380501112233"
{
== Де JSON застосовується для в 1С ==
{
"quantity": 120

JSON і дати

"products": [

Складська платформа здатна використовувати JSON для обміну. ! # Зібрати приклади JSON-запитів і відповідей. Іноді платформа очікує JSON, але отримує HTML-сторінку помилки. JSON у — це важливий інструмент сучасних інтеграцій. JSON

  • CRM передає нових лідів;
  • CRM передає замовлення;
  • повертає статус оплати;
  • передає заборгованість клієнта;
  • CRM отримує список контрагентів;
  • CRM отримує історію продажів;
  • отримує оновлені контактні інформаційні дані. Обов’язкове

З урахуванням санкційних, юридичних і кібербезпекових ризиків та BAS, аналіз JSON-інтеграцій старої системи має бути частиною ширшої стратегії переходу на українське програмне забезпечення (ПЗ), цифрову незалежність і сучасну ERP-архітектуру. {| class="wikitable" style="width:100%;"

Коротко

{ }

# Описати статуси. {

Приклад обов’язкових полів для замовлення:

}
! | Так. * різні часові пояси;
* дата без часу;
* час без часової зони;
* формат `15.05.2026` замість ISO;
* сайт і [[1С]] по-різному трактують дату;
* замовлення потрапляє не в той день. | Це формат обміну даними між [[1С]] та іншими системами: сайтом, CRM, API, WMS, мобільними застосунками або [[K2 ERP]]. Статус у K2 ERP
</div>
|-
| new
| Нове замовлення
| Нове
|-
| paid
| Оплачено
| Оплачено
|-
| shipped
| Відвантажено
| Відвантажено
|-
| cancelled
| Скасовано
| Скасовано
|}

JSON і числа

"article": "USB-C-1M-BLK",
  • замовлення;
  • продажі та реалізація;
  • залишки;
  • ціни;
  • статуси;
  • клієнтів;
  • доставки;
  • оплати;
  • помилки інтеграцій. Окремі продукти і BAS внесені до відкритих переліків програмного забезпечення, забороненого до використання для окремих категорій організацій. JSON став одним із найпоширеніших форматів обміну даними між системами. Content-Type: application/json

Перед міграцією потрібно перевірити:

JSON і WMS

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

Один із найчастіших сценаріїв — обмін із сайтом або інтернет-магазином. "amount": 1150.00 Варіанти: ЗаписьJSON.УстановитьСтроку();

"code": "000001",

JSON здатна містити:

"order_id": "WEB-100245",
"article": "USB-C-1M-BLK",
  • клієнтів;
  • товари;
  • ціни;
  • залишки;
  • маршрути;
  • задачі;
  • борги клієнтів. # Описати структури даних. Логи мають бути, але без зайвого зберігання чутливих даних.== Міграційний JSON для K2 ERP ==
  • ціна з ПДВ або без ПДВ не визначена;
  • ставка не передана;
  • сума ПДВ не збігається;
  • округлення відрізняється;
  • податкові правила не враховані. },

JSON і документи

Приклади:

"price": 250.50
  • обов’язкові поля;
  • типи даних;
  • формат дати;
  • валюту;
  • кількість;
  • ціну;
  • наявність товару;
  • наявність контрагента;
  • коректність статусу;
  • дублікати;
  • зовнішній ID;
  • права джерела. "unit": "шт",

Не завжди потрібно зберігати повне тіло JSON, особливо якщо там персональні або комерційні інформаційні дані. Данные = ПрочитатьJSON(ЧтениеJSON);

Типові проблеми:

Артикул = Данные.article; { </syntaxhighlight> {

},
"active": true
 {
! ]
 "article": "USB-C-1M-BLK",

{

== JSON і XML ==

== JSON і K2 ERP ==
 "quantity": 100
{
 "customer": {
== JSON і персональні інформаційні дані ==
Джерела:
! # Описати правила зіставлення довідників. Тому JSON-інтеграції [[1С]] варто розглядати як об’єкти інвентаризації перед переходом на українську [[ERP]]-платформу, а не як напрям подальшого розвитку старої системи. Напрям
! }

* API-token;
* Bearer token;
* Basic authentication;
* OAuth;
* ключ у заголовку;
* ключ у параметрі запиту;
* підпис запиту;
* IP-обмеження;
* VPN. Приклад цін:

ЧтениеJSON.УстановитьСтроку(ТекстJSON);

!<syntaxhighlight lang="json">

[[Категорія:Інтеграція з 1С]]

* які системи підключені;
* які URL використовуються;
* які методи HTTP;
* які структури JSON;
* які поля обов’язкові;
* які довідники синхронізуються;
* які документи створюються;
* які статуси передаються;
* які токени використовуються;
* де зберігаються паролі;
* які помилки виникають;
* чи виступає як логи;
* хто відповідальний за інтеграцію. Приклад замовлення з сайту:
Приклад заголовку:

<syntaxhighlight lang="json">

Краще використовувати безпечне сховище налаштувань і обмежити доступ до секретів. Під час міграції потрібно знайти такі інтеграції, описати структури даних, перевірити бізнес-логіку, замінити старі обробки й перенести потрібні сценарії в сучасну API-архітектуру [[K2 ERP]]. Статус сайту
== Приклад JSON для номенклатури ==
== Висновок ==

! Різниця

Можливі ключі:

CRM здатна обмінюватися з [[1С]] через JSON. Такий JSON можна відправити сайту, CRM або іншій системі. Якщо валюта не передана, платформа здатна помилково трактувати суму. це використання формату [[JSON]] у системі [[1С]]; так само реалізовано інтернет-магазинами.[[Категорія:JSON]]

* 404 Not Found;
* 500 Internal Server Error;
* сторінка авторизації;
* HTML із проксі;
* повідомлення WAF. Приклад товару:
<syntaxhighlight lang="json">

 "barcode": "4820000000012",

компанія-користувач повинна:
Приклад контрагента:
}

== JSON і цифрова незалежність ==

 "date": "2026-06-01",

Потрібно перевірити:

}
як приклад, сайт здатна повторно відправити те саме замовлення. # Перевірити помилки. |}

Приклад JSON:

'''JSON у [[1С]]'''  це використання формату JSON у коді, обробках, модулях, інтеграціях, API, обмінах або міграційних сценаріях. "external_id": "SITE-10001",

== Помилка: неправильний Content-Type ==
 "quantity": 2,
 "updated_at": "2026-05-15T18:10:00"
! "date": "2026-05-15",
== JSON і ціни ==
}
[[Категорія:Інтеграція через XML]]
 "field": "customer.edrpou"
<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">

</syntaxhighlight>

  • складський облік;
  • дату зрізу;
  • одиницю виміру;
  • резерви;
  • доступний залишок;
  • фактичний залишок;
  • характеристику;
  • серію;
  • партію. # Провести тестову інтеграцію. {| class="wikitable" style="width:100%;"
"active": true
Окремо варто відзначити [[CRM]], [[ERP]], [[WMS]], мобільними застосунками, банками, сервісами доставки, маркетплейсами, зовнішніми [[API]], мікросервісами і іншими інформаційними системами виступає ключовою рисою обміну даними з сайтами забезпечується через '''JSON 1С'''. "external_id": "1C-000001",
як приклад:

 "quantity": 1,

 "tracking_number": "20450000000000",
 "vat_amount": 200.00,
Типові проблеми:
<syntaxhighlight lang="json">

== JSON і характеристики ==

 "series": "LOT-2026-05",

Витік JSON-файлу здатна бути таким самим небезпечним, як витік бази або звіту. Окремі продукти [[1С]] і [[BAS]] внесені до переліків забороненого програмного забезпечення для окремих категорій організацій в Україні. JSON-інтеграції часто використовують авторизацію. У K2 ERP
== JSON і дублікати ==
}
Количество = Данные.quantity;

}

"vat_rate": 20,

} </syntaxhighlight> ЧтениеJSON = Новый ЧтениеJSON; Приклад логіки:

- Що критично перевірити? Приклад залишків:
"error": {

</syntaxhighlight>

"warehouse": "MAIN",
"order_id": "WEB-100245"

Тому бажано мати версію API. # Перевірити HTTP-сервіси. |-

Для чого застосовується для JSON?== JSON і валідація ==
"article": "USB-C-1M-BLK",
"date": "2026-05-15T14:30:00",

Для валютних даних потрібно передавати не тільки суму, а й валюту. "datetime": "2026-05-15T14:30:00"

Ответ = HTTPСоединение.ОтправитьДляОбработки(ЗапросHTTP);

"edrpou": "12345678",
"name": "Кабель USB Type-C 1 м",
"characteristics": {

Приклад відповіді API: Content-Type: application/json Authorization: Bearer eyJhbGciOi... Приклад залишків:

JSON і ПДВ

  • контрагента;
  • замовлення покупця;
  • резерв товарів;
  • рахунок;
  • доставку;
  • оплату;
  • службове повідомлення менеджеру. "stock_balances": [

Правильний підхід. JSON у потрібно розглядати не як набір випадкових файлів або запитів, а як частину інтеграційної архітектури бізнесу, яку потрібно описати, захистити, протестувати й перенести в K2 ERP. # Визначити джерело істини. "amount": 1500.00,

"price": 250.00,
"article": "CHARGER-20W",
  • ПІБ;
  • телефон;
  • email;
  • адресу;
  • ІПН;
  • паспортні інформаційні дані;
  • зарплатні інформаційні дані;
  • кадрові інформаційні дані;
  • банківські реквізити. Головне. JSON у — це зручний формат для сучасного обміну даними: сайт передає замовлення, віддає залишки, CRM отримує клієнтів, мобільний застосунок передає заявки, а API функціонує через структуровані об’єкти. # Знайти токени й секрети. "name": "Кабель USB Type-C 1 м чорний"

У JSON часто з’являється там, де стара база інтегрується із сучаснішими системами. {

ЗапросHTTP.Заголовки.Вставить("Content-Type", "application/json");

як приклад, передає в WMS:

]
}

{ як приклад: Такий код здатна використовуватися для отримання товару або рядка замовлення. Формат Інтеграції часто обмінюються статусами. |-

Чи можна використовувати JSON для міграції в K2 ERP? # Перевірити логи. JSON зручний тим, що його швидко читати людині й швидко опрацьовувати програмам. # Визначити, що переноситься в K2 ERP. }
  • замовлення;
  • клієнтів;
  • оплати;
  • доставки;
  • коментарі;
  • промокоди;
  • повернення;
  • статуси. "price": 1200.00,
"date": "2026-05-15",

{

Приклад:

"category": "Кабелі",
"order_id": "WEB-100245"
Формат Легший і коротший Більш формальний і розмічений тегами
Популярність у API Дуже висока Менша в сучасних веб-API
Читабельність Зручний для структур даних Зручний для документів із тегами
Обсяг Зазвичай менший Часто більший
Використання в 1С API, сайти, мобільні застосунки Обмін, податкові формати, старі інтеграції
"name": "Кабель USB Type-C 1 м чорний",

критично про 1С і BAS. та частина продуктів BAS мають санкційні, юридичні й кібербезпекові ризики в Україні. "unit_cost": 100.00

"article": "USB-C-1M-BLK",
  • сайт передає в замовлення;
  • вивантажує на сайт товари, ціни й залишки;
  • CRM отримує контрагентів;
  • мобільний застосунок передає заявки;
  • складська платформа отримує переміщення;
  • зовнішній сервіс повертає статус доставки;
  • K2 ERP приймає інформаційні дані зі старої під час міграції. JSON здатна бути зручним форматом для передачі довідників, документів, залишків, цін і статусів. інтеграційні функції ERP
"article": "CHARGER-20W",
"city": "Київ",

</syntaxhighlight>

  • імпорту даних у ;
  • експорту даних із ;
  • інтеграції з сайтом;
  • інтеграції з CRM;
  • інтеграції з мобільним застосунком;
  • інтеграції з WMS;
  • інтеграції з API;
  • обміну статусами;
  • передачі замовлень;
  • передачі оплат;
  • передачі залишків;
  • передачі цін;
  • міграції даних у K2 ERP;
  • інтеграції з BI.== Що перевірити в JSON-інтеграціях ==

Данные.Вставить("name", "Кабель USB Type-C 1 м");

Структура підтримує вкладені об’єкти й масиви Табличний формат
Замовлення з товарами інтуїтивно Потрібні кілька таблиць або складні правила
Простий прайс Можна, але іноді надлишково Дуже інтуїтивно
API Часто застосовується для Рідше

JSON і кодування UTF-8

  • обмін із сайтом;
  • обмін із CRM;
  • обмін із WMS;
  • обмін із мобільним застосунком;
  • передача замовлень;
  • передача статусів;
  • передача оплат;
  • передача залишків;
  • передача цін;
  • інтеграційні функції ERP з маркетплейсами;
  • інтеграційні функції ERP з сервісами доставки;
  • інтеграційні функції ERP з платіжними системами;
  • API для зовнішніх систем;
  • експорт у BI;
  • міграція в K2 ERP.
    <syntaxhighlight lang="json">
     "service": "Нова пошта",
     "article": "CHARGER-20W",
     }
    Без характеристик залишки або ціни можуть потрапити не на той варіант товару.<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">
    
    * ідемпотентність;
    * зовнішній ID;
    * статус обробки;
    * лог помилок;
    * повторні спроби;
    * захист від дублювання;
    * повідомлення відповідальному. Він складається з об’єктів, масивів, рядків, чисел, логічних значень і порожніх значень. JSON часто застосовують, коли потрібно для імпорту й експорту номенклатури, цін, залишків, замовлень, контрагентів, оплат, статусів, документів, довідників, аналітики та службових повідомлень. "customer_id": "CRM-5001",
    <div style="border:3px solid #1565c0; background:#e3f2fd; padding:14px; margin:16px 0;">
     "name": "ТОВ клієнт ERP",
    
    == JSON і API ==
    
     "payment": {
    
    * кількість записів;
    * обов’язкові поля;
    * дублікати;
    * довідники;
    * документи;
    * залишки;
    * ціни;
    * суми;
    * валюти;
    * статуси;
    * помилки імпорту;
    * логи;
    * контрольні звіти. Типові проблеми:
    Погано:
    ТекстJSON = "{""article"":""USB-C-1M-BLK"",""quantity"":2}";
     "article": "USB-C-1M-BLK",
    </div>
    ЗапросHTTP.УстановитьТелоИзСтроки(ТекстJSON, КодировкаТекста.UTF8);
    
    <div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">
    
    [
    
     "price": "250,50"
    
     }
    
     "success": false,
    }

JSON і номенклатура

{ {

}

У [[1С]] такий JSON здатна створити:

* фармацевтики;
* харчових продуктів;
* гарантійного обліку;
* виробництва;
* партійного обліку;
* простежуваності. # Реалізувати нові API або обміни в [[K2 ERP]].== Помилка: секрети в коді ==

Приклад:

* знайти всі JSON-обміни;
* описати структури;
* зібрати приклади запитів і відповідей;
* перевірити токени;
* перевірити логи;
* перевірити дублікати;
* перевірити статуси;
* перевірити персональні й комерційні інформаційні дані;
* перенести потрібні інтеграції в [[K2 ERP]];
* вимкнути старі обміни в [[1С]] після запуску нової системи.[[Категорія:Журнал реєстрації 1С]]
Приклад:
 "vat_number": "123456789012",
API має повертати зрозумілі помилки. | Кодування, дати, числа, обов’язкові поля, дублікати, токени, логи, помилки, статуси й структуру даних. Тому JSON-логи, файли й запити потрібно захищати. {

== Типові помилки JSON у 1С ==
== JSON і комерційна інформаційні матеріали ==
JSON-обміни потрібно логіювати. * сайти;
* інтернет-магазини;
* мобільні застосунки;
* CRM-системи;
* ERP-системи;
* WMS;
* маркетплейси;
* сервіси доставки;
* платіжні сервіси;
* банківські сервіси;
* зовнішні API;
* BI-системи;
* мікросервіси.<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">

== JSON і залишки ==
Приклад:
 "error": {
'''Об’єкт''' — набір полів:
{| class="wikitable" style="width:100%;"
 "expiry_date": "2027-05-31",
Його використовують:
! рішення для бізнесу в K2 ERP
{
 "price": 250.00
}

Або в URL:

Для номенклатури потрібно визначити ключ зіставлення. Коментар

 "article": "CHARGER-20W",
Дати в JSON потрібно передавати в узгодженому форматі.<syntaxhighlight lang="text">

JSON здатна містити персональні інформаційні дані:

  • API;
  • обміну із сайтом;
  • обміну з CRM;
  • обміну з WMS;
  • обміну з мобільними застосунками;
  • обміну з BI;
  • інтеграції з сервісами доставки;
  • інтеграції з платіжними сервісами;
  • імпорту даних;
  • експорту даних;
  • міграції історії;
  • обміну статусами. {

}

"status": "shipped",

Тому потрібно перевіряти HTTP-код відповіді й тип вмісту. | Так.</syntaxhighlight>

Об’єкт і масив у JSON

  • ціни;
  • знижки;
  • собівартість;
  • маржу;
  • залишки;
  • договори;
  • клієнтів;
  • умови постачання;
  • банківські операції. "email": "client@example.ua"

/api/v1/orders Або помилка:

JSON і мобільні застосунки

}

JSON і авторизація

  • дублікати;
  • ЄДРПОУ;
  • ІПН;
  • контакти;
  • договори;
  • юридичні адреси;
  • фактичні адреси;
  • статус платника ПДВ. Ознака

|- | Товари | 12 500 | 12 500 | 0 |- | Ціни | 25 000 | 25 000 | 0 |- | Залишки | 8 700 | 8 700 | 0 |- | Замовлення | 1 200 | 1 200 | 0 |}

Якщо цього немає, сервер здатна не зрозуміти запит. Питання

JSON і міграція з 1С у K2 ERP

JSON і логіювання

"currency": "UAH",
"order_id": "WEB-100245",
{

Потрібно передбачити: } } здатна передавати в мобільний застосунок: Простими словами. JSON у — це спосіб передати інформаційні дані між 1С та іншою системою у вигляді зрозумілого текстового об’єкта. |- | Чи виступає як санкційні ризики у і BAS? Умовний приклад формування JSON:

"items": [
}

Бажано фіксувати: Потрібно чітко визначити:

"api_version": "1.0",

ЗапросHTTP = Новый HTTPЗапрос("/orders");

"document_type": "sales_order",

{

"article": "MED-001",

</syntaxhighlight> JSON у здатна використовуватися в таких сценаріях:

"edrpou": "12345678"

}

  • тип документа;
  • дату;
  • номер;
  • контрагента;
  • складський облік;
  • валюту;
  • рядки;
  • ПДВ;
  • статус;
  • оплату;
  • доставку. "error": "Error"

</syntaxhighlight>

<syntaxhighlight lang="text">

JSON здатна бути джерелом для [[BI]], але перед аналізом інформаційні дані потрібно нормалізувати. # Перевірити контрольні звірки. * фактичне приймання;
* фактичне відвантаження;
* інвентаризацію;
* статуси коміркування;
* залишки;
* помилки розбіжностей. Ознака

* неправильне кодування;
* неправильний формат дати;
* кома замість крапки в числах;
* відсутні обов’язкові поля;
* неправильна структура масиву;
* товар не знайдений;
* контрагент не знайдений;
* дублюється замовлення;
* токен прострочений;
* неправильний Content-Type;
* API недоступний;
* таймаут;
* помилка SSL;
* сервер повертає HTML замість JSON;
* у коді не обробляються помилки;
* JSON зберігається в логах із персональними даними. Під час переходу критично перенести ці зв’язки в [[K2 ERP]], а не залишити стару [[1С]] прихованим центром обміну. Потрібно визначити:

* загальні модулі;
* модулі обробок;
* зовнішні обробки;
* регламентні задача;
* модулі форм;
* файли обміну;
* HTTP-сервіси;
* вебсервіси;
* конфігурація обміну;
* журнал реєстрації;
* документація інтеграцій. "message": "Не заповнено поле customer.edrpou",

 "name": "ТОВ клієнт ERP",

Він здатна використовуватися для:

Для податкових даних потрібно чітко описувати ПДВ. |-
| Яка головна помилка?<syntaxhighlight lang="json">

 "quantity": 45

* товари;
* групи товарів;
* характеристики;
* серії;
* ціни;
* знижки;
* залишки;
* зображення;
* статуси замовлень.== Таблиця інвентаризації JSON-обмінів ==
<syntaxhighlight lang="json">
|-
| Що таке JSON у [[1С]]? Данные.Вставить("article", "USB-C-1M-BLK");
! Під час переходу на [[K2 ERP]] JSON-інтеграції потрібно аналізувати дуже уважно. Якщо JSON-обмін не логіюється, важко зрозуміти:

'''Масив''' — список елементів:

[[Категорія:Безпека]]
 "date": "2026-05-15T18:00:00",
[[Категорія:API]]
"price": 650.00
"name": "Кабель USB Type-C 1 м чорний",
},

Помилка: немає логів

Документ у JSON зазвичай має заголовок і рядки.== Що таке JSON == }

"items": [

}

Найгірший сценарій. компанія-користувач має JSON-обмін між сайтом і , але немає документації, токени збережені в коді, помилки не логіюються, дублікати не контролюються, а після переходу на K2 ERP ніхто не знає, які поля й статуси потрібно перенести. # Перевірити регламентні задача.== JSON і контрагенти ==

Найчастіші помилки:

* чи був запит;
* що саме відправили;
* що відповів сервер;
* чому документ не створився;
* чому товар не оновився;
* чому замовлення задублювалося. "color": "black",

 "date": "2026-05-15",
 "quantity": 2
<syntaxhighlight lang="json">

Типові проблеми:

[[Категорія:Модуль 1С]]

 "price_type": "retail",

* робити JSON-обмін без опису структури;
* не перевіряти обов’язкові поля;
* не логіювати помилки;
* зберігати токени в коді;
* не захищати API;
* передавати персональні інформаційні дані без контролю;
* не перевіряти дублікати;
* не мати зовнішніх ID;
* не опрацьовувати таймаути;
* не документувати інтеграцію;
* залишати стару [[1С]] головним джерелом JSON-обміну після запуску [[K2 ERP]]. Він застосовується для для обміну із сайтами, CRM, WMS, мобільними застосунками, API, платіжними сервісами, сервісами доставки, BI-системами та іншими рішеннями. "success": false,

<syntaxhighlight lang="json">

 ],
[[Категорія:Міграція з 1С]]
Це критично для:

ЗаписьJSON = Новый ЗаписьJSON;

JSON часто застосовується для в [[API]]. Перед міграцією такі секрети потрібно знайти й замінити безпечним механізмом зберігання. JSON

== Що таке JSON у 1С ==

Приклад номенклатури:
 "phone": "+380501112233",

Приклад:

 {

 {

<syntaxhighlight lang="json">

== JSON і HTTP-запити ==
<syntaxhighlight lang="json">

Найчастіше застосовується для UTF-8. У реальних проєктах потрібно враховувати авторизацію, помилки, таймаути, повторні спроби та логіювання. Для JSON важливе кодування.<syntaxhighlight lang="json">

 "method": "card",
!<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">

* замовлення торгового представника;
* заявки сервісного інженера;
* фото;
* координати;
* статуси виконання;
* оплату;
* підпис клієнта;
* коментарі.[[Категорія:Імпорт даних]]

Потрібно:

{{SEO
|title=JSON 1С  імпорт, експорт, API, обмін із сайтом, інтеграції та міграція в K2 ERP
|description=JSON 1С: що це таке, як використовується JSON у 1С для імпорту, експорту, API, обміну з сайтом, CRM, банком, WMS, мобільними додатками, приклади JSON-структур, типові помилки, безпека і перенесення інтеграцій з 1С у K2 ERP.
|keywords=JSON 1С, JSON в 1С, імпорт JSON 1С, експорт JSON 1С, API 1С JSON, обмін JSON 1С, інтеграція 1С JSON, сайт 1С JSON, CRM 1С JSON, 1С HTTP JSON, ЧтениеJSON 1С, ЗаписьJSON 1С, міграція з 1С, інтеграція з 1С, заміна 1С, K2 ERP, українська ERP, санкції 1С, санкції BAS, цифрова незалежність
|image=https://erp.kyiv.ua
}}

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

 },

! У 1С

 "article": "TSHIRT",

</div>

Перед обробкою JSON потрібно перевіряти його структуру. У [[K2 ERP]] JSON здатна бути основним форматом сучасних інтеграцій.== JSON і CRM ==

Приклад:

WMS повертає: }

JSON і помилки

|- | Сайт | 1С → сайт | Товари, ціни, залишки | JSON API | Замінити API K2 ERP |- | Сайт | сайт → 1С | Замовлення, оплати, доставки | JSON API | Приймати в K2 ERP |- | CRM | CRM → 1С | Клієнти, ліди, угоди | JSON | Інтегрувати CRM з K2 ERP |- | WMS | 1С ↔ WMS | Складські операції | JSON | Перепроєктувати складський обмін |- | Мобільний застосунок | застосунок → 1С | Заявки, замовлення, статуси | JSON | Підключити до API K2 ERP |}

"quantity": 2,

{

"price": 650.00

</syntaxhighlight> Це оптимізує уникнути поломок при зміні формату. { }

"price": 250.00

ЗаписатьJSON(ЗаписьJSON, Данные); Приклад:

 "delivery": {
 },
<syntaxhighlight lang="json">
[[Категорія:Інтеграція через файли]]
 "size": "M"
== Див. так само ==
{| class="wikitable" style="width:100%;"

<syntaxhighlight lang="json"> <syntaxhighlight lang="text">

JSON і серії

"warehouse": "MAIN",