Інтеграція через файли

CSV добре підходить для:

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

</Рядок>

!; # Прочитати структуру.; # Описати структуру.; Платежі можуть передаватися через файли банківських виписок або спеціальні формати.; "phone": "+380671112233", |- | 15 | Контрагент | ЄДРПОУ | Порожній код | Заповнити ЄДРПОУ або дозволити створення без коду |- | 48 | Товар | Артикул | Товар із таким артикулом не знайдено | Створити товар або додати відповідність |- | 102 | Документ | Сума | Сума рядків не збігається із сумою документа | Перевірити ціни і ПДВ |}

Для великих обсягів краще:

є собою два основні варіанти:

Перевірка має змогу включати:

дату і час;
назву файлу;
джерело;
користувача або сервіс;
формат файлу;
кількість рядків;
кількість створених об’єктів;
кількість оновлених об’єктів;
кількість помилок;
результат обробки;
шлях до архіву;
контрольну суму файлу.; * `/in` — вхідні файли;
`/out` — вихідні файли;
`/processed` — оброблені файли;
`/error` — файли з помилками;
`/archive` — архів;
`/log` — журнали.;

чи правильний формат;
чи правильне кодування;
чи є собою всі обов’язкові колонки;
чи не порожні ключові поля;
чи правильні дати;
чи правильні числа;
чи існують довідники;
чи немає дублів;
чи збігаються суми;
чи не пошкоджений файл;
чи відповідає файл затвердженій версії шаблону.;</syntaxhighlight>

TXT застосовується рідше, але досі має змогу зустрічатися у старих банківських, складських або галузевих системах.;

K2 ERP формує файл із залишками товарів.; Зі старої системи можна вивантажити:

Недоліки CSV:

Як K2 ERP має змогу використовувати файлову інтеграцію

Для українського бізнесу файлова інтеграційні функціональні можливості має змогу бути не без ускладнень технічним інструментом.; "name": "Іван Петренко", </syntaxhighlight>

},

|- | CSV | Прайси, прості довідники, залишки, списки | Простий, компактний, без зайвих зусиль відкривається в таблицях | Погано підходить для вкладених структур |- | Excel | Прайси, ручний імпорт, підготовка даних користувачами | Зручний для користувачів | має змогу мати різні формати, формули, приховані колонки |- | XML | Документи, складні структури, міграція | підтримує роботу вкладеність і схеми | Громіздкий формат |- | JSON | Сучасні обміни, веб-системи, інтеграції | Легший за XML, зручний для API | Не всі старі системи його підтримують |- | TXT | Простий обмін, старі системи, фіксовані формати | Дуже простий | Потребує чітких правил позицій або роздільників |- | YML | Каталоги товарів, маркетплейси, характеристика структур | Читабельний, зручний для конфігурацій | Чутливий до відступів |- | DBF | Старі облікові системи | Поширений у старих системах | Застарілий формат |}

!; | Так, але краще як перехідний інструмент для міграції в K2 ERP, а не як постійну залежність.; Для K2 ERP файлова інтеграційні функціональні можливості має змогу бути корисним інструментом імпорту, експорту та міграції, особливо під час переходу з 1С або BAS.;</syntaxhighlight>

}
"phone": "+380671112233"

<Склад Код="WH-001">ключовий складський облік</Склад>

створити клієнта;
створити замовлення;
перевірити товар;
зарезервувати залишок;
передати задачу складу;
сформувати протокол помилок.; | Для міграції, прайсів, пакетного обміну, старих систем і сценаріїв, де API недоступний.; !; # K2 ERP забирає файл.;</syntaxhighlight>

!; # Сформувати файл.; {| class="wikitable" style="width:100%;"

описати формат;
затвердити шаблон;
визначити обов’язкові поля;
використовувати зовнішні коди;
перевіряти інформаційні дані;
контролювати дублікати;
логіювати імпорт і експорт;
формувати протоколи помилок;
архівувати файли;
захищати доступ;
не залишати тимчасові обміни назавжди.; # Реалізувати архівування.; Простими словами. Файлова інтеграційні функціональні можливості — це коли системи домовляються: “я покладу інформаційні дані у файл у такому форматі, а ти цей файл прочитаєш і правильно обробиш”.; Артикул

Але після завершення міграції бажано:

Залишки часто передаються під час міграції або складського обміну.; # Формує протокол помилок.; # Обрати формат файлу.; Приклад JSON-файлу:

