Дані доступні як в'ю у наборі даних bimp_public. Усі назви в цьому документі — це саме ті назви, які ви бачите й використовуєте у запитах.
Що варто знати при побудові звітів
Залишки рахуються на кінець місяця. Колонки opening_* дають значення на початок того самого місяця, closing_* — на кінець. Поточний місяць у розрахункових в'ю не заповнюється, бо він ще не завершений.
Залишки товарів ведуться в розрізі партій. Якщо компанія не веде облік партій, batch_guid буде порожнім у всіх рядках — це нормально. Якщо веде, не забувайте агрегувати по партіях, коли партія вам не потрібна.
Суми в двох валютах. У грошових в'ю amount і *_balance — у базовій валюті компанії, а *_currency — у валюті самого рахунку чи каси. Не змішуйте їх в одній сумі.
Ціни оновлюються раз на добу, решта даних — частіше. Якщо звіт показує «стару» ціну, спершу подивіться на exported_at.
Загальні позначення:
- Поля з суфіксом `_guid` — унікальний ідентифікатор для зв'язку з відповідним довідником (наприклад, `item_guid` зв'язує з таблицею `dim_nomenclature`).
- `company_id` є в кожній таблиці — ідентифікатор компанії (для компаній з кількома базами/філіями).
`exported_at` / `created_at` / `updated_at` — технічні дати вивантаження чи зміни запису, не бізнес-дата.
Довідники (Dimension)
v_dim_nomenclature — Номенклатура (товари, послуги, варіанти)
v_dim_counterparties — Контрагенти (клієнти, постачальники)
v_dim_employees — Співробітники
v_dim_business_lines — Напрямки діяльності
v_dim_nomenclature_groups — Групи номенклатури
v_dim_projects — Проекти
v_dim_warehouses — Склади
v_dim_organizations — Організації (юридичні особи компанії)
v_dim_financial_items — Статті доходів і витрат
v_dim_equipment — Техніка (обладнання клієнтів)
v_dim_equipment_groups — Групи техніки
v_cash_accounts — Рахунки та каси
v_customer_price — Прайс-листи для покупців
v_dim_nomenclature — Номенклатура (товари, послуги, варіанти)
| Поле | Опис |
|---|---|
| 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 | Ведеться облік серійних номерів |
| created_at / updated_at | Дата створення / останньої зміни запису |
v_dim_counterparties — Контрагенти (клієнти, постачальники)
| Поле | Опис |
|---|---|
| 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_prices.
| Поле | Опис |
|---|---|
| price_list_guid | Унікальний ідентифікатор прайс-листа |
| company_id | Компанія |
| name | Назва прайс-листа |
| comment | Коментар |
| is_main | Основний прайс-лист |
| is_archived | Архівний прайс-лист |
| currency_code | Код валюти прайс-листа за ISO 4217 |
Факти (Fact)
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 | Дата вивантаження запису |
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 | Дата вивантаження запису |
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 | Дата вивантаження запису |
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 | Дата вивантаження запису |
fact_additional_costs — Додаткові витрати по реалізації
| Поле | Опис |
|---|---|
| company_id | Компанія |
| document_guid | Документ додаткових витрат |
| item_guid | Товар, на який віднесено витрату |
| batch_guid | Партія товару |
| sales_document_guid | Документ продажу, до якого віднесено витрату |
| movement_date | Дата операції |
| cost_amount | Сума додаткової витрати |
| exported_at | Дата вивантаження запису |
fact_service_costs — Собівартість послуг
| Поле | Опис |
|---|---|
| company_id | Компанія |
| document_guid | Документ-підстава |
| item_guid | Послуга/товар |
| order_guid | Пов'язане замовлення |
| movement_date | Дата операції |
| cost_amount | Сума собівартості |
| exported_at | Дата вивантаження запису |
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 — Рух грошових коштів
Охоплює надходження й витрати по рахунках і касах: оплати, перекази між рахунками й касами, отримання та повернення кредитів і інвестицій.
| Поле | Опис |
|---|---|
| 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 — Ціни для покупців
Чинні ціни номенклатури по кожному прайс-листу. Це зріз актуальних цін, а не історія змін: на кожну пару «товар + прайс-лист» є рівно один рядок з останньою ціною.
Оновлюється раз на добу, о 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 — Місячні залишки на складах
| Поле | Опис |
|---|---|
| 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 | Дата розрахунку запису |
`average_cost` порожній там, де `closing_balance` дорівнює нулю. Якщо товар повністю розпроданий за місяць, собівартості залишку не існує — ділити нема на що. Це не прогалина в даних, і таких рядків зазвичай близько половини. У звітах фільтруйте за closing_balance != 0, а не за average_cost IS NOT NULL.
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 | Службова, для перевірки доступу; бізнес-даних не містить |
