Skip to main content
POS Ventas uses the Html5-QRCode library to scan barcodes and QR codes directly in the browser using your device’s camera. No app installation is required.
The scanner works best on a mobile device with a rear camera.

Scanning a product during a sale

1

Tap Escanear

In the Sales view, tap the Escanear (📷) button next to the search bar. Your browser will ask for camera permission if it hasn’t already been granted — tap Allow.
2

Point at the barcode

Hold the camera steady over the barcode or QR code. The scanner targets a 250 × 250 px area in the center of the viewfinder.
3

Wait for the result

The scanner runs at 10 frames per second. Once a code is recognized, the camera closes automatically.
  • Product found — the item is added to the cart immediately
  • Product not found — a prompt asks whether you want to create a new product with the scanned code pre-filled

Adding a new product with a scanned code

When you scan a barcode that does not match any existing product, the app asks whether you want to create a new product. If you confirm, the product form opens with the scanned code pre-filled in the Código de Barras field — you only need to enter the name and price.
The barcode scanner is available in the Sales view only. To add a new product using a scanned code, initiate a scan from the Sales view and confirm the “create product” prompt when the code is not recognized.

Supported formats

Html5-QRCode supports a broad range of code types, including:
  • QR codes
  • EAN-13 and EAN-8
  • Code 128
  • UPC-A and UPC-E
  • Code 39, ITF, and more

Scanner configuration

SettingValue
Frame rate10 fps
Scan box250 × 250 px
CameraBack camera (facingMode: "environment")
Input modeCamera only

Error states

ErrorCause
Permission deniedCamera access was blocked in the browser
No camera foundThe device has no camera, or no camera was detected
Browser not supportedThe browser does not support the camera API
Camera in useAnother app or tab is already using the camera
Camera access requires permission from the browser. Some browsers only allow camera access over HTTPS — if you’re running POS Ventas from a local file, the scanner may not work in those browsers.

Build docs developers (and LLMs) love