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

JSON 1С

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

"success": true,

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

"expiry_date": "2027-05-31",

Документ у JSON зазвичай має заголовок і рядки.; "external_id": "SITE-10001", 

}

Під час переходу на K2 ERP JSON-інтеграції потрібно аналізувати дуже уважно.; Перед міграцією такі секрети потрібно знайти й замінити безпечним механізмом зберігання.; "price": 250.00

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

JSON і контрагенти

  • ПІБ;
  • телефон;
  • email;
  • адресу;
  • ІПН;
  • паспортні інформаційні дані;
  • зарплатні інформаційні дані;
  • кадрові інформаційні дані;
  • банківські реквізити.; |-

| Що істотно перевірити?; CSV Умовний приклад формування JSON:

}

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

Найчастіше застосовується UTF-8.; | JSON легший і частіше застосовується в сучасних API, а XML частіше зустрічається в старих обмінах і формальних документах.;</syntaxhighlight>

{ 

"date": "2026-05-15",

Найгірший сценарій. організація має JSON-обмін між сайтом і 1С, але немає документації, токени збережені в коді, помилки не логіюються, дублікати не контролюються, а після переходу на K2 ERP ніхто не знає, які поля й статуси потрібно перенести.; WMS повертає: Це істотно для:

JSON і документи

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

JSON часто застосовується в API.;

== Читання JSON у 1С ==
API має змогу працювати за схемою:
== Як не треба робити ==
 "items": [
як ілюстрація:
/api/v2/orders
 "vat_rate": 20,
<syntaxhighlight lang="json">

Де JSON застосовується в 1С

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

!; }

Його використовують:

</syntaxhighlight> { 

"tracking_number": "20450000000000",

} 

== Вступ ==
{
</div>
 "quantity": 1
Або помилка:
 "article": "USB-C-1M-BLK",
Для JSON зазвичай потрібно вказувати:
Приклад залишків:
Приклад замовлення з сайту:
 "customer_id": "CRM-5001",
Потрібно передбачити:

У практиці переходу з [[1С]] на [[K2 ERP]] JSON має особливе значення, з цієї причини що багато сучасних інтеграцій старої системи вже можуть бути побудовані не через [[XML]] або файли [[CSV]], а через JSON і HTTP-запити.; * неправильне кодування;
* неправильний формат дати;
* кома замість крапки в числах;
* відсутні обов’язкові поля;
* неправильна структура масиву;
* товар не знайдений;
* контрагент не знайдений;
* дублюється замовлення;
* токен прострочений;
* неправильний Content-Type;
* API недоступний;
* таймаут;
* помилка SSL;
* сервер повертає HTML замість JSON;
* у коді не обробляються помилки;
* JSON зберігається в логах із персональними даними.;<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">
Можливі ключі:

ЧтениеJSON = Новый ЧтениеJSON;

{{DISPLAYTITLE:JSON 1С}}
ЗапросHTTP.Заголовки.Вставить("Content-Type", "application/json");
 },
Якщо товар має характеристики, їх потрібно передавати явно.; Статус у 1С

<syntaxhighlight lang="text">

 "warehouse": "MAIN",

}

}

* API-token;
* Bearer token;
* Basic authentication;
* OAuth;
* ключ у заголовку;
* ключ у параметрі запиту;
* підпис запиту;
* IP-обмеження;
* VPN.; інформаційні дані
<syntaxhighlight lang="json">

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

* тип ціни;
* валюту;
* дату актуальності;
* ПДВ;
* знижки;
* округлення;
* мінімальну ціну;
* акційні ціни.;[[Категорія:Імпорт даних]]
 "message": "Не заповнено поле customer.edrpou",
 "name": "Кабель USB Type-C 1 м чорний",
<syntaxhighlight lang="json">
 }
[[Категорія:BI]]
 },
 "vat_amount": 200.00,
Приклад:
<syntaxhighlight lang="json">
JSON часто передається через HTTP.; }

