> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/ms/ciri-lain/analytics.md).

# Laporan Inventori

Ciri Laporan Inventori dalam BoxHero membantu anda menjana laporan tersuai daripada data inventori dan jualan anda. Anda boleh mencipta pengiraan yang diperibadikan dan menjejak metrik utama yang paling penting bagi anda.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-ddbbbff7339c6b8d9b396c551f5d467a89563617%2F%E1%84%8C%E1%85%A2%E1%84%80%E1%85%A9%20%E1%84%87%E1%85%AE%E1%86%AB%E1%84%89%E1%85%A5%E1%86%A8%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Gambaran Keseluruhan Laporan Inventori

Dalam bar sisi, pergi ke <mark style="color:$primary;">`Laporan`</mark> > <mark style="color:$primary;">`Inventori`</mark>.

Anda boleh melaraskan tetapan formula untuk menganalisis data inventori anda, menapis hasil mengikut lokasi atau julat tarikh, dan mengeksport laporan ke Excel untuk penyimpanan rekod dan analisis.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2F8VpQzrhWgL3KDApwmKaQ%2Freport-inventory.jpg?alt=media&amp;token=d1620085-55c3-426c-a0ec-fc1afc86ea90" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Laporan inventori menggunakan&#x20;*****semasa*****&#x20;kos dan harga**, bukan nilai pada masa transaksi. Jika anda menukar harga sesuatu item, laporan lampau akan dikira semula menggunakan harga baharu. Untuk ketepatan pada masa tertentu, gunakan <mark style="color:biru;">`Pembelian & Jualan`</mark> atau eksport secara berkala.
{% endhint %}

## Tambah Formula

Untuk menambah formula, klik <mark style="color:$primary;">`Tetapan Formula`</mark> > <mark style="color:$primary;">`Tambah Formula`</mark>. Anda akan mempunyai dua pilihan:

* **Tambah Pantas** — pilih daripada formula siap sedia untuk metrik umum seperti keuntungan, pusing ganti, dan banyak lagi. Tiada persediaan diperlukan.
* **Formula Tersuai** — bina formula anda sendiri daripada pemboleh ubah dan fungsi BoxHero. Gunakannya untuk metrik yang kami tidak tawarkan, atau untuk menggabungkan atribut item anda sendiri dengan data inventori.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FbDVRAVhl4IUFajnV5MIz%2Freport-add%20formula%20options.jpg?alt=media&amp;token=2704f812-5468-4bf1-918b-6e4122029ef0" alt=""><figcaption></figcaption></figure>

### A. Tambah Pantas

Tambah formula siap sedia dan mula membuat laporan dengan segera.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FYgkfDP44NTxrimkrfD93%2Fframeit_2026-07-15T00-00-56.jpg?alt=media&amp;token=c558728b-b62c-48b1-97c6-bbd650f80b38" alt=""><figcaption></figcaption></figure>

#### Atribut Item

Anda boleh menggunakan [atribut](/docs/documentation/ms/konsep/attributes.md) dengan nilai berangka untuk mencipta formula.

#### Jualan & Untung

* **Jumlah Kos**: Kos x Jumlah Kuantiti Stok Masuk
* **Jumlah Hasil**: Harga x Jumlah Kuantiti Stok Keluar
* **Untung Bersih**: Harga - Kos
* **Untung Kasar**: (Harga - Kos) x Jumlah Kuantiti Stok Keluar
  * *Jumlah keuntungan daripada semua yang dijual dalam tempoh yang dipilih.*
* **Margin Keuntungan (%)**: (Harga - Kos) ÷ Harga
  * *Bahagian harga yang merupakan keuntungan.*
* **Purata Hasil Harian**: (Harga x Jumlah Kuantiti Stok Keluar) ÷ Bilangan Hari
* **Purata Untung Kasar Harian**: (Harga - Kos) x Jumlah Kuantiti Stok Keluar ÷ Bilangan Hari

#### **Inventori & Pergerakan**

