Змінні, які слід використовувати під час імпорту даних до акаунта
Створено:
30.04.2025
Остання актуалізація:
30.04.2025
Кількість відвідувань статті: 32
Хочете швидко імпортувати рахунки-фактури, клієнтів або товари до BitFaktura, але не знаєте, які змінні підтримуються системою? Ми підготували перелік доступних змінних із поділом на імпорт рахунків-фактур, клієнтів і товарів, завдяки якому ви зможете перевірити, які змінні доступні залежно від типу імпортованих даних.
Які дані можна імпортувати в систему?
Система дозволяє імпортувати рахунки-фактури, базу клієнтів та товари. Якщо раніше ви користувалися іншою системою, яка підтримує експорт даних у форматах .XLS, .XLSX (Excel), .TXT, .CSV, .TSV, або самостійно підготували файл для імпорту, ви можете завантажити його до системи — на його основі буде створено документи та сформовано базу решти даних.
Детальні інструкції з імпорту можна знайти у відповідних статтях:
→ Імпорт рахунків-фактур на продаж та Імпорт витратних рахунків-фактур
→ Імпорт бази клієнтів
→ Імпорт бази продуктів
Щоб імпорт завершився успішно, на кроці 2 необхідно призначити стовпцям правильні змінні, які відповідають їх вмісту. Наприклад, стовпець із назвою проданого товару або послуги повинен мати призначену змінну position.name : позиція - Назва продукту / послуги. Тоді система правильно зіставить це значення з відповідним полем у рахунку-фактурі.
Нижче надаємо повний список змінних, поділений за типами імпорту.
Змінні для використання під час імпорту даних до акаунта
Нижче ви знайдете список змінних з їх описом, розділених на імпорти, для яких заданий список є дійсним.
→ імпорт рахунків-фактур
→ імпорт клієнтів
→ імпорт продуктів
Змінні, доступні для вибору під час імпорту рахунків-фактур ↴
| Ключ |
Опис |
| number |
номер |
| issue_date |
Дата виставлення |
| sell_date |
Дата продажу |
| payment_to |
Термін оплати |
| buyer_name |
Одержувач |
| position.name |
позиція - Назва продукту / послуги |
| position.quantity |
позиція - Кількість |
| position.total_price_gross |
позиція - Загальна вартість |
| accounting_income_tax_date |
Дата оприбуткування податку на прибуток |
| accounting_kind |
Вид витрати |
| accounting_scheme |
Схема бухгалтерського обліку |
| accounting_status |
Статус обліку |
| accounting_vat_tax_date |
Дата оприбуткування ПДВ |
| additional_info_desc |
Додаткове поле в позиціях рахунку-фактури |
| buyer_bank |
Банк |
| buyer_bank_account |
Банківський рахунок |
| buyer_city |
Місце |
| buyer_company |
Фірма |
| buyer_country |
Країна |
| buyer_email |
E-mail клієнта |
| buyer_first_name |
Ім'я |
| buyer_last_name |
Прізвище |
| buyer_mass_payment_code |
Індивідуальний банківський рахунок |
| buyer_name |
Покупець |
| buyer_note |
Додатковий опис |
| buyer_person |
Ім'я та прізвище одержувача |
| buyer_phone |
Телефон клієнта |
| buyer_post_code |
Поштовий індекс |
| buyer_street |
Вулиця та № |
| buyer_tax_no |
ІПН / ЄДРПОУ |
| buyer_tax_no_kind |
Тип ідентифікаційного номера покупця |
| cancelled |
Скасування документа |
| category_id |
Категорія |
| correction |
Виправлений документ |
| currency |
Валюта |
| delivery_address |
Адресат |
| delivery_date |
Дата надходження документа |
| department_id |
Продавець |
| description |
Примітки |
| description_footer |
Додаткові примітки (друковані внизу сторінки) |
| description_long |
Додаткові примітки (друковані на зворотному боці) |
| discount |
Знижка |
| discount_kind |
Тип знижки |
| discount_net |
Знижка від чистої суми |
| email_status |
Статус надсилання електронного листа |
| exchange_currency |
Конвертація валют |
| exchange_currency_rate |
Курс |
| exchange_currency_rate_den |
Знаменник обмінного курсу валют |
| exchange_date |
Дата курсу конвертації |
| exchange_kind |
За курсом |
| exchange_note |
Примітка до курсу |
| exchange_rate_den |
Знаменник курсу |
| exclude_from_stock_level |
Виключення товару зі складу |
| gov_id |
Номер KSeF |
| gov_kind |
Тип KSeF |
| gov_status |
Статус KSeF |
| income |
Дохід |
| internal_note |
Приватна примітка (не видно на друкованому вигляді) |
| invoice_id |
ID документа |
| invoice_template_id |
Шаблон для друку |
| issue_date |
Дата виставлення |
| issued_to_receipt |
Рахунок-фактура до квитанції |
| issuer |
Видавець документа |
| kind |
Тип |
| lang |
Мова |
| na_tax_kind |
Вид податку, що не підлягає оподаткуванню |
| number |
Номер |
| oid |
№ замовлення |
| paid |
Сума сплачена |
| paid_date |
Дата платежу |
| pattern |
Формат нумерації |
| payment_to |
Термін платежу |
| payment_to_kind |
Термін платежу |
| payment_type |
Платіж |
| place |
Місце виставлення |
| price_gross |
Ціна |
| price_net |
Чиста ціна |
| price_tax |
ПДВ |
| print_time |
Дата друку |
| recipient_id |
ID одержувача |
| recipient_name |
Одержувач |
| reverse_charge |
Зворотне нарахування |
| search_data |
Дані для швидкого пошуку рахунка-фактури |
| sell_date |
Дата продажу |
| sell_date_kind |
Позначення часу продажу |
| seller_bank |
Банк |
| seller_bank_account |
Банківський рахунок |
| seller_bank_account_id |
ID номер банківського рахунку |
| seller_city |
Місце |
| seller_country |
Країна |
| seller_email |
E-mail |
| seller_fax |
Факс |
| seller_name |
Продавець |
| seller_person |
Ім'я та прізвище продавця |
| seller_phone |
Телефон |
| seller_post_code |
Поштовий індекс |
| seller_street |
Вулиця та № |
| seller_tax_no |
ІПН/ЄДРПОУ |
| seller_tax_no_kind |
Тип ідентифікаційного номера Продавця |
| seller_www |
Сайт |
| sent_time |
Дата відправлення |
| show_attachments |
Вкладені файли, видимі клієнту |
| show_discount |
Видимий розділ знижок |
| status |
Статус |
| tax2_visible |
Другий податок (видимість) |
| test |
Тестовий документ |
| use_delivery_address |
Інша поштова адреса |
| use_issuer |
Інний видавець |
| use_moss |
Рахунок-фактура OSS |
| warehouse_id |
Склад |
| additional_invoice_field |
Дата закінчення послуги |
| buyer_mobile_phone |
Мобільний телефон |
| department_shortcut |
Скорочена назва відділу |
| no |
№ |
| gtu_codes |
Коди GTU |
| procedure_designations |
Позначення процедур |
| original_invoice |
Оригінальний документ |
| correction_reason |
Причина виправлення |
| position.name |
позиція - Назва продукту / послуги |
| position.quantity |
позиція - Кількість |
| position.price_net |
позиція - Чиста ціна |
| position.price_gross |
позиція - Ціна |
| position.tax |
позиція - Ставка ПДВ |
| position.total_price_net |
позиція - Сума |
| position.total_price_tax |
позиція - ПДВ |
| position.total_price_gross |
позиція - Загальна сума |
| position.gtu_code |
позиція - Код GTU |
| position.quantity_unit |
позиція - Одиниця |
| position.discount |
позиція - Сума знижки |
| position.description |
позиція - Опис |
| position.code |
позиція - Код продукту |
| position.additional_info |
позиція - Значення додаткового поля на позиціях рахунка-фактури |
| position.product_id |
позиція - ID продукту |
| position.kind |
позиція - тип позиції |
| position.discount_percent |
позиція - Знижка |
| recipient_company |
[Одержувач] Фірма |
| recipient_first_name |
[Одержувач] Ім'я |
| recipient_last_name |
[Одержувач] Прізвище |
| recipient_tax_no |
[Одержувач] ІПН/ЄДРПОУ |
| recipient_street |
[Одержувач] Вулиця та № |
| recipient_post_code |
[Одержувач] Поштовий індекс |
| recipient_city |
[Одержувач] Місце |
| recipient_country |
[Одержувач] Країна |
| recipient_email |
[Одержувач] E-mail |
| recipient_phone |
[Одержувач] Телефон |
| recipient_note |
[Одержувач] Додатковий опис |
| split_payment |
Механізм розділеної оплати |
Змінні, доступні для вибору під час імпорту клієнтів ↴
| Ключ |
Опис |
| shortcut |
Скорочена назва (системна) |
| name |
Назва фірми |
| company |
Фірма |
| accounting_id |
Ідентифікатор в бухгалтерській програмі |
| attachments_count |
Кількість вкладень |
| bank |
Банк |
| bank_account |
Номер банківського рахунку |
| bank_account_id |
ID Банківського рахунку |
| buyer_id |
Покупець |
| category_id |
Категорія |
| city |
Місце |
| company |
Фірма |
| country |
Країна |
| default_payment_type |
Тип платежу за умовчанням |
| delivery_address |
Адреса для листування |
| department_id |
Доступ до даних |
| disable_auto_reminders |
Не надсилати автоматичні нагадування |
| discount |
% знижки за замовчуванням |
| email |
E-mail |
| external_id |
ID клієнта |
| fax |
Факс |
| first_name |
Ім'я |
| id |
ID |
| kind |
Тип |
| last_name |
Прізвище |
| mass_payment_code |
Індивідуальний банківський рахунок (або закінчення рахунку) |
| mobile_phone |
Мобільний телефон |
| name |
Назва фірми |
| note |
Додатковий опис |
| payment_to_kind |
Дата платежу за замовчуванням |
| person |
Отримувач рахунка-фактури |
| phone |
Мобільний телефон |
| post_code |
Поштовий індекс |
| price_list_id |
Прайс-лист |
| referrer |
Джерело запиту |
| register_number |
REGON |
| shortcut |
Скорочена назва (системна) |
| street |
Вулиця |
| street_no |
Номер будинку |
| tag_list |
Теги |
| tax_no_kind |
ІПН/ЄДРПОУ |
| title |
Назва |
| use_delivery_address |
Інша поштова адреса |
| use_mass_payment |
Масові платежі |
| www |
Вебсайт |
Змінні, доступні для вибору під час імпорту продуктів ↴
| Ключ |
Опис |
| name |
Назва |
| price_net |
Ціна |
| accounting_id |
Код обліку (продажі) |
| additional_fields |
Додаткові поля у рахунку-фактурі |
| additional_info |
Додаткове поле |
| attachments_count |
Кількість вкладень |
| auto_payment_deoartment_id |
Відділ, що виставляє рахунок |
| automatic_sales |
Продажі онлайн |
| available_from |
Продається з |
| available_to |
Продається до |
| category_id |
Категорія |
| code |
Код продукту |
| currency |
Валюта |
| department_id |
Фірма/Відділ (доступ до даних) |
| description |
Опис |
| disabled |
Неактивний |
| ean_code |
Код EAN |
| elastic_price |
Ціна може бути змінена платником (наприклад, пожертвування тощо) або встановлена при виклику віджета |
| elastic_price_date_trigger |
Наступна зміна ціни відбудеться |
| form_description |
Опис платежу |
| form_fields_horizontal |
Описи полів ліворуч |
| form_kind |
Форма оплати |
| form_name |
Назва платежу |
| form_template |
Шаблон форми |
| gtu_codes |
Код GTU |
| id |
ID продукту |
| image_url |
URL-адреса зображення продукту |
| kind |
Тип |
| limited |
Обмеження кількості (склади) |
| name |
Назва |
| next_product_id |
Черговий продукт у формі |
| payment_callback |
API викликаний після оплати |
| payment_url_error |
URL-адреса після помилки оплати |
| payment_url_ok |
URL-адреса після успішної оплати |
| period |
Період оплати |
| price_gross |
Ціна |
| price_net |
Чиста ціна |
| price_net_on_payment |
Показувати чисту ціну в платежі |
| price_tax |
Сума податку |
| purchase_price_gross |
Ціна закупівлі |
| purchase_price_net |
Чиста ціна закупівлі |
| purchase_price_tax |
Вартість податку |
| purchase_tax |
ПДВ |
| purchase_tax2 |
Назва другого податку (TAX) |
| default_quantity |
Кількість продаваних товарів за замовчуванням |
| quantity_unit |
Одиниця |
| restricted_to_warehouses |
Продукт доступний лише для дистриб'юторів на вибраних складах |
| service |
Послуга |
| show_elastic_price |
Гнучка ціна |
| size |
Розмір |
| size_height |
Висота |
| size_unit |
Представляє одиниці вимірювання (мм, см, м) |
| size_width |
Ширина |
| status |
Статус рахунку-фактури (виставлений, оплачений тощо) |
| stock_level |
Доступна кількість |
| subscription_id |
ID підписки |
| supplier_code |
Код постачальника |
| tag_list |
Теги |
| tax |
ПДВ |
| tax2 |
TAX (другий податок) |
| token |
Токен |
| use_moss |
Підлягає під OSS |
| use_product_warehouses |
Окремі ціни продажу для складів |
| use_quantity_discount |
Доступні кількості (і можлива знижка) |
| warehouse_quantity |
Рівні запасів |
| weight |
Вага |
| weight_unit |
Представляє одиниці вимірювання (кг, г) |
| warehouse_id |
ID складу |
Додати коментар