* клієнтів;
* товари;
* ціни;
* залишки;
* маршрути;
* задачі;
* борги клієнтів.; {

 "updated_at": "2026-05-15T18:10:00"

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

Краще використовувати безпечне сховище налаштувань і обмежити доступ до секретів.; HTTPСоединение = Новый HTTPСоединение("api.example.ua", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL);
Приклади:
{
[[Категорія:Міграція з BAS]]
Данные.Вставить("name", "Кабель USB Type-C 1 м");
{

<syntaxhighlight lang="json">

* ціна з ПДВ або без ПДВ не визначена;
* ставка не передана;
* сума ПДВ не збігається;
* округлення відрізняється;
* податкові правила не враховані.; {| class="wikitable" style="width:100%;"
}

'''істотно про 1С і BAS.''' [[1С]] та частина продуктів [[BAS]] мають санкційні, юридичні й кібербезпекові ризики в Україні.; Він складається з об’єктів, масивів, рядків, чисел, логічних значень і порожніх значень.; Такий JSON можна відправити сайту, CRM або іншій системі.; "price": 250.50

"article": "CHARGER-20W",

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

Висновок

Коротко

"currency": "UAH"
"error": "Error"

Приклад товару:
 "unit": "шт",
 "name": "Кабель USB Type-C 1 м чорний"

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

Такий JSON має змогу використовуватися для:
Приклад номенклатури:
 "phone": "+380501112233",
 }
 "price": 650.00
 "vat_number": "123456789012",

з цієї причини бажано мати версію API.; Приклад:

JSON у 1С має змогу використовуватися в таких сценаріях: 

"field": "customer.edrpou"
  • CRM передає нових лідів;
  • CRM передає замовлення;
  • 1С повертає статус оплати;
  • 1С передає заборгованість клієнта;
  • CRM отримує список контрагентів;
  • CRM отримує історію продажів;
  • 1С отримує оновлені контактні інформаційні дані.; | Так.;
    <syntaxhighlight lang="text">
[[Категорія:JSON 1С]]
== JSON і дати ==
}
{

 "order_id": "WEB-100245",

<syntaxhighlight lang="json">

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

 "category": "Кабелі",

== Помилка: секрети в коді ==
[[Категорія:Цифрова незалежність України]]
 "items": [
{
 "amount": 1500.00,
 "date": "2026-05-15T18:00:00",

Приклад проблеми:

* різні часові пояси;
* дата без часу;
* час без часової зони;
* формат `15.05.2026` замість ISO;
* сайт і [[1С]] по-різному трактують дату;
* замовлення потрапляє не в той день.; # Зібрати зовнішні обробки.; інформаційні дані
!;</div>
}

"price": 650.00

1С має змогу передавати на сайт: 

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

"warehouse": "Відділення №1"

</syntaxhighlight>

</syntaxhighlight> 

[[Категорія:K2 ERP]]
 ]
Приклад відповіді API:
 {
У [[1С]] об’єкт JSON часто перетворюється на структуру або відповідність, а масив — на масив або таблицю значень.; {

== Що перевірити в JSON-інтеграціях ==

ЗапросHTTP.УстановитьТелоИзСтроки(ТекстJSON, КодировкаТекста.UTF8);

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

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

* загальні модулі;
* модулі обробок;
* зовнішні обробки;
* регламентні задача;
* модулі форм;
* файли обміну;
* HTTP-сервіси;
* вебсервіси;
* конфігурація обміну;
* журнал реєстрації;
* документація інтеграцій.;== JSON і повторні спроби ==
Перед обробкою JSON потрібно перевіряти його структуру.; # Визначити, що переноситься в [[K2 ERP]].; Формат

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

 "article": "USB-C-1M-BLK",
!; "items": [

!; "email": "client@example.ua"

},

</syntaxhighlight> ЧтениеJSON.УстановитьСтроку(ТекстJSON); Погана практика — зберігати токен прямо в модулі: |- | Товари | 12 500 | 12 500 | 0 |- | Ціни | 25 000 | 25 000 | 0 |- | Залишки | 8 700 | 8 700 | 0 |- | Замовлення | 1 200 | 1 200 | 0 |}

</syntaxhighlight>

Authorization: Bearer eyJhbGciOi...; "document_type": "sales_order",

  • фармацевтики;
  • харчових продуктів;
  • гарантійного обліку;
  • виробництва;
  • партійного обліку;
  • простежуваності.; Він застосовується для обміну із сайтами, CRM, WMS, мобільними застосунками, API, платіжними сервісами, сервісами доставки, BI-системами та іншими рішеннями.; |-

| Чи є собою санкційні ризики у 1С і BAS?; JSON } }

</syntaxhighlight> 

}