* **Nilai Inventori**: Kos x Kuantiti Semasa
* **Pusing Ganti Inventori**: Jumlah Kuantiti Stok Keluar ÷ Purata Kuantiti
  * *Berapa kali anda menjual stok purata anda. Lebih tinggi bermaksud inventori bergerak lebih pantas.*
* **Purata Stok Masuk Harian**: Jumlah Kuantiti Stok Masuk ÷ Bilangan Hari
* **Purata Stok Keluar Harian**: Jumlah Kuantiti Stok Keluar ÷ Bilangan Hari
* **Hari Stok Baki**: Kuantiti Semasa ÷ (Jumlah Kuantiti Stok Keluar ÷ Bilangan Hari)
  * *Pada kadar semasa, berapa lama lagi sehingga stok habis. Gunakannya untuk menetapkan masa pesanan semula.*

### B. Formula Tersuai

Bina formula anda sendiri daripada pemboleh ubah dan fungsi BoxHero.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FFjSgJHwjFvzeVynbOmNZ%2Freport-formula%20settings.jpg?alt=media&amp;token=24dbf068-a033-405b-8402-83cbcc7c3bec" alt=""><figcaption></figcaption></figure>

#### Pemboleh ubah autolengkap

Enter `$` untuk mengakses pemboleh ubah inventori dan `{{` untuk mendapatkan atribut/nilai yang disimpan.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FqfJzuQNgnXEQugUDYGCV%2Fcustom%20formula-autocomplete.jpg?alt=media&amp;token=60681cd2-66af-4faf-8e3f-e00b7b3d7a51" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="209">Nama Pemboleh Ubah</th><th>Penerangan</th></tr></thead><tbody><tr><td><strong>Kuantiti Semasa</strong></td><td>Paras inventori semasa bagi sesuatu item.</td></tr><tr><td><strong>Bilangan Hari</strong></td><td>Bilangan hari dalam tempoh yang dipilih.</td></tr><tr><td><strong>Purata Kuantiti</strong></td><td>Purata inventori sepanjang tempoh yang dipilih, dikira menggunakan kuantiti inventori pada 23:59:59 setiap hari.</td></tr><tr><td><strong>Kuantiti Permulaan</strong></td><td>Inventori pada permulaan tempoh yang dipilih (23:59:59 pada <em>hari sebelum</em> tarikh mula).</td></tr><tr><td><strong>Kuantiti Akhir</strong></td><td>Inventori pada akhir tempoh yang dipilih (23:59:59 pada <em>hari terakhir</em> tempoh tersebut).</td></tr><tr><td><strong>Jumlah Kuantiti Stok Masuk</strong></td><td>Jumlah kuantiti masuk.</td></tr><tr><td><strong>Kiraan Stok Masuk</strong></td><td>Bilangan <strong>Stok</strong> <strong>Sedang</strong> transaksi sepanjang tempoh yang dipilih.</td></tr><tr><td><strong>Jumlah Kuantiti Stok Keluar</strong></td><td>Jumlah kuantiti keluar.</td></tr><tr><td><strong>Kiraan Stok Keluar</strong></td><td>Bilangan <strong>Stok</strong> <strong>Keluar</strong> transaksi sepanjang tempoh yang dipilih.</td></tr><tr><td><strong>Purata Berwajaran Stok Keluar (Linear 2, 3, 4)</strong></td><td><p>Purata stok keluar harian, dibobotkan supaya hari yang lebih baru dikira lebih banyak. Setiap hari dalam tempoh yang dipilih diberi wajaran yang meningkat secara linear, dengan hari tertua sentiasa diberi wajaran 1. Nombor tersebut menetapkan wajaran hari yang paling baru — 2, 3, atau 4 — jadi nombor yang lebih tinggi menjadikan purata lebih responsif terhadap aktiviti terkini.</p><ul><li><strong>Linear 2</strong>: Hari tertua mempunyai wajaran 1, hari paling baru mempunyai wajaran 2</li><li><strong>Linear 3</strong>: Hari tertua mempunyai wajaran 1, hari paling baru mempunyai wajaran 3</li><li><strong>Linear 4</strong>: Hari tertua mempunyai wajaran 1, hari paling baru mempunyai wajaran 4</li></ul></td></tr><tr><td><strong>Laraskan Kuantiti (Peningkatan)</strong></td><td>Kuantiti ditambah oleh <strong>Laraskan Stok</strong> transaksi.</td></tr><tr><td><strong>Laraskan Kuantiti (Pengurangan)</strong></td><td>Kuantiti dikeluarkan oleh <strong>Laraskan Stok</strong> transaksi.</td></tr><tr><td><strong>Laraskan Kuantiti (Bersih)</strong></td><td>Laraskan Kuantiti (Peningkatan) − Laraskan Kuantiti (Pengurangan).</td></tr><tr><td><strong>Kiraan Pelarasan</strong></td><td>Bilangan kali suatu <strong>Laraskan</strong> transaksi dibuat dalam tempoh tertentu.</td></tr><tr><td><strong>Pindah Kuantiti (Masuk)</strong></td><td>Kuantiti dipindahkan <em>ke dalam</em> ke lokasi yang dipilih oleh <strong>Pindahkan Stok</strong> transaksi.</td></tr><tr><td><strong>Pindah Kuantiti (Keluar)</strong></td><td>Kuantiti dipindahkan <em>keluar dari</em> ke lokasi yang dipilih oleh <strong>Pindahkan Stok</strong> transaksi.</td></tr><tr><td><strong>Pindah Kuantiti (Bersih)</strong></td><td>Pindah Kuantiti (Masuk) − Pindah Kuantiti (Keluar).</td></tr><tr><td><strong>Kiraan Pindah (Masuk)</strong></td><td>Bilangan <strong>Pindahkan Stok</strong> transaksi yang meningkatkan inventori di lokasi yang dipilih.</td></tr><tr><td><strong>Kiraan Pindah (Keluar)</strong></td><td>Bilangan <strong>Pindahkan Stok</strong> transaksi yang mengurangkan inventori di lokasi yang dipilih.</td></tr></tbody></table>