розбивати файл на частини;
передавати інформаційні дані пакетами;
використовувати інкрементальний обмін;
обробляти файл потоково;
зберігати проміжний результат;
повторно обробляти тільки помилкові рядки.; Добрий протокол:

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

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

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

Типовий бізнес-процес експорту: "payment": { Приклад: документ продажу можна передати двома файлами.; Але для постійних інтеграцій, які мають працювати в реальному часі, краще поступово переходити на API, вебхуки, черги або інтеграційні сервіси.;== Файлова інтеграційні функціональні можливості цін == 000001ТОВ Ромашка 1234567815000.00 Найгірший сценарій. Файли без ускладнень складаються в спільну папку, хтось вручну їх запускає, помилки не логіюються, дублікати не контролюються, а бізнес-середовище не розуміє, які інформаційні дані реально були завантажені.; |-

Який формат краще для складних документів?; Не можна сліпо завантажувати файли. Навіть якщо файл відкривається, він має змогу містити неправильні коди, дублікати, порожні поля, старі інформаційні дані або некоректні суми.; !;JSON часто застосовується у веб-інтеграціях.; # Визначити джерело і приймач даних.; Іноді найпростіший, найшвидший або єдиний доступний спосіб інтеграції — це файл.; \|-	Контрагент	1C-000001	58421	Для зв’язку документів
Товар	SKU-001	90015	Для рядків документів і залишків
складський облік	WH-001	120	Для складських операцій
Договір	DOG-015	3405	Для взаєморозрахунків

Файли і ручний контроль

це спосіб обміну даними між інформаційними системами за допомогою файлів різних форматів: CSV.; # Запустити промисловий обмін.; з цієї причини файловий обмін із такими системами бажано розглядати не як постійну залежність, а як перехідний інструмент для міграції в українську ERP-платформу.; |- | Простота старту | Висока | Потрібна розробка програмного забезпечення |- | Робота в реальному часі | Обмежена | Добра |- | Контроль помилок | Потрібно будувати окремо | Можна робити через відповіді API |- | Великі пакети даних | комфортно | Потрібна пакетна логіка |- | Ручна перевірка | комфортно | Менш комфортно |- | автоматизація процесів | Можлива, але потребує дисципліни | Краща для постійних процесів |}

Файловий обмін часто будується через каталоги.; Документи складніші за довідники, з цієї причини що мають шапку і табличну частину.; Формат

Формати дат і чисел

Приклад TXT із роздільником:

Потрібно домовитися про єдині формати.; Окремі продукти 1С і BAS внесені до переліків забороненого програмного забезпечення для окремих категорій організацій в Україні.; Ціна

Кожен файловий обмін повинен мати журнал.; Але для постійних сучасних інтеграцій бажано використовувати API, JSON, вебхуки, черги або спеціалізовані інтеграційні сервіси.; Файл має змогу бути простим: як ілюстрація, прайс постачальника в Excel.;<Кількість>10</Кількість>

</syntaxhighlight> Вона добре підходить для:

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

Excel часто застосовується для ручного імпорту даних.; Об’єкт

</syntaxhighlight>

!; |}

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

* довідників;
* документів;
* прайсів;
* залишків;
* цін;
* замовлень;
* платежів;
* інвентаризацій;
* звітів;
* міграцій;
* обміну зі старими системами.; | Так.;</ДокументПродажу>

 "email": "ivan@example.ua"

!; бізнес-середовище використовує багато різних програм і сервісів:

{| class="wikitable" style="width:100%;"
!; Валюта
1C-000146;CHARGER-20W;Зарядний пристрій 20W;шт;20;4820000000013
Проблеми Excel-файлів:
|-
| Контрагенти
| ЄДРПОУ, ІПН, зовнішній код
| Назва
|-
| Номенклатура
| Артикул, штрихкод, зовнішній код
| Назва
|-
| Склади
| Зовнішній код
| Назва без коду
|-
| Договори
| Код договору + контрагент
| Тільки номер договору
|}

!; ]