JSON має змогу бути джерелом для BI, але перед аналізом інформаційні дані потрібно нормалізувати.; У 1С або K2 ERP потрібно перевірити, чи вже існує документ із таким ID.; "series": "LOT-2026-05", K2 ERP у цьому процесі має змогу стати новою платформою для контрольованих API, JSON-обмінів, довідників, документів, залишків, цін, статусів, інтеграцій, BI-аналітики, журналювання, прав доступу й подальшого розвитку автоматизації бізнесу без залежності від старої екосистеми 1С.;</syntaxhighlight>

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

],

"article": "TSHIRT",
  • ідемпотентність;
  • зовнішній ID;
  • статус обробки;
  • лог помилок;
  • повторні спроби;
  • захист від дублювання;
  • повідомлення відповідальному.; | Для імпорту, експорту, замовлень, цін, залишків, контрагентів, статусів, оплат, документів і API.;
    * фактичне приймання;
* фактичне відвантаження;
* інвентаризацію;
* статуси коміркування;
* залишки;
* помилки розбіжностей.;== JSON і BI-аналітика ==
  • робити JSON-обмін без опису структури;
  • не перевіряти обов’язкові поля;
  • не логіювати помилки;
  • зберігати токени в коді;
  • не захищати API;
  • передавати персональні інформаційні дані без контролю;
  • не перевіряти дублікати;
  • не мати зовнішніх ID;
  • не обробляти таймаути;
  • не документувати інтеграцію;
  • залишати стару 1С головним джерелом JSON-обміну після запуску K2 ERP.; |-

| Чи можна використовувати JSON для міграції в K2 ERP?; "external_id": "1C-000001", 

"price": 250.50

Приклад JSON: Цифрова незалежність. JSON-інтеграції 1С часто з’єднують стару систему з сучасним цифровим середовищем.; |} 

{{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
}}

 "price": "250,50"

Без характеристик залишки або ціни можуть потрапити не на той варіант товару.;== JSON і помилки ==
Окремо варто відзначити [[CRM]], [[ERP]], [[WMS]], мобільними застосунками, банками, сервісами доставки, маркетплейсами, зовнішніми [[API]], мікросервісами і іншими інформаційними системами виступає ключовою рисою обміну даними з сайтами забезпечується через '''JSON 1С'''.; Найчастіші помилки:

<syntaxhighlight lang="json">

* кома замість крапки;
* число передане як рядок;
* втрата точності;
* різні правила округлення;
* неправильна валюта;
* сума не збігається з рядками.;== JSON і дублікати ==

 "api_version": "1.0",

CSV простіший, але менш структурований.; !; {
 "barcode": "4820000000012",
з цієї причини потрібно перевіряти HTTP-код відповіді й тип вмісту.; ТекстJSON = "{""article"":""USB-C-1M-BLK"",""quantity"":2}";
Данные = ПрочитатьJSON(ЧтениеJSON);

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

Варіанти:

Приклад:

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

== Приклад JSON для номенклатури ==
 "success": false,
 }
 "unit_cost": 100.00
[[Категорія:Журнал реєстрації 1С]]
<syntaxhighlight lang="json">
[[Категорія:Модуль 1С]]
Під час міграції потрібно знайти всі JSON-інтеграції старої [[1С]].;== JSON і CRM ==
[[Категорія:JSON]]

JSON і залишки

JSON став одним із найпоширеніших форматів обміну даними між системами.;</syntaxhighlight> |- | Формат | Легший і коротший | Більш формальний і розмічений тегами |- | Популярність у API | Дуже висока | Менша в сучасних веб-API |- | Читабельність | Зручний для структур даних | Зручний для документів із тегами |- | Обсяг | Зазвичай менший | Часто більший |- | Використання в 1С | API, сайти, мобільні застосунки | Обмін, податкові формати, старі інтеграції |}

JSON і версіонування API

"quantity": 2,

"quantity": 120,

Масив — список елементів: Витік JSON-файлу має змогу бути таким самим небезпечним, як витік бази або звіту.; XML 

"paid": true,

