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

JSON 1С

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


SEO title: JSON 1С — імпорт, експорт, API, обмін із сайтом, інтеграції та міграція в K2 ERP SEO description: JSON 1С: що це таке, як використовується JSON у 1С для імпорту, експорту, API, обміну з сайтом, CRM, банком, WMS, мобільними додатками, приклади JSON-структур, типові помилки, безпека і перенесення інтеграцій з 1С у K2 ERP. SEO 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, цифрова незалежність Alternative to:


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

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

Головне. JSON у — це зручний формат для сучасного обміну даними: сайт передає замовлення, віддає залишки, CRM отримує клієнтів, мобільний застосунок передає заявки, а API працює через структуровані об’єкти.

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

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

Вступ

JSON став одним із найпоширеніших форматів обміну даними між системами.

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

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

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

Наприклад:

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

Що таке JSON

JSON — це текстовий формат подання структурованих даних. Він складається з об’єктів, масивів, рядків, чисел, логічних значень і порожніх значень.

Приклад JSON:

{
  "code": "000001",
  "name": "Кабель USB Type-C 1 м",
  "price": 250.00,
  "active": true
}

JSON зручний тим, що його легко читати людині й легко обробляти програмам.

Що таке JSON у 1С

JSON у — це використання формату JSON у коді, обробках, модулях, інтеграціях, API, обмінах або міграційних сценаріях.

JSON може використовуватися для:

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

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

Приклад JSON для номенклатури

Приклад товару:

{
  "article": "USB-C-1M-BLK",
  "name": "Кабель USB Type-C 1 м чорний",
  "category": "Кабелі",
  "unit": "шт",
  "vat_rate": 20,
  "active": true
}

Такий JSON може використовуватися для:

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

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

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

{
  "order_id": "WEB-100245",
  "date": "2026-05-15T14:30:00",
  "customer": {
    "name": "ТОВ Клієнт",
    "edrpou": "12345678",
    "phone": "+380501112233"
  },
  "items": [
    {
      "article": "USB-C-1M-BLK",
      "quantity": 2,
      "price": 250.00
    },
    {
      "article": "CHARGER-20W",
      "quantity": 1,
      "price": 650.00
    }
  ],
  "delivery": {
    "service": "Нова пошта",
    "city": "Київ",
    "warehouse": "Відділення №1"
  },
  "payment": {
    "method": "card",
    "paid": true,
    "amount": 1150.00
  }
}

У такий JSON може створити:

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

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

У JSON є два базові типи структур.

Об’єкт — набір полів:

{
  "name": "ТОВ Клієнт",
  "edrpou": "12345678"
}

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

[
  {
    "article": "USB-C-1M-BLK",
    "quantity": 2
  },
  {
    "article": "CHARGER-20W",
    "quantity": 1
  }
]

У об’єкт JSON часто перетворюється на структуру або відповідність, а масив — на масив або таблицю значень.

JSON і XML

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

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

JSON і CSV

CSV простіший, але менш структурований.

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

Де JSON використовується в 1С

JSON у може використовуватися в таких сценаріях:

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

JSON і сайт

Один із найчастіших сценаріїв — обмін із сайтом або інтернет-магазином.

може передавати на сайт:

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

Сайт може передавати в :

  • замовлення;
  • клієнтів;
  • оплати;
  • доставки;
  • коментарі;
  • промокоди;
  • повернення;
  • статуси.

JSON і CRM

CRM може обмінюватися з через JSON.

Приклади:

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

JSON і WMS

Складська система може використовувати JSON для обміну.

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

  • надходження;
  • переміщення;
  • відвантаження;
  • номенклатуру;
  • штрихкоди;
  • партії;
  • серії;
  • характеристики.

WMS повертає:

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

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

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

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

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

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

JSON і API

JSON часто використовується в API.

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

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

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

{
  "success": true,
  "message": "Замовлення створено",
  "document_number": "ЗМ-000123"
}

Або помилка:

{
  "success": false,
  "error": {
    "code": "PRODUCT_NOT_FOUND",
    "message": "Товар з артикулом USB-C-1M-BLK не знайдено"
  }
}

