Ke mana data pergi (POS)

POS retail memanggil POST /v1/lookup setiap kali produk tidak ada di daftar jual toko. Pencarian hanya membaca katalog yang diterbitkan.

flowchart TD
  K["Kasir scan barcode / ketik nama"] --> L{"Ada di produk toko?"}
  L -- "ya" --> M["Masuk keranjang<br/>(tidak memakai katalog)"]
  L -- "tidak" --> N["POST /v1/lookup"]
  N --> O{"Ada barcode?"}
  O -- "ya" --> P{"GTIN valid ada di katalog?"}
  P -- "ya" --> Q["Hasil pasti: matchedBy gtin"]
  P -- "tidak" --> R
  O -- "tidak" --> R["Cari kata di nama, merek, varian, alias"]
  R --> S{"Ada yang cocok?"}
  S -- "ya" --> T["Kandidat (maks 10)<br/>kasir memilih"]
  S -- "tidak" --> U["404 no product found"]
  Q --> V["Kasir mengisi harga sendiri<br/>jadi produk toko"]
  T --> V

Yang dipakai pencarian

Cara cari	Field katalog yang dibaca
Barcode	gtin14 (barcode dinormalkan ke 14 digit, mis. 8991234567891 → 08991234567891)
Teks	Setiap kata diharuskan cocok di salah satu dari: nama, merek, varian, alias

Karena itu alias, merek, dan varian sangat menentukan apakah produk ditemukan. Lihat Alias agar mudah dicari.

Yang tidak dibawa ke POS

Katalog tidak menyimpan harga, stok, atau foto kemasan; kasir mengisi harga jual toko sendiri. Isian Catatan pada draft tidak ikut ke katalog.