Типові проблеми: } Для валютних даних потрібно передавати не тільки суму, а й валюту.; Приклад: 

{

Під час перенесення даних із 1С у K2 ERP JSON має змогу використовуватися як міграційний формат.;</syntaxhighlight> 

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

1С має змогу передавати в мобільний застосунок:

JSON і сайт

}

Якщо цього немає, сервер має змогу не зрозуміти запит.; "quantity": 45

{ 

"code": "PRODUCT_NOT_FOUND",
"success": false,

}

Головне. JSON у 1С — це зручний формат для сучасного обміну даними: сайт передає замовлення, 1С віддає залишки, CRM отримує клієнтів, мобільний застосунок передає заявки, а API функціонує через структуровані об’єкти.; # Знайти токени й секрети.; Під час переходу істотно перенести ці зв’язки в K2 ERP, а не залишити стару 1С прихованим центром обміну.; "edrpou": "12345678" 

"price": 250.00

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

JSON і K2 ERP

"quantity": 2,

Типові проблеми: з цієї причини JSON-логи, файли й запити потрібно захищати.;

як ілюстрація, сайт має змогу повторно відправити те саме замовлення.; # Вимкнути старий JSON-обмін у 1С після переходу.; "name": "??????; Поле 

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

Іноді платформа очікує JSON, але отримує HTML-сторінку помилки.; | Це формат обміну даними між 1С та іншими системами: сайтом, CRM, API, WMS, мобільними застосунками або K2 ERP.; * складський облік;

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