#### Fungsi Tersedia

BoxHero menyokong pelbagai fungsi, serupa dengan fungsi Excel yang setara.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FpfVugON6ys4TRDkaWvMV%2Fcustom%20formula-functions.jpg?alt=media&amp;token=b96457f9-561a-4e3b-a7e8-3ad5f7c498b2" alt=""><figcaption></figcaption></figure>

* **Aritmetik asas:** `+`, `-`, `*`, `/`
* **Bersyarat**: `if(syarat, nilai jika benar, nilai jika palsu)`
  * Menilai satu syarat dan memulangkan satu nilai jika benar, satu lagi jika palsu.
* **Pembundaran:**
  * **round**: `round(nombor, digit)`
  * **roundUp**: `roundUp(nombor, digit)`
  * **roundDown**: `roundDown(nombor, digit)`
* **Penukaran Jenis:**
  * **toNumber**: `toNumber(rentetan, nilai sandaran)`
    * Menukar teks kepada nombor, dan memulangkan nilai sandaran jika penukaran gagal.
  * **toString**: `toString(nombor)`
    * Menukar nombor kepada teks.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FVyBJAJ0MT0De3Y0tqCIA%2Fcustom%20formula-examples.jpg?alt=media&amp;token=69c49349-7827-4f20-85e0-228819f82b03" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Perlukan sesuatu yang lain?** <mark style="color:$primary;">`Analitik Tersuai`</mark> membolehkan anda membuat pertanyaan terus pada data inventori anda dengan SQL. Gunakannya untuk soalan yang tidak sesuai dengan formula setiap item.
{% endhint %}

***

## Soalan Lazim

**Mencari maklumat lanjut?** Layari Soalan Lazim kami:

{% content-ref url="/spaces/8A9ZEY4416TjPUs4LWRq/pages/e9e451cc9cea4493b4cf4cfaa3c3eb42a08dfb89" %}
[Laporan inventori](/docs/faq/ms/pelaporan/inventory-reports.md)
{% endcontent-ref %}