вгору

Заборонені символи – не біда

10.09.2025

SAF-T UA

Гарбузове лате, легка прохолода й робота в улюбленій обліковій системі – так розпочався новий ранок Звітлани. Вона саме вносила до довідника нового контрагента з красивою назвою «Сузір’я». Та коли дійшла до апострофа, в голові промайнула думка: «Здається, я щось читала про цей символ у документації SAF-T UA…» І тут згадалося: заборонені символи! « Чудовий привід покликати Сафтія на каву.» – з посмішкою вирішила Звітлана. І вже за мить, наче почувши запрошення, поруч з’явився Сафтій – як завжди готовий допомогти розібратися.

– Сафтію, що ти знаєш про заборонені символи в SAF-T UA? Мені доведеться вручну перевіряти всю базу і виправляти ці символи?

– Дійсно, існує перелік символів, які не можна використовувати у файлі SAF-T UA. Але не забувай, що у тебе є M.E.Doc API SAF-T UA, який самостійно обробляє такі символи. Наприклад, якщо ти десь поставиш «<», «>» чи «&», то в XML вони автоматично перетворяться на безпечні версії: <, >, &.

– Тобто, якщо я в назві контрагента напишу «Сузір’я», система сама все підчистить? – з цікавістю спитала Звітлана.

– Саме так. Але є три комбінації, яких варто уникати: амперсанд із хешем (&#), подвійне тире (--) і слеш зі зірочкою (/*).

– Упс… Подвійне тире я могла десь поставити. Я так інколи підкреслюю важливе.

– Не хвилюйся, – заспокоїв Сафтій. – Якщо таке і трапиться, то під час експорту в XML система просто замінить ці символи на пробіл. Файл SAF-T UA не пошкодиться, але краще уникати таких комбінацій одразу. Бо пробіл замість «підкреслення важливості» виглядає не так ефектно, еге ж?

– Сафтію, а якщо я все ж зроблю помилку, як вчасно її виявити та виправити?

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

– Супер! Виходить, навіть якщо я щось пропущу, M.E.Doc API SAF-T UA мене підстрахує?

– Так, звичайно. Але якщо уважність – це твоя сильна сторона, то можеш спробувати і сама все перевірити.

– Я- то звичайно уважна, але якщо що – знаю, що M.E.Doc API SAF-T UA завжди «прикриє спину».

– Оце правильний підхід! – вигукнув Сафтій, перш ніж піти.

Заборонені символи більше не лякали, і Звітлана відчула, що контролює ситуацію. Вона зробила ковток теплого лате й посміхнулася: день обіцяв бути продуктивним.

Висновки:

Більшість «небезпечних» символів система автоматично перетворює на безпечні XML-еквіваленти.

Є три комбінації, яких краще уникати: &#, --, /*.

Не зайвим буде перевірити дані, особливо ті, що копіюються з Excel чи інших систем.

M.E.Doc API SAF-T UA має вбудовані перевірки і протоколи, тож «заборонені символи» – це радше маленьке попередження, ніж реальна загроза.

Далі буде...

У наступній статті – «У яких довідниках важливий період, а в яких - – ні?». Пояснимо, чому одні дані вимагають період, а інші - діють незалежно від часу. 