{ 

{

Для податкових даних потрібно чітко описувати ПДВ.; 

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

} 

"quantity": 1,

ЗаписатьJSON(ЗаписьJSON, Данные); 

 "number": "SO-000123",

[[Категорія:Режим підприємства 1С]]

* українські літери відображаються неправильно;
* замість тексту видно символи `????`;
* сайт не приймає файл;
* API повертає помилку;
* втрачаються лапки або спецсимволи;
* неправильно обробляються emoji або символи валюти.; API має повертати зрозумілі помилки.; Напрям

Для серійного обліку JSON має містити серію або партію.; # Описати структури даних.; з цієї причини JSON-інтеграції [[1С]] варто розглядати як об’єкти інвентаризації перед переходом на українську [[ERP]]-платформу, а не як напрям подальшого розвитку старої системи.;<syntaxhighlight lang="json">
 "active": true
Потрібно перевірити:
__TOC__
== JSON і валюта ==
'''Об’єкт''' — набір полів:
== JSON і CSV ==
<syntaxhighlight lang="json">

Приклад:

<syntaxhighlight lang="json">

"quantity": 120

JSON у 1С — це важливий інструмент сучасних інтеграцій.; # Описати статуси.;</syntaxhighlight> 

{
"date": "2026-05-15",

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

{

  • дублікати;
  • ЄДРПОУ;
  • ІПН;
  • контакти;
  • договори;
  • юридичні адреси;
  • фактичні адреси;
  • статус платника ПДВ.; CRM має змогу обмінюватися з 1С через JSON.;</syntaxhighlight>

/api/v1/orders

{

  • код 1С;
  • артикул;
  • GUID;
  • штрихкод;
  • зовнішній ID;
  • SKU;
  • комбінація артикул + характеристика;
  • код у сайті;
  • код у K2 ERP.; "active": true
 "phone": "+380501112233"

[[Категорія:Права доступу]]

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

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

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

Краще:

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

!; Або в URL:

JSON і ПДВ

"color": "black",

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

Content-Type: application/json

ЗаписьJSON.УстановитьСтроку();

Content-Type: application/json

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

{ У JSON є собою два базові типи структур.; Один із найчастіших сценаріїв — обмін із сайтом або інтернет-магазином.; } Данные.Вставить("price", 250); як ілюстрація, 1С передає в WMS: "active": true } "error": { Умовний приклад коду:
; Якщо валюта не передана, платформа має змогу помилково трактувати суму.; Артикул = Данные.article; 
{
}

Потрібно мати зовнішній ID: Статуси потрібно узгодити між системами.; Сайт має змогу передавати в 1С: 

"name": "Кабель USB Type-C 1 м чорний",

"payment": {

"amount": 1150.00

JSON і комерційна відомості

"order_id": "WEB-100245"

{ 

},

JSON і XML

як ілюстрація, із JSON можна отримати: 

"method": "card",

JSON і серії

  • вивантаження товарів на сайт;
  • імпорту номенклатури в K2 ERP;
  • синхронізації з CRM;
  • передачі в мобільний каталог;
  • обміну з маркетплейсом.;
}
; Перед переходом у K2 ERP потрібно перевірити: Правильний підхід. JSON у 1С потрібно розглядати не як набір випадкових файлів або запитів, а як частину інтеграційної архітектури бізнесу, яку потрібно описати, захистити, протестувати й перенести в K2 ERP.;

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

; }

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

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

</syntaxhighlight>

Сайт 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; 

"items": [

Дати в JSON потрібно передавати в узгодженому форматі.; Обов’язкове

Приклади: 

"size": "M"

Джерела:

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

!; |- | new | Нове замовлення | Нове |- | paid | Оплачено | Оплачено |- | shipped | Відвантажено | Відвантажено |- | cancelled | Скасовано | Скасовано |}

У 1С JSON часто з’являється там, де стара база інтегрується із сучаснішими системами.; JSON часто застосовують, коли потрібно для імпорту й експорту номенклатури, цін, залишків, замовлень, контрагентів, оплат, статусів, документів, довідників, аналітики та службових повідомлень.; {

</syntaxhighlight>

Міграційний JSON для K2 ERP

Див.; додатково

</syntaxhighlight> Погано: 

{
{| class="wikitable" style="width:100%;"
}
== JSON і персональні інформаційні дані ==
Ответ = HTTPСоединение.ОтправитьДляОбработки(ЗапросHTTP);

Інтеграції часто обмінюються статусами.; Ознака

* обмін із сайтом;
* обмін із CRM;
* обмін із WMS;
* обмін із мобільним застосунком;
* передача замовлень;
* передача статусів;
* передача оплат;
* передача залишків;
* передача цін;
* інтеграційні функціональні можливості з маркетплейсами;
* інтеграційні функціональні можливості з сервісами доставки;
* інтеграційні функціональні можливості з платіжними системами;
* API для зовнішніх систем;
* експорт у BI;
* міграція в [[K2 ERP]].; Питання

Приклад:

!; Окремі продукти [[1С]] і [[BAS]] внесені до відкритих переліків програмного забезпечення, забороненого до використання для окремих категорій організацій.; USB Type-C"

 "article": "CHARGER-20W",
 }
== JSON і числа ==
 "price": 250.00,
{| class="wikitable" style="width:100%;"
 "unit": "шт",
}
Приклад:
 "price": 1200.00,

Логи мають бути, але без зайвого зберігання чутливих даних.; "warehouse": "MAIN",

Приклад:

!; рішення для бізнесу в K2 ERP
JSON-інтеграції часто використовують авторизацію.; JSON має змогу містити:

Структура JSON має змогу змінюватися.; !;[[Категорія:Заміна 1С]]
Типові проблеми:
!; Окремі продукти [[1С]] і [[BAS]] внесені до переліків забороненого програмного забезпечення для окремих категорій організацій в Україні.; # Описати правила зіставлення довідників.; # Перевірити контрольні звірки.; '''JSON''' — це текстовий формат подання структурованих даних.; # Перевірити логи.; }
 "order_id": "WEB-100245",
{| class="wikitable" style="width:100%;"
Аналіз JSON-інтеграцій [[1С]] — це частина підготовки до виходу зі старої ризикової системи.;<syntaxhighlight lang="json">

'''Ризик безпеки.''' Токени, паролі й ключі API не можна зберігати у відкритому коді модулів, у файлах на робочому столі або в незахищених обробках.; Складська платформа має змогу використовувати JSON для обміну.;[[Категорія:Міграція з 1С]]

 "edrpou": "12345678",

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

* чи був запит;
* що саме відправили;
* що відповів сервер;
* чому документ не створився;
* чому товар не оновився;
* чому замовлення задублювалося.; | Так.;<syntaxhighlight lang="json">
 "date": "2026-05-15",
<syntaxhighlight lang="json">
!; !;<syntaxhighlight lang="json">

JSON і API

}

}

Бажано фіксувати:

У реальних проєктах потрібно враховувати авторизацію, помилки, таймаути, повторні спроби та логіювання.; 

"edrpou": "12345678",

JSON і ціни

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

"amount_with_vat": 1200.00

!; # Перевірити помилки.; # Визначити джерело істини.; 

"article": "MED-001",

}

Помилка: неправильний Content-Type

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

Це сприяє уникнути поломок при зміні формату.;== JSON і WMS ==

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

}

  • замовлення торгового представника;
  • заявки сервісного інженера;
  • фото;
  • координати;
  • статуси виконання;
  • оплату;
  • підпис клієнта;
  • коментарі.; "characteristics": {

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

"vat_rate": 20,

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

<div style="border:3px solid #1565c0; background:#e3f2fd; padding:14px; margin:16px 0;">

'''Підхід K2 ERP.''' Під час переходу з [[1С]] потрібно описати всі JSON-обміни: які системи підключені, які URL використовуються, які структури передаються, які токени застосовуються, які інформаційні дані є собою джерелом істини та як ці інтеграції мають працювати в [[K2 ERP]].; JSON

* дату і час;
* напрям обміну;
* URL;
* метод;
* користувача або сервіс;
* короткий характеристика запиту;
* код відповіді;
* результат;
* помилку;
* ID документа;
* зовнішній ID;
* час виконання.; {
== JSON і авторизація ==
[[Категорія:Інтеграція з BAS]]

== Помилка: API повертає не JSON ==
== JSON і логіювання ==
!; | Кодування, дати, числа, обов’язкові поля, дублікати, токени, логи, помилки, статуси й структуру даних.; # Знайти всі JSON-інтеграції в [[1С]].;

{
  • сайт передає в 1С замовлення;
  • 1С вивантажує на сайт товари, ціни й залишки;
  • CRM отримує контрагентів;
  • мобільний застосунок передає заявки;
  • складська платформа отримує переміщення;
  • зовнішній сервіс повертає статус доставки;
  • K2 ERP приймає інформаційні дані зі старої 1С під час міграції.; }

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

"quantity": 100

</syntaxhighlight>

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

Потрібно:

* 404 Not Found;
* 500 Internal Server Error;
* сторінка авторизації;
* HTML із проксі;
* повідомлення WAF.; ]

</syntaxhighlight>

Що таке JSON

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

Але для BI краще мати контрольовану модель даних, а не аналізувати хаотичні JSON-файли без валідації.; * ціни;

  • знижки;
  • собівартість;
  • маржу;
  • залишки;
  • договори;
  • клієнтів;
  • умови постачання;
  • банківські операції.; * сайти;
  • інтернет-магазини;
  • мобільні застосунки;
  • CRM-системи;
  • ERP-системи;
  • WMS;
  • маркетплейси;
  • сервіси доставки;
  • платіжні сервіси;
  • банківські сервіси;
  • зовнішні API;
  • BI-системи;
  • мікросервіси.; JSON має змогу бути зручним форматом для передачі довідників, документів, залишків, цін і статусів.; Відповідь

} 

{

Якщо API тимчасово недоступний, інтеграційні функціональні можливості має змогу повторювати відправку.; # Перевірити HTTP-сервіси.; це використання формату JSON у системі 1С; додатково реалізовано інтернет-магазинами.; # Перевірити регламентні задача.; |-

| Яка головна помилка?; | Мати JSON-обмін без документації, логів, контролю дублікатів і безпечного зберігання токенів.;

== Що таке JSON у 1С ==
{
У [[1С]] довго використовували [[XML]], але JSON став популярним для вебінтеграцій і API.; Різниця
Погані підходи:
== Типові помилки JSON у 1С ==
}
== Контроль після міграції JSON-даних ==
== JSON і міграція з 1С у K2 ERP ==
При інтеграції через JSON потрібно захищатися від дублікатів.; "article": "USB-C-1M-BLK",

 "products": [
Якщо JSON-обмін не логіюється, важко зрозуміти:
Бо користувач системи або інтегратор не розуміє, що саме сталося.; "warehouse": "MAIN",
[[Категорія:CSV]]
 {
== Зовнішні посилання ==
Приклад:
 "article": "USB-C-1M-BLK",
== JSON і валідація ==
Данные.Вставить("article", "USB-C-1M-BLK");
як ілюстрація:
Такий код має змогу використовуватися для отримання товару або рядка замовлення.; "price_type": "retail",

Приклад цін:

 "code": "VALIDATION_ERROR",
!; У модулях [[1С]] можуть використовуватися механізми читання JSON.; "date": "2026-05-15T14:30:00",
[[Категорія:Деколонізація обліку]]
 "code": "000001",
 "order_id": "WEB-100245"
"name": "ТОВ замовник",

"service": "Нова пошта",

</syntaxhighlight> 

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

У K2 ERP JSON має змогу бути основним форматом сучасних інтеграцій.; |- | Чим JSON відрізняється від XML?; У K2 ERP </syntaxhighlight> Приклад контрагента: Не завжди потрібно зберігати повне тіло JSON, особливо якщо там персональні або комерційні інформаційні дані.; "document_number": "ЗМ-000123" 

},

Для JSON важливе кодування.; # Зібрати приклади JSON-запитів і відповідей.; Статус сайту

JSON і HTTP-запити

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

"article": "CHARGER-20W",

} !; * кількість записів;

  • обов’язкові поля;
  • дублікати;
  • довідники;
  • документи;
  • залишки;
  • ціни;
  • суми;
  • валюти;
  • статуси;
  • помилки імпорту;
  • логи;
  • контрольні звіти.;
"datetime": "2026-05-15T14:30:00"

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

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

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

організація повинна:

Приклад логіки:

  • товари;
  • групи товарів;
  • характеристики;
  • серії;
  • ціни;
  • знижки;
  • залишки;
  • зображення;
  • статуси замовлень.; "external_id": "CRM-5001",

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

]

!; # Перевірити дублікати.; },

  • надходження;
  • переміщення;
  • відвантаження;
  • номенклатуру;
  • штрихкоди;
  • партії;
  • серії;
  • характеристики.; * знайти всі JSON-обміни;
  • описати структури;
  • зібрати приклади запитів і відповідей;
  • перевірити токени;
  • перевірити логи;
  • перевірити дублікати;
  • перевірити статуси;
  • перевірити персональні й комерційні інформаційні дані;
  • перенести потрібні інтеграції в K2 ERP;
  • вимкнути старі обміни в 1С після запуску нової системи.; * обов’язкові поля;
  • типи даних;
  • формат дати;
  • валюту;
  • кількість;
  • ціну;
  • наявність товару;
  • наявність контрагента;
  • коректність статусу;
  • дублікати;
  • зовнішній ID;
  • права джерела.; У 1С такий JSON має змогу створити:

Таблиця інвентаризації JSON-обмінів

]

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

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