Читання JSON у 1С

У модулях можуть використовуватися механізми читання JSON.

Умовний приклад коду:

ТекстJSON = "{""article"":""USB-C-1M-BLK"",""quantity"":2}";

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

Данные = ПрочитатьJSON(ЧтениеJSON);

Артикул = Данные.article;
Количество = Данные.quantity;

Такий код може використовуватися для отримання товару або рядка замовлення.

Запис JSON у 1С

Умовний приклад формування JSON:

Данные = Новый Структура;
Данные.Вставить("article", "USB-C-1M-BLK");
Данные.Вставить("name", "Кабель USB Type-C 1 м");
Данные.Вставить("price", 250);

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

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

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

Такий JSON можна відправити сайту, CRM або іншій системі.

JSON і HTTP-запити

JSON часто передається через HTTP.

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

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

ЗапросHTTP = Новый HTTPЗапрос("/orders");
ЗапросHTTP.Заголовки.Вставить("Content-Type", "application/json");
ЗапросHTTP.УстановитьТелоИзСтроки(ТекстJSON, КодировкаТекста.UTF8);

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

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

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

JSON-інтеграції часто використовують авторизацію.

Варіанти:

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

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

Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

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

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

Для JSON важливе кодування.

Найчастіше використовується UTF-8.

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

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

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

{
  "name": "?????? USB Type-C"
}

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

JSON і дати

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

Приклади:

{
  "date": "2026-05-15",
  "datetime": "2026-05-15T14:30:00"
}

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

  • різні часові пояси;
  • дата без часу;
  • час без часової зони;
  • формат `15.05.2026` замість ISO;
  • сайт і по-різному трактують дату;
  • замовлення потрапляє не в той день.

JSON і числа

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

{
  "quantity": 2,
  "price": 250.50
}

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

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

Погано:

{
  "price": "250,50"
}

Краще:

{
  "price": 250.50
}

JSON і валюта

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

Приклад:

{
  "amount": 1500.00,
  "currency": "UAH"
}

Якщо валюта не передана, система може помилково трактувати суму.

JSON і ПДВ

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

Приклад:

{
  "price": 1200.00,
  "vat_rate": 20,
  "vat_amount": 200.00,
  "amount_with_vat": 1200.00
}

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

  • ціна з ПДВ або без ПДВ не визначена;
  • ставка не передана;
  • сума ПДВ не збігається;
  • округлення відрізняється;
  • податкові правила не враховані.

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

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

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

  • код ;
  • артикул;
  • GUID;
  • штрихкод;
  • зовнішній ID;
  • SKU;
  • комбінація артикул + характеристика;
  • код у сайті;
  • код у K2 ERP.

Приклад:

{
  "external_id": "SITE-10001",
  "article": "USB-C-1M-BLK",
  "barcode": "4820000000012",
  "name": "Кабель USB Type-C 1 м чорний"
}

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

Якщо товар має характеристики, їх потрібно передавати явно.

Приклад:

{
  "article": "TSHIRT",
  "characteristics": {
    "color": "black",
    "size": "M"
  }
}

Без характеристик залишки або ціни можуть потрапити не на той варіант товару.

JSON і серії

Для серійного обліку JSON має містити серію або партію.

Приклад:

{
  "article": "MED-001",
  "series": "LOT-2026-05",
  "expiry_date": "2027-05-31",
  "quantity": 100
}

Це важливо для:

  • фармацевтики;
  • харчових продуктів;
  • гарантійного обліку;
  • виробництва;
  • партійного обліку;
  • простежуваності.

JSON і залишки

Приклад залишків:

{
  "warehouse": "MAIN",
  "date": "2026-05-15T18:00:00",
  "items": [
    {
      "article": "USB-C-1M-BLK",
      "quantity": 120
    },
    {
      "article": "CHARGER-20W",
      "quantity": 45
    }
  ]
}

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

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

JSON і ціни

Приклад цін:

