# Mengimpor barang dari foto

Membaca daftar barang dari foto menu atau daftar harga, memeriksanya, lalu menyimpannya sekaligus.

## Sebelum mulai

* Menu **POS** harus aktif untuk workspace. Bila belum, layar menampilkan **POS belum aktif untuk workspace ini**.
* Sidebar Catalog hanya untuk peran dengan izin `pos:config:update`. Peran lain dialihkan ke `/pos`.
* Siapkan foto menu atau daftar harga. Maksimal 5 foto, masing-masing 10 MB, berformat JPG, PNG, atau WebP.
* Ada batas impor foto per hari. Bila tercapai, halaman menampilkan **Batas impor foto hari ini sudah tercapai. Coba lagi besok.**

## Langkah

<Steps>
  <Step>
    Di halaman **Barang**, pilih **Impor dari foto**. Halaman **Impor dari foto** terbuka dengan teks "Baca daftar barang dari foto menu, periksa, lalu simpan."

    ![Tombol Impor dari foto](/help/pos/items/25-import-button.png)
  </Step>

  <Step>
    Pilih **Pilih foto** (atau seret foto ke kotak). Di HP juga ada **Ambil foto**. Foto yang dipilih tampil sebagai gambar kecil; pilih tombol silang untuk membuangnya.

    ![Kotak unggah foto](/help/pos/items/26-upload.png)
  </Step>
</Steps>

## Setelah memilih foto

* Pilih **Mulai baca**. Tombol nonaktif sampai ada foto, dan berubah menjadi **Mengunggah…** saat berjalan.
* Tunggu pembacaan. Halaman menampilkan **Membaca foto 1 dari N…** dan status tiap foto: **Menunggu**, **Membaca…**, **Selesai**, atau **Gagal**.
* Periksa hasil di tab **Item**. Ubah **Nama**, **Harga**, **Kategori**, dan **Satuan** bila perlu, lalu centang barang yang mau disimpan. Pilih **Varian** pada satu baris untuk membuka daftar varian, lalu **Tambah varian** untuk menambahnya.
* Pilih **Simpan N item**. Pilih **Batal** untuk kembali ke daftar tanpa menyimpan.

## Hasilnya

* Barang yang tersimpan muncul di daftar **Barang** dan notifikasi menampilkan "N item tersimpan".
* Baris yang sudah ada di katalog diberi label **Sudah ada**.
* Barang yang sudah disimpan dikelompokkan di **Sudah disimpan**.

## Masalah umum

* **Semua foto gagal dibaca.** — pilih **Coba foto lain**.
* **Tidak ada item terbaca dari foto ini.** — foto tidak menghasilkan barang. Coba foto lain.
* **Nama dan harga wajib diisi.** — baris yang dicentang harus punya **Nama** dan **Harga**. **Nama varian wajib diisi.** bila ada harga varian tanpa nama.
* Bila sebagian foto gagal, halaman menampilkan **Foto 1 gagal: \<alasan>** untuk foto itu.
* Foto yang bukan JPG, PNG, atau WebP, lebih dari 10 MB, atau melebihi 5 foto ditolak dengan pesan di bawah kotak unggah.