"article": "CHARGER-20W",

JSON має змогу використовуватися для:

Правильне кодування має бути узгоджене між системами.;

{

Приклад:

  • замовлення;
  • продажі та реалізація;
  • залишки;
  • ціни;
  • статуси;
  • клієнтів;
  • доставки;
  • оплати;
  • помилки інтеграцій.; |-

| Що таке JSON у 1С?; ] 

!; # Реалізувати нові API або обміни в [[K2 ERP]].; Коментар
 "name": "ТОВ замовник",
 "price": 250.00

Простими словами. JSON у 1С — це спосіб передати інформаційні дані між 1С та іншою системою у вигляді зрозумілого текстового об’єкта.; "delivery": { [ Приклад залишків: 

"city": "Київ",

{ 

"error": {
"status": "shipped",

Токен = "secret-token-123"; <syntaxhighlight lang="bsl">

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

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

ЗаписьJSON = Новый ЗаписьJSON; <syntaxhighlight lang="text"> 

{

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

JSON зручний тим, що його без зайвих зусиль читати людині й без зайвих зусиль обробляти програмам.; |- | Для чого застосовується JSON?;<syntaxhighlight lang="text"> 

"customer": {

Запис JSON у 1С

{

"currency": "UAH",
"quantity": 2

JSON-обміни потрібно логіювати.; Статус у K2 ERP

  • замовлення;
  • клієнтів;
  • оплати;
  • доставки;
  • коментарі;
  • промокоди;
  • повернення;
  • статуси.; "quantity": 2,
"stock_balances": [ {
Отримано з https://wiki.corp2.eu/index.php?title=JSON_1С&oldid=1986