{
  "price_type": "retail",
  "currency": "UAH",
  "date": "2026-05-15",
  "items": [
    {
      "article": "USB-C-1M-BLK",
      "price": 250.00
    },
    {
      "article": "CHARGER-20W",
      "price": 650.00
    }
  ]
}

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

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

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

Приклад контрагента:

{
  "external_id": "CRM-5001",
  "name": "ТОВ Клієнт",
  "edrpou": "12345678",
  "vat_number": "123456789012",
  "phone": "+380501112233",
  "email": "client@example.ua"
}

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

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

JSON і документи

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

Приклад:

{
  "document_type": "sales_order",
  "number": "SO-000123",
  "date": "2026-05-15",
  "customer_id": "CRM-5001",
  "warehouse": "MAIN",
  "items": [
    {
      "article": "USB-C-1M-BLK",
      "quantity": 2,
      "price": 250.00
    }
  ]
}

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

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

JSON і статуси

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

Приклад:

{
  "order_id": "WEB-100245",
  "status": "shipped",
  "tracking_number": "20450000000000",
  "updated_at": "2026-05-15T18:10:00"
}

Статуси потрібно узгодити між системами.

Статус сайту Статус у 1С Статус у K2 ERP
new Нове замовлення Нове
paid Оплачено Оплачено
shipped Відвантажено Відвантажено
cancelled Скасовано Скасовано

JSON і помилки

API має повертати зрозумілі помилки.

Приклад:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Не заповнено поле customer.edrpou",
    "field": "customer.edrpou"
  }
}

Погано, якщо API повертає просто:

{
  "error": "Error"
}

Бо користувач або інтегратор не розуміє, що саме сталося.

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

JSON-обміни потрібно логіювати.

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

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

Не завжди потрібно зберігати повне тіло JSON, особливо якщо там персональні або комерційні дані.

JSON і персональні дані

JSON може містити персональні дані:

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

Тому JSON-логи, файли й запити потрібно захищати.

JSON і комерційна інформація

JSON може містити:

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

Витік JSON-файлу може бути таким самим небезпечним, як витік бази або звіту.

JSON і валідація

Перед обробкою JSON потрібно перевіряти його структуру.

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

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

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

Поле Обов’язкове Коментар
order_id Так Зовнішній номер замовлення
date Так Дата замовлення
customer Так Дані клієнта
items Так Рядки товарів
payment Ні Може прийти пізніше

JSON і дублікати

При інтеграції через JSON потрібно захищатися від дублікатів.

Наприклад, сайт може повторно відправити те саме замовлення.

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

{
  "order_id": "WEB-100245"
}

У або K2 ERP потрібно перевірити, чи вже існує документ із таким ID.

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

Якщо API тимчасово недоступний, інтеграція може повторювати відправку.

Потрібно передбачити:

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

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

Структура JSON може змінюватися.

Тому бажано мати версію API.

Приклад:

{
  "api_version": "1.0",
  "order_id": "WEB-100245"
}

Або в URL:

/api/v1/orders
/api/v2/orders

Це допомагає уникнути поломок при зміні формату.

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

Під час міграції потрібно знайти всі JSON-інтеграції старої .

Джерела:

  • загальні модулі;
  • модулі обробок;
  • зовнішні обробки;
  • регламентні завдання;
  • модулі форм;
  • файли обміну;
  • HTTP-сервіси;
  • вебсервіси;
  • налаштування обміну;
  • журнал реєстрації;
  • документація інтеграцій.

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

Перед переходом у K2 ERP потрібно перевірити:

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

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

Інтеграція Напрям Дані Формат Рішення в K2 ERP
Сайт 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

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

Під час перенесення даних із у K2 ERP JSON може використовуватися як міграційний формат.

Приклад номенклатури:

{
  "products": [
    {
      "external_id": "1C-000001",
      "article": "USB-C-1M-BLK",
      "name": "Кабель USB Type-C 1 м чорний",
      "unit": "шт",
      "active": true
    }
  ]
}

Приклад залишків:

{
  "stock_balances": [
    {
      "date": "2026-06-01",
      "warehouse": "MAIN",
      "article": "USB-C-1M-BLK",
      "quantity": 120,
      "unit_cost": 100.00
    }
  ]
}

