# Довідник полів таблиць BigQuery

URL: https://bimpsoft.com/help/bi/bigquery-fields/
Updated: 2026-11-06

> Дані Bimp у BigQuery доступні як в'ю набору даних bimp_public: довідники (v_dim_*), факти (v_fact_*), грошові в'ю і розрахункові місячні залишки. Довідник описує кожне поле кожного в'ю. Поля з суфіксом _guid зв'язують таблиці, company_id є в кожній таблиці, а exported_at, created_at, updated_at — технічні дати, не бізнес-дати.

## Загальні правила роботи з в'ю

Усі дані Bimp доступні як в'ю (views) у наборі даних «bimp_public» проєкту «Bimpsoft». Назви в'ю й полів у цьому довіднику збігаються з тими, що ви бачите й використовуєте в запитах, Looker Studio та Power BI. Про підключення — у статтях [BigQuery і Looker Studio](https://bimpsoft.com/help/bi/bigquery-looker-studio/) та [Power BI](https://bimpsoft.com/help/bi/power-bi/).

| Правило | Що це означає |
|---|---|
| Поля із суфіксом `_guid` | Унікальний ідентифікатор для зв'язку з відповідним довідником. Наприклад, «item_guid» зв'язує факт із «v_dim_nomenclature» |
| «company_id» | Є в кожній таблиці; ідентифікатор компанії (для компаній з кількома базами чи філіями) |
| «exported_at», «created_at», «updated_at» | Технічні дати вивантаження чи зміни запису, не бізнес-дата. Для звітів беріть «document_date» або «movement_date» |
| Залишки на кінець місяця | Колонки «opening_*» — значення на початок місяця, «closing_*» — на кінець. Поточний місяць у розрахункових в'ю не заповнюється, бо він не завершений |
| Партії | Залишки товарів ведуться в розрізі партій. Якщо компанія не веде облік партій, «batch_guid» порожній у всіх рядках. Якщо веде, агрегуйте по партіях, коли партія не потрібна |
| Дві валюти | У грошових в'ю «amount» і «*_balance» — у базовій валюті компанії, «*_currency» — у валюті рахунку чи каси. Не змішуйте їх в одній сумі |
| Ціни | Оновлюються раз на добу, решта даних — частіше. Якщо звіт показує «стару» ціну, спершу перевірте «exported_at» |

## Які в'ю доступні

Набір даних «bimp_public» містить довідники (dimension), факти (fact), грошові в'ю та розрахункові в'ю.

| В'ю | Що містить | Група |
|---|---|---|
| v_dim_nomenclature | Номенклатура: товари, послуги, варіанти | Довідник |
| v_dim_counterparties | Контрагенти: клієнти, постачальники | Довідник |
| v_dim_employees | Співробітники | Довідник |
| v_dim_business_lines | Напрямки діяльності | Довідник |
| v_dim_nomenclature_groups | Групи номенклатури | Довідник |
| v_dim_projects | Проєкти | Довідник |
| v_dim_warehouses | [Склади](https://bimpsoft.com/help/inventory/warehouses/) | Довідник |
| v_dim_organizations | Організації (юридичні особи компанії) | Довідник |
| v_dim_financial_items | Статті доходів і витрат | Довідник |
| v_dim_equipment | Техніка (обладнання клієнтів) | Довідник |
| v_dim_equipment_groups | Групи техніки | Довідник |
| v_cash_accounts | Рахунки та каси | Довідник |
| v_customer_price | [Прайс-листи для покупців](https://bimpsoft.com/help/pricing/price-lists/) | Довідник |
| v_fact_sales | Продажі | Факт |
| v_fact_orders | [Замовлення (рахунки на оплату)](https://bimpsoft.com/help/sales/customer-order/) | Факт |
| v_fact_income_expenses | Доходи та витрати | Факт |
| v_fact_repairs | Ремонти | Факт |
| v_fact_additional_costs | Додаткові витрати по реалізації | Факт |
| v_fact_service_costs | Собівартість послуг | Факт |
| v_fact_stock_movements | Рух товарів по складах | Факт |
| v_cash_movements | Рух грошових коштів | Факт |
| v_customer_prices | Ціни для покупців | Факт |
| v_dim_monthly_stock_balances | Місячні залишки на складах | Розрахункове |
| v_monthly_cash_balances | Місячні залишки коштів | Розрахункове |

## v_dim_nomenclature: номенклатура

В'ю «v_dim_nomenclature» містить товари, послуги та їхні варіанти (характеристики). Саме «item_guid» цього в'ю використовується у фактових в'ю.

| Поле | Опис |
|---|---|
| company_id | Компанія |
| item_guid | Унікальний ідентифікатор товару чи послуги (використовується у фактових в'ю) |
| product_guid | Ідентифікатор базового товару (якщо рядок є варіантом чи характеристикою) |
| variant_guid | Ідентифікатор варіанту (характеристики) товару |
| product_name | Назва базового товару |
| variant_name | Назва варіанту чи характеристики |
| full_name | Повна назва (товар + варіант) |
| is_variant | Це варіант (характеристика), а не основний товар |
| article | Артикул |
| group_guid | Група номенклатури (зв'язок з v_dim_nomenclature_groups) |
| unit_name | Одиниця виміру |
| is_service | Послуга (не фізичний товар) |
| is_archived | Архівний (неактивний) товар |
| is_kit | Комплект (набір з кількох товарів) |
| barcode | Штрихкод |
| weight, length, width, height, volume | Вага, довжина, ширина, висота, об'єм |
| country_of_origin | Країна виробництва |
| description | Опис товару |
| min_stock_level | Мінімальний залишок на складі |
| is_batches_tracked | Ведеться облік партій |
| is_serial_tracked | Ведеться облік [серійних номерів](https://bimpsoft.com/help/inventory/serial-numbers/) |
| created_at, updated_at | Дата створення і останньої зміни запису |

## v_dim_counterparties: контрагенти

В'ю «v_dim_counterparties» містить клієнтів і постачальників. Ключ — «contractor_guid».

| Поле | Опис |
|---|---|
| contractor_guid | Унікальний ідентифікатор контрагента |
| company_id | Компанія |
| status | Статус контрагента |
| name | Повна назва |
| print_name | Назва для друку в документах |
| priority | Пріоритет контрагента |
| parent_contractor_guid | Головний контрагент (якщо входить у групу чи холдинг) |
| owner_name | Відповідальний за контрагента |
| email, phone | Контактні дані |
| lead_source | Джерело залучення клієнта |
| is_customer | Є клієнтом |
| is_supplier | Є постачальником |
| is_individual | Фізична особа (не компанія) |
| country, region | Країна, регіон |
| tax_id | ІПН (податковий номер) |
| reg_code | ЄДРПОУ (реєстраційний код) |
| author_name | Хто створив запис |
| manager_name | Менеджер, відповідальний за контрагента |
| is_archived | Архівний (неактивний) контрагент |
| created_at, updated_at | Дата створення і останньої зміни |
| comment | Коментар до контрагента |
| contact_name | Ім'я основного контакту контрагента |

## v_dim_employees: співробітники

| Поле | Опис |
|---|---|
| employee_guid | Унікальний ідентифікатор співробітника |
| company_id | Компанія |
| name | ПІБ |
| position | Посада |
| status_name | Статус (працює / звільнений) |
| hire_date | Дата прийняття на роботу |
| dismissal_date | Дата звільнення |
| comment | Коментар |
| is_archived | Архівний запис |
| created_at, updated_at | Дата створення і останньої зміни |

## v_dim_business_lines: напрямки діяльності

| Поле | Опис |
|---|---|
| business_line_guid | Унікальний ідентифікатор напрямку |
| company_id | Компанія |
| name | Назва напрямку |
| comment | Коментар |
| is_archived | Архівний напрямок |
| is_main | Основний напрямок діяльності |
| parent_business_line_guid | Батьківський напрямок (якщо є ієрархія) |
| warehouse_guid | Пов'язаний склад |
| created_at, updated_at | Дата створення і останньої зміни |

## v_dim_nomenclature_groups: групи номенклатури

| Поле | Опис |
|---|---|
| nomenclature_group_guid | Унікальний ідентифікатор групи |
| company_id | Компанія |
| name | Назва групи |
| comment | Коментар |
| is_archived | Архівна група |
| parent_nomenclature_group_guid | Батьківська група (ієрархія груп товарів) |
| created_at, updated_at | Дата створення і останньої зміни |

## v_dim_projects: проєкти

| Поле | Опис |
|---|---|
| project_guid | Унікальний ідентифікатор проєкту |
| company_id | Компанія |
| name | Назва проєкту |
| comment | Коментар |
| is_archived | Архівний проєкт |
| manager_name | Менеджер проєкту |
| parent_project_guid | Батьківський проєкт (ієрархія) |
| created_at, updated_at | Дата створення і останньої зміни |

## v_dim_warehouses: склади

| Поле | Опис |
|---|---|
| warehouse_guid | Унікальний ідентифікатор складу |
| company_id | Компанія |
| name | Назва складу |
| is_main | Основний склад |
| is_archived | Архівний склад |
| is_public | Публічний склад (доступний усім) |
| is_active | Активний склад |
| is_group | Група складів (не фізичний склад, а об'єднання) |
| warehouse_kind | Тип складу |
| comment | Коментар |
| address | Адреса |
| is_counterparty_warehouse | Склад контрагента (наприклад, комісія) |
| parent_warehouse_guid | Батьківський склад (ієрархія) |
| created_at, updated_at | Дата створення і останньої зміни |

## v_dim_organizations: організації

В'ю містить юридичні особи компанії.

| Поле | Опис |
|---|---|
| organization_guid | Унікальний ідентифікатор організації |
| company_id | Компанія |
| name | Назва організації |
| legal_name | Юридична назва |
| inn_code | ІПН |
| edrpou_code | ЄДРПОУ |
| legal_address | Юридична адреса |
| director_name | Директор |
| phone_number | Телефон |
| organization_type | Тип організації |
| is_main | Основна організація |
| is_vat_payer | Платник ПДВ |
| is_archived | Архівна організація |
| created_at, updated_at | Дата створення і останньої зміни |

## v_dim_financial_items: статті доходів і витрат

| Поле | Опис |
|---|---|
| financial_item_guid | Унікальний ідентифікатор статті |
| company_id | Компанія |
| item_type | Тип статті (дохід / витрата) |
| name | Назва статті |
| group_name | Назва групи статей |
| parent_guid | Батьківська стаття (ієрархія) |
| rgk_item | Пов'язана стаття руху грошових коштів (ДДС), якщо застосовується |
| activity_kind_name | Вид діяльності (операційна / інвестиційна / фінансова) |
| is_archived | Архівна стаття |
| exported_at | Дата вивантаження запису |

## v_dim_equipment: техніка

В'ю містить обладнання клієнтів.

| Поле | Опис |
|---|---|
| equipment_guid | Унікальний ідентифікатор одиниці техніки |
| company_id | Компанія |
| name | Назва техніки |
| is_archived | Архівний запис |
| created_at, updated_at | Дата створення і останньої зміни |
| equipment_group_guid | Група техніки (зв'язок з v_dim_equipment_groups) |
| model | Модель |
| serial_number | Серійний номер |
| manufacture_year | Рік випуску |
| counterparty_guid | Власник техніки (контрагент) |
| equipment_kind | Вид техніки |
| comment | Коментар |
| acceptance_date | Дата прийняття на облік |
| warranty_months | Гарантійний термін, місяців |

## v_dim_equipment_groups: групи техніки

| Поле | Опис |
|---|---|
| equipment_group_guid | Унікальний ідентифікатор групи техніки |
| company_id | Компанія |
| name | Назва групи |
| parent_group_guid | Батьківська група (ієрархія) |
| is_archived | Архівна група |
| created_at, updated_at | Дата створення і останньої зміни |

## v_cash_accounts: рахунки та каси

В'ю містить власні банківські рахунки організацій і каси компанії. Рахунки контрагентів сюди не входять.

| Поле | Опис |
|---|---|
| account_guid | Рахунок або каса |
| company_id | Компанія |
| account_kind | `bank_account` (банківський рахунок) або `cash_desk` (каса) |
| name | Назва |
| code | Код у довіднику |
| currency_guid | Валюта |
| currency_code | Код валюти за ISO 4217 |
| bank_name | Банк (лише для рахунків) |
| account_number | Номер рахунку |
| mfo | МФО банку |
| is_main | Основний рахунок чи каса |
| is_archived | В архіві |
| is_deleted | Позначено на видалення |
| comment | Коментар |
| exported_at | Дата вивантаження запису |

## v_customer_price: прайс-листи для покупців

В'ю «v_customer_price» — довідник прайс-листів. Самі ціни містяться у «v_customer_prices».

| Поле | Опис |
|---|---|
| price_list_guid | Унікальний ідентифікатор прайс-листа |
| company_id | Компанія |
| name | Назва прайс-листа |
| comment | Коментар |
| is_main | Основний прайс-лист |
| is_archived | Архівний прайс-лист |
| currency_code | Код валюти прайс-листа за ISO 4217 |

## v_fact_sales: продажі

В'ю «v_fact_sales» містить рядки продажів товарів і послуг. Одному рядку відповідає одна позиція документа продажу.

| Поле | Опис |
|---|---|
| sale_id | Унікальний ідентифікатор рядка продажу |
| company_id | Компанія |
| movement_date | Дата і час продажу |
| item_guid | Товар чи послуга |
| batch_guid | Партія товару |
| batch_name | Назва партії |
| organization_guid | Організація-продавець |
| counterparty_guid | Покупець |
| contract_guid | Договір |
| order_guid | Пов'язане замовлення (рахунок на оплату) |
| business_line_guid | Напрямок діяльності |
| project_guid | Проєкт |
| warehouse_guid | Склад, з якого здійснено продаж |
| responsible_employee_guid | Відповідальний співробітник |
| quantity | Кількість |
| amount_base | Сума продажу в базовій валюті, з ПДВ |
| amount_without_vat_base | Сума без ПДВ, у базовій валюті |
| vat_amount_base | Сума ПДВ, у базовій валюті |
| amount_currency | Сума у валюті документа |
| document_currency_code | Код валюти документа |
| goods_cost_amount | Собівартість проданого товару |
| operation_type | Тип операції продажу |
| sales_document_guid | Документ-підстава для продажу |
| document_type | Тип документа продажу |
| document_number | Номер документа продажу |
| document_date | Дата документа продажу |
| order_number | Номер замовлення (рахунка) |
| order_date | Дата замовлення (рахунка) |
| order_type | Тип документа замовлення |
| contract_number | Номер договору |
| contract_name | Назва договору |
| exported_at | Дата вивантаження запису |

## v_fact_orders: замовлення покупців

В'ю «v_fact_orders» містить замовлення (рахунки на оплату) по рядках.

| Поле | Опис |
|---|---|
| row_id | Унікальний ідентифікатор рядка замовлення (замовлення + номер рядка) |
| order_guid | Ідентифікатор замовлення (документа) |
| company_id | Компанія |
| order_date | Дата замовлення |
| order_number | Номер замовлення |
| organization_guid | Організація-продавець |
| counterparty_guid | Покупець |
| project_guid | Проєкт |
| business_line_guid | Напрямок діяльності |
| comment | Коментар до замовлення |
| responsible_employee_guid | Відповідальний співробітник |
| warehouse_guid | Склад відвантаження |
| planned_shipment_date | Планована дата відвантаження |
| status_name | Статус замовлення |
| contract_name | Назва договору |
| contract_number | Номер договору |
| line_number | Номер рядка в замовленні |
| item_guid | Товар чи послуга в рядку замовлення |
| quantity | Кількість |
| amount_without_vat | Сума рядка без ПДВ |
| vat_amount | Сума ПДВ рядка |
| amount_with_vat | Сума рядка з ПДВ |
| discount_amount | Сума знижки |
| exported_at | Дата вивантаження запису |

## v_fact_income_expenses: доходи та витрати

| Поле | Опис |
|---|---|
| movement_id | Унікальний ідентифікатор руху коштів чи статті |
| company_id | Компанія |
| movement_date | Дата операції |
| document_guid | Документ-підстава |
| document_type | Тип документа |
| document_date | Дата документа |
| document_number | Номер документа |
| business_line_guid | Напрямок діяльності |
| project_guid | Проєкт |
| financial_item_guid | Стаття доходу чи витрати |
| counterparty_guid | Контрагент |
| organization_guid | Організація |
| income_amount | Сума доходу |
| expense_amount | Сума витрати |
| exported_at | Дата вивантаження запису |

## v_fact_repairs: ремонти

| Поле | Опис |
|---|---|
| movement_id | Унікальний ідентифікатор запису |
| company_id | Компанія |
| movement_date | Дата операції (передачі чи приймання) |
| document_guid | Документ «Прийом і передача в ремонт» |
| document_number | Номер документа |
| counterparty_guid | Клієнт |
| warehouse_guid | Склад |
| project_guid | Проєкт |
| business_line_guid | Напрямок діяльності |
| responsible_guid | Відповідальний співробітник |
| reason_for_service | Причина звернення чи опис несправності |
| acceptance_date | Дата приймання техніки в ремонт |
| completion_date | Дата завершення ремонту |
| return_date | Дата повернення техніки клієнту |
| item_guid | Товар, запчастина чи послуга, пов'язана з ремонтом |
| quantity | Кількість |
| order_guid | Пов'язане замовлення |
| order_date | Дата замовлення |
| order_number | Номер замовлення |
| order_type | Тип документа замовлення |
| exported_at | Дата вивантаження запису |

## v_fact_additional_costs: додаткові витрати по реалізації

| Поле | Опис |
|---|---|
| company_id | Компанія |
| document_guid | Документ додаткових витрат |
| item_guid | Товар, на який віднесено витрату |
| batch_guid | Партія товару |
| sales_document_guid | Документ продажу, до якого віднесено витрату |
| movement_date | Дата операції |
| cost_amount | Сума додаткової витрати |
| exported_at | Дата вивантаження запису |

## v_fact_service_costs: собівартість послуг

| Поле | Опис |
|---|---|
| company_id | Компанія |
| document_guid | Документ-підстава |
| item_guid | Послуга чи товар |
| order_guid | Пов'язане замовлення |
| movement_date | Дата операції |
| cost_amount | Сума [собівартості](https://bimpsoft.com/help/costing/cost-price-guide/) |
| exported_at | Дата вивантаження запису |

## v_fact_stock_movements: рух товарів по складах

| Поле | Опис |
|---|---|
| company_id | Компанія |
| movement_id | Унікальний ідентифікатор руху |
| document_guid | Документ-підстава руху |
| document_type | Тип документа |
| document_number | Номер документа |
| document_date | Дата документа |
| movement_date | Дата і час руху товару |
| warehouse_guid | Склад |
| item_guid | Товар |
| batch_guid | Партія товару |
| batch_name | Назва партії |
| quantity | Кількість руху |
| amount | Сума руху |
| sign | Напрямок руху: надходження чи списання (+1 / −1) |
| exported_at | Дата вивантаження запису |

## v_cash_movements: рух грошових коштів

В'ю «v_cash_movements» охоплює надходження й витрати по рахунках і касах: оплати, перекази між рахунками й касами, отримання та повернення кредитів і інвестицій.

| Поле | Опис |
|---|---|
| company_id | Компанія |
| movement_id | Ключ рядка: `document_guid:номер рядка` |
| document_guid | Документ-підстава |
| document_type | Тип документа |
| document_number | Номер документа |
| document_date | Дата документа |
| movement_date | Дата руху |
| account_guid | Рахунок або каса |
| account_kind | `bank_account` або `cash_desk` |
| cash_type_guid | Тип грошових коштів |
| cash_type_name | Назва типу грошових коштів |
| currency_guid | Валюта |
| currency_code | Код валюти за ISO 4217 |
| amount | Сума в базовій валюті |
| amount_currency | Сума у валюті рахунку або каси |
| sign | Напрямок руху: надходження чи витрата (+1 / −1) |
| comment | Призначення платежу |
| exported_at | Дата вивантаження запису |

## v_customer_prices: ціни для покупців

В'ю «v_customer_prices» містить чинні ціни номенклатури по кожному прайс-листу. Це зріз актуальних цін, а не історія змін: на кожну пару «товар + прайс-лист» є рівно один рядок з останньою ціною. В'ю оновлюється раз на добу о 02:00, тому ціна, змінена протягом дня, з'явиться наступної ночі.

| Поле | Опис |
|---|---|
| company_id | Компанія |
| item_guid | Товар (для товарів з характеристиками — конкретна характеристика) |
| price_list_guid | Прайс-лист (зв'язок з v_customer_price) |
| price | Ціна |
| currency_code | Код валюти за ISO 4217; береться з прайс-листа |
| price_date | Дата, з якої діє ця ціна |
| exported_at | Момент зняття зрізу — однаковий для всіх рядків одного оновлення |

## v_dim_monthly_stock_balances: місячні залишки на складах

Розрахункові в'ю не вивантажуються з обліку напряму: рядки рахуються накопиченням по рухах. В'ю «v_dim_monthly_stock_balances» показує залишки товарів по складах на початок і кінець кожного завершеного місяця.

| Поле | Опис |
|---|---|
| company_id | Компанія |
| warehouse_guid | Склад |
| item_guid | Товар |
| batch_guid | Партія товару (порожньо, якщо компанія не веде облік партій) |
| month_start | Перший день місяця, до якого належить рядок |
| net_quantity | Чистий рух кількості товару за місяць |
| opening_balance | Залишок кількості на початок місяця |
| closing_balance | Залишок кількості на кінець місяця |
| net_amount | Чистий рух вартості за місяць |
| opening_amount | Вартість залишку на початок місяця |
| closing_amount | Вартість залишку на кінець місяця |
| average_cost | Собівартість одиниці залишку: `closing_amount / closing_balance` |
| calculated_at | Дата розрахунку запису |

> [!NOTE] Поле «average_cost» порожнє там, де «closing_balance» дорівнює нулю: якщо товар повністю розпроданий за місяць, собівартості залишку не існує. Це не прогалина в даних, і таких рядків зазвичай близько половини. У звітах фільтруйте за `closing_balance != 0`, а не за `average_cost IS NOT NULL`.

## v_monthly_cash_balances: місячні залишки коштів

В'ю «v_monthly_cash_balances» показує обороти й залишки по кожному рахунку чи касі на початок і кінець завершеного місяця, у базовій валюті й у валюті рахунку.

| Поле | Опис |
|---|---|
| company_id | Компанія |
| account_guid | Рахунок або каса |
| account_kind | `bank_account` або `cash_desk` |
| currency_code | Код валюти за ISO 4217 |
| month_start | Перший день місяця, до якого належить рядок |
| net_amount | Оборот за місяць у базовій валюті |
| opening_balance | Залишок на початок місяця |
| closing_balance | Залишок на кінець місяця |
| net_amount_currency | Оборот за місяць у валюті рахунку |
| opening_balance_currency | Залишок на початок місяця у валюті рахунку |
| closing_balance_currency | Залишок на кінець місяця у валюті рахунку |
| calculated_at | Дата розрахунку запису |

## Які в'ю не описані в довіднику

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

| В'ю | Примітка |
|---|---|
| v_fact_sales_enriched | Похідне в'ю поверх продажів; склад полів залежить від його визначення |
| test_whoami | Службове, для перевірки доступу; бізнес-даних не містить |

## FAQ

**Як зв'язати таблиці BigQuery між собою?**

Через поля із суфіксом _guid. Наприклад, item_guid у v_fact_sales відповідає item_guid у v_dim_nomenclature, counterparty_guid — contractor_guid у v_dim_counterparties.

**Чому в таблицях залишків немає поточного місяця?**

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

**Чому batch_guid порожній?**

Якщо компанія не веде облік партій, batch_guid порожній у всіх рядках — це нормально. Якщо веде, агрегуйте по партіях, коли партія в звіті не потрібна.

**Чому ціна у звіті застаріла?**

Ціни у v_customer_prices оновлюються раз на добу о 02:00, тож змінена вдень ціна з'явиться наступної ночі. Перевірте поле exported_at.

**Чому average_cost порожній?**

У v_dim_monthly_stock_balances average_cost порожній, коли closing_balance дорівнює нулю: ділити нема на що. Фільтруйте за closing_balance != 0, а не за average_cost IS NOT NULL.