Приклад таблиці прайсу:
== Файлова інтеграційні функціональні можливості залишків ==
!; * товари для сайту;
* залишки для маркетплейсу;
* ціни для партнерів;
* документи для бухгалтерії;
* звіт для керівництва;
* файл для банку;
* архів міграції;
* файл для зовнішнього [[BI]].; # Переносить файл в архів.; # Якщо все добре — переноситься в `/processed` або `/archive`.; Ключ пошуку
'''Підхід K2 ERP.''' У [[K2 ERP]] файловий обмін має змогу використовуватися як зручний механізм імпорту, експорту і міграції.; Не всі підтримують прямий обмін у реальному часі.; |-
| Чи можна використовувати файловий обмін із [[1С]] або [[BAS]]?; # Створити нові об’єкти, якщо дозволено.; Відповідь
{| class="wikitable" style="width:100%;"

 "amount": 500.00

Приклад:

Рекомендована структура:

Для інтеграції використовуються різні формати.; Для українських даних істотно правильно працювати з кодуванням.; |-
| Який формат найпростіший?; # Передати файл у каталог або зовнішню систему.; Найчастіші сценарії:

* перевірити історію;
* знайти помилку;
* повторити імпорт;
* довести, які інформаційні дані були отримані;
* відновити файл;
* провести аудит;
* розібрати конфлікт із зовнішньою системою.; Назва
[[TXT]]-файли можуть використовуватися для простих або старих інтеграцій.;<Сума>2500.00</Сума>

Для залишків істотно:

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

<syntaxhighlight lang="text">

<ДокументПродажу>

; Приклад

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

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

з цієї причини потрібно:

;

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

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

"customer": { XML зручний для:

Інтернет-магазин формує файл із замовленнями.; # Перевірити кодування.; Рядок

; Великі файли можуть створювати проблеми: Найчастіше використовуються: Що таке файлова інтеграційні функціональні можливості date;payment_number;payer_tax_code;payer_name;amount;currency;purpose Користувачам комфортно працювати з Excel, з цієї причини постачальники, бухгалтери, менеджери і склади часто передають інформаційні дані саме у цьому форматі.; Файловий обмін має змогу бути повним або частковим.; \| XML або JSON.; * звірки залишків; оформлення нестач; оформлення надлишків; пошуку пересортиці; підготовки стартових залишків при міграції.;== Файлова інтеграційні функціональні можливості платежів == }, Каталоги обміну
Дата	YYYY-MM-DD	2026-05-15
Дата і час	ISO-формат	2026-05-15T14:25:00
Число	Крапка як десятковий роздільник	250.50
Валюта	Код валюти	UAH, USD, EUR
Булеве значення	true/false або 1/0	true

Приклад із фіксованими позиціями:

2026-05-15;WH-002;CHARGER-20W;45;шт;27000.00

як ілюстрація, документ продажу має змогу мати шапку і табличну частину:

; Створено

Файл шапок документів:

 {

Не всі ці системи мають сучасний [[API]].; Ціни часто передаються через Excel або CSV.;== Протокол помилок ==

== Експорт файлів ==
WH-001;CHARGER-20W;50;55;5
<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">
[[Категорія:CSV]]
== Вступ ==
З урахуванням санкційних, юридичних і кібербезпекових ризиків [[1С]] та [[BAS]], файловий обмін із такими системами має бути частиною стратегії переходу на українське програмне забезпечення, цифрову незалежність і сучасну [[ERP]]-архітектуру.; # Перевірити типи даних.; # Результат записується в журнал.;<Ціна>250.00</Ціна>

 "city": "Київ",

* “ТОВ Ромашка” має змогу перетворитися на набір незрозумілих символів;
* адреси можуть зіпсуватися;
* назви товарів стануть непридатними для пошуку;
* файл має змогу не пройти імпорт.; Код у старій системі
Під час переходу з [[1С]] або [[BAS]] у [[K2 ERP]] файли часто використовуються як проміжний формат.; # Файл потрапляє в каталог обміну.; # Застосувати фільтри.; Оновлено
!; Файли добре підходять для:

А має змогу бути складним: як ілюстрація, [[XML]]-файл із документами, табличними частинами, контрагентами, товарами, складами, ПДВ і службовими кодами.; doc_id;article;quantity;price;amount

Але файлова інтеграційні функціональні можливості повинна бути контрольованою.; Критерій
000002|ТОВ Калина|87654321|32000.00
Без таблиці відповідності документи можуть втратити зв’язок із довідниками.; '''Головне.''' Файлова інтеграційні функціональні можливості — це простий і зрозумілий спосіб обміну даними.;[[Категорія:Інтеграція через файли]]
!; !;</div>

[[Категорія:Деколонізація обліку]]
<div style="border:3px solid #ef6c00; background:#fff3e0; padding:14px; margin:16px 0;">
 "customer": {
Під час імпорту платежів потрібно визначити:

!; # Узгодити формат дат і чисел.; Тип обміну
date;warehouse_code;article;quantity;unit;amount
 </Товари>
|-
| USB-C-1M-BLK
| Кабель USB Type-C 1 м чорний
| шт
| 250.00
| UAH
| 120
|-
| CHARGER-20W
| Зарядний пристрій 20W
| шт
| 600.00
| UAH
| 45
|}

 ],

* користувачі змінюють назви колонок;
* можуть бути об’єднані комірки;
* можуть бути приховані рядки;
* можуть бути формули замість значень;
* дати можуть зберігатися в різних форматах;
* числа можуть мати кому або крапку;
* файл має змогу містити кілька аркушів;
* у файлі можуть бути службові рядки, підсумки, примітки.; # платформа перевіряє структуру.; Його потрібно архівувати, щоб можна було перевірити, що саме було завантажено або передано.;<Артикул>USB-C-1M-BLK</Артикул>

 "delivery": {
DOC-001;USB-C-1M-BLK;10;250.00;2500.00
== Безпека файлового обміну ==
== Файлова інтеграційні функціональні можливості документів ==
1C-000145;USB-C-1M-BLK;Кабель USB Type-C 1 м чорний;шт;20;4820000000012
 "items": [
!; Недолік

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

Типові помилки файлової інтеграції

K2 ERP має змогу використовувати файловий обмін для:

CSV — один із найпростіших форматів файлового обміну.;

; Статус

<Контрагент Код="CUST-001">ТОВ "замовник"</Контрагент>

;	; переважні аспекти Якщо організація переходить із 1С або BAS на K2 ERP, файлова інтеграційні функціональні можливості має змогу бути дуже корисною.; # Створює замовлення клієнтів.; !; Довідник Роздрібна;2026-05-15;CHARGER-20W;UAH;600.00 Імпорт — це завантаження даних із файлу в систему.; 2026-05-15;WH-001;USB-C-1M-BLK;120;шт;30000.00
Повний обмін	Передаються всі інформаційні дані	Повний каталог товарів	Великий обсяг файлів
Частковий обмін	Передаються тільки вибрані інформаційні дані	Тільки товари однієї групи	Потрібно контролювати фільтри
Інкрементальний обмін	Передаються тільки зміни	Товари, змінені за останню годину	Потрібен контроль дати зміни
Разовий обмін	Виконується один раз	Міграція залишків	Потрібна ретельна перевірка
Регулярний обмін	Виконується постійно	Щогодинний експорт залишків	Потрібне логіювання і моніторинг

Висновок

}

],

Файлова інтеграційні функціональні можливості не замінює API.; # Узгодити кодування.;

JSON зручний для:

* [[K2]]
* [[K2 ERP]]
* [[ERP]]
* [[Інтеграція ERP]]
* [[Інтеграція через XML]]
* [[XML]]
* [[JSON]]
* [[CSV]]
* [[Microsoft Excel]]
* [[API]]
* [[Імпорт даних]]
* [[Експорт даних]]
* [[Обмін даними]]
* [[Інтеграція з 1С]]
* [[Інтеграція з BAS]]
* [[Обробки 1С]]
* [[Довідники 1С]]
* [[Документи 1С]]
* [[Реквізити 1С]]
* [[Проводки 1С]]
* [[Міграція з 1С]]
* [[Міграція з BAS]]
* [[Заміна 1С]]
* [[Заміна BAS]]
* [[BI]]
* [[Python]]
* [[TypeScript]]
* [[PostgreSQL]]
* [[Українське програмне забезпечення]]
* [[Автоматизація бізнесу]]
* [[Цифрова незалежність]]
* [[Деколонізація обліку]]

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

* [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://www.president.gov.ua/documents/6012024-52009 Указ Президента України №601/2024]
* [https://t.me/+uIdWI1W6vndkMTAy Telegram-канал K2 ERP]
* [https://t.me/+6jFwAZM6TQliNTdi Група обговорення функціоналу та пропозицій]
* [https://www.linkedin.com/company/k2erp/ LinkedIn K2]

warehouse_code;article;accounting_quantity;fact_quantity;difference
__TOC__
 }
Така схема зручна для CSV, де складно передати вкладену структуру в одному файлі.; Ненадійний ключ
== Файлова інтеграційні функціональні можливості з 1С і BAS ==
 }
[[Категорія:Міграція з BAS]]
!; |-
| Контрагент
| ЄДРПОУ або зовнішній код
| Назва має змогу змінюватися
|-
| Товар
| Артикул, штрихкод або зовнішній код
| Назва не є собою надійним ключем
|-
| Документ
| Зовнішній номер + дата + джерело
| Захист від повторного імпорту
|-
| Платіж
| Номер платежу + дата + сума + рахунок
| Потрібно уникати дублів
|-
| складський облік
| Зовнішній код
| Назви можуть дублюватися
|}

<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">

CSV-файл — це текстова таблиця, де рядки відповідають записам, а колонки розділені комою, крапкою з комою або іншим роздільником.; Окремі продукти [[1С]] і [[BAS]] внесені до відкритих переліків програмного забезпечення, забороненого до використання для окремих категорій організацій.; {| class="wikitable" style="width:100%;"

* немає вкладених структур;
* можуть бути проблеми з кодуванням;
* різні системи по-різному трактують роздільники;
* складно передавати табличні частини документів;
* складно передавати файли або складні реквізити.;[[Категорія:API]]
'''Практичне правило.''' Якщо Excel застосовується для регулярного імпорту, потрібно затвердити шаблон: назви колонок, порядок, типи даних, обов’язкові поля і правила перевірки.; Такий підхід застосовується; додатково реалізовано документів, залишків, цін, замовлень, платежів, інвентаризацій, звітів і інших бізнес-даних.; # Файл обробляється.; Бажаний формат
== Повний і частковий обмін ==
як ілюстрація:
Приклад логіки:

<syntaxhighlight lang="text">

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

"quantity": 2,

<Рядок>

Описати бізнес-сценарій.; Об’єкт

Типовий бізнес-процес імпорту: Приклад CSV:

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

; # Визначити ключі пошуку.; # Якщо є собою помилки — переноситься в `/error`.; Для чого підходить

Файлова інтеграційні функціональні можливості інвентаризації

Під час імпорту довідників істотно визначити ключ пошуку.; Помилка

постійних інтеграцій;
сайтів;
мобільних додатків;
обміну в реальному часі;
двосторонньої синхронізації;
автоматизованих процесів.;== Коли використовують інтеграцію через файли ==

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

користувач системи має змогу змінити структуру;
видалити колонку;
змінити формат дати;
випадково відсортувати тільки одну колонку;
зіпсувати артикули;
змінити формули;
зберегти файл у неправильному форматі.; Приклад CSV для номенклатури:

Що таке інтеграційні функціональні можливості через файли?; * не використовувати відкриті спільні папки без контролю;

обмежувати доступ;
шифрувати передавання;
захищати архіви;
не зберігати файли довше, ніж потрібно;
логіювати доступ;
очищати тимчасові файли;
перевіряти джерело файлу;
не приймати файли від невідомих джерел.; "name": "Іван Петренко",

Файловий обмін використовують у багатьох ситуаціях.; Результати інвентаризації можуть передаватися файлом із мобільного додатка або складської системи.; # Перевірити результат із користувачами.; Приклад

prices_2026_05_15.xlsx

15.05.2026 15:00

4500

0

4490

10

Частково завантажено

orders_2026_05_15.json

15.05.2026 16:00

120

118

0

2

Завантажено з помилками

Через файли часто передаються довідники:

інтеграційні функціональні можливості через файли — це простий, зрозумілий і практичний спосіб обміну даними між бізнес-системами.;

}

price_type;date;article;currency;price

<syntaxhighlight lang="json">
== Excel-файли ==
Але ручне редагування додатково створює ризики:
Після імпорту файл має змогу мати помилки.; рішення для бізнесу
!;<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">

{| class="wikitable" style="width:100%;"
 {
Вона надає можливість:
Приклад:
 "status": "paid",

== Архівування файлів ==

!; Приклад CSV-файлу з контрагентами:
== CSV-файли ==
організація повинна:
</div>
 }
== Файлова інтеграційні функціональні можливості і API ==
 "price": 250.00
{| class="wikitable" style="width:100%;"
'''Правильний підхід.''' Файлова інтеграційні функціональні можливості — це не хаотичний файл у спільній папці, а формалізований канал обміну з правилами, версіями, логами, перевірками і зрозумілою відповідальністю.; {

# Вибрати інформаційні дані.;== Типова стратегія файлової інтеграції ==
'''Файл рядків документів:'''
== XML-файли ==

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

!; Файли
== Файлова інтеграційні функціональні можливості довідників ==
Щоб уникнути дублів, під час імпорту потрібно визначити ключі пошуку.; # Визначити обов’язкові поля.; !;<Номер>РН-000123</Номер>
!; "number": "WEB-100245",

== Основні формати файлів ==

</div>

* вивантажити довідники;
* підготувати таблиці відповідності;
* перенести документи;
* перенести залишки;
* перенести взаєморозрахунки;
* перевірити якість даних;
* виконати тестову міграцію;
* повторити перенесення після виправлень.; doc_id;number;date;customer_code;warehouse_code;currency
!; Що означає
'''[[K2 ERP]]''' у цьому процесі має змогу стати новою платформою для контрольованого обміну даними, інтеграцій, імпорту, експорту, [[API]], [[BI]], звітності, бізнес-процесів і подальшого розвитку української ERP-екосистеми.; | Довідники, документи, залишки, ціни, замовлення, платежі, інвентаризації, звіти та файли.; DOC-001;CHARGER-20W;5;600.00;3000.00
Потрібно:
Приклади експорту:
!; * довго завантажуються;
* займають багато пам’яті;
* важко перевіряються;
* складно повторно обробляються;
* можуть блокувати інші процеси;
* можуть обриватися під час передачі.; # Реалізувати логіювання.; # Регулярно контролювати журнал.; Надійний ключ

* “Файл не завантажено”.;[[Категорія:Імпорт даних]]

# Зовнішня платформа кладе файл у каталог `/in`.; "quantity": 2,

Під час міграції або регулярного обміну потрібні таблиці відповідності.; * тип цін;
* дату дії;
* валюту;
* правило округлення;
* чи перезаписувати стару ціну;
* чи зберігати історію;
* чи потрібне погодження.; # Реалізувати протокол помилок.; Приклад

 <Дата>2026-05-15</Дата>

Або навпаки:

* прайс постачальника;
* залишки складу;
* список контрагентів;
* інвентаризаційна відомість;
* список товарів;
* таблиця відповідності кодів;
* фінансовий звіт.; |-
| Які інформаційні дані можна передавати?; Об’єкт

Якщо вона застосовується для вивантаження даних із [[1С]] або [[BAS]], це частина переходу до цифрової незалежності.; # Записати лог.; Одиниця

<syntaxhighlight lang="text">

* імпорту довідників;
* імпорту документів;
* імпорту залишків;
* імпорту цін;
* імпорту інвентаризацій;
* експорту товарів;
* експорту залишків;
* експорту звітів;
* міграції з [[1С]] або [[BAS]];
* обміну з партнерами;
* підтримки старих форматів клієнта.; |-
| Імпорт прайсів
| Товари, ціни, залишки постачальника
| Постачальник надсилає Excel-файл із цінами
|-
| Обмін із сайтом
| Замовлення, товари, ціни, залишки
| Інтернет-магазин передає замовлення в [[ERP]]
|-
| Міграція даних
| Довідники, документи, залишки, проводки
| Перехід із [[1С]] або [[BAS]] у [[K2 ERP]]
|-
| Обмін зі складом
| Переміщення, інвентаризації, залишки
| [[WMS]] передає результати складських операцій
|-
| Обмін із банком
| Виписки, платежі, статуси оплат
| Банк передає файл із рухом коштів
|-
| Обмін із маркетплейсом
| Каталог, ціни, залишки, замовлення
| Маркетплейс приймає файл із товарами
|-
| Передача звітів
| Таблиці, агреговані інформаційні дані, фінансові показники
| Вивантаження для аналітики або керівництва
|}

== Файлова інтеграційні функціональні можливості як перехідний інструмент з 1С/BAS ==

Файли можуть містити чутливі інформаційні дані:

 "price": 250.00
Інтернет-магазин має змогу передавати замовлення через файл.; # Сформувати протокол помилок.; # Результат записується в журнал обміну.; Приклад:

Якщо одна платформа передає `250,50`, а інша очікує `250.50`, імпорт має змогу завершитися помилкою.; 000002ТОВ Калина 8765432132000.00
<div style="border:3px solid #2e7d32; background:#e8f5e9; padding:14px; margin:16px 0;">
!; * міграції;
* прайсів;
* періодичних пакетних обмінів;
* роботи зі старими системами;
* ручної підготовки даних.; Коментар

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

'''Правильний файловий обмін.''' Файл не повинен без ускладнень зникати після обробки.; | CSV або Excel.; # Перенести файл в архів.; Приклад CSV:

Роздрібна;2026-05-15;USB-C-1M-BLK;UAH;250.00

external_code;article;name;unit;vat_rate;barcode

* відкрити Excel;
* перевірити кількість рядків;
* подивитися ціни;
* виправити помилки;
* порівняти з попередньою версією.; "order_number": "WEB-100245",
!; !;<syntaxhighlight lang="text">

Проблеми з кодуванням можуть призвести до пошкодження кирилиці.;== Таблиці відповідності ==
'''Файлова інтеграційні функціональні можливості''' — це обмін даними між системами через файли.; # Перевірити права доступу.; як ілюстрація:

!; Це потрібно для того, щоб:
[[Категорія:K2]]
!; Поле

* сайти;
* інтернет-магазини;
* [[CRM]];
* [[WMS]];
* банки;
* служби доставки;
* маркетплейси;
* мобільні додатки;
* бухгалтерські системи;
* аналітичні системи;
* системи електронного документообігу;
* зовнішні сервіси перевірки контрагентів;
* державні або галузеві системи.; Приклад:
Але нові інтеграції бажано проєктувати так, щоб у майбутньому їх можна було перевести на [[API]] або інші сучасні механізми.; Файловий обмін часто зручний тим, що користувач системи має змогу побачити файл.; Окремо варто відзначити [[XML]], [[JSON]], [[Microsoft Excel|Excel]], [[TXT]], [[YML]], [[DBF]] або інших структурованих файлів виступає ключовою рисою імпорту й експорту довідників забезпечується через '''інтеграційні функціональні можливості через файли'''.; |-
| Що найважливіше у файловій інтеграції?; # Отримати файл.; * текст із роздільниками;
* текст із фіксованою довжиною полів.;<syntaxhighlight lang="text">

* [[CSV]];
* [[XML]];
* [[Microsoft Excel|Excel]];
* [[JSON]];
* [[TXT]];
* [[DBF]].; # Записати журнал.; У журналі бажано зберігати:

як ілюстрація:
як ілюстрація:
!; # Провести тестовий обмін.; ID у K2 ERP

Файли обміну потрібно архівувати.;== Імпорт файлів ==

== JSON-файли ==

* документів;
* довідників із вкладеними реквізитами;
* залишків із характеристиками;
* міграції з [[1С]] або [[BAS]];
* обміну зі старими системами;
* складних структур.; |-
| Коли файловий обмін доречний?;[[XML]] добре підходить для складних структур.; | Структура файлу, ключі пошуку, валідація, логіювання, архівування, протокол помилок і контроль дублів.; Сценарій
'''істотно про 1С і BAS.''' Якщо файлова інтеграційні функціональні можливості застосовують, коли потрібно для обміну з [[1С]] або [[BAS]], потрібно враховувати санкційні, юридичні та кібербезпекові ризики цих продуктів в Україні.; # Перевірити формат.; !; Вона добре підходить для імпорту довідників, прайсів, залишків, документів і міграції, але потребує правил: структури файлів, контролю дублів, логіювання, архівування, перевірки помилок і захисту даних.; Залишок

Експорт — це формування файлу з даними системи.;<div style="border:3px solid #ef6c00; background:#fff3e0; padding:14px; margin:16px 0;">
!; !; API
Приклади:
 <Товари>
'''Правильна стратегія.''' Якщо файловий обмін застосовується для переходу з [[1С]] або [[BAS]], його головна задача — допомогти забрати інформаційні дані, перевірити їх і перенести в [[K2 ERP]], а не залишити стару систему як постійний центр обліку.; Дата
== Кодування файлів ==
'''Цифрова незалежність.''' Файлова інтеграційні функціональні можливості має змогу бути мостом від старої ризикової системи до сучасної української [[ERP]]-платформи.; Найчастіші помилки:

Поганий протокол:

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

Це різні підходи.; # Знайти існуючі об’єкти.;== Логіювання файлового обміну ==
!; | Це обмін даними між системами за допомогою файлів: CSV, Excel, XML, JSON, TXT та інших форматів.; # Реалізувати валідацію.; !; Перед завантаженням файл потрібно перевірити.; # Сайт оновлює доступну кількість товарів.; # Оновити інформаційні дані.; # Файл передається на сайт.; # [[K2 ERP]] перевіряє нові файли.; code;name;tax_code;phone;email
Формати можуть бути різними:
 "warehouse": "Відділення №10"

== Ключі пошуку ==

</div>

* немає затвердженого формату файлу;
* різні назви колонок;
* неправильне кодування;
* неправильні формати дат;
* кома замість крапки в числах;
* дублікати документів;
* відсутні зовнішні коди;
* назви використовуються замість кодів;
* файли перезаписуються без архіву;
* немає протоколу помилок;
* немає журналу;
* немає контролю доступу;
* користувачі вручну копіюють файли;
* обмін залежить від одного комп’ютера;
* файл імпортується повторно.;<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">
{
Такий файл має змогу бути використаний для:
[[Категорія:Інтеграції]]
DOC-001;РН-000123;2026-05-15;CUST-001;WH-001;UAH

<syntaxhighlight lang="text">

* сайтів;
* мобільних додатків;
* API;
* сучасних сервісів;
* легких інтеграцій;
* обміну структурованими даними.; !; Що передається
== Файлова інтеграційні функціональні можливості і цифрова незалежність ==
{{SEO
|title=Інтеграція через файли — обмін даними, CSV, XML, JSON, Excel, TXT та міграція в K2 ERP
|description=Інтеграція через файли: що таке файловий обмін, як передавати довідники, документи, залишки, ціни, замовлення, платежі, інвентаризації та звіти через CSV, XML, JSON, Excel, TXT, каталоги обміну, приклади структур, логіювання, безпека, типові помилки та перехід з 1С/BAS у K2 ERP.
|keywords=інтеграція через файли, файловий обмін, обмін файлами ERP, CSV інтеграція, XML інтеграція, JSON інтеграція, Excel імпорт, TXT обмін, імпорт файлів ERP, експорт файлів ERP, K2 ERP, інтеграція з 1С, інтеграція з BAS, міграція з 1С, міграція з BAS, санкції 1С, санкції BAS, українська ERP, автоматизація бізнесу, цифрова незалежність
|image=https://erp.kyiv.ua
}}
Жодна сучасна [[ERP]]-система не функціонує у вакуумі.;[[Категорія:Автоматизація бізнесу]]

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

* забрати свої інформаційні дані;
* зберегти довідники;
* перенести документи;
* звірити залишки;
* прибрати дублікати;
* відмовитися від ризикової платформи;
* перейти на українську [[ERP]];
* будувати нові інтеграції вже навколо [[K2 ERP]].; 2026-05-15;PAY-1001;12345678;ТОВ "замовник";15000.00;UAH;Оплата за рахунком №123
!; Файл
== TXT-файли ==

<syntaxhighlight lang="text">

Файлова інтеграційні функціональні можливості замовлень

UTF-8;
UTF-8 без BOM;
Windows-1251 у старих системах;
інші кодування для застарілих форматів.; # Архівувати копію.; "orders": [

Для XML або JSON документ можна передати одним файлом із вкладеними рядками.; Помилок

"article": "USB-C-1M-BLK",
<Назва>Кабель USB Type-C 1 м чорний</Назва>

Валідація файлів

000001|ТОВ Ромашка|12345678|15000.00

дата залишків;
складський облік;
товар;
характеристика;
партія;
серія;
кількість;
одиниця виміру;
сума;
організація.; "items": [

}
"date": "2026-05-15T14:25:00",
"date": "2026-05-15T14:25:00",

Одна платформа формує файл, інша платформа його читає.; 000001;ТОВ "Ромашка";12345678;+380441112233;info@romashka.ua !; # Перевірити обов’язкові поля.;</syntaxhighlight>

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

000002;ТОВ "Калина";87654321;+380671112233;office@kalyna.ua

Коротко

Ручний файл — це зона ризику. Якщо користувачі редагують файли перед імпортом, платформа повинна перевіряти не тільки інформаційні дані, а й структуру шаблону.;</syntaxhighlight> WH-001;USB-C-1M-BLK;100;98;-2

Великі файли

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