Контроль після міграції JSON-даних

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

  • кількість записів;
  • обов’язкові поля;
  • дублікати;
  • довідники;
  • документи;
  • залишки;
  • ціни;
  • суми;
  • валюти;
  • статуси;
  • помилки імпорту;
  • логи;
  • контрольні звіти.

Приклад:

Дані У 1С У K2 ERP Різниця
Товари 12 500 12 500 0
Ціни 25 000 25 000 0
Залишки 8 700 8 700 0
Замовлення 1 200 1 200 0

Типові помилки JSON у 1С

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

  • неправильне кодування;
  • неправильний формат дати;
  • кома замість крапки в числах;
  • відсутні обов’язкові поля;
  • неправильна структура масиву;
  • товар не знайдений;
  • контрагент не знайдений;
  • дублюється замовлення;
  • токен прострочений;
  • неправильний Content-Type;
  • API недоступний;
  • таймаут;
  • помилка SSL;
  • сервер повертає HTML замість JSON;
  • у коді не обробляються помилки;
  • JSON зберігається в логах із персональними даними.

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

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

Content-Type: application/json

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

Помилка: API повертає не JSON

Іноді система очікує JSON, але отримує HTML-сторінку помилки.

Наприклад:

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

Тому потрібно перевіряти HTTP-код відповіді й тип вмісту.

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

Якщо JSON-обмін не логіюється, важко зрозуміти:

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

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

Помилка: секрети в коді

Погана практика — зберігати токен прямо в модулі:

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

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

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

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

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

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

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

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

  1. Знайти всі JSON-інтеграції в .
  2. Зібрати зовнішні обробки.
  3. Перевірити загальні модулі.
  4. Перевірити регламентні завдання.
  5. Перевірити HTTP-сервіси.
  6. Зібрати приклади JSON-запитів і відповідей.
  7. Описати структури даних.
  8. Визначити джерело істини.
  9. Знайти токени й секрети.
  10. Перевірити логи.
  11. Перевірити дублікати.
  12. Перевірити помилки.
  13. Описати статуси.
  14. Описати правила зіставлення довідників.
  15. Визначити, що переноситься в K2 ERP.
  16. Реалізувати нові API або обміни в K2 ERP.
  17. Провести тестову інтеграцію.
  18. Перевірити контрольні звірки.
  19. Вимкнути старий JSON-обмін у після переходу.

JSON і K2 ERP

У K2 ERP JSON може бути основним форматом сучасних інтеграцій.

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

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

JSON і BI-аналітика

JSON може бути джерелом для BI, але перед аналізом дані потрібно нормалізувати.

Наприклад, із JSON можна отримати:

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

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

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

Аналіз JSON-інтеграцій — це частина підготовки до виходу зі старої ризикової системи.

Компанія повинна:

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

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

Коротко

Питання Відповідь
Що таке JSON у ? Це формат обміну даними між та іншими системами: сайтом, CRM, API, WMS, мобільними застосунками або K2 ERP.
Для чого використовується JSON? Для імпорту, експорту, замовлень, цін, залишків, контрагентів, статусів, оплат, документів і API.
Чим JSON відрізняється від XML? JSON легший і частіше використовується в сучасних API, а XML частіше зустрічається в старих обмінах і формальних документах.
Що важливо перевірити? Кодування, дати, числа, обов’язкові поля, дублікати, токени, логи, помилки, статуси й структуру даних.
Чи можна використовувати JSON для міграції в K2 ERP? Так. JSON може бути зручним форматом для передачі довідників, документів, залишків, цін і статусів.
Яка головна помилка? Мати JSON-обмін без документації, логів, контролю дублікатів і безпечного зберігання токенів.
Чи є санкційні ризики у і BAS? Так. Окремі продукти і BAS внесені до переліків забороненого програмного забезпечення для окремих категорій організацій в Україні.

Висновок

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

Під час переходу на K2 ERP JSON-інтеграції потрібно аналізувати дуже уважно.

Потрібно:

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

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

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

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

Див. також

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